Saltar a contenido

Canon visual operativo (roles, decisiones y arquitectura)

Objetivo

Definir una unica lamina de referencia para todas las audiencias (no tecnica y tecnica) con flujos operativos, toma de decision y arquitectura por capas.

1. Mapa maestro por capas

flowchart TB
  U[Usuarios\nciudadania | pyme/empresa | entidades financieras | aseguradoras | asesorias de varios oficios | funcionariado | empleado | socio | promotor | inversor | colaborador externo | servicio publico | administraciones | autonomias | ministerios | senados | diputaciones | ayuntamientos | estados europeos (EuroGroup) | universidades y centros de estudio | centros de salud y sanitarios | centros deportivos | industria | social | politica] --> X[Interfaz UX\nportal | chatbot | panel ops]
  X --> R[Razonamiento\nLLM + RAG documental + plantillas auditables]
  R --> D[Datos y gobierno\nordenanzas | BOP | BOE | expedientes | auditoria]
  D --> I[Infraestructura Atlantyqa\nMicroK8s | GitOps | O11y | seguridad | GPU local]
  I --> E[Evidencia y mejora continua\nlogs | metricas | runbooks | retroalimentacion]

2. Grafo canonico de decision humana (HILT)

flowchart LR
  A[Solicitud/accion] --> B{Riesgo}
  B -->|Bajo| C[Ejecucion guiada]
  B -->|Medio| D[Revision de evidencia]
  B -->|Alto o Critico| E[HILT obligatorio]
  D --> F{Cumple contrato}
  E --> F
  F -->|Si| G[Aplicar cambio]
  F -->|No| H[Corregir y revalidar]
  G --> I[Registrar evidencia y decision]
  H --> A

3. Mindmap de experiencia por audiencia

mindmap
  root((Atlantyqa Universe))
    Ciudadania
      movil first
      lenguaje claro
      pasos cortos
      cita de fuente
    Pyme y empresa
      SLA
      cumplimiento
      panel operativo
      soporte guiado
    Entidades financieras y aseguradoras
      cumplimiento regulatorio
      riesgo controlado
      trazabilidad de decisiones
      continuidad de servicio
    Asesorias de varios oficios
      flujo multi-cliente
      evidencia documental
      procesos repetibles
      soporte especializado
    Funcionariado
      trazabilidad
      checklist operativo
      decision HILT
      auditoria exportable
    Servicio publico y administraciones
      evidencia de cumplimiento
      procesos auditables
      decisiones trazables
      continuidad del servicio
    Ministerios, senados y diputaciones
      gobernanza multinivel
      evidencia regulatoria
      coordinacion interinstitucional
      continuidad administrativa
    Autonomias y estados europeos (EuroGroup)
      alineacion territorial
      interoperabilidad normativa
      comparabilidad de indicadores
      cooperacion transfronteriza
    Ayuntamientos
      tramites frecuentes
      atencion ciudadana
      orientacion normativa
      medicion de tiempos
    Universidades y centros de estudio
      itinerario de aprendizaje
      laboratorios guiados
      competencias digitales
      evidencia academica
    Centros de salud y sanitarios
      claridad operativa
      prioridad de seguridad
      trazabilidad de uso
      protocolos visibles
    Centros deportivos
      operativa sencilla
      turnos y servicios
      comunicacion clara
      soporte rapido
    Industria
      fiabilidad operativa
      integracion de procesos
      control de riesgo
      eficiencia de ciclo
    Social y politica
      transparencia
      explicabilidad
      gobernanza participativa
      decision humana explicita
    Empleado
      entrega diaria
      estado de tareas
      evidencia operativa
      soporte por rol
    Socio
      estado de hitos
      riesgo compartido
      decision de continuidad
      visibilidad ejecutiva
    Promotor
      roadmap y entregables
      avance verificable
      riesgos y mitigacion
      narrativa institucional
    Inversor
      indicadores de adopcion
      riesgo y cumplimiento
      evidencia de ejecucion
      horizonte de crecimiento
    Colaborador externo
      onboarding guiado
      alcance limitado
      control de permisos
      aprobacion de tutor
    Pre-venta y reventa
      propuesta clara
      oferta por perfil
      validacion de alcance
      handoff a delivery
    Comunicaciones
      narrativa consistente
      mensajes aprobados
      control reputacional
      trazabilidad publica
    Soporte y atencion al usuario
      resolucion rapida
      base de conocimiento
      escalado por riesgo
      cierre verificable
    Desarrolladores
      entrega incremental
      pruebas locales
      CI en verde
      evidencia de cambios
    Coordinadores y lideres
      priorizacion
      gestion de dependencias
      decision HILT
      seguimiento de KPIs
    Educacion y talento
      ruta 101
      laboratorio guiado
      practica reproducible
      evidencia de aprendizaje
    Ops y arquitectura
      GitOps
      FSM por capas
      observabilidad
      rollback seguro

4. Contrato de no-duplicidad documental

  1. Esta pagina es el punto canonico para arquitectura visual y decision.
  2. portal/global-vision-role-based-experience.md amplia segmentacion de perfiles.
  3. portal/human-agent-interaction-model.md detalla el contrato operativo humano-maquina.
  4. internal/microk8s-runtime-audience-views.md aterriza runtime tecnico interno.
  5. Si hay conflicto narrativo, prevalece este canon y se corrige el resto por PR.

5. Salida minima por tipo de audiencia

Audiencia Entrada principal Salida minima Prueba de valor
Ciudadania webapp movil respuesta con pasos + fuente tiempo de tarea y comprension
Pyme/empresa portal de servicios estado, SLA, accion siguiente menos friccion operativa
Entidades financieras/aseguradoras portal regulado control de riesgo + cumplimiento + evidencia continuidad y confianza
Asesorias (varios oficios) panel profesional expediente + checklist + trazabilidad productividad y menor error
Funcionariado portal autenticado checklist + borrador + evidencia reduccion de errores repetitivos
Servicio publico/administraciones/ayuntamientos portal institucional trazabilidad + cumplimiento + evidencia mejor atencion y menor tiempo de resolucion
Ministerios/senados/diputaciones panel institucional control normativo + decision + evidencia coordinacion y legitimidad operativa
Autonomias/estados europeos (EuroGroup) panel multinivel alineacion regulatoria + indicadores + evidencia gobernanza territorial y europea
Empleado panel de trabajo estado + prioridad + accion siguiente continuidad de entrega
Socio vista ejecutiva hitos + riesgo + decision alineacion estrategica
Promotor panel de programa roadmap + evidencia + desviaciones capacidad de impulso
Inversor panel de confianza KPI + riesgo + cumplimiento confianza de inversion
Colaborador externo onboarding + tablero de tareas alcance acotado + checklist + aprobacion colaboracion segura
Pre-venta/reventa hub comercial + trust pack propuesta + alcance + handoff conversion y continuidad
Soporte/atencion usuario mesa de soporte ticket + diagnostico + accion tiempo medio de resolucion
Comunicaciones hub de narrativa mensaje aprobado + evidencia coherencia institucional
Desarrolladores VSCode/CLI + PR cambio probado + evidencia CI calidad de entrega
Coordinadores/lideres panel ejecutivo/operativo decision + prioridad + seguimiento foco y gobernanza
Universidades/centros de estudio ruta de aprendizaje practica validada + reporte adopcion y continuidad
Centros de salud/sanitarios/deportivos panel de operacion accion clara + estado + escalado continuidad de servicio
Industria panel de ciclo de vida alerta + accion + registro estabilidad operativa
Social/politica vista de governance decision + evidencia + explicacion confianza y legitimidad
Ops/tech runbooks + CLI logs, artefactos y rollback fiabilidad del ciclo de vida

6. Uso en validacion local-first

  1. Validar narrativa y flujos: python3 scripts/verify/citizen_hmi_ux_guard.py
  2. Validar routing por rol: python3 scripts/verify/citizen_role_routing_contract_guard.py
  3. Validar plantillas de cita y auditoria RAG: python3 scripts/verify/rag_citation_audit_template_guard.py
  4. Ejecutar bateria UAT local: bash scripts/proxmox/local_uat_battery.sh --env-file env.dev.local