Saltar a contenido

Estado de fase (MASTER-00): POST_MVP — documento de catálogo de producto sujeto a validación; no es alcance aprobado de Gate 0 / PoC / MVP. Gobernanza: MASTER-00.

Alcance multiplataforma (DEC-002): este mapa cubre Mobile (Fases A–C) y Desktop (Fase D, entorno operativo principal) sobre el núcleo compartido. El alcance MVP vigente son los 5 flujos (F1–F5) de MASTER-00 §5.4; la discrepancia con el conteo de pantallas del propio mapa ("62" vs "34" de MASTER-00) permanece como TBD (DEC-001).

DocuGraph Master UI/UX Screen Map

This document establishes the official functional UI/UX layout for DocuGraph, defining 62 unique screens and critical interaction states split into MVP Shipaton (25 screens) and Product Expansion (37 screens).


A. MVP Shipaton: 25 Core Screens & States

1. Entrada y Onboarding

ID Pantalla Objetivo
MVP-01 Splash Mostrar marca y carga inicial
MVP-02 Bienvenida Explicar DocuGraph y ofrecer crear o abrir demo
MVP-03 Onboarding: problema Mostrar el problema del contexto documental disperso
MVP-04 Onboarding: solución Explicar documentación atómica, grafo y MCP

2. Proyectos y Configuración Inicial

ID Pantalla Objetivo
MVP-05 Lista de proyectos Mostrar proyectos, estado MCP y alertas
MVP-06 Crear proyecto Crear proyecto vacío, demo o desde plantilla
MVP-07 Importar proyecto Seleccionar documentos o directorio autorizado
MVP-08 Checklist de configuración Revisar AGENTS.md, visión, historias, OpenAPI y schema
MVP-09 Proyecto demo Ejemplo completo listo para la demostración

3. Editor Documental

ID Pantalla Objetivo
MVP-10 Biblioteca de documentos Navegar documentos por fase, tipo y estado
MVP-11 Editor de documento Visualizar y editar un archivo Markdown
MVP-12 Editor de sección Modificar una sección concreta sin abrir todo el documento
MVP-13 Editor de nodo y metadata Editar ID, tipo, estado, ruta y dependencias
MVP-14 Selector de referencias Buscar y vincular nodos como US-01, IX-01 o BE-02

4. Grafo Documental

ID Pantalla Objetivo
MVP-15 Grafo principal Visualizar documentos, nodos y conexiones
MVP-16 Inspector de nodo Revisar dependencias, referencias, contenido y acciones
MVP-17 Análisis de impacto Mostrar qué elementos resultan afectados por un cambio

5. MCP y Contexto

ID Pantalla Objetivo
MVP-18 Vista previa del context bundle Mostrar qué recibirá el agente y qué se excluye
MVP-19 Estado del servidor MCP Mostrar estado, transporte, recursos, prompts y tools
MVP-20 Detalle de tool MCP Probar get_task_context y visualizar su respuesta

6. Validación y Ejecución

ID Pantalla Objetivo
MVP-21 Validación de trazabilidad Detectar referencias rotas, huérfanos y operationIds ausentes
MVP-22 Project Manifest Mostrar tareas, specs, estados y dependencias

7. Monetización y Configuración

ID Pantalla Objetivo
MVP-23 Paywall Pro Presentar suscripción gestionada con RevenueCat
MVP-24 Función Pro bloqueada Explicar límites Free y ofrecer mejora
MVP-25 Configuración MCP, almacenamiento, tema, plan y restauración de compras

B. Proyecto Completo: 37 Pantallas Adicionales de Expansión

8. Acceso, Cuenta y Espacios de Trabajo

ID Pantalla Objetivo
FULL-01 Iniciar sesión Acceso para sincronización futura
FULL-02 Crear cuenta Registrar usuario
FULL-03 Recuperar acceso Recuperación de cuenta
FULL-04 Selector de workspace Cambiar entre espacios personales y de equipo
FULL-05 Miembros y permisos Administrar integrantes y roles

9. Creación Documental Asistida

ID Pantalla Objetivo
FULL-06 Galería de plantillas Elegir metodología o estructura inicial
FULL-07 Editor de Business Vision Definir actores, procesos, reglas y glosario inicial
FULL-08 Constructor de User Story Crear historia, escenarios y criterios de aceptación
FULL-09 Constructor de Interaction Spec Diseñar pantallas, estados, transiciones y errores
FULL-10 Constructor de tarea backend Crear spec técnica y vincular operación API
FULL-11 Constructor de tarea frontend Crear spec de pantalla o componente
FULL-12 Asistente para derivar documentos Crear una historia, flujo o tarea desde un nodo origen

10. Edición Avanzada

ID Pantalla Objetivo
FULL-13 Convertir sección en nodo Atomicizar una parte del documento
FULL-14 Editor de relaciones Crear, modificar o eliminar conexiones
FULL-15 Comparación de versiones Mostrar diferencias entre revisiones
FULL-16 Historial documental Consultar y restaurar versiones
FULL-17 Sugerencias de enlaces Proponer posibles relaciones faltantes
FULL-18 Resolución de conflictos Resolver cambios incompatibles o simultáneos

11. Contratos Técnicos

ID Pantalla Objetivo
FULL-19 Explorador OpenAPI Navegar operaciones, schemas y operationIds
FULL-20 Mapeador de operación API Vincular operationId con tareas, flujos y pantallas
FULL-21 Explorador del modelo de datos Visualizar entidades, tablas y relaciones
FULL-22 Mapeador de tablas Vincular tablas con endpoints y tareas
FULL-23 Editor del glosario Gestionar términos de dominio y sus referencias

12. MCP y Agentes Avanzados

ID Pantalla Objetivo
FULL-24 Catálogo de Resources Inspeccionar recursos publicados por MCP
FULL-25 Catálogo de Prompts Administrar implement_task, review_task_diff, etc.
FULL-26 Constructor de context rules Configurar qué incluir por tipo de tarea
FULL-27 Entrega al agente Copiar configuración, prompt o invocación MCP
FULL-28 Revisión del diff Comparar código generado con spec y contrato
FULL-29 Historial MCP Revisar bundles, invocaciones y resultados anteriores

13. Calidad y Trazabilidad Avanzada

ID Pantalla Objetivo
FULL-30 Resolución de referencias rotas Corregir errores mediante sugerencias
FULL-31 Documentos huérfanos Revisar nodos sin relaciones
FULL-32 Ruta de trazabilidad Mostrar el camino completo desde negocio hasta código
FULL-33 Reporte de cobertura Medir historias con flujo, tareas, API y datos vinculados
FULL-34 Checklist de cambio Generar acciones derivadas de un impacto

14. Exportación, Seguridad y Fallos

ID Pantalla Objetivo
FULL-35 Centro de exportación Exportar Markdown, JSON, YAML, PDF, Mermaid o reporte
FULL-36 Permisos y roots Controlar qué directorios puede leer el MCP
FULL-37 Centro de errores y logs Visualizar fallos MCP, parsing, escritura y sincronización

🎬 Flujo Crítico de Demostración (Golden Path Video Demo)

Para el video de presentación de RevenueCat Shipaton 2026, se ejecutará la siguiente ruta crítica de 7 pantallas/estados:

  1. MVP-09 Proyecto demo
  2. MVP-12 Editor de sección
  3. MVP-15 Grafo principal
  4. Seleccionar BE-02 (en MVP-16 Inspector de nodo)
  5. MVP-18 Context bundle
  6. MVP-20 Tool MCP (get_task_context)
  7. MVP-21 Validación de trazabilidad o MVP-23 Paywall Pro