Trayectorias: cómo Nammu construye la hoja de ruta procesal correcta para cada caso

Cada tipo de proceso legal tiene su propia secuencia estatutaria de etapas, sus propias citas de artículos, sus propios plazos, su propio “qué pasa si X no ocurre.” La audiencia preliminar de un ordinario civil no tiene nada en común procesalmente con la ventana de plazo de vigencia de un caso de violencia doméstica. Trayectorias existe para renderizar la hoja de ruta estatutaria correcta para la jurisdicción y tipo de proceso específicos de este caso — y luego superponerla con evidencia real de los propios documentos de este caso para mostrar dónde realmente se encuentra hoy. Esto no es una barra de progreso genérica de cinco etapas.

Dos vistas sobre un solo modelo

La misma estructura de datos CaseTimeline alimenta dos renderizados deliberadamente distintos. Mantenerlos separados evita que se confundan dos preguntas genuinamente diferentes.

El modelo de datos

Tres dataclasses en timeline_model.py llevan todo lo que produce un constructor:

Símbolos de los hitos

Cada hito lleva un símbolo que comunica de un vistazo su rol estructural en la secuencia procesal:

Un constructor por tipo de proceso — no por jurisdicción

load_case_timeline() lee process_type de case_index.json y lo enruta a exactamente una función build_*_timeline(). Este es un despacho a nivel de tipo de proceso, no a nivel de jurisdicción: que una jurisdicción esté completamente clasificada no garantiza que todos sus tipos de proceso tengan plantilla. El monitorio civil, el procedimiento_abreviado y la flagrancia de penal, y el proceso_de_lesividad de contencioso están todos correctamente clasificados pero aún no tienen constructor — muestran un estado de “plantilla faltante” diseñado a propósito, no un error genérico.

Cada constructor es autocontenido. Tiene su propia lista de hitos, citas de artículos y reglas de inferencia de estado — fundamentadas en una revisión específica del dominio legal, citada en el código. No existe una estructura de hitos genérica compartida que las jurisdicciones personalicen. Los 13 hitos de un ordinario civil y los 8 hitos de un caso de violencia doméstica familiar no comparten un solo nombre o estructura de etapa, porque están regidos por códigos distintos con relojes procesales distintos.

Fases — comunicando el cambio jurisdiccional a mitad de proceso

MilestonePhase tiene cuatro valores. Cuáles usa un constructor dice algo legalmente significativo sobre si la jurisdicción del caso puede cambiar a mitad de proceso.

build_ordinario_timeline() es el único constructor que debe manejar las tres formas posibles de un caso ordinario civil. Elige explícitamente entre ellas: bisagra detectada → emite ambas fases más el nodo de bisagra resaltado en dorado; jurisdicción no civil sin bisagra todavía → aun así muestra ambas plantillas de fase para que la hoja de ruta de la mini-vista sea visible antes de una transferencia; puramente civil desde el inicio → descarta las etiquetas de fase y marca cada hito como SINGLE.

Cómo se infiere el estado de un hito

Cada constructor inspecciona el conjunto consolidado de doc_kind de document_index.json — la salida de la Segmentación Inteligente de Documentos — y deriva el estado de cada hito a partir de qué tipos de documento están presentes. Los patrones van de simples a legalmente sofisticados:

COMPLETED if "notificacion" in doc_kinds else UNKNOWN

COMPLETED    si existe una resolución de admisión del tribunal
IN_PROGRESS  si se señalaron defectos y/o se presentó subsanación,
             pero el tribunal aún no ha resuelto
PENDING      si no hay ninguna señal

El texto de los hitos lleva orientación de seguridad legal

El campo notes de un hito no es decorativo. En varios constructores, lleva instrucciones directas y críticas de seguridad legal, incrustadas exactamente en el punto de la interfaz donde son operacionalmente relevantes.

Enriquecimiento de fechas — mejor esfuerzo, nunca un determinante de estado

timeline_dates.py corre una pasada posterior separada que intenta adjuntar una fecha de calendario real a hitos ya marcados como alcanzados por la lógica de estado. Nunca determina si un hito ocurrió — solo cuándo.

Para cada ID de hito, una tabla de búsqueda indica qué doc_kind(s) buscar; la página de ancla del primer segmento coincidente se escanea con expresiones regulares de fecha en español que cubren tanto fechas numéricas (28/01/2026) como la fórmula canónica costarricense de autofechado judicial deletreada (“del veintiocho de enero de dos mil veintiséis”), incluyendo una tabla de palabra a número para días y años deletreados.

Un fallo de extracción de fecha simplemente significa que un hito aparece como alcanzado sin fecha — nunca es una razón para degradar u ocultar un estado que la evidencia de doc_kind ya estableció.

Siete estados vacíos distintos

Trayectorias deliberadamente no colapsa toda situación de “nada visible” en un único estado vacío genérico. La razón por la que un caso no tiene nada que mostrar es en sí misma información útil, y confundir las razones engañaría al abogado sobre lo que realmente está sucediendo.

Principios rectores