Introducción al Portal de Desarrolladores
SaaSCol Core es el kernel del ecosistema: IAM (Keycloak), API Gateway (Traefik), Event Bus (Redis), Storage (MinIO), UAP Low-Code (Go) y este portal.
Estado 2026-08: backend canónico = Go (
saas-col-core/backend, puerto3001). Core + CMS están cerrados para handoff a CRM. No usar el legado TypeScript/Fastify.
Qué documenta este manual
| Sección | Contenido |
|---|---|
| Notas de cierre Core+CMS | Qué se entregó y qué queda fuera |
| OpenAPI / rutas | Contratos HTTP vigentes |
| CMS Runtime & Admin | Public Site, Page Schema, import URL |
| Storage & Event Bus | Mediador Core · tenant × producto |
| Handoff CRM | Cómo el CRM debe integrarse |
| Handoff Marketplace | Satélite comercio + OpenAPI |
| Webhooks HMAC | X-SaaSCol-Signature |
| MCP | Protocolo agentes (roadmap / parcial) |
Auth
Authorization: Bearer <access_token>
- Producción: JWT Keycloak RS256 (JWKS) con claim
tenant_id. - Local/CI:
SAASCOL_TEST_API_KEY(defaultsaascol_test_token_samisalud) solo siAPP_ENV≠production. - Header de producto recomendado:
X-SaaSCol-Product: cms|bot|crm|…
Base URLs locales
| Servicio | URL |
|---|---|
| API Core | http://localhost:3001/api/v1 o http://api.saascol.localhost/api/v1 |
| CMS Engine + Runtime | http://localhost:3002 |
| Docs (este portal) | http://localhost:3000 / docs.saascol.localhost |
Principio de integración
Los productos satélite (CMS, Bot, CRM, ERP, Marketplace) se integran hacia Core. No hay hub horizontal (p. ej. Bot mediando MinIO del CMS).