rckrdmrd/template-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
eb0d39216c
template-saas/docs/_MAP.md
Adrian Flores Cortes ae092a9bb1
Some checks are pending
CI / Backend CI (push) Waiting to run
Details
CI / Frontend CI (push) Waiting to run
Details
CI / Security Scan (push) Waiting to run
Details
CI / CI Summary (push) Blocked by required conditions
Details
chore: Update docs/_MAP.md and purge obsolete archive files 
- Update docs/_MAP.md to include SAAS-015 to SAAS-022 modules
- Update schema count from 12 to 17, tables from 24 to 48
- Add ADR-006 to ADR-011 references
- Add sales, commissions, portfolio, goals, mlm schemas
- Purge 75 obsolete files from orchestration/_archive/ (~620KB)
  - 2026-01-07-trazas/ (5 files)
  - 2026-01-10-simco-v37/ (52 files)
  - 2026-01-10-sprint5/ (18 files)
- Update frontend submodule reference

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 13:05:24 -06:00

8.7 KiB
Raw 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-24

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
│   ├── SAAS-015-oauth.md
│   ├── SAAS-016-analytics.md
│   ├── SAAS-017-reports.md
│   ├── SAAS-018-sales.md
│   ├── SAAS-019-portfolio.md
│   ├── SAAS-020-COMMISSIONS.md
│   ├── SAAS-021-mlm.md
│   └── SAAS-022-goals.md
│
├── 02-especificaciones/
│   ├── ET-SAAS-007-notifications-v2.md
│   ├── ET-SAAS-015-oauth.md
│   ├── ET-SAAS-016-analytics.md
│   └── ET-SAAS-017-reports.md
│
├── 03-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
│
├── 04-devops/
│   └── CICD-GUIDE.md
│
└── 97-adr/
    └── 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
        ├── ADR-006-ai-integration-multi-provider.md
        ├── ADR-007-storage-abstraction-layer.md
        ├── ADR-008-webhook-retry-strategy.md
        ├── ADR-009-whatsapp-business-integration.md
        ├── ADR-010-audit-log-retention-policy.md
        └── ADR-011-rate-limiting-strategy.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
OAuth 2.0 SAAS-015 Completado Google, Microsoft, GitHub, Apple
Analytics SAAS-016 Completado Dashboard métricas empresariales
Reports SAAS-017 Completado PDF, Excel, CSV exports

Módulos Comerciales/Enterprise

Modulo Codigo Estado Descripcion
Sales SAAS-018 Completado Pipeline de ventas, leads, oportunidades
Portfolio SAAS-019 Completado Catálogo de productos y servicios
Commissions SAAS-020 Completado Sistema de comisiones multi-esquema
MLM SAAS-021 Completado Marketing multinivel, redes
Goals SAAS-022 Completado Metas, OKRs, KPIs

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
sales 4 Pipeline, leads, oportunidades, actividades
commissions 4 Esquemas, asignaciones, entries, períodos
portfolio 4 Categorías, productos, variantes, precios
goals 4 Definiciones, asignaciones, progreso, hitos
mlm 6 Estructuras, nodos, rangos, comisiones, bonos

Total: 17 schemas, 48 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/97-adr/adr/

ADR Titulo Estado
ADR-001 Multi-tenancy con RLS Accepted
ADR-002 Authentication JWT + OAuth Accepted
ADR-003 Billing con Stripe Accepted
ADR-004 Notifications Real-time Accepted
ADR-005 Feature Flags por Tenant Accepted
ADR-006 AI Integration Multi-Provider Accepted
ADR-007 Storage Abstraction Layer Accepted
ADR-008 Webhook Retry Strategy Accepted
ADR-009 WhatsApp Business Integration Accepted
ADR-010 Audit Log Retention Policy Accepted
ADR-011 Rate Limiting Strategy Accepted

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-02-03 Version: 3.0.0