# 🎛️ 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