codigo0/docs/ESPECIFICACION_EJECUTIVA_1PAGINA.md

75 lines
2.5 KiB
Markdown
Raw Normal View History

2026-01-19 08:10:16 +00:00
# 🎛️ PANEL DE ADMINISTRACIÓN DE CONTENIDO - ESPECIFICACIÓN EJECUTIVA
**Versión**: 1.0 | **Fecha**: 2025-01-05 | **Estado**: ✅ Backend Completo | 🚧 UI en Desarrollo
---
## 🎯 OBJETIVO
Permitir **editar contenido clínico** (protocolos, guías, vademécum, checklists) **sin modificar código de la app**, manteniendo la PWA offline-first.
---
## ✅ 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
---
## 🏗️ COMPONENTES
| Componente | Estado | Descripción |
|------------|--------|-------------|
| **Backend API** | ✅ Completo | REST API con auth JWT, CRUD, versionado, auditoría |
| **Admin Panel** | 🚧 Estructura lista | Web app React separada, login funcional, editores pendientes |
| **Content Pack** | ✅ Implementado | Sistema de override (pack > local), funciona offline |
| **Integración App** | ✅ Hooks listos | Hooks React para usar contenido con override automático |
---
## 📊 FLUJO DE TRABAJO
**Editor** → Crea/edita (`draft`) → Envía revisión (`in_review`) → **Revisor** valida (`approved`) → **Super Admin** publica (`published`) → **App** consume automáticamente
---
## 🔐 SEGURIDAD
- Autenticación JWT con 5 roles (Super Admin, Editor Clínico, Editor Formativo, Revisor, Viewer)
- Permisos granulares por rol
- Log de auditoría completo
- Versionado con posibilidad de revertir
- Validación clínica obligatoria
---
## 📈 BENEFICIOS
✅ Actualización rápida sin despliegues | ✅ Control de versiones clínico | ✅ Trazabilidad completa | ✅ Sin riesgo de romper funcionalidad crítica | ✅ Offline-first mantenido
---
## 🚀 ESTADO ACTUAL
-**Backend**: Completo y funcional
-**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