rckrdmrd/template-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
master
template-saas/docs/_MAP.md
rckrdmrd 50a821a415
Some checks failed
CI / Backend CI (push) Has been cancelled
Details
CI / Frontend CI (push) Has been cancelled
Details
CI / Security Scan (push) Has been cancelled
Details
CI / CI Summary (push) Has been cancelled
Details
[SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Actualizaciones de configuracion

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:08 -06:00

6.7 KiB
Raw Permalink Blame History

id title type status priority version created_date updated_date
MAP-DOCS Mapa de Documentacion Index Published P1 1.0.0 2026-01-07 2026-01-10

Template SaaS - Mapa de Documentacion

Proyecto: template-saas Tipo: Template Base Multi-Tenant Fecha: 2026-01-10 Estado: Completado - DDL 100%, Backend 100%, Frontend 100%, WhatsApp 100%

Estructura de Documentacion

docs/
├── _MAP.md                            <- ESTE ARCHIVO
├── 00-vision-general/
│   ├── README.md
│   ├── VISION-TEMPLATE-SAAS.md
│   ├── ESPECIFICACION-PLATAFORMA-SAAS.md
│   └── ARQUITECTURA-MULTI-TENANT.md
│
├── 01-modulos/                        <- Archivos planos SAAS-XXX.md
│   ├── SAAS-001-auth.md
│   ├── SAAS-002-tenants.md
│   ├── SAAS-003-users.md
│   ├── SAAS-004-billing.md
│   ├── SAAS-005-plans.md
│   ├── SAAS-006-ai-integration.md
│   ├── SAAS-007-notifications.md
│   ├── SAAS-008-audit-logs.md
│   ├── SAAS-009-feature-flags.md
│   ├── SAAS-010-webhooks.md
│   ├── SAAS-011-storage.md
│   ├── SAAS-012-crud-base.md
│   ├── SAAS-013-email.md
│   └── SAAS-014-whatsapp.md
│
├── 02-especificaciones/
│   └── ET-SAAS-007-notifications-v2.md
│
├── 02-integraciones/
│   ├── INT-001-stripe.md
│   ├── INT-002-oauth.md
│   ├── INT-003-email.md
│   ├── INT-004-push.md
│   ├── INT-005-storage.md
│   ├── INT-006-webhooks.md
│   └── INT-007-redis.md
│
├── 02-devops/
│   └── CICD-GUIDE.md
│
└── architecture/
    └── adr/
        ├── ADR-001-multi-tenancy-rls.md
        ├── ADR-002-authentication-jwt-oauth.md
        ├── ADR-003-billing-stripe.md
        ├── ADR-004-notifications-realtime.md
        └── ADR-005-feature-flags.md

Modulos SaaS

Modulos Core (Autenticacion y Tenants)

Modulo Codigo Estado Descripcion
Auth SAAS-001 Completado JWT (OAuth, MFA planificados)
Tenants SAAS-002 Completado Gestion multi-tenant
Users SAAS-003 Completado Usuarios con RBAC

Modulos Billing

Modulo Codigo Estado Descripcion
Billing SAAS-004 Completado Suscripciones Stripe
Plans SAAS-005 Completado Planes y limites

Modulos Avanzados

Modulo Codigo Estado Descripcion
AI Integration SAAS-006 Completado Wrapper multi-proveedor LLM (Claude, GPT-4, Gemini)
Notifications SAAS-007 Completado Email, push, in-app, WhatsApp (v2.0)
Audit Logs SAAS-008 Completado Auditoria de acciones
Feature Flags SAAS-009 Completado Toggles por plan/tenant
Webhooks SAAS-010 Completado Webhooks outbound con BullMQ
Storage SAAS-011 Completado S3, R2, MinIO
CRUD Base SAAS-012 Documentacion Guia de patrones (no implementacion)
Email SAAS-013 Completado SendGrid, SES, SMTP
WhatsApp SAAS-014 Completado WhatsApp Business API

Integraciones Externas

Las integraciones estan documentadas en sus modulos correspondientes:

Integracion Modulo Relacionado Estado Proposito
Stripe SAAS-004-billing Completado Pagos y suscripciones
OAuth SAAS-001-auth Planificado Google, GitHub, etc. (DDL existe, endpoints pendientes)
Email SAAS-013-email Completado SendGrid, SES, SMTP
Push SAAS-007-notifications Completado Web Push API (VAPID)
Storage SAAS-011-storage Completado S3, R2, MinIO
Webhooks SAAS-010-webhooks Completado BullMQ queue processing
Redis SAAS-010-webhooks Completado Queue backend
WhatsApp SAAS-014-whatsapp Completado WhatsApp Business API

Schemas de Base de Datos

Schema Tablas Descripcion
auth 4 Autenticacion y sesiones
tenants 2 Multi-tenancy
users 4 Usuarios, roles, permisos, invitaciones
billing 6 Suscripciones, invoices, payments
plans 2 Planes y features
notifications 6 Notificaciones multicanal (v2.0 implementado)
feature_flags 4 Feature toggles y evaluaciones
audit 2 Logs de auditoria
ai 2 Configuracion y uso de IA
storage 3 Archivos y uso de almacenamiento
webhooks 2 Webhooks outbound y entregas
whatsapp 2 Configuracion y mensajes WhatsApp

Total: 12 schemas, 24 tablas

Portales

Portal Ruta Descripcion
User / Portal usuario final
Admin /admin Portal admin de tenant
Superadmin /superadmin Portal superadmin

Arquitectura Multi-Tenant

estrategia: "Row-Level Security (RLS)"
aislamiento: "Por tenant_id en cada tabla"
contexto:
  - JWT claims contienen tenant_id
  - Middleware inyecta tenant context
  - RLS policies validan automaticamente

Modelo de Billing

planes:
  - Free: $0/mes, limitaciones
  - Starter: $29/mes
  - Pro: $99/mes
  - Enterprise: Custom

ciclos:
  - Monthly
  - Yearly (20% descuento)

trial: 14 dias
metered_billing: opcional

AI Integration

wrapper: "Agnostico multi-proveedor"
proveedores_soportados:
  - Claude (Anthropic)
  - GPT-4 (OpenAI)
  - Gemini (Google)

features:
  - Token counting
  - Cost tracking
  - Rate limiting por tenant

ADRs (Decisiones Arquitectonicas)

Ubicacion: docs/architecture/adr/

ADR Titulo Estado
ADR-001 Multi-tenancy con RLS Completado
ADR-002 Authentication JWT + OAuth Completado
ADR-003 Billing con Stripe Completado
ADR-004 Notifications Real-time Completado
ADR-005 Feature Flags por Tenant Completado

Navegacion Rapida

Por Componente Tecnico

  • Database: Ver orchestration/inventarios/DATABASE_INVENTORY.yml
  • Backend: Ver orchestration/inventarios/BACKEND_INVENTORY.yml
  • Frontend: Ver orchestration/inventarios/FRONTEND_INVENTORY.yml

Por Estado

  • Completado: Todos los modulos SAAS-001 a SAAS-014
  • Documentacion: ADRs, Especificaciones tecnicas

Referencias

Ultima actualizacion: 2026-01-10 Version: 2.0.0