feat: add full project - backend, frontend, docker, specs and configs

.specify/features/002-docker-setup/plan.md

@@ -0,0 +1,114 @@
+# Implementation Plan: Docker Setup
+
+**Branch**: `002-docker-setup`
+**Spec**: `.specify/features/002-docker-setup/spec.md`
+**Created**: 2026-04-13
+
+## Constitution Check
+- ✅ Design-First: não se aplica (infra)
+- ✅ Separation of Concerns: Flask e React permanecem desacoplados, Docker apenas orquestra
+- ✅ Spec-Driven: este plano deriva da spec aprovada
+- ✅ Security: nenhuma secret hardcoded; `.env` no gitignore
+- ✅ Simplicity: sem multi-stage build, sem nginx — foco em dev environment
+
+---
+
+## Phase 1 — Backend Dockerfile
+
+**Objetivo**: Containerizar o Flask app usando python:3.12-slim e uv.
+
+**Arquivos**:
+- `backend/Dockerfile`
+
+**Detalhes**:
+- Base: `python:3.12-slim`
+- Instalar `uv` via pip
+- Copiar `pyproject.toml` → `uv sync` → copiar código
+- Entrypoint: script shell que executa `flask db upgrade && python seeds/seed.py && python run.py`
+- Porta exposta: 5000
+
+**Critério de conclusão**: `docker build -t backend ./backend` conclui sem erro.
+
+---
+
+## Phase 2 — Frontend Dockerfile
+
+**Objetivo**: Containerizar o servidor de desenvolvimento Vite com hot-reload.
+
+**Arquivos**:
+- `frontend/Dockerfile`
+
+**Detalhes**:
+- Base: `node:20-alpine`
+- Copiar `package*.json` → `npm ci` → copiar código
+- CMD: `npm run dev -- --host 0.0.0.0` (necessário para expor dentro do container)
+- Porta exposta: 5173
+- O `vite.config.ts` já tem proxy `/api → http://localhost:5000`; atualizar para `http://backend:5000` (nome do serviço Docker)
+
+**Critério de conclusão**: `docker build -t frontend ./frontend` conclui sem erro.
+
+---
+
+## Phase 3 — docker-compose.yml
+
+**Objetivo**: Orquestrar db + backend + frontend com dependências e healthchecks.
+
+**Arquivos**:
+- `docker-compose.yml` (raiz)
+- `.env.example` (atualizar/criar na raiz)
+
+**Serviços**:
+```yaml
+db:
+  image: postgres:16-alpine
+  healthcheck: pg_isready -U ${POSTGRES_USER}
+  depends_on: (nenhum)
+
+backend:
+  build: ./backend
+  depends_on:
+    db: { condition: service_healthy }
+  environment:
+    DATABASE_URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}
+
+frontend:
+  build: ./frontend
+  depends_on: [backend]
+  volumes:
+    - ./frontend/src:/app/src        ← hot-reload
+    - ./frontend/public:/app/public
+```
+
+**Critério de conclusão**: `docker-compose config` valida sem erro; `docker-compose up` sobe os 3 serviços.
+
+---
+
+## Phase 4 — start.ps1
+
+**Objetivo**: Script PowerShell de conveniência na raiz.
+
+**Arquivos**:
+- `start.ps1` (raiz)
+
+**Lógica**:
+1. Verificar se `docker` está disponível no PATH
+2. Se não: exibir mensagem com link para Docker Desktop e sair
+3. Se sim: executar `docker-compose up --build`
+
+**Critério de conclusão**: `.\start.ps1` inicia o ambiente ou exibe erro informativo.
+
+---
+
+## Sequência de execução
+
+```
+Phase 1 (backend/Dockerfile)
+  ↓
+Phase 2 (frontend/Dockerfile + vite.config proxy update)
+  ↓
+Phase 3 (docker-compose.yml + .env.example)
+  ↓
+Phase 4 (start.ps1)
+  ↓
+Validação: docker-compose up --build → testar endpoints
+```