# Mantenimientos programados y contratos

Cómo Ascendix genera las mantenciones preventivas de cada equipo, cómo se relacionan con los
contratos de los clientes y qué reglas siguen.

## 1. El programa de mantenimiento

Cada **equipo** (ascensor) puede tener un **programa de mantenimiento**: una regla que dice cada
cuánto tiempo corresponde una mantención preventiva.

- La frecuencia más común es **mensual**: una mantención por mes, en un **día fijo del mes** que
  se configura por equipo (por ejemplo, todos los días 15). También existen frecuencias
  semanales, anuales o cada varios meses, según lo que necesite el equipo.
- Si la fecha cae en fin de semana o feriado, el sistema la **corre al siguiente día hábil**.
- El programa tiene una vigencia (fecha de inicio y, si corresponde, de término) y puede
  configurarse para **esperar a que la mantención anterior esté terminada** antes de generar la
  siguiente.

## 2. Cómo se generan las mantenciones (mensuales, no diarias)

El sistema revisa los programas automáticamente varias veces al día, pero eso **no significa que
cree tareas todos los días**. Las reglas son:

1. Para cada programa activo, calcula cuándo corresponde la **próxima mantención**, avanzando un
   período completo desde la última generada (en un programa mensual: un mes).
2. La tarea se crea **con anticipación** (alrededor de 30 días antes para programas mensuales),
   para que operaciones pueda agendarla con calma.
3. **Reparto de la preagenda**: al crearla, el sistema puede correrla hasta **2 días hábiles**
   (antes o después, dentro del mismo mes) para que el técnico responsable no acumule demasiadas
   mantenciones en un día y para juntar clientes cercanos. Los equipos de un mismo cliente con el
   mismo técnico quedan el mismo día. Los programas con día fijo del mes no se corren. Lo ya
   agendado nunca se mueve; operaciones puede ajustar la fecha a mano como siempre.
4. **Nunca se duplica**: si la mantención de esa fecha ya existe, no se vuelve a crear. Y si el
   programa exige que la anterior esté terminada, espera a que se cierre antes de generar la
   siguiente.

Resultado: un equipo con programa mensual recibe **exactamente una mantención por mes**, en su
día configurado, generada con anticipación.

## 3. Relación con los contratos

El contrato del cliente define **la parte comercial**: cliente, vigencia, valor del período y
forma de facturación. Las mantenciones en sí las define el programa de cada equipo. El vínculo
funciona así:

- Al crear un contrato, el sistema **conecta automáticamente** los programas mensuales activos de
  los equipos de ese cliente con el contrato.
- También se pueden **agregar equipos al contrato manualmente**, siempre que el equipo pertenezca
  al cliente del contrato. Un equipo no puede tener dos programas mensuales de contrato al mismo
  tiempo.
- Las mantenciones del mes de esos equipos quedan asociadas al contrato: eso permite ver cuántas
  mantenciones cubre el contrato en el mes y su avance.
- Cuando todas las mantenciones del mes están **validadas**, el contrato queda listo para
  facturar ese período.
- Si el contrato se termina o se cancela, sus programas se **desvinculan** y dejan de generar
  mantenciones a nombre de ese contrato.

## 4. Asignaciones de cada mantención

Toda mantención generada queda asociada automáticamente a su **equipo** y a su **cliente** — esa
es la base para los reportes y el historial del equipo. El técnico responsable se define según la
configuración del programa: puede **heredarse de la mantención anterior** (equipos con técnico
habitual) o dejarse **pendiente para que operaciones lo asigne** al agendar. La ubicación de la
tarea siempre se toma del equipo (o del cliente) al momento de generarla, para que el técnico
llegue a la dirección correcta.

## 5. El ciclo de vida de una mantención

1. **Pre-agendada**: recién generada por el programa, a la espera de agendamiento.
2. **Agendada**: con fecha y técnico confirmados.
3. **En curso**: el técnico va en camino, llega al sitio y ejecuta el trabajo (la app registra
   cada paso: en camino → en el sitio → en ejecución, con pausas si corresponde).
4. **Terminada**: el técnico cierra el trabajo con su evidencia (fotos, formularios, firma).
5. **Validada**: operaciones revisa y aprueba el trabajo. Con todas las mantenciones del mes
   validadas, el contrato puede facturarse.

## 6. Resumen de reglas

| Regla | Cómo funciona |
|---|---|
| Frecuencia mensual | Una mantención por mes por equipo, en el día del mes configurado |
| Día hábil | Si cae en feriado o fin de semana, se mueve al siguiente día hábil |
| Anticipación | La tarea se genera con ~30 días de anticipación |
| Reparto de preagenda | Puede correrse hasta 2 días hábiles del mismo mes según la carga y cercanía del técnico; el día fijo no se toca |
| Sin duplicados | Nunca se crea dos veces la mantención de una misma fecha |
| Contrato nuevo | Se conecta automáticamente con los programas mensuales de los equipos del cliente |
| Equipo en contrato | Un equipo no puede tener dos programas mensuales de contrato a la vez |
| Facturación | El mes se factura cuando todas sus mantenciones están validadas |