Sistema de gestión de un banco de cepas microbianas
Un sistema de información para el cepario: identidad y linaje de cada cepa, sus existencias y su ubicación física, el trabajo diario del laboratorio y la actividad biológica que la respalda, con trazabilidad de todo lo que pasa.
Desplegado con una carga inicial de los datos existentes y en los primeros usos por I+D.
- Modelado de un dominio científico con su vocabulario real: identidad, linaje, existencias y actividad biológica de un organismo vivo.
- Del correo de una petición a un sistema completo en unas seis semanas, con el diseño escrito y validado antes del código.
- Los datos existentes convertidos en el punto de partida, con decisiones revisables y controles de cobertura y carga.
El banco de cepas vivía en una hoja de cálculo que había crecido sin modelo.
No hacer una versión bonita de la hoja, sino el sistema de información del cepario: separar la identidad de la cepa de su existencia física, estructurar la actividad biológica con su evidencia y diseñarlo todo antes de escribir el primer modelo.
Una aplicación más de la plataforma común: sin login propio, la identidad y los permisos los da la intranet. Modelos y servicios de dominio separados de las vistas; cada operación pasa por un servicio que escribe a la vez el dato, el evento legible y el histórico.
- La cepa y la alícuota son entidades distintas: la identidad biológica no es el vial que la contiene, y la genealogía de resiembras vive en las alícuotas.
- La afirmación científica separada de la evidencia que la respalda, con estados de validación y registro de quién valida y cuándo.
- Los datos existentes, cargados desde el día cero con una migración en dos fases, revisión humana y comprobaciones de cobertura y coherencia de la carga.
Las evidencias20
- Modelado de dominioDecisión escrita · Confidencial
La identidad biológica de la cepa se separa de su existencia física, y la actividad biológica de las evidencias que la respaldan: planos distintos de una misma entidad, cada uno con su linaje y su trazabilidad.
- Dominio agronómico y regulatorioCódigo · Confidencial
- Análisis de requisitos de negocioDocumento · Confidencial
- ETL e ingesta de datosCódigo · Confidencial
- Tests de regresión y equivalenciaCódigo · Confidencial
- Integridad de datosCódigo · Confidencial
- Gobierno del dato (data governance)Código · Confidencial
- Modelado minimalista (YAGNI)Decisión escrita · Confidencial
- Gestión del alcanceDecisión escrita · Confidencial
- Registros de decisiones de arquitectura (ADR)Documento · Confidencial
- Diseño de UX para usuarios no técnicosCódigo · Confidencial
- Sistema de diseñoDocumento · Confidencial
- Arquitectura por capas (capa de servicios)Código · Confidencial
- Relaciones polimórficasCódigo · Confidencial
- Internacionalización (i18n)Código · Confidencial
- Entrega rápida con IA sin perder calidadMétrica · Confidencial
- Auditoría técnica y retrospectivasDocumento · Confidencial
- Desarrollo web full stackCódigo · Confidencial
- Comunicación con perfiles no técnicosDocumento · Confidencial
- Aprendizaje rápidoDocumento · Confidencial
Principios que se ven aquí17
- PrincipioCuando migro o refactorizo, verifico la equivalencia con código, no con confianza
- La migración de la hoja del cepario comprueba que cada fila del original acaba en una cepa o una alícuota, y contrasta la base de datos cargada con el artefacto intermedio
- PrincipioEl modelo de datos primero, la herramienta después
- La cepa es una entidad con identidad y linaje propios, no una línea de inventario; vocabulario regulatorio real
- El vial no se modela porque la unidad de trabajo es la alícuota, y la migración de los datos existentes se adapta al modelo, no al revés
- PrincipioCuando el uso contradice el modelo, se rehace el modelo — y se escribe por qué
- Se revirtió la restricción de transiciones de estado, pero se mantuvo el motivo obligatorio en las sensibles: se pide el porqué, no se limita la opción
- PrincipioUna decisión sin su porqué es una decisión que se va a repetir mal
- Decisiones de modelo consolidadas, marcando las que tienen riesgo de volver a discutirse, y la reversión de una decisión como entrada nueva que cita la anterior
- PrincipioLo difuso se resuelve en el borde; el núcleo es determinista
- En la migración, lo dudoso no se resuelve en caliente: queda como decisión revisable que el laboratorio corrige antes de cargar
- PrincipioLa petición no es el requisito: primero el problema que hay detrás
- El encargo era consultar una hoja de cálculo con permisos; el análisis de la hoja real llevó a un sistema de información completo, validado con el departamento
- PrincipioLo que se puede calcular no se escribe a mano
- El pase de una alícuota lo deriva el servicio y las existencias son la suma de los movimientos: ninguno de los dos se teclea
- PrincipioLo seguro es el camino por defecto, y se garantiza en un solo sitio
- Los movimientos de existencias pasan por un único servicio, que rechaza las salidas superiores a las unidades disponibles
- PrincipioLo que tiene historia no se borra; lo que nunca fue, sí
- Las cepas y las alícuotas nunca se borran, cambian de estado; los movimientos solo se añaden y se corrigen con otro; los duplicados sí se eliminan
- PrincipioEl dato dice cuánto sabe: vacío, provisional o validado
- La identificación lleva su grado de certeza y las actividades nacen provisionales y pasan a validadas con autor y fecha
- En la migración, lo que habría que inventar se deja vacío y lo deducido queda marcado como tal
- PrincipioConstruyo donde vive el conocimiento del negocio; lo demás se compra o se enlaza
- Un argumentario escrito de construir frente a comprar, con el control de los datos propios como criterio
- PrincipioLo irreversible lo ejecuta una persona
- Entre transformar y cargar los datos existentes hay una revisión humana, y la carga tiene modo de prueba
- PrincipioUn «no» lleva escrita la condición que lo reabriría
- Cada pieza que no se modela —el vial, los lotes de entrada, las relaciones entre cepas, las etiquetas libres— lleva su criterio para reabrirla
- PrincipioLo que decide el negocio se configura en vivo, sin publicar una versión
- Los vocabularios del laboratorio son tablas editables, no listas en el código, para no migrar al añadir un valor
- PrincipioUna maqueta antes que una reunión abstracta
- Una maqueta navegable para validar el modelo y para enseñarla al departamento, que aprobó la propuesta sobre ella
- PrincipioPrimero la cadena hasta producción, después el producto
- Repositorio, flujo de despliegue y primer despliegue el mismo día; los documentos de concepto y el modelo, después
- PrincipioLa interfaz sigue cómo trabaja quien la usa; el modelo, cómo es el negocio
- El laboratorio entra a colas de revisión con lo que tiene pendiente, no a listados de tablas