Bootstrap EDEN: Fase 0 (arquitetura) e Fase 1 (monorepo + infra)
Fase 0 — descoberta e arquitetura:
- Inventário do projeto, glossário de domínio, arquitetura com bounded
contexts e topologia de containers, threat model inicial.
- 12 ADRs cobrindo modular monolith, topologia de containers (Postgres
isolado + eden-core/parceiros/assinante em containers e portas
distintos), auth/sessões, modelo de permissões, criptografia/segredos,
contrato first-class, stock ledger, separação billing/finance/fiscal,
outbox transacional, adapters SaperX e Focus NFe, e identidade
compartilhada entre as 3 apps.
- 14 subagentes e 7 skills especializados por domínio em .claude/.
- Hooks de segurança (PreToolUse/PostToolUse/Stop) testados via pipe.
Fase 1 — plataforma (em andamento):
- Monorepo pnpm workspaces + Turborepo: apps/{api,worker,core-web,
reseller-web,subscriber-web} + 9 packages compartilhados.
- apps/api: NestJS mínimo com /health/live e /health/ready (checando
Postgres real via @eden/database).
- 3 frontends Vite + React + TypeScript + Tailwind, com o favicon
oficial do EDEN.
- packages/database: migration baseline (node-pg-migrate) criando
roles/role_permissions/applications/users/user_applications/sessions/
audit_log — audit log append-only com hash-chain, testado ao vivo
(UPDATE/DELETE bloqueados pelo trigger).
- compose.yaml implementando a topologia da ADR-0002, validada de ponta
a ponta: os 6 containers sobem e ficam saudáveis com um único
`docker compose up`.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
63
.env.example
Normal file
63
.env.example
Normal file
@@ -0,0 +1,63 @@
|
||||
# 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
|
||||
|
||||
# --- 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=
|
||||
Reference in New Issue
Block a user