De uma coleção de jogos para um produto
O PuzzleHub nasce para reunir puzzles de lógica, números, caminhos, sombreamento e estratégia num único lugar. A ambição não é encher uma página com links. Queremos que descobrir um jogo, aprender as regras, iniciar uma partida, guardar o progresso e consultar resultados seja natural, independentemente do puzzle escolhido.
Isto muda completamente o problema técnico. Cada jogo tem regras e representações próprias, mas à volta de todos reaparecem necessidades comuns: navegação, controlos, dificuldade, tamanho da grelha, nova partida, ajuda, estatísticas, acessibilidade e adaptação ao telemóvel.
Uma base deliberadamente simples
A primeira arquitetura assenta em HTML, CSS e JavaScript estáticos, geração através de scripts e distribuição com Firebase Hosting. O GitHub continua a ser o centro do código, das revisões e da automação. É uma base pouco vistosa, mas rápida, económica de servir e simples de inspecionar.
Desde o início documentamos o objetivo, a arquitetura e as convenções do repositório. A intenção é importante: a IA pode acelerar enormemente o desenvolvimento, mas apenas se os agentes receberem limites, contexto e critérios de qualidade claros.
O catálogo será um problema de design
Sabemos que o número de jogos vai crescer rapidamente. Por isso, o catálogo não pode depender de uma lista escrita à mão nem de uma página inicial pensada para dez elementos. Os metadados de cada jogo vivem separados da interface para podermos gerar páginas, categorias e navegação de forma sistemática.
Construir em público também significa mostrar o processo
Este Journal não será apenas um changelog. Vamos contar decisões técnicas, experiências falhadas, algoritmos de geração, ferramentas de IA, automação, design, desempenho e como a nossa forma de trabalhar muda à medida que o projeto cresce.
A primeira versão do PuzzleHub não pretende ser o destino final. É a grelha onde vamos jogar a nossa própria partida de desenvolvimento.