CommunityProgramación y desarrollogithub.com

revisión-de-código-de-pagos

Revisa código Java o Kotlin de pagos (Spring Boot, Kafka, JPA) en busca de errores que pierdan o dupliquen dinero: cargos dobles por falta de claves de idempotencia, montos en double/float, eventos perdidos por escrituras duales, consumidores no idempotentes, autoaprobación, timeouts faltantes, datos de tarjeta en logs. Ejecuta un escáner incluido, verifica cada hallazgo en el código y luego recorre una lista de verificación manual. Úsalo al revisar un pull request o un servicio que crea, mueve, aprueba, contabiliza o concilia pagos, transferencias, reembolsos, libros contables o saldos.

¿Qué es revisión-de-código-de-pagos?

Esta habilidad está diseñada para revisar código de pagos en Java o Kotlin que utilice Spring Boot, Kafka y JPA. Su propósito es detectar errores que puedan causar pérdidas o duplicación de dinero, como cargos dobles por falta de claves de idempotencia, montos declarados como double o float, eventos perdidos por escrituras duales, consumidores no idempotentes, autoaprobación, timeouts faltantes y registros de datos de tarjetas en logs. El flujo de trabajo incluye ejecutar un escáner integrado que genera una lista de pistas, verificar cada hallazgo manualmente en el código y recorrer una lista de verificación detallada. Soporta plataformas como Claude Code, Cursor y Codex, y proporciona un reporte estructurado con severidad, ubicación, problema e impacto monetario. Es útil para desarrolladores o revisores que necesitan asegurar que el código de pagos no tenga errores que cuesten dinero real.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Vidhidesai12/payments-review-skill/tree/main/payments-code-review

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. 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).

  2. 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 adicional
    

    Necesita 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.

  3. Verifica cada hallazgo leyendo el código. Por cada pista, abre el archivo y confírmalo:

    • Un double llamado amount que 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.
  4. 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.

  5. 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.

Skills relacionados