# 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. **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 |
| 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 |