Quickstart y comandos

Quickstart (entorno local)

git clone https://github.com/bongga-dev/platform.git
cd platform

./platform/setup-dev.sh   # setup inicial (una vez)
make up                   # levanta el stack de desarrollo (Podman/Docker)
make migrate              # aplica migraciones SQL
make health-gate          # verifica salud de los servicios

URLs locales

Servicio	URL
api-gateway	http://localhost:8080
flow-engine	http://localhost:8081
ai-service	http://localhost:8000
dashboard-ui	http://localhost:3000
control-plane	http://localhost:9000
Tenants (Traefik)	http://{slug}.localhost:8085
RabbitMQ UI	http://localhost:15672
Grafana	http://localhost:3001

Comandos esenciales

make up / make down        # levantar / bajar el stack
make build                 # compilar todas las apps
make migrate / make seed   # migraciones / datos semilla
make test                  # tests de todas las apps
make test-integration      # integración (testcontainers + pgvector)
make coverage              # cobertura por app
make lint                  # golangci-lint + ruff + eslint
make clean                 # limpiar artefactos

Reglas (resumen)

La fuente de verdad es CLAUDE.md en la raíz. Lo esencial:

• Clean Architecture + SOLID en cada app Go/Python.
• ≤ 500 LOC por archivo (CI falla si se supera).
• ≥ 80% de cobertura por app.
• TDD: no se escribe código sin test previo o simultáneo.
• Naming: snake_case (JSON/DB/archivos), smallCamelCase (vars/funcs), PascalCase (tipos), SCREAMING_SNAKE_CASE (constantes/env).
• Atomic Design en la UI.

Contribuir

1. Lee CLAUDE.md (contiene todas las reglas).
2. Rama: git checkout -b feat/tu-feature — nunca push directo a main (protegido).
3. Conventional Commits, tests verdes, actualiza CHANGELOG.md.
4. ADR para cada cambio arquitectónico.
5. Abre PR — CI verifica automáticamente.