Estructura Objetivo de /docs/
Fecha: 2026-01-10
Fase: 4.1 - Diseno de Estructura Objetivo
Estado: COMPLETADO
Estructura Actual vs Objetivo
Estructura Actual
docs/
├── _MAP.md (indice desactualizado)
├── 00-vision-general/
│ ├── README.md
│ ├── VISION-TEMPLATE-SAAS.md
│ ├── ESPECIFICACION-PLATAFORMA-SAAS.md
│ └── ARQUITECTURA-MULTI-TENANT.md
├── 01-modulos/ (14 archivos SAAS-XXX)
├── 02-devops/
│ └── CICD-GUIDE.md
├── 02-especificaciones/
│ ├── ET-SAAS-007-notifications-v2.md
│ └── PLAN-IMPLEMENTACION-NOTIFICATIONS-V2.md
├── 02-integraciones/ (7 stubs INT-XXX)
└── architecture/
└── adr/ (5 ADRs)
Estructura Objetivo
docs/
├── _MAP.md (ACTUALIZADO - indice maestro)
├── _INDEX.md (NUEVO - indice de navegacion)
├── 00-vision-general/
│ ├── README.md
│ ├── VISION-TEMPLATE-SAAS.md
│ ├── ESPECIFICACION-PLATAFORMA-SAAS.md
│ └── ARQUITECTURA-MULTI-TENANT.md
├── 01-modulos/
│ ├── _INDEX.md (NUEVO)
│ ├── SAAS-001-auth.md (ACTUALIZADO - OAuth/MFA a Roadmap)
│ ├── 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 (ACTUALIZADO - consolidado)
│ ├── 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 (ACTUALIZADO - rutas)
├── 02-integraciones/
│ ├── _INDEX.md (NUEVO)
│ ├── INT-001-stripe.md (EXPANDIDO ~300 lineas)
│ ├── INT-002-oauth.md (EXPANDIDO ~350 lineas)
│ ├── INT-003-email.md (EXPANDIDO ~300 lineas)
│ ├── INT-004-push.md (EXPANDIDO ~280 lineas)
│ ├── INT-005-storage.md (EXPANDIDO ~350 lineas)
│ ├── INT-006-webhooks.md (EXPANDIDO ~300 lineas)
│ └── INT-007-redis.md (EXPANDIDO ~280 lineas)
├── 03-devops/
│ ├── _INDEX.md (NUEVO)
│ └── CICD-GUIDE.md (MOVIDO de 02-devops)
├── architecture/
│ └── adr/
│ ├── _INDEX.md (NUEVO)
│ ├── ADR-001-multi-tenancy-rls.md
│ ├── ADR-002-authentication-jwt-oauth.md (ACTUALIZADO)
│ ├── ADR-003-billing-stripe.md
│ ├── ADR-004-notifications-realtime.md
│ └── ADR-005-feature-flags.md
└── _archivo/
├── ET-SAAS-007-notifications-v2.md (MOVIDO)
└── PLAN-IMPLEMENTACION-NOTIFICATIONS-V2.md (MOVIDO)
Cambios Requeridos
Archivos a ACTUALIZAR
| Archivo |
Cambios |
| _MAP.md |
Corregir numeracion SAAS-006 a SAAS-014, estructura real |
| SAAS-001-auth.md |
Mover OAuth/MFA a seccion Roadmap |
| SAAS-007-notifications.md |
Agregar referencia a SAAS-014 WhatsApp |
| SAAS-014-whatsapp.md |
Corregir waba_id, rutas de endpoints |
| ADR-002-authentication-jwt-oauth.md |
Marcar OAuth como planificado |
Archivos a CREAR
| Archivo |
Contenido |
| _INDEX.md |
Indice de navegacion rapida |
| 01-modulos/_INDEX.md |
Lista de modulos con estado |
| 02-integraciones/_INDEX.md |
Lista de integraciones |
| 03-devops/_INDEX.md |
Guias de operaciones |
| architecture/adr/_INDEX.md |
Lista de ADRs |
Archivos a MOVER
| Origen |
Destino |
| 02-devops/CICD-GUIDE.md |
03-devops/CICD-GUIDE.md |
| 02-especificaciones/ET-SAAS-007-* |
_archivo/ |
| 02-especificaciones/PLAN-IMPLEMENTACION-* |
_archivo/ |
Archivos a EXPANDIR
| Archivo |
De |
A |
| INT-001-stripe.md |
~30 lineas |
~300 lineas |
| INT-002-oauth.md |
~32 lineas |
~350 lineas |
| INT-003-email.md |
~37 lineas |
~300 lineas |
| INT-004-push.md |
~35 lineas |
~280 lineas |
| INT-005-storage.md |
~46 lineas |
~350 lineas |
| INT-006-webhooks.md |
~41 lineas |
~300 lineas |
| INT-007-redis.md |
~37 lineas |
~280 lineas |
Carpetas a ELIMINAR
| Carpeta |
Razon |
| 02-especificaciones/ |
Contenido movido a _archivo/ |
| 02-devops/ |
Renombrado a 03-devops/ |
Contenido de Indices
_MAP.md (actualizado)
# Mapa de Documentacion - Template SaaS
## Modulos (14)
| ID | Nombre | Estado |
|----|--------|--------|
| SAAS-001 | Auth | Completado (OAuth/MFA Roadmap) |
| SAAS-002 | Tenants | Completado |
...
| SAAS-014 | WhatsApp | Completado |
## Integraciones (7)
| ID | Nombre | Estado |
|----|--------|--------|
| INT-001 | Stripe | Documentado |
...
## ADRs (5)
| ID | Decision |
|----|----------|
| ADR-001 | Multi-tenancy RLS |
...
01-modulos/_INDEX.md
# Modulos del Sistema
## Core
- [SAAS-001 Auth](./SAAS-001-auth.md) - Autenticacion y autorizacion
- [SAAS-002 Tenants](./SAAS-002-tenants.md) - Multi-tenancy
- [SAAS-003 Users](./SAAS-003-users.md) - Gestion de usuarios
## Negocio
- [SAAS-004 Billing](./SAAS-004-billing.md) - Facturacion Stripe
- [SAAS-005 Plans](./SAAS-005-plans.md) - Planes y limites
## Avanzados
- [SAAS-006 AI Integration](./SAAS-006-ai-integration.md)
- [SAAS-007 Notifications](./SAAS-007-notifications.md)
- [SAAS-008 Audit Logs](./SAAS-008-audit-logs.md)
## Infraestructura
- [SAAS-009 Feature Flags](./SAAS-009-feature-flags.md)
- [SAAS-010 Webhooks](./SAAS-010-webhooks.md)
- [SAAS-011 Storage](./SAAS-011-storage.md)
## Comunicacion
- [SAAS-012 CRUD Base](./SAAS-012-crud-base.md) - Guia de patrones
- [SAAS-013 Email](./SAAS-013-email.md)
- [SAAS-014 WhatsApp](./SAAS-014-whatsapp.md)
Metricas Objetivo
| Metrica |
Actual |
Objetivo |
| Archivos en docs/ |
35 |
38 (+3 indices) |
| Lineas integraciones |
~278 |
~2,160 |
| Archivos huerfanos |
8 |
0 |
| Enlaces rotos |
5 |
0 |
| Cobertura de indices |
60% |
100% |
Entregable de: FASE 4.1