rckrdmrd
50a821a415
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Actualizaciones de configuracion Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
243 lines
6.7 KiB
Markdown
243 lines
6.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-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
|