# Loteca (LC) — Migração para v2

**Status:** Documentado; página /loteca "Em breve" e regra .cursor/rules/loterias/loteca.mdc criados. Implementação completa (volante + conferência) em backlog.

## Descrição

Loteca é uma loteria baseada em 14 jogos de futebol. Em cada jogo o apostador escolhe 1 (vitória do time 1), X (empate) ou 2 (vitória do time 2). O preço da aposta depende da quantidade de duplos e triplos (combinações que permitem mais de um resultado em um ou mais jogos). A Caixa ainda opera a Loteca em 2025.

## v1 (referência)

- **Controller:** `src/Loteria/Controller/LotecaController.php` — Action (página loteca), boloesAction (listagem bolões).
- **View:** `src/Loteria/View/Loteca/loteca.php` — tabela 14 jogos, colunas 1-X-2, duplos/triplos, valor.
- **Model/DAO:** `src/Core/Model/LotecaCoreMODEL.php`, `src/Core/Dao/LotecaCoreDAO.php` — n_triplos, n_duplos, preco, preco_caixa, custo.
- **Integração:** Formulário envia para `/boloes/add_bolao` com lotecaCombinacao; combinações com valor/custo por duplo/triplo.

## O que falta na v2 para implementação completa

1. **API**
   - GET /api/v2/loterias/LC (se loteria LC existir na tabela).
   - GET /api/v2/concursos?id_loteria=LC e GET /api/v2/boloes?id_loteria=LC (reutilizar se estrutura de concurso/bolão for compatível).
   - Cálculo de preço Loteca (duplos/triplos) — PrecoService ou endpoint específico.
   - Carrinho: payload para jogo LC (14 palpites + opção duplos/triplos); FinalizarService e ConferenciaService com condicional sigla LC.

2. **Frontend**
   - Página /loteca com volante: 14 jogos, cada um com 3 opções (1, X, 2). Dados dos jogos (times) podem vir da API ou configuração.
   - Seletor de duplos/triplos e preview de preço.
   - Adicionar ao carrinho; fluxo igual às outras loterias.

3. **Conferência**
   - Resultado oficial: placar de cada um dos 14 jogos → derivar 1, X ou 2 por jogo.
   - Comparar aposta do cliente com resultado; aplicar faixas de premiação Caixa (documentar em ConcursoController ou ConferenciaService com condicional LC).

4. **Regra**
   - .cursor/rules/loterias/loteca.mdc — criado; consultar ao implementar.

## Ordem sugerida de implementação

1. Garantir que a loteria LC existe na tabela `loteria` (migration se necessário).
2. PrecoService: método ou regra para preço Loteca (duplos/triplos).
3. Carrinho: aceitar payload LC (14 palpites + duplos/triplos); validar e persistir.
4. Frontend: componente LotecaSelector (14 linhas 1-X-2) e página /loteca completa.
5. Conferência: obter resultado oficial por concurso LC; função _conferirLoteca ou equivalente; integrar em ConcursoController/ConferenciaService.

## Referências

- Plano: docs/plano-acao-v2-completo.md § Fase 22.2
- Regra: .cursor/rules/loterias/loteca.mdc
- v1: src/Loteria/Controller/LotecaController.php, View/Loteca/loteca.php