Skip to content

Ajustes v2 (GT) — Especificaciones listas para ejecutar B6 y B7 ​

Date: 2026-10-02

Actualización (2026-10-02, más tarde). Esto ya se ejecutó: B6 (PR #71) y B7 (PR #72) están hechas, apiladas sobre B1–B5, y esperan el merge de Carlos. Lo que sigue es el registro de cómo se especificó cada una y del método; se conserva porque es la referencia de qué se pidió en cada etapa y porque vale para cualquier entrega parecida. B1.5 sigue bloqueada.

Qué es esto. El 2026-10-02 Carlos decidió parar el plan de ajustes v2 en B5: B1 a B5 se entregaron en el PR #67 y B6 (perfiles y menú) y B7 (tesorería como estado de cuenta) quedaron, en ese momento, sin hacer. Esta carpeta guarda las especificaciones de ejecución que ya estaban escritas para esas dos entregas, para que una sesión nueva pudiera retomarlas sin volver a relevar todo (y así se hizo, el mismo día).

El plan que manda es ../2026-10-01-ajustes-v2-cliente-gt.md (secciones B6, B7, §3, §5 y la sección "Decisiones de Carlos del 2026-10-02"). Estas especificaciones lo complementan con el detalle de ejecución (riesgos, orden de trabajo, tests obligatorios y chequeos manuales); si se contradicen, manda el plan.

Cómo se ejecutó B1 a B5 (el método) ​

Cada entrega se hizo en etapas secuenciales sobre el mismo branch (backend → frontend → documentación), con los tests en el mismo commit que el código, y después: verificación independiente (suites completas y chequeos manuales en el browser y por API), revisión por cuatro o cinco lentes en paralelo (aceptación, corrección, permisos y privacidad, tests y documentación, y una lente propia de la entrega), corrección de los hallazgos y re-verificación. Cada archivo de esta carpeta es la especificación de una etapa:

ArchivoEtapa
b6-backend.mdB6: ADR-014, migración de datos de perfiles, separar pagar de cancelar, módulos para la ficha de usuario, test de matriz por API
b6-frontend.mdB6: menú nuevo, rutas, firstAllowedRoute, botones por permiso, ficha de usuario
b6-seeders-docs.mdB6: usuarios de prueba y toda la documentación (incluidos los cuatro PDF del manual)
b6-verif.mdB6: chequeos manuales (migración sobre la matriz vieja, los cuatro perfiles, API)
b7-backend.mdB7: ADR-015, referencia en la Holding, los cuatro extractos, exports
b7-frontend.mdB7: pestañas de Prefondeo Soterex y Fondeo PDVs
b7-docs.mdB7: documentación (con el diagrama del circuito de saldos) y cierre del estado en CLAUDE.md / doc/README.md
b7-verif.mdB7: chequeos manuales (la planilla del cliente número por número)

Orden y branches ​

B6 sale de la punta del branch de PR 1 (una vez mergeado el PR #67, de main) en feature/ajustes-v2-perfiles-menu; B7 sale de B6 en feature/ajustes-v2-tesoreria, con PRs apilados (la base de cada PR es el branch anterior). B7 necesita el rol Tesorería de B6 y el servicio de saldo corrido de B2.

Qué cambió en el repo desde que se escribieron estas especificaciones (leelo antes de ejecutar) ​

Las especificaciones se escribieron antes de que B3 a B5 estuvieran hechas. Para B6 y B7:

  • Decisiones de Carlos del 2026-10-02 (ya están en el plan): el Admin cancela y paga (la celda pago de Admin pasa a L E); Cumplimiento solo Admin; el Supervisor deja de ver la comisión del Dashboard (P11).
  • ADRs: ya existen 001–013 y 016 (datos personales en bloque, de B4). 014 y 015 siguen libres y son de B6 y B7. El índice doc/architecture/index.md ya lista 011, 012, 013 y 016.
  • B1 dejó los helpers para migraciones de datos de permisos y catálogos: App\Support\DataMigrations\EnsureRolePermissions y EnsureCatalogItems (siempre sin eventos del modelo). La migración de perfiles de B6 los extiende o reusa, y deja un evento de Auditoría sin usuario por cada celda que cambia (patrón ya implementado).
  • B2 dejó App\Services\RunningBalance (saldo corrido puro, en centavos) y PrefundingService::balanceBefore(): B7 los reusa. Ver su docblock y ReportesController::loadSituacionData.
  • B3 agregó la regla de la sesión de caja vencida (ADR-013) y el reporte "Cierres por día".
  • B4 agregó el módulo de permiso reporte_cumplimiento (Admin 1/0/0, en RoleSeeder::MATRIX y por migración de datos), el middleware ThrottlePerUser y el listado de Transacciones como lista blanca (TransactionListResource). La ficha de usuario (UsuariosView.vue) ya lista el módulo nuevo, pero la lista de módulos sigue a mano en el front: B6.6 la pasa al backend.
  • B5 agregó countries.formato_recibo y el recibo A4: B6 no lo toca, pero el manual por perfil y el recorrido guiado ya hablan de él.
  • El manual de usuario ya tiene un Markdown por módulo con permiso, incluido 61-reportes-cumplimiento.md; el manual en PDF sale por rol según RoleSeeder::MATRIX (hoy tres).
  • Los números de línea y los nombres de archivos de estas especificaciones se leyeron el 2026-10-01 o 02: verificalos antes de apoyarte en ellos.

Para retomar con una sesión nueva de Claude Code ​

Ya no hace falta: B6 y B7 se retomaron y se hicieron. Queda el bloque como registro de cómo se lanzó.

Se pegó este bloque como primer mensaje (ajustado según B6 / B7):

Sos el product owner de este proyecto (Soterex / CIS Latam). Leé CLAUDE.md y después
doc/plans/2026-10-01-ajustes-v2-cliente-gt.md (secciones B6, B7, §3, §5 y "Decisiones de Carlos del
2026-10-02") y doc/plans/2026-10-01-prompt-ajustes-v2-gt.md (reglas de ejecución). Ejecutá la entrega
B6 (después B7) siguiendo las especificaciones de doc/plans/2026-10-02-ajustes-v2-b6-b7-especificaciones/
y el README de esa carpeta. Branch de B6: feature/ajustes-v2-perfiles-menu, saliendo de main una vez
mergeado el PR #67 (o de docs/plan-ajustes-v2-gt si todavía no se mergeó). No mergees PRs ni toques
staging/producción.

Documentación viva — se actualiza junto con el código, no es un anexo aparte.