El proyecto MULTAGAL

MULTAGAL — Sistema de gestión de sanciones de tráfico.

Durante todo el curso desarrollarás el subsistema de tramitación de expedientes sancionadores de una administración de tráfico. El sistema debe cubrir el ciclo de vida completo de una denuncia: captación, tramitación, notificación, alegaciones, resolución, pago y, en su caso, detracción de puntos.

Glosario administrativo​

Antes del modelo, el vocabulario. Estos términos son del procedimiento sancionador español y aparecerán en todos los enunciados del curso.

Entidades del dominio​

Relaciones principales​

Fíjate en dos puntos que darán trabajo más adelante:

• Titularidad es una N:M con atributos (fecha de alta y de baja). No se puede resolver con un simple @ManyToMany: hará falta una entidad propia. Además es temporal: un vehículo puede haber tenido varios titulares, y la pregunta «¿quién era el titular el día de la denuncia?» no tiene una respuesta trivial.
• Conductor puede ser nulo en Denuncia. Un radar capta una matrícula, no una persona. La identificación del conductor es un paso posterior del procedimiento.

Estados del expediente​

El expediente es una máquina de estados. Casi todas las reglas de negocio son, en realidad, restricciones sobre las transiciones válidas.

Reglas de negocio significativas​

Estas seis reglas son la fuente de complejidad del proyecto: de ellas salen las transacciones, las validaciones y las consultas interesantes.

R1 — Bonificación por pronto pago​

Bonificación del 50 % del importe si el pago se produce dentro de los 20 días naturales siguientes a la notificación, con renuncia a alegaciones.

Implica: cálculo de plazos sobre fechas, y un efecto lateral — pagar cierra la vía de alegación.

R2 — La detracción de puntos exige firmeza​

La detracción de puntos sólo se materializa cuando la resolución es firme.

Implica: no basta con que exista una Resolucion; hay que comprobar su estado antes de tocar el saldo del conductor.

R3 — Saldo cero ⇒ permiso suspendido, atómicamente​

Un conductor con saldo de puntos igual a cero queda con el permiso suspendido: la actualización del saldo y el cambio de estado del permiso deben ser atómicos.

R4 — Prescripción​

Prescripción de la infracción a los 3 meses (leves) o 6 meses (graves y muy graves) desde la fecha de comisión si no se ha notificado.

Implica: consultas por rango de fechas condicionadas a la gravedad, y un proceso de purga (que en la UD1 se hará recorriendo un árbol de directorios).

R5 — No se resuelve con alegaciones pendientes​

Un expediente no puede resolverse mientras existan alegaciones pendientes de contestar.

Implica: una validación que consulta una colección asociada antes de permitir la transición de estado.

R6 — Obligación de identificar al conductor​

La identificación del conductor es obligatoria para el titular del vehículo; su omisión genera una infracción autónoma muy grave.

Implica: un expediente puede generar otro expediente. Cuidado con las recursividades y con las referencias circulares al serializar.

Fases del proyecto​

El desarrollo se organiza en siete fases que se corresponden con las unidades didácticas:

Observa la progresión en espiral: la fase 3 no tira lo de la fase 2, lo reimplementa. Al final del curso tu repositorio contendrá varias soluciones al mismo problema, y sabrás argumentar cuál conviene en cada escenario.

Protección de datos​

El dominio maneja datos personales de categoría ordinaria pero sensible en la práctica: NIF, domicilio, matrícula, historial sancionador.

Estos puntos se evalúan: aparecen en las condiciones formales de los entregables descritas en la presentación del módulo.

Un primer esbozo del modelo​

En la actividad A0.3 crearás los primeros POJOs del dominio. Todavía sin persistencia: sólo tipos Java que representen los conceptos. Un adelanto del criterio a seguir:

public record Coordenadas(double latitud, double longitud) { }

public enum Gravedad { LEVE, GRAVE, MUY_GRAVE }

public record Infraccion(
        String codigo,
        String articulo,
        String descripcion,
        BigDecimal importeBase,
        int puntos,
        Gravedad gravedad) { }