01Premisa del assessment

Después de 3 versiones (v1 SaaS · v2 uso interno · v3 Reputation First) el banco tiene 32 documentos vivos. Antes de seguir construyendo · alto y pregunto: ¿qué está bien · qué falta · qué hay que rediseñar?

02Alcance del assessment (16 de 32 docs)

📦 PRODUCTO TÉCNICO (8)         👥 FOUNDERS OPERATION (4)
   01 Vision                       12 Roles
   02 BBP                          14 Journey
   03 Requirements                 15 Valor Interno
   04 RFP                          16 Comparativa Tools
   05 Data Model
   06 API Catalog               💼 ESTRATEGIA (1)
   07 Architecture                 17 ⭐ Reputation First Y1
   08 Roadmap

👔 GOBERNANZA selectiva (3)    ⛔ FUERA DE SCOPE
   38 Onboarding Dev              25·26·27 Marca · 30 Legal
   39 API SDK Postman             31·32 Seguridad
   41 Changelog                   21·23·24 Negocio · resto gobernanza

03Evaluación por documento

04Lo que FUNCIONA · se mantiene tal cual (8 docs)

🟢 Verde · cero cambios:

• Doc 01 Vision (premisa Reputation First clara)
• Doc 04 RFP (especificación contractual sólida)
• Doc 08 Roadmap (post-fix de 2 dimensiones)
• Doc 12 Roles Founders (cross-funcional explícito)
• Doc 15 Valor Interno (ROI cuantificable bien argumentado)
• Doc 16 Comparativa Tools (referente operativo)
• Doc 39 API SDK Postman (consistente · funcional)
• Doc 41 Changelog (formato Keep a Changelog · OK)

05Lo que FALTA agregar al banco v4 (secciones nuevas)

🟡 Amarillo · construir:

06Lo que REDISEÑAR profundo (4 docs)

🔵 Azul · rework:

Doc 03 Requirements · rediseño
─────────────────────────────────────────────────────
Actual: tabla genérica FR/NFR sin agrupación clara.
Propuesta v4:
  · FR-Y1F1 (features Fase 1 Reputación)
  · FR-Y1F2 (features Fase 2 Escala MeLi)
  · FR-Y1F3 (features Fase 3 Diversificación)
  · FR-Y1F4 (features Fase 4 Consolidación)
  · FR-CROSS (cross-cutting: auth · DB · adapter · cerebro)
  · NFR-Y1 (performance · seguridad · uptime targets Y1)

Doc 07 Architecture · rediseño parcial
─────────────────────────────────────────────────────
Actual: HLA muy bueno · 5 escenarios pipeline · ADRs.
Falta:
  · Sub-diagrama Supplier Adapter Pattern (paralelo a Channel)
  · Zona ADS pixels (Meta Conversions API · Google Ads · TikTok Events)
  · ADR-0002 Supplier Adapter Pattern formal
  · ADR-0003 ADS automation strategy

Doc 17 Estrategia Y1 · rediseño leve
─────────────────────────────────────────────────────
Actual: 4 fases + tácticas + KPIs · sólido.
Agregar:
  · Sección "Avance semanal" (review lunes · qué medimos)
  · Sección "Qué hacer si fase no llega a hito" (decisión tree)
  · Sección "Cómo se relaciona con Doc 18 Plan Ejecución"

Doc 14 Founders Journey · rediseño leve
─────────────────────────────────────────────────────
Actual: 3 scenarios (ONBOARDING · MP_FIRST · EVOLVE).
Agregar:
  · Scenario "BREAKDOWN" · cuando algo se rompe (orden duplicada · stock 0 · SII rechaza DTE · etc) · quién toma qué decisión

07Navegación propuesta v4

Hoy hay un index plano con 7 bloques. v4 propone navegación por intención del lector:

Lector tipo A · "tengo 5 min · quiero entender SMC"
─────────────────────────────────────────────────────
  → Doc 01 Vision (5 min lectura)
  → Doc 17 ⭐ Estrategia Y1 (10 min · doc central)
  → STOP · tiene el panorama

Lector tipo B · "soy founder · necesito operar"
─────────────────────────────────────────────────────
  → Doc 12 Roles Founders (mi rol específico)
  → Doc 14 Founders Journey (qué hago día 1 al 90)
  → Doc 02 BBP (los procesos donde participo)
  → Doc 17 Estrategia (cómo se conecta a la estrategia anual)

Lector tipo C · "voy a construir tech"
─────────────────────────────────────────────────────
  → Doc 11 🆕 Especificación Técnica (norte arquitectural)
  → Doc 07 Architecture (HLA + escenarios)
  → Doc 05 Data Model (schema)
  → Doc 06 API Catalog (endpoints)
  → Doc 38 Onboarding Dev (setup · convenciones)

Lector tipo D · "necesito plan + plata"
─────────────────────────────────────────────────────
  → Doc 18 🆕 Plan Ejecución (gantt + agentes + montos)
  → Doc 23 Financial (cash flow esperado · ver bloque negocio)
  → Doc 41 Changelog (historial decisiones)

Implementación en index.html v4: tabs/filters por tipo de lector + recommended path visual.

08Versionado · cómo navegamos entre versiones

v3.0.0 (actual · stable)
  · Tag git congelado · navegable en repo
  · URL: github.com/SmartConnection-CodeHub/marketplace-smc-banco/tree/v3.0.0
  · No se borra · no se modifica

v4.0.0-rc1 (futuro · proceso)
  · Rama paralela: feature/v4-banco-extended
  · Build separado: banco-v4 dir en mismo repo
  · O subdomain: v4.marketplace.smconnection.cl
  · Vos navegás entre las dos vía link visible en header

Switcher UI (a construir):
  ┌─────────────────────────────────────────┐
  │ Marketplace SMC Banco          v3 [v4]  │
  │                                          │
  │ Estás viendo · v3.0.0 (stable)           │
  │ Hay versión nueva · v4.0.0-rc1 (preview) │
  │ [Probar v4]   [Quedarme en v3]           │
  └─────────────────────────────────────────┘

09Backlog priorizado para v4

P1 = bloquea v4 · P2 = roadmap v4 · P3 = nice-to-have · P4 = post-launch.

10Próximos pasos inmediatos (cola Sentinela)

• ✅ Doc 10 Assessment creado
• ✅ Doc 11 Especificación Funcional v2 (granular · 3 sidecars)
• ✅ Doc 13 Especificación Técnica v2 (granular · 1 sidecar)
• ✅ Doc 18 Plan Ejecución (Gantt + agentes + montos)
• ✅ Doc 19 UAT v1 (24 CU · 5 E2E · sign-off por fase)
• ✅ Scaffolding repo marketplace · adapters + Sprint 1
• ✅ Doc 17 refinado (review semanal · breakdown · conexión Doc 18)
• ✅ Doc 14 refinado (scenario BREAKDOWN)
• ⏭️ Sprint 2 Q4-26 · empezar implementación real (MeLi OAuth + dashboard)
• ⏭️ Resto backlog P2-P3 según prioridad founders

Status v4: 70% completado · pendiente Sprint 2-10 ejecución técnica.