Estado actual: S01 en curso · Fase A · 7 de mayo 2026 · próximas dos semanas (S03–S04) levantar Keycloak + Vault + Kafka + observabilidad básica y entregar auth-svc en QA.
9.1 Fases (mayo 2026 – diciembre 2026)
| Fase | Semanas | Estado | Hito | Salidas |
|---|
| A · Cimientos | S01–S08 (mayo–jun) | en curso | Plataforma + Identidad | K3s · Keycloak · Vault · Kafka · auth · audit · bus · notif · identidad-paciente · pasarela-fhir esqueleto |
| B · Núcleo clínico | S09–S18 (jul–sep) | no iniciada | Atención punto a punto | episodios · expediente · ordenes · signos · emergencia · encamamiento · laboratorio · imagen · farmacia · inventario |
| C · Hospitalario completo | S19–S26 (sep–oct) | no iniciada | Cirugía + Obstetricia + Vigilancia | quirofano · obstetricia · vigilancia-epi · nutricion · facturacion · reportes-sigsa |
| D · Administración y entrega | S27–S34 (nov–dic) | no iniciada | Go-live HNSM | rrhh · presupuesto · compras · tableros · pasarela-fhir final · capacitación · DRP · soporte |
9.2 Cronograma detallado por semana · estado real
| Semana | Estado | Trabajo |
|---|
| S01 | en curso | Kickoff · acuerdo de gobernanza HNSM/MSPAS · creación de repos · plantilla de microservicio · entornos DEV. |
| S02 | próxima | QA + STAGING · CI/CD GitHub Actions · ArgoCD · primer despliegue de prueba (servicio hello). |
| S03–S04 | pendiente | Keycloak realm SIH · Vault · Kafka · Mirth · observabilidad básica · primer servicio (auth) en QA. |
| S05–S06 | pendiente | audit · bus · notif desplegados · runbooks v1. |
| S07–S08 | pendiente | identidad-paciente con RENAP · pasarela-fhir esqueleto · primer end-to-end (registro paciente). |
| S09–S10 | pendiente | episodios · expediente-clinico (notas) · primer flujo CE. |
| S11–S12 | pendiente | ordenes-medicas · laboratorio (HL7 lab del HNSM) · F3 completo en QA. |
| S13–S14 | pendiente | signos-vitales (Timescale) · emergencia (triaje) · encamamiento (tablero vivo). |
| S15–S16 | pendiente | farmacia (LBM, alergias) · inventario · F4 completo. |
| S17–S18 | pendiente | imagenologia (DICOM MWL) · piloto Consulta Externa con 1 servicio (Med Interna). |
| S19–S20 | pendiente | quirofano · checklist OMS · F5 en QA. |
| S21–S22 | pendiente | obstetricia · partograma · RN · F7 en QA. |
| S23–S24 | pendiente | vigilancia-epi · nutricion · F8 en QA. |
| S25–S26 | pendiente | facturacion · reportes-sigsa (14 formularios) · primer SIGSA real generado. |
| S27–S28 | pendiente | rrhh · presupuesto (SICOIN) · compras (Guatecompras). |
| S29 | pendiente | tableros Dirección y MSPAS · pasarela-fhir final. |
| S30 | pendiente | pruebas de carga k6 · pentest OWASP ZAP · DRP simulacro. |
| S31 | pendiente | capacitación primera ronda (Admisión, Estadística, Médicos CE). |
| S32 | pendiente | capacitación segunda ronda (ER, Hosp, Quirófano, Obstetricia, Lab, Farmacia, Admin). |
| S33 | pendiente | piloto en producción HNSM · servicio por servicio · monitoreo 24×7. |
| S34 | pendiente | go-live total · cierre formal · inicio soporte 12 meses. |
9.3 Bitácora del proyecto
Registro cronológico de avances reales. Cada entrada es trazable a un commit, deploy, acta o decisión. Esta tabla crece cada semana.
| Fecha | Sem. | Tipo | Avance | Responsable |
|---|
| 07-may-26 | S01 | ARQ | 14 ADRs firmados (ADR-01 a ADR-14) en formato MADR. Publicados en página 11.5 ADRs con contexto, decisión, consecuencias y alternativas. | Toscana · Senior 1 (Giordano) + Toscana · IngenierÃa |
| 07-may-26 | S01 | OPS | WhatsApp enviado a Jeremías (VM Toscana) y Erick (superservidor HNSM) · acceso de infraestructura · resolución esperada 08-may. | Toscana · Senior 1 |
| 07-may-26 | S01 | DOC | Publicado el manual técnico interno (10 secciones + botón 11 bitácora viva). | Toscana · Senior 1 |
| 06-may-26 | S01 | PLAN | Cronograma maestro 34 semanas validado con Subdir Médica HNSM. Fase A inicia. | Toscana · Senior 1 (Giordano) + Toscana · IngenierÃa + HNSM |
| 05-may-26 | S01 | ARQ | ADRs 1–14 adoptados como base. Firma formal completada el 07-may-26 (ver entrada superior). | Toscana · Toscana · IngenierÃa |
| 05-may-26 | S01 | EQUIPO | Equipo Toscana confirmado: Senior 1 (Giordano · Diseño) + Toscana · IngenierÃa (Jeremías · Arquitecto) + 2 Junior + DevOps/QA compartidos. | Toscana · Senior 1 |
| 04-may-26 | S01 | KICKOFF | Inicio formal del proyecto. Acta de gobernanza HNSM/MSPAS firmada. Repos GitHub creados. | Toscana + HNSM + MSPAS |
Cómo se actualiza esta bitácora: al cierre de cada sesión de trabajo (Senior 1 (Giordano) + Toscana · IngenierÃa), se agrega una fila aquí con fecha, semana, tipo (KICKOFF · ARQ · DEV · QA · DEPLOY · DOC · PLAN · INTEGR · OPS · INC · UAT) y el avance concreto. La bitácora es la verdad histórica del proyecto.
9.3 Receta de build (cualquier servicio)
# Local
git clone git@github.com:toscana-sih/sih-<svc>.git
cd sih-<svc>
make up # levanta deps con docker compose
make test # unit + integration con Testcontainers
make run # mvn spring-boot:run con perfil dev
# En CI (GitHub Actions)
on: [push]
jobs:
build:
- mvn verify
- docker build -t ghcr.io/toscana/sih-<svc>:$SHA .
- trivy image ghcr.io/toscana/sih-<svc>:$SHA
- docker push ghcr.io/toscana/sih-<svc>:$SHA
- argocd app sync sih-<svc>-qa
9.4 Receta de despliegue (DEV → QA → STAGING → PROD)
- Merge a
main → CI publica imagen con tag commit.
- ArgoCD sincroniza automáticamente DEV y QA.
- Smoke tests automáticos en QA (Playwright + k6 ligero).
- Promoción manual a STAGING con tag semver (v1.x.y).
- STAGING corre con dataset sintético MSPAS-grade · UAT con champions del HNSM.
- Aprobación firmada (Toscana · IngenierÃa + Subdir Médica HNSM) → ArgoCD aplica a PROD-HNSM.
- Despliegue progresivo (Argo Rollouts canary 10% → 50% → 100% en 30 min).
- Watchdog automático: si error rate > 1 % o p95 > SLO, rollback inmediato.
9.5 Runbook de hito (qué entregar en cada Fase)
| Hito | Demo | Documentación | Métricas |
|---|
| Fin Fase A | Login + registro paciente + envío FHIR Patient a sandbox MSPAS | ADRs · runbooks plataforma · diagrama topológico | Disponibilidad auth ≥ 99.9 % |
| Fin Fase B | Flujo CE completo: cita → consulta → orden lab → resultado → receta → dispensación | Manual de uso CE · Lab · Farmacia · video | Latencia p95 cumplida · 0 incidentes Sev1 |
| Fin Fase C | Cirugía cerrada · Parto cerrado · Caso EPI notificado · SIGSA-1 generado | Manual Quirófano · Obstetricia · Vigilancia · Estadística | SIGSA aceptado por MSPAS · 100 % integraciones |
| Fin Fase D | Tablero Director + ejecución SICOIN + compra Guatecompras importada | Manuales Admin · DRP · plan de soporte | Carga k6: 200 usuarios concurrentes · DRP RTO ≤ 4 h |
9.6 Riesgos y mitigaciones
Conectividad RENAP/SICOIN intermitente → cola con reintento exponencial · cache local · indicador visible.
Resistencia al cambio → champions por servicio · capacitación en 2 rondas · acompañamiento presencial primera semana.
Hardware HNSM heterogéneo → frontend ligero · degradación elegante · listas virtualizadas.
Cambios regulatorios MSPAS → feature flags · plantillas SIGSA versionadas · pasarela-fhir con perfiles versionados.