planetazuzu/codigo0
1
0
Fork 0
Code Issues Pull requests Actions 1 Packages Projects Releases Wiki Activity
codigo0/docs/CHECKLIST_LIMPIEZA_MARKDOWN.md
planetazuzu a26963654f Implementación completa: Guías de Refuerzo (Modo Formativo) 
- Arquitectura paralela para Guías de Refuerzo
- Nuevos componentes: GuideCard, GuideHeader, GuideNavigation, etc.
- Vistas formativas: GuideIndex, GuideViewer, GuideSectionViewer
- Layout específico GuideLayout (sin BottomNav)
- Índice de guías con ABCDE Operativo y RCP Adulto SVB
- Corrección de Service Worker para desarrollo
- Enlaces de navegación en menú y página principal
- Documentación completa de implementación
2025-12-27 19:29:00 +01:00

320 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 📋 Checklist de Limpieza Markdown - Paso 2
**Objetivo:** Dejar el sistema Markdown estable, coherente y defendible
**Fecha:** 2025-12-23
**Estado:** Listo para ejecución
---
## 🎯 Decisiones Firmes (Ya No Se Discuten)
### ✅ Markdown se mantiene como:
- Manual base
- Referencia textual
- Fuente editorial estable
- Soporte offline
### ❌ Markdown NO será:
- Sistema multimedia
- Guía educativa rica
- Lugar para casos clínicos complejos
👉 **Eso vendrá después con la Guía de Refuerzo.**
---
## 🔴 BLOQUE A — OBLIGATORIO
**Si no haces esto, todo lo demás se vuelve frágil.**
### A1. Renombrado de Archivos con Numeración Anómala
**Archivos afectados:** 9 archivos
| Archivo Actual | Nuevo Nombre | Acción |
|----------------|--------------|--------|
| `BLOQUE_02_X_INVENTARIO_MATERIAL.md` | `BLOQUE_02_14_INVENTARIO_MATERIAL.md` | Renombrar |
| `BLOQUE_03_X_INVENTARIO_MATERIAL_SANITARIO.md` | `BLOQUE_03_19_INVENTARIO_MATERIAL_SANITARIO.md` | Renombrar |
| `BLOQUE_03_X2_MALETIN_CURAS.md` | `BLOQUE_03_20_MALETIN_CURAS.md` | Renombrar |
| `BLOQUE_03_X3_BOLSA_MONITORIZACION.md` | `BLOQUE_03_21_BOLSA_MONITORIZACION.md` | Renombrar |
| `BLOQUE_03_X4_INVENTARIO_GLOBAL.md` | `BLOQUE_03_22_INVENTARIO_GLOBAL.md` | Renombrar |
| `BLOQUE_03_X5_CHECKLIST_MAESTRO.md` | `BLOQUE_03_23_CHECKLIST_MAESTRO.md` | Renombrar |
| `BLOQUE_03_99_CIERRE_BLOQUE_3.md` | `BLOQUE_03_24_CIERRE_BLOQUE_3.md` | Renombrar |
| `BLOQUE_04_0B_RECONOCIMIENTO_PCR.md` | `BLOQUE_04_0_RECONOCIMIENTO_PCR.md` | Renombrar |
| `BLOQUE_04_0_ACCESO_VASCULAR_BASICO.md` | `BLOQUE_04_10_ACCESO_VASCULAR_BASICO.md` | Renombrar (después de renombrar 0B) |
| `BLOQUE_05_0B_PROTOCOLOS_EMERGENCIAS_ESPECIFICAS.md` | `BLOQUE_05_9_PROTOCOLOS_EMERGENCIAS_ESPECIFICAS.md` | Renombrar |
**Orden de ejecución:**
1. ✅ Renombrar todos los archivos (comando `mv` o desde IDE)
2. ✅ Actualizar `src/data/manual-index.ts` con nuevas rutas
3. ✅ Verificar que la app carga sin errores
4. ✅ Verificar que no hay enlaces rotos
**⏱️ Tiempo estimado:** 45-60 minutos
---
### A2. Corrección de Títulos (Mayúsculas + Paréntesis)
**Archivos afectados:** 12 archivos
#### Mayúsculas Inconsistentes (8 archivos)
| Archivo | Título Actual | Corrección |
|---------|--------------|------------|
| `BLOQUE_04_3_RCP_LACTANTES.md` | `# 4.3 – Rcp Básica en Lactantes` | `# 4.3 – RCP Básica en Lactantes` |
| `BLOQUE_04_4_USO_DESA.md` | `# 4.4 – Uso del Desa` | `# 4.4 – Uso del DESA` |
| `BLOQUE_04_5_RCP_DOS_INTERVINIENTES.md` | `# 4.5 – Rcp con Dos Intervinientes` | `# 4.5 – RCP con Dos Intervinientes` |
| `BLOQUE_04_7_OVACE_PEDIATRIA.md` | `# 4.7 – Ovace en Pediatría` | `# 4.7 – OVACE en Pediatría` |
| `BLOQUE_04_8_OVACE_LACTANTES.md` | `# 4.8 – Ovace en Lactantes` | `# 4.8 – OVACE en Lactantes` |
| `BLOQUE_05_2_OVACE_TRANSTELEFONICA.md` | `# 5.2 – Ovace Transtelefónica` | `# 5.2 – OVACE Transtelefónica` |
| `BLOQUE_04_0B_RECONOCIMIENTO_PCR.md` | `# 4.0 – Reconocimiento de la Parada Cardiorrespiratoria (Pcr)` | `# 4.0 – Reconocimiento de la Parada Cardiorrespiratoria (PCR)` |
**Regla:** Acrónimos siempre en mayúsculas: RCP, OVACE, DESA, PCR, ABCDE, START
#### Paréntesis Redundantes (4 archivos)
| Archivo | Título Actual | Corrección |
|---------|--------------|------------|
| `BLOQUE_03_11_GLUCOMETRO.md` | `# 3.11 – Glucómetro y Control de Glucemia: Uso Operativo (Tes)` | `# 3.11 – Glucómetro y Control de Glucemia: Uso Operativo` |
| `BLOQUE_03_9_EXPOSICION_AISLAMIENTO_TERMICO.md` | `# 3.9 – Exposición, Aislamiento Térmico y Prevención de Hipotermia (Operativo Tes)` | `# 3.9 – Exposición, Aislamiento Térmico y Prevención de Hipotermia` |
| `BLOQUE_03_99_CIERRE_BLOQUE_3.md` | `# 3.99 – Cierre del Bloque 3: Uso Operativo del Material en Intervención (Tes)` | `# 3.99 – Cierre del Bloque 3: Uso Operativo del Material en Intervención` |
| `BLOQUE_03_2_ASPIRACION.md` | `# 3.2 – Aspiración: Material y Uso Seguro (Operativo Tes)` | `# 3.2 – Aspiración: Material y Uso Seguro` |
**Regla:** Eliminar "(Tes)" y "(Operativo Tes)". El tipo se indica en YAML.
**⏱️ Tiempo estimado:** 30-40 minutos
---
### A3. YAML Mínimo en Protocolos Críticos
**Archivos afectados:** 10 archivos
**YAML a añadir (solo esto):**
```yaml
---
tipoContenido: "operativo"
capaApp: "operativa"
---
```
**Archivos:**
| Archivo | Ubicación |
|---------|-----------|
| `BLOQUE_04_1_RCP_ADULTOS.md` | Al inicio del archivo (después de título si no hay YAML) |
| `BLOQUE_04_2_RCP_PEDIATRIA.md` | Al inicio del archivo |
| `BLOQUE_04_3_RCP_LACTANTES.md` | Al inicio del archivo |
| `BLOQUE_04_4_USO_DESA.md` | Al inicio del archivo |
| `BLOQUE_04_6_OVACE_ADULTOS.md` | Al inicio del archivo |
| `BLOQUE_04_7_OVACE_PEDIATRIA.md` | Al inicio del archivo |
| `BLOQUE_04_8_OVACE_LACTANTES.md` | Al inicio del archivo |
| `BLOQUE_01_1_CONSTANTES_VITALES.md` | Al inicio del archivo |
| `BLOQUE_01_2_ABCDE_OPERATIVO.md` | Al inicio del archivo |
| `BLOQUE_01_3_GLASGOW_OPERATIVO.md` | Al inicio del archivo |
**Nota:** Si el archivo ya tiene YAML, solo añadir estas dos líneas si faltan.
**⏱️ Tiempo estimado:** 30 minutos
---
## 🟠 BLOQUE B — IMPORTANTE
**Mejora calidad, pero no rompe nada si se retrasa.**
### B1. YAML Mínimo al Resto de Archivos Operativos
**No hacerlo todo de golpe. Hacerlo por bloques:**
**Orden sugerido:**
1. **BLOQUE_4** (resto de archivos) - 3 archivos
2. **BLOQUE_1** (resto de archivos) - 1 archivo
3. **BLOQUE_2** - 14 archivos
4. **BLOQUE_3** (resto de archivos) - ≈20 archivos
5. **BLOQUE_5** - 10 archivos
6. **BLOQUE_7** - 6 archivos
7. **BLOQUE_8** - 5 archivos
**YAML a añadir:**
```yaml
---
tipoContenido: "operativo"
capaApp: "operativa"
---
```
**Excepciones (archivos formativos):**
| Archivo | tipoContenido | capaApp |
|---------|---------------|---------|
| `BLOQUE_00_0_FUNDAMENTOS_EMERGENCIAS.md` | `formativo` | `refuerzo` |
| `BLOQUE_12_0_MARCO_LEGAL_ETICO_PROFESIONAL.md` | `formativo` | `refuerzo` |
| `BLOQUE_13_0_COMUNICACION_RELACION_PACIENTE.md` | `formativo` | `refuerzo` |
| `BLOQUE_14_0_SEGURIDAD_PERSONAL_SALUD_TES.md` | `formativo` | `refuerzo` |
| `BLOQUE_15_0_INTRODUCCION_ALTERACIONES_PSIQUIATRICAS.md` | `formativo` | `refuerzo` |
| `BLOQUE_09_0_MEDICINA_EMERGENCIAS_APLICADA.md` | `mixto` | `ambas` |
| `BLOQUE_10_0_SITUACIONES_ESPECIALES.md` | `mixto` | `ambas` |
**Archivos de referencia (inventarios, checklists):**
| Archivo | tipoContenido | capaApp |
|---------|---------------|---------|
| `BLOQUE_02_14_INVENTARIO_MATERIAL.md` | `referencia` | `anexos` |
| `BLOQUE_03_19_INVENTARIO_MATERIAL_SANITARIO.md` | `referencia` | `anexos` |
| `BLOQUE_03_20_MALETIN_CURAS.md` | `referencia` | `anexos` |
| `BLOQUE_03_21_BOLSA_MONITORIZACION.md` | `referencia` | `anexos` |
| `BLOQUE_03_22_INVENTARIO_GLOBAL.md` | `referencia` | `anexos` |
| `BLOQUE_03_23_CHECKLIST_MAESTRO.md` | `referencia` | `anexos` |
| `BLOQUE_06_7_ABREVIATURAS_TERMINOLOGIA_FARMACOLOGICA.md` | `referencia` | `anexos` |
**⏱️ Tiempo estimado:** 1-2 sesiones cortas (30-45 min cada bloque)
---
### B2. Enlaces "Ver También" SOLO en Capítulos Troncales
**❌ NO enlaces todo con todo**
**❌ NO conviertas esto en Wikipedia**
**✔ Solo en estos archivos principales:**
| Archivo | Enlaces Recomendados (máx. 5) |
|---------|------------------------------|
| `BLOQUE_04_1_RCP_ADULTOS.md` | → `BLOQUE_04_2_RCP_PEDIATRIA.md`<br>→ `BLOQUE_04_3_RCP_LACTANTES.md`<br>→ `BLOQUE_04_4_USO_DESA.md`<br>→ `BLOQUE_03_1B_VENTILACION_BOLSA_MASCARILLA.md` |
| `BLOQUE_04_6_OVACE_ADULTOS.md` | → `BLOQUE_04_7_OVACE_PEDIATRIA.md`<br>→ `BLOQUE_04_8_OVACE_LACTANTES.md` |
| `BLOQUE_01_2_ABCDE_OPERATIVO.md` | → `BLOQUE_01_1_CONSTANTES_VITALES.md`<br>→ `BLOQUE_01_3_GLASGOW_OPERATIVO.md` |
| `BLOQUE_03_0_OXIGENOTERAPIA_COMPLETA.md` | → `BLOQUE_03_1B_VENTILACION_BOLSA_MASCARILLA.md`<br>→ `BLOQUE_03_4_CANULAS.md` |
| `BLOQUE_03_4_CANULAS.md` | → `BLOQUE_03_1B_VENTILACION_BOLSA_MASCARILLA.md`<br>→ `BLOQUE_03_2_ASPIRACION.md` |
**Formato estándar:**
```markdown
---
## Relación con Otros Capítulos
- **4.2 – RCP Básica en Pediatría** (variante pediátrica)
- **4.4 – Uso del DESA** (equipamiento relacionado)
- **3.1 – Ventilación con Bolsa-Mascarilla** (técnica relacionada)
```
**⏱️ Tiempo estimado:** 45 minutos
---
## 🟢 BLOQUE C — OPCIONAL
**NO hacer ahora. Esto NO bloquea nada y puede esperar.**
- ❌ Navegación anterior/siguiente
- ❌ Índices por bloque
- ❌ Metadatos extra (nivelDificultad, importancia, palabrasClave)
- ❌ Notas de "desarrollo futuro"
**📌 Recomendación:** No lo hagas ahora. Te distrae del objetivo.
---
## ❌ Qué NO Hacer en el Paso 2
**Muy importante:**
- ❌ **NO dividir** capítulos largos
- ❌ **NO fusionar** capítulos salvo duplicados claros
- ❌ **NO mover** carpetas
- ❌ **NO reescribir** texto
- ❌ **NO adaptar** aún al modelo de Guía de Refuerzo
👉 **Todo eso viene después, con criterio y calma.**
---
## ✅ Resultado Esperado al Terminar el Paso 2
Cuando acabes el Paso 2, tu sistema tendrá:
- ✅ Numeración limpia y predecible
- ✅ Títulos coherentes
- ✅ Tipos de contenido explícitos
- ✅ Manual defendible como documento profesional
- ✅ Base sólida para:
- Refactor futuro
- Guía de refuerzo
- Renderers más ricos
---
## 🎯 Señal Clara de que Puedes Pasar al Paso 3
**Cuando se cumplan estas 4 cosas:**
1. ✅ **No queda ningún archivo** X / X2 / 0B / 99
2. ✅ **Todos los títulos** de RCP / OVACE están bien escritos
3. ✅ **Los protocolos críticos** tienen YAML
4. ✅ **La app carga** sin enlaces rotos
👉 **PARA.**
👉 **No sigas limpiando.**
👉 **Escríbeme y pasamos al Paso 3.**
---
## 📝 Orden de Ejecución Recomendado
### Sesión 1: Bloque A Completo (≈2 horas)
1. **A1:** Renombrar archivos (45-60 min)
- Renombrar todos los archivos
- Actualizar `manual-index.ts`
- Verificar carga
2. **A2:** Corregir títulos (30-40 min)
- Buscar y reemplazar mayúsculas
- Eliminar paréntesis redundantes
- Verificar formato
3. **A3:** Añadir YAML crítico (30 min)
- Añadir YAML a 10 archivos críticos
- Verificar formato válido
**✅ Al finalizar:** Verificar que la app funciona correctamente.
---
### Sesión 2: Bloque B (cuando tengas tiempo)
1. **B1:** YAML por bloques (1-2 sesiones)
- Empezar por BLOQUE_4
- Continuar con otros bloques cuando puedas
2. **B2:** Enlaces "Ver También" (45 min)
- Solo en archivos principales
- Máximo 5 enlaces por archivo
---
## ✅ Checklist de Verificación Final
Antes de considerar completado el Paso 2:
- [ ] Todos los archivos con numeración especial renombrados (9 archivos)
- [ ] Todos los títulos con mayúsculas consistentes (8 archivos)
- [ ] Todos los títulos sin paréntesis redundantes (4 archivos)
- [ ] YAML mínimo añadido a protocolos críticos (10 archivos)
- [ ] `manual-index.ts` actualizado con nuevas rutas
- [ ] Sin enlaces rotos en la aplicación
- [ ] La app carga sin errores
**Si todo está marcado:** ✅ **Paso 2 completado. Listo para Paso 3.**
---
**Fin del Checklist - Paso 2**
*Este documento debe actualizarse conforme se completen las acciones.*
Reference in a new issue View git blame Copy permalink