Skip to main content

node-api

node-api es el control plane principal de Crimoo. Dueño del estado persistente, APIs del dashboard, APIs internas para el data plane, billing, CRM, GTM lifecycle, analytics y parte de Copilot.

Producción: core backend.

Stack​

  • Node.js, Express 5, TypeScript.
  • TypeORM y PostgreSQL.
  • ClickHouse.
  • Pub/Sub, Secret Manager y Compute APIs.
  • Google OAuth y JWT/cookies.
  • Stripe.
  • Gemini.

Archivos relevantes:

  • node-api/src/app.ts
  • node-api/src/application/routes
  • node-api/src/application/controllers
  • node-api/src/application/use-cases
  • node-api/src/core/entities
  • node-api/src/infrastructure

Responsabilidades​

  • Users, auth, Google OAuth, sessions y logout.
  • Workspaces y membresías.
  • GTMs, dominios, VMs, puertos, logs, health y custom loader.
  • Endpoints internos de fabric.
  • CRM contacts, fields, deals, webhooks.
  • Conversiones offline.
  • Analytics dashboards.
  • Billing con Stripe.
  • Rutas Copilot integradas.

Flujo técnico​

application maneja rutas/use cases y infrastructure implementa DB, externos, schedulers y cache.

Comandos​

cd node-api
npm install
npm run dev
npm run build
npm run test

Debug​

  • Si auth falla, revisa cookies, JWT y OAuth.
  • Si GTM create falla, revisa DB, fabric URL y lifecycle.
  • Si certificados fallan, revisa DNS, ACME, persistencia y reload del proxy.
  • Si billing falla, revisa webhooks e idempotencia.