Mapa del manual vivo
El documento separa intención, diseño, prototipo y construcción. La meta es que cualquiera pueda entender no sólo cómo se verá la interfaz, sino qué problema resuelve cada decisión y qué evidencia falta para considerarla buena.
Dirección
Tesis, estado, decisiones, alcance y progreso real del producto.
Fundamentos UX
Usuarios, arquitectura, shell, navegación, selección enlazada y gramática visual.
Vistas nucleares
Conversación, procesos, conocimiento, operación, outcomes, revisión y replay.
Sistema de diseño
Inspector, componentes, estados, accesibilidad y contratos de datos.
Ejecución
Roadmap, criterios, riesgos QFUSI, entregables y próxima iteración.
Laboratorios
Ejemplos interactivos para probar antes de convertir decisiones en código costoso.
Progreso actual
Estos porcentajes representan madurez del trabajo de producto, no porcentaje de código terminado. Una pantalla documentada no cuenta como implementada y un prototipo bonito no cuenta como validado. Qué incómodo, pero qué útil.
Base conceptual
UI Spec, cinco superficies nucleares, principios, seguridad, correspondencia con v0.30 y roadmap.
Primer UX blueprint
Shell global, selección enlazada, inspector, gramática visual, wireframes y estados fundamentales.
Interacciones críticas
Conversación anotada, lentes, detalle contextual, pipeline expandible y grafos simplificados.
Observatory BFF v0.4
Proyección agregada, scopes fail-closed, trace por evento, revisión con control de snapshot, fallback explícito, importación anonimizada y suite completa validada.
Tesis de FUSI Observatory
Observatory no será un panel de indicadores con cinco donuts culpables de existir. Será una interfaz de comprensión operacional: una misma realidad proyectada como conversación, proceso, conocimiento, operación y resultado.
Qué llegó
Mensaje, archivo, evento, actor, canal, tiempo y scope.
Qué entendió
Tema, entidades, proyecto, relación, intención, compromiso y riesgo.
Cómo lo entendió
Contexto, retrieval, reglas, modelos, abstenciones, revisiones y evidencia.
Qué produjo
Assertions, decisiones, compromisos, findings, borradores e intervenciones.
Qué ocurrió después
Aceptación, dependencia, entrega, evidencia, cierre, reopen y outcome.
Qué aprendió
Correcciones, versiones, propuestas FUSI/QFUSI/GFUSI y límites de autonomía.
Qué decidimos y por qué
El valor está en explicar relaciones y causalidad, no en sumar tarjetas. Los indicadores sólo aparecen cuando ayudan a decidir.
La conversación original permanece legible. Las capas semánticas son lentes activables, no pintura permanente sobre cada palabra.
Knowledge Graph responde “qué sabemos y cómo se relaciona”; Operations Graph responde “qué está vivo, bloqueado o pendiente”. Mezclarlos crea una sopa de nodos.
Toda selección abre la misma lógica de detalle: identidad, resumen, relaciones, evidencia, historia y acciones permitidas.
Se distingue cuándo ocurrió algo de cuándo el sistema llegó a saberlo, evitando retrospectivas engañosas.
La UI no reconstruirá el dominio mediante veinte llamadas ni duplicará reglas. Recibirá vistas coherentes bajo un snapshot común.
Usuarios y trabajos principales
Operador
Entender qué pasa, qué quedó pendiente, qué bloquea y qué necesita atención hoy.
Revisor humano
Resolver identidades, temas, assertions, aceptación de compromisos y evidencia dudosa.
Model steward
Diagnosticar pipeline, modelos, reglas, costos, latencia, errores y drift.
Dirección
Ver outcomes, riesgos, dependencias y decisiones sin tragarse el JSON de la semana.
Usuario individual
Consultar qué sabe el sistema sobre una persona, proyecto o situación y corregirlo.
Auditor / seguridad
Revisar scope, autoridad, procedencia, cambios, aprobaciones y efectos externos.
Principios de experiencia
Evidencia antes que afirmación
Todo dato debe poder explicar fuente, autor, tiempo, confianza y revisión.
Resumen primero
La profundidad aparece bajo demanda; no se descarga el motor del avión sobre quien sólo preguntó por el vuelo.
Una selección, varias vistas
Entidad, bloque o compromiso conserva foco al cambiar de representación.
Confianza no es verdad
El score acompaña, pero nunca sustituye procedencia, autoridad y revisión.
Corrección sin amnesia
Original, corrección y proyección efectiva permanecen comparables.
Menos confeti semántico
Las lentes, rieles y el inspector evitan convertir el chat en piñata epistemológica.
Arquitectura de información
| Superficie | Pregunta principal | Objeto de entrada | Salida esperada |
|---|---|---|---|
| Atención | ¿Qué cambió y qué requiere decisión? | Workspace / periodo | Cadenas, preguntas y riesgos priorizados |
| Conversaciones | ¿Qué se dijo y qué entendió FUSI? | Canal / grupo / rango | Bloques, entidades, compromisos y trazas |
| Procesos | ¿Cómo se produjo esta interpretación? | Evento / bloque / outcome | Pipeline, inputs, outputs y decisiones |
| Conocimiento | ¿Qué sabe la organización? | Entidad / scope / tiempo | Subgrafo con procedencia y temporalidad |
| Operación activa | ¿Qué está pendiente, bloqueado o conectado? | Proyecto / owner / outcome | Compromisos, dependencias y findings |
| Outcomes | ¿Qué resultado se buscó y qué ocurrió? | Outcome run | Cadena causal y evaluación |
| Revisión | ¿Qué necesita criterio humano? | Review queue | Decisión versionada y auditable |
| Replay | ¿Cómo evolucionó la situación? | Tiempo / snapshot | Estado histórico y diferencia |
Estructura global de pantalla
La estructura conserva contexto global, vista principal e inspector. En lugar de abrir páginas desconectadas, el usuario cambia de proyección sin perder el objeto seleccionado.
Selección enlazada
La selección no pertenece a una pantalla; pertenece a la sesión de investigación.
Al cambiar de vista se conserva el objeto raíz, el scope, el tiempo y la evidencia seleccionada. Sólo cambia la proyección.
Gramática visual
No se asignará todo al color. Cada canal visual tendrá una responsabilidad para reducir ambigüedad.
| Canal | Representa | Ejemplo |
|---|---|---|
| Forma / icono | Tipo de entidad | Persona, proyecto, lugar, herramienta |
| Banda de color | Proyecto o scope | Palacio, Minerva, Cuitzeo |
| Borde | Estado epistemológico | Confirmado, provisional, disputado |
| Badge | Estado operativo | Activo, bloqueado, cerrado |
| Opacidad / medidor | Confianza | Alta, media, baja, abstención |
| Halo | Atención | Riesgo, cambio reciente, revisión |
| Línea | Naturaleza de relación | Sólida confirmada; punteada inferida |
Mapa de atención
La portada responde qué cambió, qué requiere criterio y por qué. No intenta sustituir las vistas profundas.
Compromiso en riesgo
La dependencia “archivo Designer” sigue sin evidencia y controla el cierre de la incidencia.
Identidad ambigua
¿“Víctor” corresponde a Víctor Alonso dentro de este proyecto y canal?
Cadena detenida
La conversación produjo compromiso, pero no existe aceptación explícita del owner propuesto.
Corrección de tema
Dos bloques logísticos fueron separados del tema técnico tras revisión humana.
Conversation-to-Outcome vertical
Este laboratorio ya no presenta vistas aisladas. Usa un único snapshot versionado y mantiene selección, procedencia y objetos relacionados al navegar entre conversación, proceso, conocimiento, operación y revisión.
Incidencia en Nodo Concentro: sector apagado → archivo Designer → cambio de tema de acceso → controlador fuera de línea → revisión del tablero → evidencia → cierre → propuesta de aprendizaje.
Audit log local
View model v0.4
Snapshot coherente y versionado con mensajes, topics, entidades, trazas, compromisos, grafos, outcome, revisión y procedencia de proyección.
Selección enlazada
Un clic puede saltar del texto a la traza, del commitment al grafo operativo y de la revisión al JSON efectivo.
BFF local
FastAPI sirve el contrato desde FUSI v0.30, aplica scope antes de agregar relaciones y preserva original, revisión, auditoría y proyección efectiva.
Importar, anonimizar y observar una conversación
El laboratorio toma un export de WhatsApp en texto, lo previsualiza, sustituye identidades y PII, persiste únicamente la versión anonimizada y proyecta el resultado real en Conversation Explorer.
0600 y su lectura por API está deshabilitada por defecto.WhatsApp Archive Lab
Preview sin persistencia → commit scoped → pipeline existente → comparación contra fixture.
Parser tolerante
Admite mensajes multilínea, formatos comunes de fecha y timezone explícita.
Anonimización reversible local
El BFF no devuelve el mapa ni retiene el original. La reversibilidad queda fuera del flujo común.
Pipeline real
Usa la ingesta, topic tracking, contexto, semántica, candidatos, revisión y trazas ya existentes.
Conversation Explorer
El texto original sigue siendo el centro. Las capas semánticas se activan como lentes y cada entidad abre información extendida con procedencia.
Estoy en Nodo Concentro. Voy a revisar las luminarias porque una zona sigue apagada.
Avísame si necesitas que mande el archivo de Designer.
Sí, mándalo por favor; sin eso no puedo confirmar si es programación o alimentación.
La entrada por Vallarta está cerrada. Hay que entrar por el estacionamiento norte.
Estados de lectura
Process Trace
La traza explica cómo se llegó a una interpretación. Los nodos muestran primero lo esencial y se expanden para revelar entrada, salida, motor y evidencia.
Simple para comprender, técnico para depurar y causal para ver sólo los pasos que contribuyeron al resultado seleccionado.
Knowledge Graph
El grafo abre en un subgrafo acotado por entidad, scope y tiempo. La línea punteada significa inferencia; no decoramos una sospecha con traje de certeza.
Active Operations Graph
Este grafo no intenta explicar quién es quién; muestra qué trabajo está vivo y qué controla su avance.
Outcome Chain
La vista conecta intención, acción, evidencia y evaluación. Es el antídoto contra celebrar que “se ejecutó un workflow” cuando nadie sabe si cambió algo en la realidad.
Review Inbox, Replay y búsqueda
Review Inbox
Preguntas concretas con propuesta, alternativas, evidencia, impacto y acciones auditables.
Replay
Reconstruye cuándo ocurrió algo y cuándo llegó a saberlo el sistema.
Búsqueda global
Consultas naturales y estructuradas con explicación de por qué cada resultado coincide.
Ejemplo de revisión
Pregunta: ¿“Voy a revisar” es una promesa suficiente para crear compromiso activo?
Propuesta: crear candidato con owner propuesto; promover a activo sólo tras aceptación explícita o regla contextual aprobada.
Impacto: evita atribuir obligaciones sin aceptación y conserva el texto original.
Inspector contextual
El inspector es la interfaz común de significado. No importa si el usuario seleccionó una palabra, nodo, compromiso o etapa: la anatomía conceptual se mantiene.
Peek
Tipo, resumen, estado y una o dos relaciones. Hover, foco o primer toque.
Pinned
Permanece abierto al navegar entre vistas y conserva el objeto raíz.
Deep inspect
Evidencia, historial, versiones, conflictos, dependencias, outcomes y acciones.
Identidad → resumen → estado → confianza → relaciones → evidencia → historia → acciones. La evidencia no debe estar escondida en el sótano de un menú de tres puntos.
Componentes iniciales
<TopicRail />Riel de tema
Delimita bloques, subtemas, cambios y retornos.
<EntityToken />Entidad inline
Anotación activable con estado, tipo y acceso al inspector.
<ContextInspector />Inspector
Resumen, evidencia, relaciones, historia y acciones.
<TraceNode />Nodo de proceso
Estado, duración, input/output y motor responsable.
<EvidenceCard />Evidencia
Fuente, fragmento, tiempo, autoridad y vínculo causal.
<EpistemicBadge />Estado epistemológico
Observado, inferido, confirmado, disputado o supersedido.
<CommitmentCard />Compromiso
Frase, speaker, owner, aceptación, dependencia y evidencia.
<GraphViewport />Subgrafo
Expansión controlada, filtros y posiciones estables.
<BitemporalScrubber />Control temporal
Tiempo de evento frente a tiempo de conocimiento.
Estados que deben diseñarse antes del “happy path”
Confirmado
Existe evidencia y autoridad suficiente.
Provisional
Hipótesis útil, pero requiere validación.
Disputado
Fuentes o revisiones incompatibles.
Abstención
El sistema decide no afirmar por falta de contexto.
Sin resultados
Explica filtros activos y ofrece ampliar scope sin asumir permisos.
Parcial
Algunos modelos o servicios fallaron; muestra qué permanece confiable.
Restringido
No revela nombres, conteos ni huecos que permitan inferir información privada.
Snapshot antiguo
Advierte que el estado visible no corresponde al tiempo presente.
Uso táctil y accesibilidad
Móvil
Navegación en drawer, inspector en bottom sheet, primer toque selecciona, segundo fija; grafos con modo foco y alternativa tabular.
Accesibilidad
No depender sólo del color, contraste AA, teclado, objetivos táctiles amplios, reducción de movimiento y texto original sin overlays.
Contratos agregados para la UI
La UI Query/BFF debe producir vistas coherentes, aplicar permisos antes de construir relaciones y mantener un snapshot común.
GET /ui/attention
GET /ui/conversations/{conversation_key}/explorer
GET /ui/events/{event_id}/trace?detail=simple|technical|causal
GET /ui/entities/{entity_type}/{entity_id}
GET /ui/graphs/knowledge?root=&depth=&time=&scope=
GET /ui/graphs/operations?project=&owner=&outcome=
GET /ui/outcomes/{run_id}/chain
GET /ui/replay?event_time=&knowledge_time=
POST /ui/search
Regla de arquitectura
No recalcula autoridad, confianza, estado de compromiso ni proyección temática. Presenta decisiones del dominio y su explicación.
Agrega, filtra por permisos, construye view models y conserva coherencia temporal. No se convierte en un segundo dominio clandestino.
Roadmap de UX y producto
Fundamentos
- UI Spec
- Arquitectura
- Gramática visual
- Shell
- Contratos BFF iniciales
Conversation → Commitment
- Fixture realista
- Explorer
- Topic blocks
- Inspector
- Process Trace
- Review básica
Operación activa
- Operations Graph
- Dependencias
- Findings
- Ruta crítica
- Intervenciones
Conocimiento y tiempo
- Knowledge Graph
- Assertions
- Conflictos
- Replay
- Snapshots
Outcome y mejora
- Outcome Chain
- Tool Graph
- FUSI/QFUSI/GFUSI
- Aprendizaje
- Comparaciones
Criterios de aceptación del primer vertical
| Dimensión | Criterio | Evidencia requerida |
|---|---|---|
| Funcionalidad | Recorrer mensaje → tema → compromiso → dependencia → outcome. | Fixture reproducible y enlaces bidireccionales |
| Comprensión | Responder “¿de dónde salió este compromiso?” en menos de dos minutos. | Prueba con usuarios y grabación de tarea |
| Legibilidad | El texto original sigue siendo fácil de leer con lentes activas. | Test comparativo original/enriquecido |
| Corrección | Revisar sin borrar silenciosamente el original. | Change set y vista de comparación |
| Seguridad | No mezclar scope ni filtrar datos mediante tooltip, conteos o grafos. | Pruebas de autorización de view models |
| Continuidad | URL restaura scope, tiempo y selección. | Deep link estable |
Riesgos y preguntas incómodas
Sobrecarga visual
Riesgo: demasiadas capas vuelven ilegible la conversación.
Mitigación: lentes, rieles, progressive disclosure e inspector persistente.
Grafo espectacular pero inútil
Riesgo: una galaxia impresionante que no ayuda a resolver el pendiente del martes.
Mitigación: subgrafos orientados a preguntas y función “¿por qué están conectados?”.
Falsa autoridad
Riesgo: una inferencia de alta confianza parece un hecho confirmado.
Mitigación: estado epistemológico, procedencia y autoridad visibles.
Acoplamiento al esquema
Riesgo: la UI se rompe con cada migración.
Mitigación: BFF y view models versionados.
Correcciones con efectos colaterales
Riesgo: corregir identidad o tema invalida relaciones posteriores.
Mitigación: vista previa de impacto, change sets y proyecciones reconstruibles.
v0.5 · Validación observada con conversación real
La v0.4 ya importa, anonimiza y proyecta archivos de WhatsApp en modo database. El siguiente gate no es otro componente: es observar a personas usando una conversación real autorizada, medir comprensión, registrar errores del pipeline y decidir qué merece rediseño.
Schemas tipados
Modelos del Explorer, graph nodes, trace stages y review decisions integrados en el repositorio.
Endpoints agregados
GET /ui/conversations/{key}/explorer, trace, health y decisiones de revisión de laboratorio o base de datos.
Preservación histórica
Original inmutable, decisión auditada, control de revisión y proyección efectiva reconstruible.
Scope fail-closed
La agregación exige contexto explícito en modo database y evita construir nodos, conteos o evidencia fuera del alcance autorizado.
Importación persistida
Preview, anonimización, artifact, eventos, spans, trazas y comparación database/fixture ya están integrados.
Validación humana observada
Comprobar con una conversación real autorizada que alguien puede explicar el caso, detectar errores y corregirlos sin conocer SQL.
Notas de revisión
Estas notas se guardan localmente en el navegador. Sirven para registrar dudas y decisiones mientras recorremos el manual.