codigo0/docs/ESPECIFICACION_ADMIN_PANEL_STAKEHOLDERS.md

3.2 KiB

🎛️ ESPECIFICACIÓN: PANEL DE ADMINISTRACIÓN DE CONTENIDO

Versión: 1.0 | Fecha: 2025-01-05 | Estado: Implementado (Backend + Estructura UI)


🎯 OBJETIVO

Permitir editar contenido clínico (protocolos, guías, vademécum, checklists) sin modificar código de la app, manteniendo la PWA offline-first y sin romper funcionalidad existente.


GARANTÍAS CRÍTICAS

  • NO se modifica código de búsqueda ni Service Worker
  • NO se rompe funcionalidad offline existente
  • NO se cambian rutas ni estructura de la app
  • Versionado completo - Todo cambio es reversible
  • Validación clínica - Workflow de revisión antes de publicar

🏗️ ARQUITECTURA

Backend ( Completo)

  • API REST con autenticación JWT
  • 5 roles: Super Admin, Editor Clínico, Editor Formativo, Revisor, Viewer
  • CRUD completo con versionado y auditoría
  • Content Pack versionado para distribución a la app

Admin Panel (🚧 Estructura lista, editores pendientes)

  • Web app React separada (no modifica app principal)
  • Login y navegación funcionales
  • Editores especializados (en desarrollo):
    • Protocolo con vista previa "modo TES"
    • Checklist reutilizable
    • Guía Markdown con preview
    • Manager de Vademécum
  • Auditoría de cambios y versiones

Integración App Principal ( Servicio listo)

  • Sistema de "override": Content pack > Contenido local
  • Funciona offline con cache del último pack
  • Hooks React para usar contenido con override automático

📊 FLUJO DE TRABAJO

  1. Editor crea/edita contenido → Estado: draft
  2. Editor envía para revisión → Estado: in_review
  3. Revisor valida → Estado: approved
  4. Super Admin publica → Estado: published
  5. App consume automáticamente el content pack publicado

🔐 SEGURIDAD Y CONTROL

  • Autenticación con JWT
  • Permisos granulares por rol
  • Log de auditoría de todos los cambios
  • Versionado con posibilidad de revertir
  • Validación clínica obligatoria antes de publicar

📈 BENEFICIOS

  • Actualización rápida de contenido sin despliegues
  • Control de versiones clínico
  • Trazabilidad completa de cambios
  • Sin riesgo de romper funcionalidad crítica
  • Offline-first mantenido

⚠️ RESTRICCIONES

  • NO toca búsqueda ni Service Worker
  • NO modifica procedures.ts ni drugs.ts
  • NO cambia rutas existentes
  • Solo integración controlada del content pack

🚀 ESTADO ACTUAL

  • Backend: Completo y funcional
  • Modelo de datos: Extendido sin romper compatibilidad
  • Content Pack: Sistema de override implementado
  • 🚧 Admin Panel UI: Estructura lista, editores en desarrollo
  • Seed data: 2 protocolos y 3 checklists de ejemplo

📋 PRÓXIMOS PASOS

  1. Completar editores del Admin Panel (Protocol, Checklist)
  2. Validación con TES - Test de 20 min (encontrar X, activar checklist, localizar dosis)
  3. Priorización Fase 1 - Matriz impacto/riesgo/esfuerzo (3-4 objetivos máximo)

Aprobación requerida para: Desarrollo de editores específicos y validación con TES