Fundamentos

LIS — punto de entrada

Sistema de Información de Laboratorio Clínico. Java 25 · Spring Boot 4.1 · jOOQ · Flyway · PostgreSQL 18. El dominio se escribe en español.

Lee esto antes de tocar código

  1. docs/00-agents.md — constitución de ingeniería. Reglas de arquitectura, del dominio clínico, de base de datos y de testing. Si una instrucción de la sesión la contradice, gana el documento y se avisa.
  2. PLAN.md — el hito en curso y su siguiente acción.
  3. docs/PLAN_MAESTRO.md — decisiones fundacionales, mapa de hitos y slices.
  4. docs/MARCO.md — cómo se trabaja: bucles, roles, puertas, DoD.

Referencia del dominio

docs/LIS_marco_conceptual_unificado.md (lenguaje ubicuo y reglas RN-xx) · docs/LIS_procesos_procedimientos_flujos_casos_uso.md (procesos PO-xx y casos CU-xx) · docs/LIS_propuesta_modelo_datos_postgresql_18.md y su DDL · docs/adr/ (decisiones) · DESIGN_claude.md (diseño de pantallas, para cuando llegue la UI).

No se inventan requisitos ni reglas clínicas. Si algo no está en esos documentos, es una pregunta, no una decisión de implementación.

Comandos

make lista todo con su descripción. Los de cada día:

Comando Para qué
make dev Postgres, pgAdmin y Grafana/OTel
make doctor Estado de contenedores, puertos y esquema
make verify La puerta completa: compila, tests, arquitectura, cobertura, formato
make migrate · make db-reset Aplicar migraciones · reconstruir el esquema desde cero
make demo Cargar la jornada de demostración (reproducible: vacía antes de sembrar)
make jooq-codegen Regenerar las clases jOOQ tras cambiar el esquema
make run Arrancar la app con el perfil dev (usuario lis/lis)
make dev-full Todo lo anterior en orden y la app en primer plano
make curls Ejercer la API con los .http de wiki/http, con sus aserciones

Los .http de wiki/http no son documentación: llevan aserciones y make curls falla si una no se cumple. Una de ellas detectó un fallo que los tests de MockMvc no veían, así que un cambio en el borde HTTP se comprueba en los dos sitios.

No está terminado hasta que make verify pasa en verde, y hasta haber mostrado la salida real del comando, no una descripción de lo que debería pasar.