107 lines
3.2 KiB
Markdown
107 lines
3.2 KiB
Markdown
# 🎛️ 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
|
|
|