Índice das specs

As regras em vigor do Twelves, escritas para quem decide: o que o projeto faz, o que não faz, onde cada regra vive no código e o que a protege. A história de como se chegou aqui fica no diário de decisões; cada página liga-lhe pela data.

Uma página só passa a vigente depois de o Claude ler a função citada e carimbar o commit em que a verificou. Até lá diz em construção — e o site mostra-o.

Capítulos

#	capítulo	o que cobre	estado	dia do plano
1	objetivo	o que é o Twelves, o que NÃO faz (não aposta, não faz login), Fase 1 fechada, Fase 2	em construção	D2 — 09/11
2	dinheiro	banca, stake, stop-loss, tetos, mercados permitidos, só simples, freebets, casas e os seus limites	em construção	D2 — 09/11
3	cacador	o ciclo de 30 em 30 min, as fontes (Leon, Betano, Pinnacle, Betfair), as guardas, ✅/⚠️/🛑, o fecho, os créditos por liga, a feed velha, os 30 min do apito	em construção	D2 — 09/11
4	medicao	preço contra o fecho como métrica-mãe, denominador, unidade, intervalos por bootstrap, pré-registo, falsos positivos, o quadro das hipóteses, as leituras	em construção	D3 — 10/11
5	laboratorio	as hipóteses em vigor (a medir, na fila), o catálogo de regras, o programa «voz própria», os horizontes	em construção	D3 — 10/11
5b	reflexao	a auto-aprendizagem: a reflexão diária, os padrões do dia contra o fecho, os horizontes (semana, mês, trimestre, semestre, ano), como se guarda uma ideia com destino datado	em construção	D3 — 10/11
6	palpites-e-vozes	as pistas (Claude, Claude seguro, David, caçador, vozes de IA, mercados), a carteira fictícia, a régua de 10 €, os palpites diários, o duelo	em construção	D4 — 11/11
7	dados	os ficheiros e as colunas (apostas, caçador, carteira, palpites, diários, agenda, tarefas, reflexões), o que fica fora do git	em construção	D4 — 11/11
8	rotina	a manhã, a véspera e o ciclo; tarefas e agenda; as notificações e o que as cala; o relógio; os créditos; o mini-PC	em construção	D5 — 12/11
9	painel	as vistas e o que cada uma decide, o contrato dos números, as ações, a publicação e o acesso	em construção	D5 — 12/11
10	qualidade	o portão por nível de risco, o revisor, os hooks, as flags (nascem desligadas), o pós-mortem, o fim de sessão, as sessões em paralelo	em construção	D6 — 13/11
11	arquitetura	os módulos e o fluxo dos dados (com diagramas), as fronteiras (sem servidor, sem login), o que corre onde	em construção	D6 — 13/11
12	glossario	os termos sem siglas; «o que mudou», gerado do diário de decisões e dos commits com Spec:	em construção	D7 — 14/11

Como ler uma página

• A regra — o vigente, em poucas linhas, com os números do código.
• Requisitos de negócio — uma tabela: o que o sistema garante ou proíbe, a decisão que o criou, onde vive no código e o que o protege.
• Diagramas — o fluxo, a sequência do dia ou os estados, desenhados a partir do texto da própria página.
• Porquê — a decisão e a data.
• Onde está no código — a função e o módulo.
• O que a protege — a flag, o teste, o portão.
• O que NÃO faz — as fronteiras.
• Ligações — outras páginas e as hipóteses do laboratório.

O cabeçalho de cada página (fontes, decisões, flags, testes, verificação) é conferido por um teste a cada commit: uma fonte que deixa de existir ou uma flag sem página dona fazem o teste falhar.