Template base para proyectos SaaS
5f25327f18
- storage/06-triggers.sql: Added updated_at triggers for files and usage - whatsapp RLS: Fixed current_setting pattern with true parameter Ref: P1 - Triggers storage y correccion RLS whatsapp Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .backups | ||
| .claude | ||
| .gemini/antigravity | ||
| .github/workflows | ||
| .trae | ||
| .windsurf | ||
| backend@a671697d35 | ||
| database@c1c5892364 | ||
| docs | ||
| frontend@9019261f8e | ||
| 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