---
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-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

```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/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

- [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-01-10
**Version:** 2.0.0