workspace-v1/projects/erp-core/docs/01-fase-foundation/MGN-004-tenants
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00
..
especificaciones feat: Workspace-v1 complete migration with NEXUS v3.4 2026-01-04 03:37:42 -06:00
historias-usuario feat: Workspace-v1 complete migration with NEXUS v3.4 2026-01-04 03:37:42 -06:00
implementacion feat: Workspace-v1 complete migration with NEXUS v3.4 2026-01-04 03:37:42 -06:00
requerimientos feat: Workspace-v1 complete migration with NEXUS v3.4 2026-01-04 03:37:42 -06:00
_MAP.md feat: Workspace-v1 complete migration with NEXUS v3.4 2026-01-04 03:37:42 -06:00
README.md feat: Workspace-v1 complete migration with NEXUS v3.4 2026-01-04 03:37:42 -06:00

MGN-004: Multi-tenant

Metadata

Campo Valor
ID MGN-004
Nombre Multi-tenant
Fase 01 - Foundation
Prioridad P0 (Critico)
Story Points 35 SP
Estado Documentado
Dependencias MGN-001, MGN-002, MGN-003

Descripcion

Sistema de multi-tenancy que permite que multiples organizaciones/empresas utilicen la misma instancia del ERP con completo aislamiento de datos.

Caracteristicas principales:

  • Aislamiento RLS: Row Level Security en PostgreSQL
  • Configuracion por tenant: Moneda, zona horaria, formato de fecha
  • Planes de suscripcion: Diferentes niveles de servicio
  • Limites por plan: Usuarios, almacenamiento, modulos
  • Onboarding automatizado: Creacion de tenant con datos iniciales

Arquitectura

Request
   │
   ▼
┌──────────────────────┐
│  TenantMiddleware    │  <- Extrae tenant_id del token JWT
└──────────┬───────────┘
           │
           ▼
┌──────────────────────┐
│  SET app.tenant_id   │  <- Establece contexto PostgreSQL
└──────────┬───────────┘
           │
           ▼
┌──────────────────────┐
│     RLS Policies     │  <- Filtra automaticamente
│   tenant_isolation   │     por tenant_id
└──────────────────────┘

Planes de Suscripcion

Plan Usuarios Almacenamiento Modulos
Free 3 1 GB Core
Starter 10 5 GB Core + Ventas
Professional 50 25 GB Todos
Enterprise Ilimitado Ilimitado Todos + Soporte

Endpoints API

Metodo Path Descripcion
GET /api/v1/tenants Listar tenants (super admin)
POST /api/v1/tenants Crear tenant
GET /api/v1/tenants/:id Obtener tenant
PATCH /api/v1/tenants/:id Actualizar tenant
GET /api/v1/tenants/current Tenant actual
GET /api/v1/tenants/current/settings Config del tenant
PATCH /api/v1/tenants/current/settings Actualizar config
GET /api/v1/plans Listar planes
POST /api/v1/subscriptions Crear suscripcion
GET /api/v1/subscriptions/current Suscripcion actual

Tablas de Base de Datos

Tabla Descripcion
tenants Organizaciones/empresas
tenant_settings Configuracion por tenant
plans Planes de suscripcion
subscriptions Suscripciones activas

Documentacion


Generado por: Requirements-Analyst Fecha: 2025-12-05