rckrdmrd
50a821a415
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Actualizaciones de configuracion Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
122 lines
3.1 KiB
Markdown
122 lines
3.1 KiB
Markdown
# Template SaaS Multi-Tenant
|
|
|
|
**Version:** 1.0.0
|
|
**Estado:** Completado - DDL 100%, Backend 100%, Frontend 100%
|
|
**Tipo:** STANDALONE
|
|
**Sistema:** SIMCO + NEXUS v4.0
|
|
|
|
---
|
|
|
|
## Descripcion
|
|
|
|
Template base para desarrollo de plataformas SaaS multi-tenant con arquitectura moderna, siguiendo los estandares definidos en el workspace NEXUS.
|
|
|
|
Este proyecto sirve como punto de partida para cualquier aplicacion SaaS que requiera:
|
|
- Multi-tenancy con aislamiento de datos (RLS)
|
|
- Sistema de suscripciones y pagos (Stripe)
|
|
- Tres portales: Usuario Final, Admin de Tenant, Superadmin
|
|
- Integracion con LLMs (agnóstico al proveedor)
|
|
- RBAC (Role-Based Access Control)
|
|
|
|
---
|
|
|
|
## Stack Tecnologico
|
|
|
|
| Capa | Tecnologia |
|
|
|------|------------|
|
|
| Backend | Node.js 20+ / Express.js / TypeScript 5.3+ |
|
|
| Frontend | React 18+ / Vite 5+ / TypeScript / Tailwind CSS 4 |
|
|
| Database | PostgreSQL 16+ con RLS |
|
|
| State | Zustand |
|
|
| Pagos | Stripe |
|
|
| IA | Claude / OpenAI / Gemini (wrapper agnóstico) |
|
|
|
|
---
|
|
|
|
## Modulos Core
|
|
|
|
| Modulo | Codigo | Descripcion |
|
|
|--------|--------|-------------|
|
|
| Auth | SAAS-001 | Autenticacion JWT (OAuth, MFA planificados) |
|
|
| Tenants | SAAS-002 | Gestion de organizaciones multi-tenant |
|
|
| Users | SAAS-003 | Usuarios con RBAC |
|
|
| Billing | SAAS-004 | Suscripciones Stripe |
|
|
| Plans | SAAS-005 | Planes y limites |
|
|
| AI Integration | SAAS-006 | Wrapper multi-proveedor LLM (Claude, GPT-4, Gemini) |
|
|
| Notifications | SAAS-007 | Email, push, in-app, WhatsApp |
|
|
| Audit Logs | SAAS-008 | Auditoria de acciones |
|
|
| Feature Flags | SAAS-009 | Toggles por plan/tenant |
|
|
| Webhooks | SAAS-010 | Webhooks outbound con BullMQ |
|
|
| Storage | SAAS-011 | S3, R2, MinIO |
|
|
| CRUD Base | SAAS-012 | Patrones base reutilizables |
|
|
| Email | SAAS-013 | SendGrid, SES, SMTP |
|
|
| WhatsApp | SAAS-014 | WhatsApp Business API |
|
|
|
|
---
|
|
|
|
## Estructura del Proyecto
|
|
|
|
```
|
|
template-saas/
|
|
├── apps/
|
|
│ ├── database/
|
|
│ │ ├── ddl/schemas/
|
|
│ │ ├── seeds/
|
|
│ │ └── scripts/
|
|
│ ├── backend/src/
|
|
│ │ ├── modules/
|
|
│ │ └── shared/
|
|
│ └── frontend/src/
|
|
│ ├── portals/
|
|
│ ├── shared/
|
|
│ └── stores/
|
|
├── docs/
|
|
│ ├── 00-vision-general/
|
|
│ ├── 01-modulos/
|
|
│ ├── 02-integraciones/
|
|
│ └── architecture/adr/
|
|
└── orchestration/
|
|
├── 00-guidelines/
|
|
├── inventarios/
|
|
├── planes/
|
|
├── _archivo/
|
|
└── trazas/
|
|
```
|
|
|
|
---
|
|
|
|
## Inicio Rapido
|
|
|
|
```bash
|
|
# Database
|
|
cd apps/database && ./scripts/drop-and-recreate-database.sh
|
|
|
|
# Backend
|
|
cd apps/backend && npm install && npm run start:dev
|
|
|
|
# Frontend
|
|
cd apps/frontend && npm install && npm run dev
|
|
```
|
|
|
|
---
|
|
|
|
## Herencia SIMCO
|
|
|
|
Este proyecto hereda directivas de:
|
|
- `core/orchestration/directivas/simco/`
|
|
- `shared/catalog/` (funcionalidades reutilizables)
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
- Vision: `docs/00-vision-general/VISION-TEMPLATE-SAAS.md`
|
|
- Arquitectura: `docs/00-vision-general/ARQUITECTURA-MULTI-TENANT.md`
|
|
- Contexto: `orchestration/00-guidelines/CONTEXTO-PROYECTO.md`
|
|
- Estado: `orchestration/PROJECT-STATUS.md`
|
|
|
|
---
|
|
|
|
**Creado:** 2026-01-07
|
|
**Sistema:** NEXUS v3.4 | SIMCO
|