ae092a9bb1
- 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>
284 lines
8.7 KiB
Markdown
284 lines
8.7 KiB
Markdown
---
|
|
id: "MAP-DOCS"
|
|
title: "Mapa de Documentacion"
|
|
type: "Index"
|
|
status: "Published"
|
|
priority: "P1"
|
|
version: "1.0.0"
|
|
created_date: "2026-01-07"
|
|
updated_date: "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
|
|
|
|
```yaml
|
|
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
|
|
|
|
```yaml
|
|
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
|
|
|
|
```yaml
|
|
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
|
|
|
|
- [CONTEXTO-PROYECTO.md](../orchestration/00-guidelines/CONTEXTO-PROYECTO.md)
|
|
- [PROXIMA-ACCION.md](../orchestration/PROXIMA-ACCION.md)
|
|
- [CONTEXT-MAP.yml](../orchestration/CONTEXT-MAP.yml)
|
|
- [PROJECT-STATUS.md](../orchestration/PROJECT-STATUS.md)
|
|
- [HISTORICO-SPRINTS.md](../orchestration/planes/HISTORICO-SPRINTS.md)
|
|
|
|
---
|
|
|
|
**Ultima actualizacion:** 2026-02-03
|
|
**Version:** 3.0.0
|