Files
eden/compose.yaml
Matheus (Handix) eff515b70d feat(api,ui): MFA/TOTP, Inventory, Support, HR-Timeclock, Fiscal, Billing e Design System
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>
2026-09-03 17:25:31 -03:00

177 lines
5.9 KiB
YAML

# EDEN — topologia de containers (docs/adr/0002-container-topology.md)
#
# Postgres isolado, credencial de banco só no serviço eden-api. Cada uma das
# 3 aplicações web em container e porta próprios, falando só com a API via
# HTTP — nunca direto com o banco. Rodar a partir da raiz do repositório:
#
# docker compose --env-file .env up -d
#
name: eden
services:
eden-postgres:
image: postgres:18-alpine
container_name: eden-postgres
restart: unless-stopped
environment:
POSTGRES_DB: ${EDEN_DATABASE_NAME:-eden}
POSTGRES_USER: ${EDEN_DATABASE_USER:-eden}
POSTGRES_PASSWORD: ${EDEN_DATABASE_PASSWORD:?defina EDEN_DATABASE_PASSWORD no .env}
volumes:
# Postgres 18's official image switched to a pg_ctlcluster-style layout:
# mount the parent dir, not .../data — see
# https://github.com/docker-library/postgres/pull/1259
- eden_pgdata:/var/lib/postgresql
# Mapeado ao host só para acesso de ferramenta local em desenvolvimento,
# numa porta alta não-padrão — nunca 5432:5432, nunca exposto em produção
# (ver docs/adr/0002-container-topology.md). Remover este bloco em prod.
ports:
- "${EDEN_POSTGRES_DEV_PORT:-55432}:5432"
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${EDEN_DATABASE_USER:-eden} -d ${EDEN_DATABASE_NAME:-eden}"]
interval: 5s
timeout: 5s
retries: 10
networks: [eden_net]
eden-api:
build:
context: .
dockerfile: infra/docker/Dockerfile.node
args:
APP_NAME: api
container_name: eden-api
restart: unless-stopped
environment:
DATABASE_URL: postgres://${EDEN_DATABASE_USER:-eden}:${EDEN_DATABASE_PASSWORD}@eden-postgres:5432/${EDEN_DATABASE_NAME:-eden}
EDEN_API_PORT: ${EDEN_API_PORT:-8080}
JWT_SIGNING_SECRET: ${JWT_SIGNING_SECRET}
SIGNATURE_OTP_SECRET: ${SIGNATURE_OTP_SECRET}
EDEN_FIELD_ENCRYPTION_KEY: ${EDEN_FIELD_ENCRYPTION_KEY}
EDEN_SUPERADMIN_EMAIL: ${EDEN_SUPERADMIN_EMAIL}
EDEN_SUPERADMIN_PASSWORD: ${EDEN_SUPERADMIN_PASSWORD}
EDEN_CORS_ORIGINS: ${EDEN_CORS_ORIGINS}
SMTP_HOST: ${SMTP_HOST}
SMTP_PORT: ${SMTP_PORT}
SMTP_USER: ${SMTP_USER}
SMTP_PASS: ${SMTP_PASS}
SMTP_FROM: ${SMTP_FROM}
S3_ENDPOINT: ${S3_ENDPOINT}
S3_REGION: ${S3_REGION}
S3_FORCE_PATH_STYLE: ${S3_FORCE_PATH_STYLE}
S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID}
S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY}
S3_BUCKET: ${S3_BUCKET}
PUBLIC_BASE_URL: ${PUBLIC_BASE_URL}
ports:
- "${EDEN_API_PORT:-8080}:${EDEN_API_PORT:-8080}"
depends_on:
eden-postgres:
condition: service_healthy
healthcheck:
test: ["CMD-SHELL", "node -e \"fetch('http://localhost:'+ (process.env.EDEN_API_PORT||8080) +'/health/live').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))\""]
interval: 10s
timeout: 5s
retries: 10
networks: [eden_net]
eden-worker:
build:
context: .
dockerfile: infra/docker/Dockerfile.node
args:
APP_NAME: worker
container_name: eden-worker
restart: unless-stopped
environment:
DATABASE_URL: postgres://${EDEN_DATABASE_USER:-eden}:${EDEN_DATABASE_PASSWORD}@eden-postgres:5432/${EDEN_DATABASE_NAME:-eden}
depends_on:
eden-postgres:
condition: service_healthy
networks: [eden_net]
eden-core:
build:
context: .
dockerfile: infra/docker/Dockerfile.web
args:
APP_NAME: core-web
# Sempre relativo aqui (não ${VITE_API_BASE_URL} do .env — esse é
# para `pnpm dev` local fora do Docker, valor diferente e não deve
# vazar para este build arg). A API nunca tem domínio público
# próprio; o proxy externo roteia este path para eden-api na rede
# interna — ver comentário em .env.example.
VITE_API_BASE_URL: /api/v1
container_name: eden-core
restart: unless-stopped
ports:
- "${EDEN_CORE_PORT:-3001}:80"
depends_on:
eden-api:
condition: service_healthy
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1/healthz"]
interval: 10s
timeout: 5s
retries: 5
networks: [eden_net]
eden-parceiros:
build:
context: .
dockerfile: infra/docker/Dockerfile.web
args:
APP_NAME: reseller-web
# Sempre relativo aqui (não ${VITE_API_BASE_URL} do .env — esse é
# para `pnpm dev` local fora do Docker, valor diferente e não deve
# vazar para este build arg). A API nunca tem domínio público
# próprio; o proxy externo roteia este path para eden-api na rede
# interna — ver comentário em .env.example.
VITE_API_BASE_URL: /api/v1
container_name: eden-parceiros
restart: unless-stopped
ports:
- "${EDEN_PARCEIROS_PORT:-3002}:80"
depends_on:
eden-api:
condition: service_healthy
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1/healthz"]
interval: 10s
timeout: 5s
retries: 5
networks: [eden_net]
eden-assinante:
build:
context: .
dockerfile: infra/docker/Dockerfile.web
args:
APP_NAME: subscriber-web
# Sempre relativo aqui (não ${VITE_API_BASE_URL} do .env — esse é
# para `pnpm dev` local fora do Docker, valor diferente e não deve
# vazar para este build arg). A API nunca tem domínio público
# próprio; o proxy externo roteia este path para eden-api na rede
# interna — ver comentário em .env.example.
VITE_API_BASE_URL: /api/v1
container_name: eden-assinante
restart: unless-stopped
ports:
- "${EDEN_ASSINANTE_PORT:-3003}:80"
depends_on:
eden-api:
condition: service_healthy
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1/healthz"]
interval: 10s
timeout: 5s
retries: 5
networks: [eden_net]
networks:
eden_net:
driver: bridge
volumes:
eden_pgdata: