template-saas/orchestration/analisis/ESTRUCTURA-OBJETIVO-DOCS.md

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

```markdown
# 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

```markdown
# 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