Planificación

Índice general del plan

Recorrido breve del proyecto. El plan maestro contiene dependencias y criterios verificables; el PLAN del hito actual registra el avance y la siguiente acción.

1. M0 · Cimientos — cerrado

Preparar una base que construya, migre, genere código, pase las verificaciones y responda contra PostgreSQL real.

  1. T0.1 · Migración base: incorporar el DDL completo con Flyway y poder reconstruir el esquema desde cero.
  2. T0.2 · Datos iniciales: separar catálogos y matrices de estado de los datos de demostración.
  3. T0.3 · Transiciones: completar la matriz y probar en PostgreSQL los cambios permitidos y rechazados.
  4. T0.4 · Generación jOOQ: generar y versionar las clases de acceso al esquema mediante un perfil manual.
  5. T0.5 · Puertas de calidad: retirar JPA e incorporar pruebas, arquitectura, cobertura y formato al build.
  6. T0.6 · Recorrido mínimo: servir GET /api/v1/sedes a través de las capas hasta la base real.

2. M1 · Camino clínico nominal — iniciado

Hacer que una orden recorra admisión, muestras, ejecución, validación e informe con trazabilidad. Los 22 slices se leen aquí en grupos; sus criterios de aceptación están en el plan maestro.

  1. Base del flujo
    1. S1.01 · Contexto de ejecución: resolver organización, sede, actor, reloj y errores de dominio. Su primera parte está construida; los requisitos CAP-01 detallan lo pendiente.
    2. S1.02 · Consecutivos: asignar números de documento únicos incluso con solicitudes concurrentes.
    3. S1.03 · Estados: aplicar la matriz de transiciones y registrar cada cambio con su historial.
  2. Admisión y configuración de la orden
    1. S1.04 · Paciente: buscar, registrar y detectar posibles duplicados.
    2. S1.05 · Orden: registrar número, sede, prioridad y estado inicial.
    3. S1.06 · Pruebas y perfiles: expandir perfiles y conservar los datos de la prueba al solicitarla.
    4. S1.07 · Datos clínicos: registrar observaciones estructuradas relevantes para la orden.
    5. S1.08 · Consentimiento: impedir el avance de pruebas que no tengan consentimiento vigente.
  3. Muestras y preparación
    1. S1.09 · Toma y custodia: identificar la muestra y conservar los eventos de su recorrido.
    2. S1.10 · Recepción técnica: aceptar, rechazar o pedir nueva toma con evidencia de la decisión.
    3. S1.11 · Alícuotas: vincular cada prueba con el material que se va a procesar.
    4. S1.12 · Lista de trabajo: mostrar pruebas por sección, prioridad y estado.
    5. S1.13 · Prueba añadida: reutilizar una muestra vigente o exigir otra toma.
  4. Ejecución y resultados
    1. S1.14 · Captura manual: ejecutar la prueba y crear un resultado versionado.
    2. S1.15 · Repetición: conservar ejecuciones previas y elegir la versión vigente.
    3. S1.16 · Referencia y criticidad: seleccionar el intervalo aplicable y calcular banderas y valores críticos.
  5. Validación clínica
    1. S1.17 · Validación: aprobar o devolver una versión concreta del resultado.
    2. S1.18 · Valor crítico: comunicarlo, confirmar o escalar y guardar la evidencia.
  6. Informe y cierre
    1. S1.19 · Emisión: firmar un informe con versiones liberadas y contenido reproducible.
    2. S1.20 · Entrega: registrar canal, destinatario y evidencia sin alterar el resultado clínico.
    3. S1.21 · Corrección: emitir nuevas versiones e informes sin perder el historial publicado.
    4. S1.22 · Tiempos y observabilidad: medir el tiempo de respuesta y trazar decisiones sin datos sensibles.

3. Hitos posteriores — alcance preliminar

El plan maestro define su objetivo y dependencia, pero todavía no desglosa sus tareas definitivas. No todos esperan al hito anterior en esta lista.

  1. M2 · Configuración clínica (después de M1): administrar pruebas, perfiles y reglas de catálogo con vigencias y aprobación.
  2. M3 · Calidad y reglas (después de M2): bloquear procesos ante controles fallidos y registrar reglas reflejas, delta y de autovalidación.
  3. M4 · Cobertura y cobro (después de M1): cotizar, facturar, cobrar y conciliar; documentar excepciones por urgencia.
  4. M5 · Microbiología y derivación (después de M1): seguir cultivos, aislamientos y antibiogramas, además del envío y retorno de pruebas derivadas.
  5. M6 · Inventario y consumo (después de M3): ligar el consumo a su lote y ejecución, actualizar saldos y rechazar lotes vencidos.
  6. M7 · Interfaces y POCT (después de M3): recibir resultados de analizadores con deduplicación y cuarentena; integrar pruebas en el punto de atención.
  7. M8 · Confidencialidad y auditoría (después de M1): restringir resultados sensibles y auditar sus consultas.

4. Pasos que se repiten en cada slice

  1. Especificar: escribir criterios verificables y marcar las preguntas abiertas.
  2. Probar en rojo: demostrar que las pruebas fallan por la razón prevista.
  3. Construir: tipos de dominio → puertos → caso de uso → adaptador jOOQ → API → observabilidad.
  4. Verificar y refactorizar: pasar pruebas, migraciones y reglas de arquitectura sin cambiar el comportamiento.
  5. Revisar y cerrar: revisar fallos y bordes; dejar un commit y actualizar el PLAN.md del hito.

Este índice resume los planes, no los sustituye. Al cambiar el mapa de hitos o los slices, actualiza esta lista junto con PLAN_MAESTRO.md.