3.2 KiB
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
- Editor crea/edita contenido → Estado:
draft - Editor envía para revisión → Estado:
in_review - Revisor valida → Estado:
approved - Super Admin publica → Estado:
published - 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.tsnidrugs.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
- Completar editores del Admin Panel (Protocol, Checklist)
- Validación con TES - Test de 20 min (encontrar X, activar checklist, localizar dosis)
- 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