Matheus (Handix)
eff515b70d
Leva grande, pedida como "pelo menos mais 20 etapas, use subagentes":
fecha a pendência de MFA/TOTP da Fase 1 (feito diretamente, autenticação é
sensível demais para delegar) e lança 5 subagentes em paralelo em 2 ondas
(eden-inventory, eden-support, eden-hr-timeclock; depois eden-finance,
eden-fiscal, eden-frontend), cada um em worktree isolado, com integração
seletiva manual (barrel, app.module.ts, migrations renomeadas/aplicadas,
build/typecheck/teste ao vivo antes de cada merge).
## Backend
- MFA/TOTP (`apps/api/src/auth/mfa.service.ts`, `crypto/field-encryption.service.ts`):
login em duas etapas quando `mfa_enabled=true`, `FieldEncryptionService`
genérico (AES-256-GCM versionado, ADR-0005) reaproveitado por outros
segredos reversíveis (ex. credencial de equipamento Control iD).
- Inventory: warehouses, stock_movements (ledger append-only), serialized_assets,
asset_assignments, stock_reservations — invariante "serial/patrimônio/MAC
nunca duplicado entre ativos ativos" reforçada por índices únicos parciais
no banco (Master Prompt §15.3).
- Support/Service Desk: tickets com máquina de estados, SLA com pausa/retomada
em `waiting_customer`/`waiting_third_party` (funções puras testáveis).
- HR-Timeclock (fundação): dispositivos Control iD (senha cifrada), import de
AFD com parser + CRC-16/KERMIT, `afd_records` imutável sem exceção nem
para super_admin (sem válvula de escape, diferente de audit_log).
- Fiscal: NCM/CFOP/municípios/naturezas de operação (eden.md módulo 5, MVP de
5 das ~19 tabelas), product_fiscal_profiles com invariante de único
profile ativo por billing_component.
- Billing: subscription→billing_run→invoice idempotente (regenerar em draft
substitui, nunca duplica) e imutável após consolidar (ADR-0008: nunca
confunde faturamento/documento fiscal/recebimento).
- FKs cruzadas fechadas: quotes/client_registrations/contracts.
## Frontend — primeira leva
- `packages/ui`: Design System real extraído do tema DreamsERP comprado —
achado que mudou o escopo: o tema já vem em React+Tailwind (não só
Angular), tokens visuais reais portados (cores, Geist como fonte real,
divergindo da doc antiga que citava Nunito/Poppins).
- `apps/core-web`: login real (com suporte a MFA), sessão, shell autenticado
via `AppShell` — substitui a tela estática "Bootstrap da Fase 1".
## Bugs reais encontrados e corrigidos (todos via teste ao vivo, não leitura)
1. **Segurança**: o token de desafio MFA era aceito como access token normal
pelo `JwtAuthGuard` (mesma assinatura, nenhuma checagem da claim
`purpose`) — bypass total do segundo fator. Explorado e fechado ao vivo
contra o container real; teste de regressão em `test/mfa.spec.ts`.
2. Crase solta dentro de comentário SQL na migration de hr-timeclock quebrava
o template literal JS (`SyntaxError` ao rodar a migration).
3. CORS ausente por completo na API.
4. `turbo.json` não declarava `VITE_API_BASE_URL` como input de build — o
Turborepo cacheava o bundle do frontend ignorando mudança na env var.
5. `compose.yaml` usava `${VITE_API_BASE_URL:-/api/v1}`, que colidia com a
variável de mesmo nome do `.env` local — o default nunca era aplicado.
6. Não existia `.dockerignore` — todo build copiava node_modules/.git/
worktrees de subagentes (665MB) para dentro do contexto Docker.
Decisão do operador incorporada: a API nunca tem domínio público próprio
(só IP interno) — os 3 frontends chamam por caminho relativo `/api/v1`,
proxy externo roteia same-origin; CORS só é relevante para dev local.
Verificado: `pnpm turbo run typecheck build` (28/28), `pnpm --filter
@eden/api test` (30/30, cresceu de 15), todo o lote testado ao vivo via
curl contra os containers reais reconstruídos, incluindo os 6 bugs acima
já fechados e confirmados, e a trilha de auditoria conferida no Postgres.
Claude-Session: https://claude.ai/code/session_01BcWWuKfykGtUweXmHD6cKx
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
87 lines
3.5 KiB
Plaintext
87 lines
3.5 KiB
Plaintext
# EDEN — variáveis de ambiente (Fase 1 bootstrap)
|
|
# Copiar para `.env` e preencher com valores reais.
|
|
# Nunca commitar `.env` — já está no .gitignore.
|
|
|
|
# --- Banco de dados (Postgres 18, container eden-postgres) ---
|
|
EDEN_DATABASE_NAME=eden
|
|
EDEN_DATABASE_USER=eden
|
|
EDEN_DATABASE_PASSWORD=
|
|
# String de conexão completa, usada por packages/database e apps/api/apps/worker.
|
|
# Dentro do compose, o host é o nome do serviço (eden-postgres); fora, localhost
|
|
# na porta mapeada abaixo.
|
|
DATABASE_URL=postgres://eden:CHANGE_ME@localhost:55432/eden
|
|
|
|
# Porta do Postgres mapeada ao host SÓ em desenvolvimento (nunca em produção —
|
|
# ver docs/adr/0002-container-topology.md). Deixar em branco/comentar em prod.
|
|
EDEN_POSTGRES_DEV_PORT=55432
|
|
|
|
# --- Portas das aplicações (cada uma em container/porta distintos — ADR-0002) ---
|
|
EDEN_API_PORT=8080
|
|
EDEN_CORE_PORT=3001
|
|
EDEN_PARCEIROS_PORT=3002
|
|
EDEN_ASSINANTE_PORT=3003
|
|
|
|
# --- Frontend: URL base da API consumida pelo browser (Vite, build-time) ---
|
|
# Lida via import.meta.env.VITE_API_BASE_URL. Dev local (`pnpm dev`, fora de
|
|
# Docker): a API roda em localhost:8080, origem DIFERENTE da porta do Vite —
|
|
# precisa de URL absoluta + CORS (ver EDEN_CORS_ORIGINS abaixo). Copiar para
|
|
# o .env de cada app (apps/core-web/.env etc.) — Vite não lê o .env da raiz.
|
|
VITE_API_BASE_URL=http://localhost:8080/api/v1
|
|
|
|
# Build de produção via Docker (compose.yaml `VITE_API_BASE_URL` de build
|
|
# arg, default /api/v1): a API NÃO tem domínio público próprio (decisão do
|
|
# operador — só acessível por IP interno). O browser chama a API pelo MESMO
|
|
# domínio do frontend, caminho relativo /api/v1 — o proxy reverso na frente
|
|
# de cada um dos 3 domínios públicos precisa rotear internamente esse path
|
|
# para o container eden-api (rede interna, nunca exposto publicamente).
|
|
# Nesse fluxo (mesma origem) o navegador não faz preflight de CORS.
|
|
|
|
# --- CORS (origens de browser permitidas a chamar a API cross-origin) ---
|
|
# Só é relevante para dev local (core-web em localhost:3001+, API em
|
|
# localhost:8080 — origens diferentes). Nunca usar "*" — a API emite bearer
|
|
# token (ver packages/config/src/env-schema.ts). Os 3 domínios públicos NÃO
|
|
# entram aqui: eles chamam a API por caminho relativo via proxy (acima),
|
|
# nunca cross-origin diretamente na API.
|
|
EDEN_CORS_ORIGINS=http://localhost:3001,http://localhost:3002,http://localhost:3003
|
|
|
|
# --- Autenticação / sessão (ADR-0003) ---
|
|
# Gerar com: openssl rand -hex 48
|
|
JWT_SIGNING_SECRET=
|
|
# Segredo do servidor para HMAC de OTP (nunca reaproveitar o JWT secret) —
|
|
# gerar com: openssl rand -hex 32
|
|
SIGNATURE_OTP_SECRET=
|
|
|
|
# --- Criptografia de campo reversível (ADR-0005) ---
|
|
# Chave raiz para AES-256-GCM (segredos de integração, credenciais reversíveis).
|
|
# Gerar com: openssl rand -hex 32. Rotação é operação auditada — ver docs/security/threat-model.md.
|
|
EDEN_FIELD_ENCRYPTION_KEY=
|
|
|
|
# --- Bootstrap do primeiro superadmin (só usado se `users` estiver vazia) ---
|
|
EDEN_SUPERADMIN_EMAIL=
|
|
EDEN_SUPERADMIN_PASSWORD=
|
|
|
|
# --- SMTP (e-mail) ---
|
|
SMTP_HOST=
|
|
SMTP_PORT=465
|
|
SMTP_USER=
|
|
SMTP_PASS=
|
|
SMTP_FROM=
|
|
|
|
# --- S3 / storage de objetos (compatível MinIO ou AWS S3) ---
|
|
S3_ENDPOINT=
|
|
S3_REGION=us-east-1
|
|
S3_FORCE_PATH_STYLE=true
|
|
S3_ACCESS_KEY_ID=
|
|
S3_SECRET_ACCESS_KEY=
|
|
S3_BUCKET=
|
|
|
|
# --- URL pública base (usada para montar links absolutos em e-mails) ---
|
|
PUBLIC_BASE_URL=http://localhost:3001
|
|
|
|
# --- Integrações externas (preenchidas quando cada adapter for implementado) ---
|
|
FOCUS_NFE_API_TOKEN=
|
|
FOCUS_NFE_BASE_URL=
|
|
SAPERX_API_TOKEN=
|
|
SAPERX_BASE_URL=
|
|
CONTROLID_ENCRYPTION_KEY=
|