docs: add mandatory docker container update rule to GEMINI.md

This commit is contained in:
Gabriel Menezes 2026-10-22 10:02:04 -04:00
parent cec8a1f818
commit 93c06cdad8

View file

@ -4,44 +4,47 @@ Este documento contém as instruções e regras mandatórias para desenvolviment
---
## ⚠️ Regra Mandatória: Commit e Push ao Finalizar Edições
## ⚠️ Regras Mandatórias Pós-Edição de Código
> [!IMPORTANT]
> **Sempre após a finalização de quaisquer edições ou correções no código, é OBRIGATÓRIO realizar o `git commit` com uma mensagem clara e padronizada e em seguida executar o `git push` para o repositório remoto.**
### Fluxo Obrigatório pós-edição:
1. Validar as alterações (testes/build, ex: `tsc -b` ou `./mvnw test` se aplicável).
2. Adicionar os arquivos alterados:
```bash
git add <arquivos>
```
3. Fazer o commit semântico:
```bash
git commit -m "feat/fix/refactor: descrição clara da alteração"
```
4. Fazer o push imediatamente:
```bash
git push origin <branch-atual>
```
> **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.
---
## 🐳 Atualização de Ambiente Docker
### 🔄 Fluxo Obrigatório Pós-Edição:
Caso as alterações envolvam o frontend ou backend que rodam via Docker Compose em produção/staging:
- **Frontend**:
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**:
```bash
docker compose build --no-cache frontend && docker compose up -d --no-deps frontend
```
- **Backend**:
- Se alterou **Backend**:
```bash
docker compose build --no-cache backend && docker compose up -d --no-deps backend
```
- Se alterou **Ambos**:
```bash
docker compose build --no-cache frontend backend && docker compose up -d --no-deps frontend backend
```
3. **📦 Versionamento Git (Commit & Push)**:
```bash
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.
- Verificar tipagem estrita com `npm --prefix frontend exec -- tsc -b`.
- 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).