refactor: unificar nombres de parametros anio/mes en todos los endpoints

/listado usaba periodo/mesCorte mientras /detallado, /boleta e /historial
usaban anio/mes. Ahora todos exponen anio/mes en la firma publica; el
FiltroDTO y DatosCalculo internos mantienen sus nombres actuales.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AyxL2mSnUE9XyUFHw8zDmM

CLAUDE.md

@@ -54,16 +54,21 @@ so.planilla_be
 
 | Método | Ruta | Descripción |
 |---|---|---|
-| GET | `/api/v1/renta-quinta` | Grilla paginada de retenciones, con cálculo |
+| GET | `/api/v1/renta-quinta/listado` | Grilla paginada de retenciones, con cálculo |
 | GET | `/api/v1/renta-quinta/{id}` | Boleta completa por `id_renta_quinta` |
+| GET | `/api/v1/renta-quinta/detallado` | Detalle completo por `numeroDocumento` + `anio` + `mes` |
 | GET | `/api/v1/renta-quinta/boleta` | Boleta por `codper` + `anio` + `mes` |
 | GET | `/api/v1/renta-quinta/historial/{codper}/{anio}` | Meses del trabajador en el periodo |
 
+`anio` y `mes` son los nombres de parámetro usados en **todos** los endpoints (`listado`,
+`detallado`, `boleta`, `historial`) — no usar `periodo`/`mesCorte` en la firma pública aunque
+internamente `RentaQuintaFiltroDTO` y `DatosCalculo` sigan llamándolos así.
+
 ### Filtros de la grilla
 
-`periodo` y `mesCorte` son **obligatorios**; el resto es opcional y, si no se envía, no filtra.
-Todos son `Integer` salvo `documentoOApellidos`, que es texto (busca por `numero_documento` o por
-apellidos + nombres, con `LIKE` en mayúsculas).
+`anio` y `mes` son **obligatorios**; el resto es opcional y, si no se envía, no filtra. Todos son
+`Integer` salvo `documentoOApellidos`, que es texto (busca por `numero_documento` o por apellidos
++ nombres, con `LIKE` en mayúsculas).
 
 Los filtros de catálogo (`sede`, `tipoPlanilla`, `areaGeneral`, `subArea`, `cargo`) llegan como
 número y se comparan **como texto** contra columnas TEXT: el service los convierte con

src/main/java/so/planilla_be/rentaquinta/calculo/RentaQuintaCalculadora.java

@@ -104,8 +104,7 @@ public class RentaQuintaCalculadora {
      * boleta real ni el estimado del propio mes de corte cuando este es julio/diciembre).
      */
     private BigDecimal gratificacionesPendientes(DatosCalculo datos, boolean julioCubierto, boolean diciembreCubierto) {
-        BigDecimal gratificacion = orZero(datos.basicoReferencia())
-                .add(orZero(datos.asignacionFamiliarReferencia()))
+        BigDecimal gratificacion = orZero(datos.remuneracionReferencia())
                 .multiply(FACTOR_GRATIFICACION);
         BigDecimal total = BigDecimal.ZERO;
         if (!julioCubierto) {

src/main/java/so/planilla_be/rentaquinta/controller/RentaQuintaController.java

@@ -36,8 +36,8 @@ public class RentaQuintaController {
     @Operation(summary = "Grilla de proyección y control de quinta categoría (paginada)")
     @GetMapping("/listado")
     public Page<RentaQuintaResumenDTO> listado(
-            @RequestParam @NotNull Integer periodo,
-            @RequestParam @NotNull @Min(1) @Max(12) Integer mesCorte,
+            @RequestParam @NotNull Integer anio,
+            @RequestParam @NotNull @Min(1) @Max(12) Integer mes,
             @RequestParam(required = false) Integer sede,
             @RequestParam(required = false) Integer tipoPlanilla,
             @RequestParam(required = false) Integer areaGeneral,
@@ -47,7 +47,7 @@ public class RentaQuintaController {
             @RequestParam(defaultValue = "0") Integer page,
             @RequestParam(defaultValue = "20") Integer size) {
         return service.buscar(new RentaQuintaFiltroDTO(
-                periodo, mesCorte, sede, tipoPlanilla, areaGeneral, subArea, cargo,
+                anio, mes, sede, tipoPlanilla, areaGeneral, subArea, cargo,
                 documentoOApellidos, page, size));
     }