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:
| Archivo | Etapa |
|---|---|
b6-backend.md | B6: 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.md | B6: menú nuevo, rutas, firstAllowedRoute, botones por permiso, ficha de usuario |
b6-seeders-docs.md | B6: usuarios de prueba y toda la documentación (incluidos los cuatro PDF del manual) |
b6-verif.md | B6: chequeos manuales (migración sobre la matriz vieja, los cuatro perfiles, API) |
b7-backend.md | B7: ADR-015, referencia en la Holding, los cuatro extractos, exports |
b7-frontend.md | B7: pestañas de Prefondeo Soterex y Fondeo PDVs |
b7-docs.md | B7: documentación (con el diagrama del circuito de saldos) y cierre del estado en CLAUDE.md / doc/README.md |
b7-verif.md | B7: 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
pagode Admin pasa aL 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.mdya lista 011, 012, 013 y 016. - B1 dejó los helpers para migraciones de datos de permisos y catálogos:
App\Support\DataMigrations\EnsureRolePermissionsyEnsureCatalogItems(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) yPrefundingService::balanceBefore(): B7 los reusa. Ver su docblock yReportesController::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, enRoleSeeder::MATRIXy por migración de datos), el middlewareThrottlePerUsery 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_reciboy 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únRoleSeeder::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.
