beetask/GEMINI.md

Diretrizes do Projeto BeeTask (GEMINI.md)

Este documento contém as instruções e regras mandatórias para desenvolvimento e manutenção no repositório bee-task-v3.

---

⚠️ Regras Mandatórias Pós-Edição de Código

Important

Sempre após a finalização de quaisquer alterações ou correções no código, é OBRIGATÓRIO:

1. Atualizar o container Docker correspondente (rebuild e restart imediato).
2. Realizar o git commit com mensagem clara e padronizada.
3. Executar o git push para o repositório remoto.

---

🔄 Fluxo Obrigatório Pós-Edição:

1. Validar as alterações:

   • Frontend: npm --prefix frontend exec -- tsc -b frontend
   • Backend: ./mvnw test (ou verificação de compilação)

2. 🐳 Atualizar o container Docker imediatamente:

   • Se alterou Frontend:

     docker compose build --no-cache frontend && docker compose up -d --no-deps frontend
     

   • Se alterou Backend:

     docker compose build --no-cache backend && docker compose up -d --no-deps backend
     

   • Se alterou Ambos:

     docker compose build --no-cache frontend backend && docker compose up -d --no-deps frontend backend
     

3. 📦 Versionamento Git (Commit & Push):

   git add <arquivos>
   git commit -m "feat/fix/refactor: descrição clara da alteração"
   git push origin <branch-atual>
   

---

🛠️ Padrões do Projeto

• Frontend: Vite + React 19 + TypeScript + Tailwind v4 + HeroUI.
  • Tipagem estrita validada com npm --prefix frontend exec -- tsc -b frontend.
• Backend: Quarkus 3.34 + Java 17 + Clean Architecture (Domain Entities -> Use Cases -> Interface Adapters -> Frameworks).