# Análise de Próximos Passos — Lotérica Premiada v2

Documento de referência para decidir o que desenvolver a seguir. Baseado em `src/` v1, `frontend/`, `docs/plano-acao-v2-completo.md`, `.cursor/rules/` e inspiração em Mega Loterias e Sorte Online.

**Última atualização:** 2025-03 (pós-Fase 34; Fase 35 documentada em docs/plano-acao-v2-completo.md)

---

## 1. O que já existe (não repetir)

Consultar `docs/plano-acao-v2-completo.md` seções "Estado Atual" e "Já existe". Resumo:

| Área | Implementado |
|------|---------------|
| **Loterias** | MG, LF, QN, LM, DS, TM, ST, SS, MM (9 completas) |
| **Home** | Hero, 3 passos, por que escolher, e se premiado, estatísticas, notícias, depoimentos, newsletter, LoteriasHomeCards (valor estimado), PodeConfiarSection, ParceirosSection, BoloesRecomendadosBanner |
| **Notícias** | Seção home, /noticias (busca, categorias, grid por loteria), /{loteria}/noticias |
| **Conta** | Login, cadastro, saldo, jogos, premiações, créditos, perfil, endereços, recuperar senha |
| **Pagamentos** | PIX, Mercado Pago, PagSeguro (boleto), Cielo (integração SDK) |
| **Admin** | Login, pedidos crédito, clientes, bolões, notícias (CRUD) |
| **Estatísticas** | Números mais sorteados, maiores prêmios, premios por estado, testador de palpite |
| **UX** | Surpresinha quentes/frios, teimosinha visual, simulador bolão, link Ver Jogo premiações |
| **Outros** | WhatsApp, login social (Google, Facebook), cashback, PWA, favoritos, lembretes, Doctor (landing), Afiliado, Campanha, Chat (Tawk.to), Push, A/B test, instantâneas (protótipo) |

---

## 2. Gaps identificados (src/ v1 vs v2 — migração completa)

| Módulo v1 | v2 | Status |
|-----------|-----|--------|
| Admin index (dashboard) | Sim | [x] 21.2 |
| Relatório financeiro | Sim (API + frontend) | [x] 21.3 |
| Configurações (Conta) | Sim | [x] 21.4 |
| Gerenciar concursos | Sim (API + frontend) | [x] 21.5 |
| Gerenciar depoimentos | Sim | [x] 21.6 |
| Gerenciar campanhas | API + frontend (listagem, edição) | [x] 21.7 |
| Lotofácil Doctor | Landing v2, redireciona v1 | **Falta** 21.11 (Doctor v2) |
| **Indique um amigo** | Sim (API + /indique, /conta/indicacoes) | [x] 22.1, 22.8 |
| **Loteca (LC)** | Página "Em breve", regra + doc | **Falta** 22.2 (volante + conferência) |
| **Gerenciar Pedidos Afiliado** | API + frontend admin/afiliados | [x] 22.3 |
| **Matrizes bolões** | API + frontend | [x] 22.4 |
| **Usuários admin** | API + frontend | [x] 22.5 |
| **Loterias CRUD** | API + frontend | [x] 22.6 |
| **Cron/Tarefas** | Runbook + endpoints v2 | [x] 23.2 |
| **Solicitar resgate de prêmio (cliente)** | Sim (API + /conta/resgate) | [x] 24.1 |
| **Admin: Extrato do cliente** | Sim (API + admin/clientes/[id] extrato) | [x] 24.2 |
| **Admin: Bolão compradores** | Sim (API + admin/boloes/[id] compradores) | [x] 24.3 |
| **Admin: Gerenciar pedidos de resgate** | Sim (API + admin/resgates) | [x] 25.1 |
| **Conta: Alterar senha (logado)** | Sim (API + conta/perfil) | [x] 25.2 |
| **E-mail resgate aprovado** | Sim | [x] 25.3 |
| **LOTOGOL completo** | Regra lotogol.mdc; v1 tem controller/view | **Falta** 21.9 / 19.3 |
| **Badge Acumulou! proeminente** | LoteriasHomeCards | [x] 22.9 |
| **/minha-conta** | Redirect para /conta/saldo | [x] 22.10 |
| **Criar bolão 100% v2** | Wizard /criar-bolao, useConcursoCotasWizard, FinalizarService | [x] 30.3 |
| **Admin Campanhas: enviar e-mail** | CRUD existe; falta disparo (sendAtivos, sendAindaNaoApostaram) | **Falta** 31.1 |
| **Admin: excluir cliente** | Bloquear existe; falta delete definitivo | **Falta** 31.2 |
| **Admin: enviar bônus em lote** | Enviar por cliente existe; falta enviarBonusTodos | **Falta** 31.3 |
| **Admin: clientes loteria online** | Filtros inativos/nao_apostaram/menos_ativos existem | **Falta** 31.4 |
| **Admin: enviar spam / spam acumulada** | — | **Falta** 31.5 |

---

## 3. Fase 21 — Ideias Novas (pós-Fase 20)

**Ver `docs/plano-acao-v2-completo.md` seção "Fase 21"** para descrição completa.

| # | Item | Inspiração | Prioridade | Esforço |
|---|------|------------|------------|---------|
| 21.1 | Especiais em destaque na home | Sorte Online | Alta | Baixo |
| 21.2 | Admin Dashboard | src/Admin | Alta | Médio |
| 21.3 | Admin Relatório financeiro | src/Relatorio | Alta | Médio |
| 21.4 | Admin Configurações | src/Admin/Conta | Alta | Alto |
| 21.5 | Admin Gerenciar concursos | src/Bolao/Concurso | Média | Médio |
| 21.6 | Admin Gerenciar depoimentos | src/Depoimentos | Média | Baixo |
| 21.7 | Admin Gerenciar campanhas | src/Campanha | Baixa | Médio |
| 21.8 | Criar bolão 100% na v2 | BolaoController v1 | Alta | Alto |
| 21.9 | LOTOGOL completo | Mega Loterias | Média | Alto |
| 21.10 | Countdown para sorteio | Sorte/Mega | Média | Baixo |
| 21.11 | Doctor integrado v2 | src/Doctor | Baixa | Muito alto |

---

## 4. Fase 22 — Ideias Novas (pós-Fase 21)

Ver `docs/plano-acao-v2-completo.md` seção "Fase 22".

| # | Item | Inspiração | Prioridade | Esforço |
|---|------|------------|------------|---------|
| 22.1 | Indique um amigo | v1 | Alta | Médio |
| 22.2 | Loteca (LC) | v1 | Baixa | Alto |
| 22.3 | Admin Gerenciar Afiliados | v1 | Média | Médio |
| 22.4 | Admin Matrizes | v1 | Baixa | Médio |
| 22.5 | Admin Usuários | v1 | Baixa | Médio |
| 22.6 | Admin Loterias CRUD | v1 | Baixa | Baixo |
| 22.7 | Cron/Tarefas | v1 | Média | Alto |
| 22.8 | Histórico indicações | Sorte Online | Média | Baixo |
| 22.9 | Badge Acumulou! proeminente | Mega/Sorte | Média | Baixo |
| 22.10 | Página /minha-conta | Mega Loterias | Baixa | Baixo |

---

## 5. Ordem sugerida de execução

1. **26.2 Lembrete antes do sorteio** — conversão e retenção (Fase 26)
2. **25.1 Admin: Gerenciar pedidos de resgate** — operação essencial para aprovar resgates (Fase 25)
3. **25.2 Conta: Alterar senha (logado)** — paridade v1, segurança (Fase 25)
4. **26.1 FAQ atendimento por categoria** — reduz suporte (Fase 26)
5. **21.3 Admin Relatório** — gestão financeira (frontend já existe)
6. **26.4 Admin exportar relatório CSV/Excel** — operação (Fase 26)
7. **22.9 Badge Acumulou!** — quick win, conversão
8. **23.2 Cron runbook/endpoints v2** — operação (Fase 23)
9. **19.2 Criar bolão v2** — fluxo central
10. **23.1 Limite depósito/aposta** — jogo responsável (Fase 23)
11. **22.3 Admin Afiliados** — se programa ativo
12. **19.3 LOTOGOL completo** — diferencial
13. **25.3 E-mail resgate aprovado** — refinamento (Fase 25)

Ver **Fase 35** (pós-Fase 34) em docs/plano-acao-v2-completo.md para ordem atualizada. Fases 23–34 concluídas.

---

## 6. Prompt para o assistente

Use este prompt ao pedir análise e documentação:

```
Analise o projeto v2 da Lotérica Premiada para identificar próximos passos de desenvolvimento.

Fontes obrigatórias: src/ (v1), frontend/, docs/plano-acao-v2-completo.md, .cursor/rules/, docs/loterias/ideias-melhorias.md.

Referências (apenas o que LP v2 NÃO tem): megaloterias.com.br, sorteonline.com.br.

Regras: (1) Não sugerir o que já existe. (2) Priorizar por impacto e viabilidade. (3) Documentar cada ideia com descrição, inspiração, prioridade, esforço. (4) Atualizar docs/plano-acao-v2-completo.md com nova Fase (ex.: Fase 31) ou "Ideias Novas (pós-Fase 30)". (5) Respeitar .cursor/rules/ e padrões v2.
```

---

## 7. Fase 26 — Ideias Novas (pós-Fase 25) — Resumo

Detalhes em `docs/plano-acao-v2-completo.md` § Fase 26.

| # | Item | Inspiração | Prioridade | Esforço |
|---|------|------------|------------|---------|
| 26.1 | FAQ atendimento por categoria | Mega/Sorte | Média | Baixo |
| 26.2 | Lembrete antes do sorteio | ideias-melhorias.md | Alta | Médio |
| 26.3 | Compartilhar bolão / redes | Mega/Sorte | Média | Baixo |
| 26.4 | Admin: Exportar relatório CSV/Excel | Operação | Média | Baixo |
| 26.5 | Conta: Excluir minha conta (LGPD) | LGPD | Média | Médio |
| 26.6 | Filtro "Sorteio hoje" em bolões | Mega/Sorte | Média | Baixo |
| 26.7 | Destaque Instantâneas na home | Sorte Online | Baixa | Baixo |
| 26.8 | Segunda via de boleto | UX | Baixa | Médio |
| 26.9 | Teimosinha: comprar mais concursos | ideias-melhorias | Baixa | Alto |
| 26.10 | Modo alto contraste (acessibilidade) | WCAG | Baixa | Baixo |

---

## 8. Fase 31 — Ideias Novas (pós-Fase 30) — Resumo

Detalhes em `docs/plano-acao-v2-completo.md` § Fase 31.

| # | Item | Inspiração | Prioridade | Esforço |
|---|------|------------|------------|---------|
| 31.1 | Admin Campanhas: enviar campanha (e-mail) | v1 CampanhaController | Média | Médio |
| 31.2 | Admin: excluir cliente | v1 GerenciarClientesController | Baixa | Médio |
| 31.3 | Admin: enviar bônus em lote | v1 GerenciarClientesController | Baixa | Médio |
| 31.4 | Admin: clientes loteria online | v1 GerenciarClientesController | Baixa | Baixo |
| 31.5 | Admin: enviar spam / spam acumulada | v1 GerenciarClientesController | Baixa | Alto |
| 31.6 | Boletim diário / newsletter resultados | Mega Loterias | Média | Médio |
| 31.7 | Conferência: extrair serviços por sigla | ideias-melhorias.md §4 | Baixa | Alto |
| 31.8 | Cache Redis para sessões | ideias-melhorias.md §11 | Baixa | Médio |
| 31.B1 | Teimosinha estender | v1, ideias-melhorias | Baixa | Alto | Backlog |
| 31.B2 | Doctor 100% v2 | v1 Doctor/* | Baixa | Muito alto | Backlog |

---

## 9. Referências rápidas

| Documento | Conteúdo |
|----------|----------|
| docs/plano-acao-v2-completo.md | Plano completo, fases 0–31, comparativos |
| docs/plano-acao-v2-completo.md § Fase 31 | Ideias novas pós-Fase 30 (gaps v1→v2, inspiração Mega/Sorte) |
| docs/loterias/ideias-melhorias.md | Ideias gerais UX, SEO, segurança |
| .cursor/rules/v2-padroes-desenvolvimento.mdc | Padrões v2 |
| .cursor/rules/plataforma-loterias-padroes.mdc | Padrões loterias |
| docs/referencias/mega-loterias-layout.md | Layout referência |