Roadmap e docs de design¶
O tempestweb está em construção inicial 🚧, com um conjunto de documentos de design vivos versionados junto ao código. Esta página é o índice deles — ela linka os originais no GitHub, que são a fonte da verdade.
Por que estes docs vivem no repositório
Eles usam links relativos para o código e para as fixtures, e mudam a cada fase. Mantê-los no repositório (e não rebuildados aqui) garante que estão sempre sincronizados com o que foi implementado.
Os documentos¶
-
O design completo: a ideia de "uma árvore, múltiplos renderizadores", os dois modos, e os trilhos N (capacidades), O (observabilidade) e P (PWA).
-
A ordem das fases com "feito quando" testável em cada uma.
-
O wire format Python↔cliente, pinado por golden fixtures. O resumo didático está em Contrato de fronteira.
-
O documento canônico das camadas. A visão geral didática está em Arquitetura.
O que vem por aí¶
Os grandes blocos de trabalho, todos compartilhados pelos dois modos:
| Trilho | Tema | Páginas aqui |
|---|---|---|
| N | Capacidades native/ (Web APIs tipadas) |
Capacidades |
| O | Observabilidade / produção (adapter pattern) | Observabilidade |
| P | PWA / offline-first / WebPush | PWA e offline |
| B5 | Transporte SSE (alternativa ao WebSocket) | Contrato de fronteira |
A documentação acompanha o código
Conforme cada trilho entrega fases, as páginas correspondentes aqui saem de "em construção" para exemplos completos e testados. O roadmap é o lugar para acompanhar o "feito quando" de cada fase.
Recap¶
- Os docs de design são vivos e vivem no repositório (fonte da verdade).
- Esta documentação linka os originais e oferece resumos didáticos das partes estáveis.
- Os trilhos N/O/P têm páginas dedicadas aqui, atualizadas conforme entregam.
Quer começar a usar? Vá para a Instalação e faça o Tutorial. 🚀