Template base para proyectos SaaS
c8b75d0435
Auditoría completa en 5 fases CAPVED (81 SP): Fase 1 - Inventario: - 22 módulos SAAS documentados (SAAS-001 a SAAS-022) - 11 ADRs, 7 integraciones, 5 especificaciones técnicas - 17 schemas DDL, 48 tablas, 72 RLS policies - 23 módulos backend, 71 entities, 41 controllers - 56 páginas frontend, 22 hooks Fase 2 - Coherencia: - DDL→Backend: 93% cobertura - Backend→Frontend: 58% cobertura (gaps críticos) - Trazabilidad RF/RNF: 97.3% Fase 3 - Plan Remediación: - 16 gaps identificados (4 P0, 4 P1, 4 P2, 4 P3) - P0: Audit, RBAC, Notifications sin frontend - 57 archivos obsoletos a purgar (620 KB) - Plan: 21 tareas, 39 SP en 3 sprints Outputs: - FASE-1-INVENTARIO-CONTEXTO.md - FASE-2-ANALISIS-COHERENCIA.md - FASE-3-PLANEACION-REMEDIACION.md - REPORTE-FINAL-ANALISIS.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .backups | ||
| .claude | ||
| .gemini/antigravity | ||
| .github/workflows | ||
| .trae | ||
| .windsurf | ||
| backend@b1ee86e0e5 | ||
| database@2837480e17 | ||
| docs | ||
| frontend@b0d5b94c07 | ||
| orchestration | ||
| .gitmodules | ||
| CLAUDE.md | ||
| docker-compose.dev.yml | ||
| docker-compose.yml | ||
| README.md | ||
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 |
| SAAS-013 | SendGrid, SES, SMTP | |
| 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
# 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