Document AURACS architecture, game design, security and roadmap

[AlexLimaTKZ]

Objetivo

Cria uma documentação completa e atualizada do AURACS, baseada no comportamento real da main, cobrindo produto, game design, arquitetura, Phaser, sandbox C#, progressão, segurança, persistência, testes, contribuição e roadmap.

O que foi adicionado

• índice central em docs/README.md;
• visão geral do produto e princípios pedagógicos;
• arquitetura React/Next + Phaser + Zustand + ASP.NET/Roslyn;
• Game Design Document (GDD);
• gameplay loop, regras de interação, combate e progressão;
• documentação da camada Phaser e geometria do mundo;
• especificação do subconjunto C# realmente suportado e do que ainda não é suportado;
• documentação do backend, limites e threat model;
• persistência local vs sessão C# temporária;
• estratégia de testes, CI e critérios de qualidade;
• guia completo de contribuição;
• roadmap separado entre implementado, próximo e futuro;
• CONTRIBUTING.md na raiz;
• README principal atualizado com Phaser 4, Capítulos 1 e 2 e links para toda a documentação;
• web/README.md atualizado para refletir a arquitetura atual.

Regras formalizadas

• backend continua sendo a fonte de verdade para validação pedagógica;
• Phaser representa o resultado, mas não aprova exercícios;
• novas construções C# devem entrar somente por allowlist e com testes;
• documentação deve mudar junto de alterações relevantes de arquitetura, segurança, capítulos e persistência;
• ideias futuras estão explicitamente separadas de funcionalidades já implementadas.

Escopo

Este PR altera apenas arquivos Markdown. Não modifica gameplay, backend, dependências ou configuração de runtime.

Validação final

• ✅ branch criada a partir da main atual e 0 commits atrás na comparação;
• ✅ estrutura de docs/ conferida após criação;
• ✅ links relativos do README apontam para arquivos presentes na branch;
• ✅ .NET restore;
• ✅ .NET build;
• ✅ testes xUnit;
• ✅ npm ci;
• ✅ audit das dependências de produção;
• ✅ testes unitários do frontend;
• ✅ ESLint;
• ✅ Next.js production build.

O PR permanece em draft apenas para revisão editorial antes do merge.