Este diretório é o ponto de entrada da organização Aprincar. Ele explica como os repositórios se conectam, como executar o sistema localmente, como criar extensões e como participar do fluxo de revisão.
| Documento | Quando consultar |
|---|---|
| Começando | Primeira instalação e execução local |
| Projetos | Escolher o repositório correto |
| Arquitetura | Entender App, Hub, jogos e dados |
| Extensões | Criar, validar e publicar um jogo |
| Operação e release | CI, Pages, offline e troubleshooting |
| Contribuição | Branches, commits, PRs e revisão |
| Segurança | Reportar vulnerabilidades |
- O App é local-first: perfis, biblioteca, progresso e evidências permanecem no dispositivo.
- Jogos são extensões independentes; o App não importa código de
games/*. - A comunicação entre jogo e plataforma acontece pelo Game SDK e por
MessageChannel. - Jogos produzem evidências; somente o Progress Engine calcula estados de habilidade.
- Recompensas são separadas de mastery pedagógico.
- BNCC é um mapeamento opcional de Skill IDs, nunca uma dependência direta do jogo.
- Privacidade infantil, acessibilidade, segurança e revisão pedagógica são requisitos do produto.
Todos os repositórios públicos estão em github.com/aprincar. O site publicado está em aprincar.github.io/platform.