Evolução arquitetural
Pimbas
Construí uma plataforma para organizar partidas e torneios de pimbolim e migrei a aplicação de Fastify para Next.js.
Restrição principal
Preservar contratos durante a migração.
Decisão central
Migrei a camada HTTP para Next.js para reduzir a configuração e os serviços de deploy.
Fluxo do projeto
API e interface em aplicações separadas.
Fronteira HTTP consolidada na aplicação.
Partidas, ranking e torneios
Autorização e dados delimitados por grupo.Contexto
Construí o Pimbas para pessoas conhecidas que jogam pimbolim e precisavam organizar partidas amistosas e torneios. Migrei a aplicação de Fastify para Next.js, mantendo as regras de partidas, ranking e torneios separadas da camada web.
Forças e restrições
- Preservar contratos durante a migração.
- Isolar dados e permissões por grupo.
- Manter as regras de partidas e torneios independentes do framework.
Decisões
Consolidar o runtime
Migrei a camada HTTP para Next.js para reduzir a configuração e os serviços de deploy.
Proteger o domínio
Separei as regras de partidas, ranking e torneios da camada web.
Tratar acesso como fronteira
Separei autenticação, autorização e pertencimento ao grupo.
Atributos de qualidade
Modificabilidade
Domínio separado da entrega web.
EvidênciaEstrutura e testes versionados no repositório.
Operabilidade
Menos runtimes para configurar e observar.
EvidênciaMigração Fastify → Next.js documentada como decisão.
Segurança
Autorização e isolamento por grupo nas bordas.
EvidênciaContratos e verificações no código.
Evidências
Código-fonte
Implementação pública e histórico de migração.
Limites conhecidos
- O projeto não teve adoção porque faltou tempo para continuar sua manutenção.
- A licença ainda precisa ser confirmada no repositório de origem.
- Ainda preciso confirmar lint, tipos, testes, build e divergências de contrato no repositório.
- A referência main é móvel. Falta concluir a auditoria e fixar o commit-fonte.
Contato
Vamos conversar