Índice maestro
Este archivo responde: "¿Qué documento manda sobre qué tema?". Si hay contradicción entre dos documentos sobre el mismo tema, gana el listado aquí como canónico. Si una contradicción no está resuelta, abrir un ADR en producto/decisiones-vigentes.md.
Reglas de prioridad
- Decisiones de negocio viven solo en
producto/decisiones-vigentes.md.
- Estados canónicos viven solo en
datos/estados.md. La UI nunca debe mostrar nombres en MAYUSCULAS_CON_GUIONES ni en español en CamelCase; el mapeo está en datos/equivalencias-estados.md.
- Reglas de negocio viven en
datos/reglas-negocio.md y deben poder rastrearse hasta una decisión vigente.
- Documentos del prototipo (
apk/*) describen lo que hace el código hoy. No sirven como regla de negocio.
- Auditorías históricas (
_archivo/auditorias/) son referencia, no autoridad.
- Casos de uso / RUP viven ahora en
_archivo/rup/. Se conservan como trazabilidad formal; no son fuente de verdad vigente.
Tabla de autoridad
| Tema |
Documento canónico |
Documentos relacionados |
| Decisiones de negocio |
producto/decisiones-vigentes.md |
— |
| Funcionalidad por fase |
producto/matriz-funcionalidad-fase.md |
roadmap/alcance-mvp.md, roadmap/fase-2.md |
| Recorrido del cliente |
flujos/flujo-end-to-end-cliente.md |
flujos/prealerta.md, flujos/kyc.md, flujos/consolidacion-pago.md, flujos/servicios.md, flujos/incidencias-reclamos.md, flujos/pantallas-mvp.md |
| Estados canónicos |
datos/estados.md |
datos/equivalencias-estados.md |
| Reglas de negocio |
datos/reglas-negocio.md |
— |
| KYC |
datos/kyc.md + flujos/kyc.md |
— |
| Política de almacenaje |
datos/politica-almacenamiento.md |
— |
| Modelo de datos |
datos/modelo-datos.md |
_archivo/datos/modelo-datos-legacy.md |
| Identificador de casillero |
datos/identificador.md |
— |
| Aduana y normativa Cuba |
datos/aduana.md, datos/aduana-normativa-cuba.md |
— |
| APK — estado actual |
apk/estado-actual-prototipo.md |
apk/estado-actual.md (rotado) |
| APK — navegación |
apk/navegacion.md |
— |
| APK — catálogo de pantallas |
apk/catalogo-pantallas.md |
apk/inventario.md (rotado) |
| APK — modelos |
apk/modelos.md |
datos/modelo-datos.md |
| APK — stack |
apk/stack.md |
stack/tecnologias.md |
| APK — tema/diseño |
apk/tema-diseno.md |
diseno/sistema-diseno.md |
| Sistema de diseño (reglas) |
diseno/sistema-diseno.md |
apk/tema-diseno.md |
| Estados UI |
diseno/estados-ui.md |
— |
| Microcopy |
diseno/microcopy.md |
— |
| Stack y arquitectura |
stack/tecnologias.md, stack/arquitectura-backend.md |
stack/api-contract.md |
| Contrato de API |
stack/api-contract.md |
— |
| Almacenamiento de archivos |
stack/almacenamiento-archivos.md |
operaciones/estandar-fotos.md |
| Módulos y servicios |
modulos/modulos.md, modulos/servicios-cargos.md |
— |
| Backoffice / manual de almacén |
operaciones/backoffice.md, operaciones/manual-almacen.md |
— |
| Roles y permisos |
operaciones/matriz-roles-permisos.md |
— |
| KPIs y reportes |
operaciones/kpis-reportes.md |
— |
| Riesgos operativos |
operaciones/riesgos.md |
— |
| Legal |
legal/terminos-condiciones.md, legal/politica-privacidad.md, legal/articulos-prohibidos.md, legal/reclamos-reembolsos.md |
— |
| Roadmap MVP |
roadmap/alcance-mvp.md, roadmap/criterios-aceptacion-mvp.md |
_archivo/roadmap/mvp.md |
| Roadmap Fase 2 |
roadmap/fase-2.md |
— |
| Integraciones futuras |
roadmap/integraciones.md |
— |
| Requisitos no funcionales |
roadmap/requisitos.md |
— |
| Backlog vigente |
roadmap/proximos-pasos.md |
— |
| Histórico |
_archivo/ |
— |
| Visión |
vision/objetivo.md, vision/perfiles.md, vision/filosofia.md |
— |
Estados de los documentos
| Etiqueta |
Significado |
vigente |
Fuente de verdad sobre su tema. |
borrador |
En construcción; no usar como referencia. |
reemplazado |
Sustituido por otro archivo; mantiene redirector. |
historico |
Auditaría o referencia pasada; vive en _archivo/. |
Convenciones
- En código, BD y documentos técnicos usar el nombre técnico (snake_case en español o CamelCase según capa).
- En UI y mensajes al usuario usar etiqueta humana (español claro).
- Cualquier cambio de estado de un documento debe reflejarse en este índice el mismo día.