Saltar al contenido principal

Manual Operatorio — Core OS (estado real)

Infraestructura y operación del kernel SaaSCol Core tras el cierre Core+CMS (2026-08).

1. Topología​

graph TD
    EDGE[Traefik · API Gateway]
    EDGE -->|api.saascol.localhost| BACK[Backend Go UAP :3001]
    EDGE -->|docs.saascol.localhost| DOCS[Docusaurus]
    EDGE -->|storage| MINIO[MinIO bucket saascol]
    BACK --> PG[(Postgres + pgvector)]
    BACK --> REDIS[(Redis Event Bus)]
    BACK --> MINIO
    CMS[CMS Engine :3002] --> BACK
    IAM[Keycloak] --> BACK

Backend canónico: Go (backend/). No desplegar el legado TypeScript.

Comandos​

cd saas-col-core
docker compose up -d
# API
cd backend && go run ./cmd/server   # :3001
# CMS
cd ../saas-col-cms && go run ./cmd/cms-engine  # :3002
# Docs
cd ../saas-col-core/docs-portal && npm start

2. Mediador de infra​

Un MinIO y un Redis de plataforma por entorno. Prefijos:

  • Objectos: tenants/{tenant}/products/{product}/…
  • Eventos: envelope con tenant_id + product
  • Caché: saascol:t:{tenant}:p:{product}:…

Detalle: Storage & Event Bus.

3. Observabilidad​

Jaeger está en compose; exportación OTel completa desde Go = parcial.
Traefik dashboard según docker-compose local.

4. Qué no afirmar aún​

  • ReBAC Zanzibar completo en producción
  • Billing Wompi cerrado (checkout + webhook + créditos)
  • Colbot ya migrado a storage/bus Core (solo guía)
  • CRM UI satélite (siguiente producto)

5. Checklist Core 100%​

Ver architecture/34-checklist-core-100.md en el repo (P0–P2 cerrados a nivel Core).

6. Kubernetes​

Ver Deploy Kubernetes — Compose sigue siendo el default diario; Helm valida el contrato multi-nodo.