# PRD — Ciclo de vida do bolão

**Dono:** Igor · **Status:** rascunho · **Data:** 03/08/2026
**Origem:** Fase 1 do `bolao-usuario` (03/08/2026)

---

## 1. Problema

O bolão tem começo, meio e fim, e hoje só o meio é resolvido — mal. O que
dói nas pontas:

- **O bolão não acaba, ele apenas para.** Sem encerramento claro, fica a
  dúvida de quem foi campeão e a discussão morre sem conclusão. O admin
  precisa anunciar isso na mão, e às vezes não anuncia.
- **Mudar regra no meio é briga garantida.** O próprio admin disse: mexer
  na pontuação com o bolão andando gera briga. Mas às vezes é necessário —
  e hoje isso acontece por mensagem no grupo, sem registro de quando
  passou a valer.
- **Temporada nova é começar do zero.** Montar tudo de novo com a mesma
  galera e as mesmas regras é trabalho repetido — o mesmo trabalho que faz
  o admin desistir.
- **Bolão morto polui a lista.** Não há como arquivar o que acabou.
- **Sair do bolão vira problema pra todo mundo.** O casual não quer virar
  assunto no grupo por ter saído.
- **Campeão do ano passado é status**, e hoje não fica registrado em lugar
  nenhum.

## 2. Objetivo e métrica de sucesso

_Métricas propostas, a validar com o dono._

- **100% dos bolões terminam com campeão e ranking final registrados**, sem
  o admin precisar anunciar à mão.
- **Recriar o bolão da temporada seguinte** com a mesma galera e regras em
  poucos passos, sem remontar nada.
- **Zero mudança de regra sem registro** de quando passou a valer.

## 3. Personas afetadas

| Persona           | O que muda                                                                    |
| ----------------- | ----------------------------------------------------------------------------- |
| **Administrador** | Ganha encerramento automático, recriação da temporada e arquivamento          |
| **Casual**        | Consegue sair sem virar assunto, e vê o resultado final sem perguntar          |
| **Competitivo**   | Tem o histórico e o título registrados, e vê qualquer mudança de regra e a data |

**Onde as personas discordam, e quem ganha:**

- **Flexibilidade do admin × previsibilidade da competição.** O admin
  precisa poder corrigir uma regra mal escolhida; o competitivo não aceita
  regra mudando com o campeonato andando. **Ganhou o competitivo, com uma
  saída para o admin:** a regra de pontuação e desempate **não muda** depois
  do primeiro palpite. O que o admin pode fazer é **encerrar o bolão e abrir
  outro** com as regras novas. É mais trabalhoso de propósito — mudar as
  regras do jogo em andamento deve ser difícil.
- **Sair do bolão × integridade do ranking.** O casual quer sair sem
  atrito; o competitivo não quer que a saída de alguém mude a classificação
  de quem ficou. **Ganharam os dois:** quem sai para de palpitar e sai do
  ranking ativo, mas os jogos já apurados permanecem no histórico do bolão.

## 4. Escopo

- Encerramento do bolão ao fim das rodadas: campeão, ranking final,
  co-campeões em caso de empate persistente
- Encerramento antecipado pelo admin
- Bloqueio de mudança de pontuação e desempate depois do primeiro palpite
- Recriar o bolão para a temporada seguinte, herdando participantes e regras
- Arquivar bolão encerrado ou abandonado
- Sair do bolão por vontade própria
- Histórico de bolões anteriores e títulos do participante

## 5. Fora de escopo

- Palpite, prazo e sigilo → épico _Palpite e prazo_
- Cálculo de ponto, ranking e desempate → épico _Pontuação e ranking_
- Criação do primeiro bolão, convite e admins → épico _Criação e convite_
- Premiação e pagamento ao campeão → **sem dinheiro nesta versão**
  (ver `docs/prd/premiacao-e-cobranca.md`)
- Gráfico de evolução ao longo das temporadas
- Estatística pessoal histórica (média de acerto por ano)

## 6. Regras de domínio decididas

| Regra                          | Decisão                                                                                                                                                                                       | Status                    |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| Mudança de regra em andamento  | **Pontuação e desempate não mudam depois do primeiro palpite registrado.** Para jogar com regra nova, o admin encerra o bolão e abre outro                                                       | decidido                  |
| Encerramento                   | O bolão encerra quando a última rodada do escopo é apurada. **O encerramento só é definitivo quando não há placar pendente de correção** — senão o campeão pode mudar depois de anunciado         | decidido                  |
| Desempate no título            | Empate que persiste após todos os critérios resulta em **co-campeões**, sem desempate arbitrário. Ordem dos critérios vem do épico _Pontuação e ranking_                                          | decidido                  |
| Saída do participante          | Quem sai **para de palpitar e sai do ranking ativo**; os jogos já apurados permanecem no histórico do bolão. A saída não recalcula a pontuação de quem ficou                                      | decidido                  |
| Recriar temporada              | Novo bolão herda **participantes e regras** do anterior, mas **começa com pontuação zerada** e regras destraváveis até o primeiro palpite                                                        | proposta a validar — Igor  |
| Arquivamento                   | Bolão encerrado ou abandonado pode ser arquivado pelo admin. **Arquivado é somente leitura**: histórico e ranking final continuam consultáveis                                                    | proposta a validar — Igor  |
| Placar corrigido após apuração | Aplica-se aqui só como travamento do encerramento (linha "Encerramento"). O recálculo em si é decidido no épico _Pontuação e ranking_                                                            | decidido (parte de ciclo)  |
| Prazo do palpite               | não se aplica — épico _Palpite e prazo_                                                                                                                                                        | não se aplica             |
| Pontuação                      | não se aplica — épico _Pontuação e ranking_; aqui só se decide que ela não muda em andamento                                                                                                    | não se aplica             |
| Sigilo dos palpites            | não se aplica — épico _Palpite e prazo_                                                                                                                                                        | não se aplica             |
| Jogo adiado / cancelado / W.O. | não se aplica — épicos _Palpite e prazo_ e _Pontuação e ranking_. **Consequência agravada:** como **não existe anulação** (todo jogo não realizado é adiado e aguarda), um único jogo nunca disputado mantém o bolão aberto para sempre. `CV-3` é a única saída | não se aplica             |
| Entrada no meio                | não se aplica — épicos _Criação e convite_ e _Pontuação e ranking_                                                                                                                              | não se aplica             |
| Palpite não enviado            | não se aplica — épico _Pontuação e ranking_                                                                                                                                                     | não se aplica             |
| Dinheiro                       | **não se aplica — sem dinheiro nesta versão** (decisão de 03/08/2026). Não há prêmio a pagar no encerramento                                                                                     | não se aplica             |

## 7. Fluxo principal

1. A última rodada é apurada e o bolão encerra sozinho.
2. Vejo o campeão e o ranking final — ou os co-campeões, se o empate
   persistiu.
3. `[ADMIN]` Arquivo o bolão, e ele sai da minha lista de bolões ativos sem
   desaparecer.
4. `[ADMIN]` Na temporada nova, recrio o bolão herdando a mesma galera e as
   mesmas regras, com pontuação zerada.
5. `[COMP]` Consulto os bolões anteriores e vejo onde terminei em cada um.

## 8. Requisitos não funcionais

- **Encerramento não pode ser prematuro.** Anunciar campeão e depois mudar
  por correção de placar é pior do que anunciar um dia mais tarde.
- **Bolão arquivado continua legível offline**, na medida do que já foi
  carregado — histórico é o que dá status ao competitivo.
- **Recriar temporada não pode reaproveitar palpite nem ponto** do bolão
  anterior; herdar dado antigo por engano corrompe a competição nova.

## 9. Riscos e dependências

- **Depende dos três outros épicos** para existir: sem palpite, ponto e
  bolão criado, não há ciclo de vida.
- **Jogo adiado sem nova data** pode deixar o bolão em estado indefinido:
  nem encerrado nem ativo. Precisa haver uma saída, mesmo que seja o admin
  encerrar antecipadamente.
- **Correção de placar depois do encerramento** é o pior cenário do
  produto: campeão anunciado e depois trocado. A regra de travamento
  mitiga, mas não elimina — a fonte oficial pode corrigir semanas depois.
- **Herdar participantes** na temporada nova assume que a lista anterior
  ainda faz sentido; gente que saiu do trabalho não deveria ser
  reconvidada automaticamente sem o admin revisar.

## 10. Perguntas abertas

| Pergunta                                                                            | Dono | Prazo      |
| ----------------------------------------------------------------------------------- | ---- | ---------- |
_Nenhuma pergunta aberta neste épico._

**Respondidas em 03/08/2026:**

- **Correção de placar após o encerramento: troca o campeão.** O ranking
  final **não é congelado** — correção oficial recalcula e pode trocar quem
  ganhou, mesmo depois de anunciado. Consequência: título registrado no
  histórico (CV-5) pode ser revogado, e o encerramento nunca é definitivo.
- **Jogo adiado sem nova data: o bolão não encerra, aguarda** até o jogo
  acontecer, e então corrige a pontuação. Consequência: **bolão pode ficar
  aberto indefinidamente** se o jogo nunca for realizado — o encerramento
  antecipado (CV-3) é a única saída.
- **Quem sai não volta: a saída é definitiva.** _(Revisado no mesmo dia — a
  resposta anterior era "recupera os pontos pela mesma conta"; a decisão de
  não permitir entrada atrasada tornou a reentrada incoerente, e a escolha
  final foi tornar a saída definitiva.)_ Consequência: `FE-1` de CV-4 precisa
  avisar que não há volta **antes** de confirmar a saída.
- **Não é possível entrar atrasado.** A entrada no bolão fecha quando o
  primeiro jogo começa. Isso elimina a regra de "entrada no meio" dos épicos
  _Pontuação_ e _Palpite_, e **cancela a story `PR-9`**.
- **Encerramento antecipado abusivo: sem tratamento.** Decisão consciente.
  ⚠️ Combinado com a correção manual de placar pelo admin, um admin que está
  perdendo tem caminho aberto para alterar o resultado do bolão. A única
  mitigação prevista é a visibilidade da intervenção manual a todos.

## 11. Stories derivadas

Os Given/When/Then vivem no cartão de cada story (`docs/stories/`), não aqui.

- [ ] `CV-1` Encerrar o bolão ao apurar a última rodada, com campeão e ranking final
- [ ] `CV-2` Tratar co-campeões quando o empate persiste após todos os critérios
- [ ] `CC-3` Bloquear mudança de pontuação e desempate após o primeiro palpite —
  **implementado pela story `CC-3`**, que consolidou esta entrada com a
  equivalente do épico _Criação e convite_. Não existe story `CV-` para isto.
- [ ] `CV-3` Encerramento antecipado pelo admin
- [ ] `CV-4` Sair do bolão por vontade própria
- [ ] `CV-6` Arquivar bolão encerrado ou abandonado
- [ ] `CV-7` Recriar o bolão para a temporada seguinte herdando galera e regras
- [ ] `CV-5` Histórico de bolões anteriores e títulos do participante

---

## Bloqueios

**Quatro decisões estão fechadas** (regra não muda em andamento,
encerramento espera correção pendente, co-campeões, saída não recalcula
ranking) — dá para escrever as stories de encerramento, travamento de regra
e saída.

**Duas stories estão bloqueadas:** "recriar temporada" depende de decidir se
reconvida todos automaticamente, e "arquivar bolão" depende de saber se o
arquivamento é reversível.

**Uma pergunta aberta é mais grave que as outras:** correção de placar
_depois_ do encerramento. Se a resposta for "troca o campeão", isso vira
requisito do épico _Pontuação e ranking_ também, não só deste — e é a única
pergunta em aberto que pode obrigar a mexer em PRD já escrito.
