Revisión de código de pagos
Encuentra los errores que cuestan dinero real en el código de pagos y explica cada uno en términos monetarios: quién es cobrado dos veces, qué contabilización se pierde, quién puede aprobar su propia transferencia.
Flujo de trabajo
-
Delimita el alcance. Encuentra el código que crea, mueve, aprueba, contabiliza o concilia dinero: controladores, servicios, listeners, entidades, migraciones. Toma nota del stack (Spring Boot, Kafka, JPA, Kotlin).
-
Ejecuta el escáner desde la carpeta de esta habilidad contra el proyecto o los archivos modificados:
python scripts/scan.py <ruta-al-código> # tabla markdown python scripts/scan.py <ruta-al-código> --format json # para procesamiento adicionalNecesita Python 3.10+, nada más. Omite las fuentes de prueba a menos que pases
--include-tests. Lee el texto fuente con heurísticas, por lo que su salida es una lista de pistas. -
Verifica cada hallazgo leyendo el código. Por cada pista, abre el archivo y confírmalo:
- Un
doublellamadoamountque realmente es un porcentaje o una relación no es PAY001. - Un consumidor o método de aprobación está bien si la verificación de duplicados o de cuatro ojos vive más profundo de lo que el escáner sigue (tres llamadas). Síguelo y di dónde está.
- Descarta los falsos positivos y di en una línea por qué, para que el lector pueda confiar en el resto.
- Un
-
Recorre la lista de verificación manual en references/checklist.md. Explica cada regla del escáner con un ejemplo malo y uno bueno, y enumera lo que ningún escáner puede ver: condiciones de carrera en saldos, alcance de la clave de idempotencia, semántica de reintento y timeout, máquinas de estado, conciliación, dinero en tránsito, auditoría y protección de datos. Solo profundiza tanto como el código bajo revisión lo necesite.
-
Escribe el informe en el formato a continuación. Encabeza con el mayor impacto monetario.
Formato del informe
## Revisión de pagos: <servicio o PR>
**Veredicto:** <una frase: seguro de fusionar / arreglar antes de fusionar / necesita rediseño>
| # | Gravedad | Dónde | Problema | Impacto monetario |
|---|---|---|---|---|
| 1 | Alta | `TransferController.java:24` | Sin clave de idempotencia en POST /transferencias | Un reintento del cliente después de un timeout crea una segunda transferencia |
### 1. <título>
**Por qué es importante:** <qué sale mal, concretamente, con un ejemplo de monto>
**Solución:** <el cambio correcto más pequeño, con un breve fragmento de código>
### Verificado y correcto
- <cosas verificadas como correctas, con su ubicación; mantiene la revisión honesta>
### No cubierto
- <lo que no se pudo verificar, p. ej., restricciones de base de datos que no están en este repositorio>
Reglas para la revisión
- La gravedad es sobre dinero. Alta = el dinero puede perderse, duplicarse o ser movido por la persona equivocada. Media = puede suceder bajo fallo o carga. Baja = higiene.
- Cita la línea, con
archivo:línea, para cada hallazgo. Nunca reportes una pista del escáner que no hayas confirmado. - Prefiere la solución segura más pequeña, por ejemplo una restricción única más un encabezado
Idempotency-Key, no una reescritura. Cuando la solución correcta sea estructural (una bandeja de salida transaccional), dilo claramente. - No reclames cumplimiento. Esta revisión no es una auditoría PCI DSS o SOX; dilo si te preguntan.
- Revisa también la base de datos. Muchas de estas garantías pertenecen a restricciones (
UNIQUE,CHECK, disparadores). Mira las migraciones (Flyway, Liquibase) cuando estén en el repositorio.