rckrdmrd/template-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Template base para proyectos SaaS
5 Commits 2 Branches 0 Tags 37 MiB
HTML 50.2%
TypeScript 46%
PLpgSQL 2.6%
JavaScript 0.5%
Shell 0.4%
Other 0.2%
68d3c54023
Go to file
rckrdmrd 68d3c54023 docs(ai): Update documentation and fix DDL scripts 
Documentation:
- Update SAAS-006-ai-integration.md with full implementation details
- Update _MAP.md with AI schema (30 tables, 11 schemas)
- Update PROJECT-STATUS.md (67% completion)

Database fixes:
- Add update_updated_at_column() function to 03-functions.sql
- Add trigger creation for ai.configs in 03-functions.sql
- Fix partial index in 02-ai-usage.sql (remove CURRENT_DATE)
- Add AI schema grants to create-database.sh
- Add AI to SCHEMA_ORDER array

Validated: Database recreation successful with all AI objects

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 07:21:56 -06:00
apps docs(ai): Update documentation and fix DDL scripts 2026-01-07 07:21:56 -06:00
docs docs(ai): Update documentation and fix DDL scripts 2026-01-07 07:21:56 -06:00
orchestration docs(ai): Update documentation and fix DDL scripts 2026-01-07 07:21:56 -06:00
README.md feat: Initial commit - template-saas 2026-01-07 04:41:24 -06:00

README.md

Template SaaS Multi-Tenant

Version: 0.1.0 Estado: Fase 0 - Preparacion Tipo: STANDALONE Sistema: SIMCO + NEXUS v3.4

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

  1. SAAS-001-auth - Autenticacion JWT, OAuth, MFA
  2. SAAS-002-tenants - Gestion de organizaciones
  3. SAAS-003-users - Usuarios con RBAC
  4. SAAS-004-billing - Suscripciones Stripe
  5. SAAS-005-plans - Planes y limites
  6. SAAS-006-onboarding - Flujo de registro
  7. SAAS-007-notifications - Email, push, in-app
  8. SAAS-008-feature-flags - Toggles por plan/tenant
  9. SAAS-009-audit - Auditoria de acciones
  10. SAAS-010-portal-user - Portal usuario final
  11. SAAS-011-portal-admin - Portal admin de tenant
  12. SAAS-012-portal-superadmin - Portal superadmin

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/
│   └── 97-adr/
└── orchestration/
    ├── 00-guidelines/
    ├── inventarios/
    └── 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