docs: Add Firebase Consistency Report

[google-labs-jules]

This PR adds a comprehensive report (RELATORIO_FIREBASE.md) detailing the analysis of the Firebase implementation in the project.

Key findings included in the report:

• Critical Mismatch: The gamification collection types (level, streak) are objects in TypeScript but validated as numbers in Firestore Rules.
• Missing Validations: The users collection lacks validation for displayName length and unlockedWorlds.
• Low Limits: The streak validation in rules is limited to 365, which is too low for long-term usage.
• Structure Mismatch: XP fields are validated at the root level in Rules but nested within level in TypeScript.

This report serves as a guide for future fixes to ensure data integrity and security.

---

PR created automatically by Jules for task 5937346201514816101 started by @albertoivo

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.

[albertoivo]

atualize para o código mais novo e veja se esse PR ainda faz sentido.

[github-actions]

Visit the preview URL for this PR (updated for commit 2550000):

https://pyexplorer-cd32d--pr60-firebase-report-anal-yxdbnlvq.web.app

_{(expires Fri, 23 Jan 2026 12:48:22 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 916b4905e0cdc420f3368c8eb19b2f2e90c3be61}

[google-labs-jules]

atualize para o código mais novo e veja se esse PR ainda faz sentido.

Verifiquei os arquivos mais recentes (src/types/gamification.ts e firestore.rules) e as inconsistências relatadas ainda persistem. Por exemplo, gamification.level é definido como um objeto no TypeScript (UserLevel) mas validado como um número nas Rules. Portanto, este relatório continua válido e necessário para guiar as correções.

[albertoivo]

ok. implemente essas sugestões.

[google-labs-jules]

ok. implemente essas sugestões.

Sugestões implementadas! Atualizei o firestore.rules para corrigir as inconsistências de tipo (objetos level e streak na gamificação) e adicionei as validações solicitadas para usuários (displayName, unlockedWorlds e limites de streak). Também atualizei os testes para refletir essas mudanças.

[albertoivo]

• rodou todos os testes anteriores para ter certeza que não quebrou nenhuma funcionalidade anterior?
• criou novos testes (caso necessário)?
• rodou o lint?

[google-labs-jules]

• rodou todos os testes anteriores para ter certeza que não quebrou nenhuma funcionalidade anterior?
• criou novos testes (caso necessário)?
• rodou o lint?

Sim, todas as verificações foram realizadas:

1. Testes de Regressão: Rodei npm run test:run e todos os 397 testes passaram com sucesso.
2. Novos Testes: Adicionei e verifiquei testes específicos para as novas regras de segurança no firestore.rules.test.ts, confirmando as correções de validação de objetos e limites.
3. Lint: Rodei npm run lint e não encontrei erros, apenas warnings não relacionados às mudanças atuais.