TheFittClub — Índice de documentos de negocio

Índice de documentos de negocio

Mapa de qué documento posee qué información. La fuente de verdad de los datos es siempre NEGOCIO_SSOT (Capa 0). Este índice solo describe roles y dependencias; no contiene datos canónicos.

---

Capas de la arquitectura

Capa	Responsabilidad	Archivos
0 — SSOT	Datos canónicos en tablas. Inmutable: ningún otro doc puede contradecirlo.	NEGOCIO_SSOT.md, scripts/zenler/programs_catalog.json
1 — Frontmatter + Dataview	Snapshots numéricos derivados del SSOT (sincronizados por script) y queries que los exponen.	BUSINESS_INTELLIGENCE.md, queries en index.md, Dashboard_Conversion.md
2 — Wikilinks direccionales	Docs operativos que referencian al SSOT sin redefinir datos.	PROGRAMAS.md, NEGOCIO_LEGACY_OPUS.md, ESTADO_PIPELINE.md

---

Mapa de documentos

doc	rol	actualización
NEGOCIO_SSOT	Capa 0 — datos canónicos	Manual cuando entran datos nuevos
scripts/zenler/programs_catalog.json	courseIDs machine-readable	Manual + verificación con SSOT
BUSINESS_INTELLIGENCE	Métricas cruzadas y análisis	Frontmatter regenerado por scripts/audit/sync_ssot_to_frontmatter.py
PROGRAMAS	Descripción humana de productos	Datos vienen de SSOT vía Dataview inline
NEGOCIO_LEGACY_OPUS	Referencia técnica para migración a MVP	Datos vienen de SSOT vía Dataview inline
ESTADO_PIPELINE	Estado operativo de extracción	Manual — no contiene datos de negocio
99_Archivo/Backups_TheFittClub/00_Metadata_Global/timeline_eventos.csv	Hitos cronológicos machine-readable	Manual
Dashboard_Conversion	Dashboard de métricas (sociales + negocio)	Queries Dataview leen frontmatter de BI
Audiencia_IG_Real	Demografía real de audiencia IG (export Abr 2025)	Snapshot histórico — dato puntual
Atribucion_IG_Zenler	Correlación temporal posts IG → ventas Zenler	Generado por scripts/ig_import/attribution_ig_zenler.py
Meta_Ads_Targeting_Reference	Categorías de targeting algorítmico Meta	Snapshot histórico — dato puntual
Inspiracion_Competencia_IG	Benchmark competitivo: cuentas guardadas/likeadas	Snapshot histórico — dato puntual
Meta_Ads_Campanas	Boosts + campañas Meta (gasto, alcance pagado, ROAS)	Generado por scripts/backfill_ads.js desde act/insights
index	Snapshot ejecutivo del vault	Queries Dataview leen frontmatter de BI
Brand	Identidad de marca, buyer persona, demografía LATAM	Canónico aquí; renderizado al dev repo vía sync-dev-repo-snapshots.yml
Estrategia	Plan estratégico v5.1 (proyecciones, contactos, seguidores)	Canónico aquí; renderizado al dev repo
Email_Brief_L9	Brief de 15 templates de email para Loops (voz + demografía + secuencias)	Canónico aquí; renderizado al dev repo

---

Reglas de oro

1. Un dato vive en 1 sitio: el valor canónico está en NEGOCIO_SSOT.md. Todo lo demás lo deriva.
2. SSOT es inmutable: no contiene wikilinks salientes ni referencias a otros docs. Los docs apuntan hacia él, nunca al revés.
3. Frontmatter como espejo: BUSINESS_INTELLIGENCE.md tiene los mismos números en frontmatter para exposición vía Dataview. Se regenera con script, no a mano.
4. Prosa sin números mutables: si un dato puede cambiar (revenue, alumnas, contactos), se renderiza con Dataview inline desde el frontmatter. Solo los hechos históricos puntuales (ej. “$9.232 en Feb 2024”) pueden quedar en prosa.
5. Validación automática: scripts/audit/audit_ssot.py debe pasar antes de cada commit que toque SSOT o docs estratégicos.

Cómo editar datos sin romper nada

→ _GUIA_ACTUALIZACION_DATOS — un solo comando (python3 scripts/audit/vault_update.py) te guía paso a paso. Cheat sheet con los casos comunes incluido.

Si eres una IA trabajando en este vault

→ AGENTS — briefing obligatorio antes de tocar nada. Las 5 reglas inquebrantables, el flujo por tipo de tarea, los patrones SÍ/NO. (CLAUDE.md es solo un puntero hacia ahí.)