Prompt de ejecución — Respuesta del cliente del 14/10 (A4, Pago 9 y bóveda del PDV)
Date: 2026-10-19
Uso. Son dos sesiones, una después de la otra. Cada una es un bloque para copiar como primer mensaje de una sesión nueva de Claude Code. Ejecutan 2026-10-19-ajustes-v3-respuesta-14-oct.md, que vive en el branch docs/plan-respuesta-14-oct hasta que se mergee. Trabajan en el directorio del repo, sin worktree, y de corrido, sin preguntar.
| Sesión | Branch | Qué hace | Cuándo |
|---|---|---|---|
| A | feature/v3-ronda3-ajustes | L1 (A4 sin «Transacción fija» y lo confirmado), L2 (Pago 9 b), y el borrador de la carta (L5) | Primero. Es chica |
| B | feature/v3-ronda3-boveda | L3 (bóveda del PDV y traspasos) y su documentación | Cuando A termine. Nunca a la vez: el stack de Docker es uno |
Antes de lanzarlas (L0 del plan, lo hacés vos): promové main a Staging y verificá J1 a J3 en pantalla. La sesión A no promueve nada, pero su carta dice «instalado» solo después de que lo hayas hecho: si todavía no lo hiciste, la carta queda con la fecha en blanco.
Revisá la sección «2. Decisiones» del bloque. Trae las recomendaciones del plan (D5-1 a D5-10, todas en la opción a). Si decidiste otra cosa, cambiá esa línea: la sesión no te va a preguntar.
Arrancá cada una con Sonnet y en modo automático, para que no frene a pedir permiso en cada comando:
cd /Users/peluca/projects/soterex claude --model sonnet --permission-mode autoEl modo
autodeja trabajar solo y sigue frenando lo riesgoso (push a otro branch, borrados, etc.). Con--permission-mode bypassPermissionsno frena nunca, y entonces los límites de la sección 6 los cumple la sesión por su cuenta y no los controla Claude Code.Pegá el bloque de la sesión que toca.
Sesión A — ajustes chicos (L1, L2 y la carta)
Sos el equipo de desarrollo de este proyecto (Soterex / CIS Latam) y ejecutás un plan ya aprobado.
**Trabajás de forma autónoma, de punta a punta.** Nadie va a contestar preguntas mientras
trabajás: no pares a preguntar ni a pedir confirmación, y no cortes entre una entrega y la
siguiente. Si algo no está decidido, aplicá la regla de la sección 6 y seguí. Lo único que te
detiene es un límite de la sección 6 o la regla de aislamiento de los tests (sección 5). Dejá todo
por escrito en el PR.
## 1. Contexto, antes de tocar código
1. **Trabajás en el directorio del repo, `/Users/peluca/projects/soterex`, sin worktree.**
cd /Users/peluca/projects/soterex
git status --short
git branch --show-current
- Anotá en qué branch estaba el repo.
- **Si `git status` muestra cambios sin commitear**, no son tuyos. No los commitees, no los
descartes y no los mezcles con tu trabajo: `git stash push -u -m "antes de feature/v3-ronda3-ajustes"`.
Anotá que lo hiciste y, al terminar, avisale a Carlos con el branch original para que haga
`git stash pop` ahí.
- Después:
git fetch origin
git checkout -b feature/v3-ronda3-ajustes origin/docs/plan-respuesta-14-oct
El branch arranca desde el commit del plan; el plan entra a `main` con tu PR.
2. Ya en el branch nuevo, leé `CLAUDE.md`.
3. Leé entero `doc/plans/2026-10-19-ajustes-v3-respuesta-14-oct.md`. Es la fuente de verdad. A vos te
tocan **L1, L2 y L5 (la carta)**; **L3 es de la otra sesión: no la hagas** y **L0 y L4 son de
Carlos: no las hagas**.
4. **El mail del cliente y el Excel no están en el repo y no los vas a tener**: tienen datos
personales. El plan transcribe todo lo que hace falta. No los pidas ni los busques.
5. Contexto por entrega:
- L1: `doc/plans/2026-10-13-ajustes-v3-excel-pendientes.md` (J1, el A4 y el enmascarado del operador).
- L2: `doc/architecture/ADR-008-documentos-identificacion-bloquean-el-pago.md`,
`ADR-011-datos-del-pago-obligatorios-antes-de-pagar.md` y `ADR-009-mecanismo-del-recorrido-guiado.md`.
6. **Stack local: el de siempre.** Montá este mismo directorio con `./start-dev.sh` (o
`docker compose up -d` si ya está construido); ver `doc/environments/dev.md`. Si ya está
corriendo, usalo. Después de cambiar de branch corré
`docker compose exec backend php artisan migrate`. **Nunca `migrate:fresh`, `db:wipe` ni
`demo:reseed`** sobre la base de dev.
## 2. Decisiones (ya tomadas: no las reabras)
- **D5-1 = a.** En Pago, **solo los documentos** (`DocumentacionPrePago`) aparecen recién al tocar
«Iniciar pago». Los datos del pago (`DatosPagoForm`) siguen visibles desde la consulta.
- **D5-2 = a.** El cambio es **solo de la pantalla Pago**. `TransaccionDetalleView.vue` no cambia:
anotalo en el PR.
- Nada de lo demás del plan (D5-0, D5-3 a D5-9) es tuyo.
## 3. Entregas
### L1 — A4 sin «Transacción fija» y lo que el cliente confirmó
Plan §3, L1. Resumen: sacar «Transacción fija: Sí / No» de
`backend/resources/views/pdf/partials/papeleta-a4-copia.blade.php` (queda solo «Tipo de transacción»,
sin cambiar el alto de la copia) con su test y su manual; actualizar los comentarios que dicen «NO SE
TOCA hasta QC-19 / QC-20» y el de `config/cumplimiento.php`; un test que fije que Chipre del Norte,
Irlanda del Norte, Somalilandia y el #216 «Santo Tomas» no están cargados. **No cambia ningún valor ni
ningún comportamiento fuera del A4.**
### L2 — Pago 9 (b): los documentos aparecen al tocar «Iniciar pago»
Plan §3, L2 (el diseño está completo: `pagoIniciado`, `puedeIniciar` / `puedePagar`, el botón «Pagar»,
`motivoNoPuedeIniciar`). Solo frontend. Reescribí los tests de `PagoView.spec.ts` y
`MatchResultCard.spec.ts` que asumen «Iniciar pago» → modal. Revisá `frontend/src/tours/pago.ts` y sus
tests. Actualizá `doc/manual/10-pago.md` y agregá la nota «Actualización» en ADR-008.
### L5 — El borrador de la carta
Escribí **`doc/plans/2026-10-19-borrador-respuesta-al-cliente-ronda-3.md`** (plan §3, L5). **Solo
borrador, con la marca arriba; no mandes nada.** Se arma sobre
`doc/plans/2026-10-13-borrador-respuesta-al-cliente-excel-v3.md` y respeta sus reglas: español neutro,
sin voseo, sin claves internas (ni L, ni D5, ni QC, ni RV3, ni ADR, ni números de PR).
- **Regla que no se negocia: no escribas «instalado» sobre algo que no viste.** La fecha de
instalación de J1 a J3 va **en blanco, entre corchetes**, con un comentario para Carlos que diga
que la complete después de ver el deploy en verde y los tres cambios en pantalla. Lo mismo para L1
y L2: «quedó hecho y se instala en la próxima actualización».
- Incluí las cuatro preguntas QC-42 a QC-45 (plan §5) con su valor por defecto escrito en el texto
de la pregunta, y el ejemplo de la bóveda con números inventados.
- Al final del archivo, una lista de «Antes de mandarla» para Carlos: los puntos de L0.
- Sin datos personales: nada de nombres, mails ni documentos reales; los MTCN de prueba sí se pueden
citar.
Agregá arriba del borrador del 13/10 (`2026-10-13-borrador-respuesta-al-cliente-excel-v3.md`) una
línea que diga que lo reemplaza el nuevo.
## 4. Cómo trabajás cada entrega
1. Tests en el mismo commit que el código. Un commit por entrega, con el trailer de
atribución que indique el sistema.
2. **Antes de la primera corrida de la suite**, el canario de aislamiento:
`docker compose exec backend ./vendor/bin/phpunit --filter=DatabaseIsolationTest`.
**Si falla, no corras ningún otro test.** La suite usa `RefreshDatabase` y sin aislamiento vacía
la base de dev. Es lo único que te autoriza a parar: dejá el trabajo commiteado y explicá qué pasó.
3. Corré y pegá la salida real:
- `docker compose exec backend php artisan test` y
`docker compose exec backend ./vendor/bin/pint --test`;
- en `frontend/`: `npm run test` y `npm run build` (incluye `vue-tsc`), directo o con
`docker compose exec frontend …`;
- si tocás Markdown de `doc/`, `npm ci` y `npm run docs:build` en `doc/` (corta con links rotos).
Si algo falla, lo arreglás y volvés a correr; no pushees en rojo.
4. **Verificá a mano en el stack local**, no alcanza con los tests:
- L1: generá el A4 y la tirilla de un pago de demo, abrí los PDF y mirá que no diga «Transacción
fija» y que el operador salga `back••••` en los dos;
- L2: con un Cajero, buscá una `ACCEPTED`, mirá que **no** se vean los documentos, tocá «Iniciar
pago», subí lo que falta, y pagá con el botón «Pagar». Probá también caja vencida y MTCN vencido.
5. `code-reviewer` sobre el diff de cada entrega; corregí lo que marque y recién ahí pusheá.
## 5. Aislamiento de los tests
Ver el punto 2 de la sección 4: el canario va primero y si falla no se corre nada más.
## 6. Autorización y límites
Te autorizo, sin pedirme confirmación, a:
- guardar con `git stash` cambios ajenos sin commitear (sección 1);
- crear el branch `feature/v3-ronda3-ajustes`;
- implementar, testear y commitear;
- levantar, usar y reiniciar el stack de Docker local;
- correr migraciones sobre la base de dev;
- pushear ese branch;
- abrir y actualizar su PR contra `main`.
No hagas nada de esto:
- mergear;
- push, merge o deploy a `staging` o `production`;
- `terraform apply`;
- disparar workflows de GitHub Actions;
- correr comandos contra Staging o Producción;
- mandar mails o mensajes;
- force-push, `reset --hard` o rebase de un branch pusheado;
- tocar el branch `docs/plan-respuesta-14-oct` ni los de la migración a Azure (`feature/az-*`).
Si aparece algo que el plan no decide, tomá la opción más conservadora y más parecida a lo que ya
existe, anotala en «Decisiones que tomé sin Carlos» del PR y seguí.
## 7. Reglas que no se negocian
- Ningún dato personal en el código, los tests, los commits ni la documentación: nada de nombres,
documentos ni mails reales. En los tests, datos inventados.
- No se cambia ningún permiso de la matriz ni se agrega una migración.
- No se toca el backend de `pay()` ni la regla de ADR-008: los documentos siguen bloqueando
**confirmar el pago**; L2 solo cambia **cuándo se ven**.
- No se toca la integración C2P (`C2PController`, OAuth, `SendRequest`, `Cancel`, Notifications).
- No se toca el enmascarado del operador de J1.
- No edites `CLAUDE.md` (lo hace el PR B).
## 8. Al terminar
Dejá en el chat y en la descripción del PR:
1. El link del PR y el estado del CI.
2. Por entrega: hecha, parcial o sin hacer; qué verificaste a mano y qué no.
3. Las decisiones que tomaste sin Carlos.
4. Actualizá la tabla «Estado de la ejecución» del plan (L1, L2 y L5 en «hecha» o «parcial»).
5. Lo que le toca a Carlos, en orden: `git stash pop` si guardaste algo; revisar y mergear; promover
a Staging; completar la fecha de la carta después de ver el deploy; L0.4 y L0.5 del plan; mandar
la carta.
6. Lo que encontraste roto o raro y no era de este plan.Sesión B — la bóveda del PDV (L3)
Sos el equipo de desarrollo de este proyecto (Soterex / CIS Latam) y ejecutás un plan ya aprobado.
**Trabajás de forma autónoma, de punta a punta.** Nadie va a contestar preguntas mientras
trabajás: no pares a preguntar ni a pedir confirmación. Si algo no está decidido, aplicá la regla de
la sección 6 y seguí. Lo único que te detiene es un límite de la sección 6 o la regla de aislamiento
de los tests (sección 4). Dejá todo por escrito en el PR.
**Esto toca plata y permisos.** Es el cambio más delicado de la ronda: andá despacio en el diseño y
rápido en el resto. Los tests de las invariantes contables no son opcionales.
## 1. Contexto, antes de tocar código
1. **Trabajás en el directorio del repo, `/Users/peluca/projects/soterex`, sin worktree.**
cd /Users/peluca/projects/soterex
git status --short
git branch --show-current
- Anotá en qué branch estaba el repo.
- **Si `git status` muestra cambios sin commitear**, no son tuyos: `git stash push -u -m "antes de feature/v3-ronda3-boveda"`,
anotalo y avisale a Carlos al terminar.
- Después:
git fetch origin
git checkout -b feature/v3-ronda3-boveda origin/main
- **El plan no está en `main` hasta que se mergee el PR de la sesión A.** Leelo sin traerlo a tu
branch:
git show origin/main:doc/plans/2026-10-19-ajustes-v3-respuesta-14-oct.md 2>/dev/null \
|| git show origin/docs/plan-respuesta-14-oct:doc/plans/2026-10-19-ajustes-v3-respuesta-14-oct.md
**No commitees archivos del plan** en este branch (los commitea el PR A). No edites la tabla
«Estado de la ejecución»: la actualiza Carlos al mergear.
2. Ya en el branch nuevo, leé `CLAUDE.md`.
3. Leé entero el plan. A vos te toca **L3** (y su parte de L5, la documentación de §3, L3.5).
**L1, L2 y la carta son de la otra sesión; L0 y L4 son de Carlos.** No los hagas.
4. **El mail del cliente y el Excel no están en el repo y no los vas a tener.** El plan transcribe
todo lo que hace falta (§1.4 trae el pedido textual de Magaly).
5. Leé antes de diseñar, en este orden:
- `doc/architecture/ADR-005-modulo-caja-doble-saldo.md` y **`ADR-007-prefondeo-tres-capas.md`**
(las invariantes: ningún saldo se guarda, ledger inmutable, mover plata dentro del país no
descuenta el saldo del país);
- `ADR-013`, `ADR-014`, `ADR-015`, `ADR-021` y `ADR-022`;
- `doc/functional/2026-08-05-modulo-caja/01-modelo-de-saldos.md` (el circuito, 1.10);
- `backend/app/Models/CashBox.php`, `CashMovement.php`, `CashSession.php`;
`backend/app/Services/CashBoxService.php`, `CountryPrefundingService.php`,
`TreasuryStatementService.php`; `backend/app/Http/Controllers/CashBoxController.php`,
`CajaReportesController.php`, `StationController.php`;
- `frontend/src/views/CajaView.vue`, `PrefondeoPaisView.vue`,
`frontend/src/components/ExtractoTesoreria.vue`, `AdministrarCajas.vue` y `frontend/src/services/caja.ts`;
- el PR de J3 (`git show 69f723f`): es el formulario que **reemplazás**.
6. **Stack local: el de siempre** (`./start-dev.sh`, ver `doc/environments/dev.md`). Después de
cambiar de branch corré `docker compose exec backend php artisan migrate`. **Nunca
`migrate:fresh`, `db:wipe` ni `demo:reseed`** sobre la base de dev.
## 2. Decisiones (ya tomadas: no las reabras)
- **D5-3 = a.** Pasan plata entre cajas y con la bóveda: **Supervisor (solo de sus PDV), Tesorería
y Admin. El Cajero no.** Módulo de permiso nuevo `traspaso_caja`: Cajero `[0,0,0]`, Supervisor
`[1,1,0]`, Tesorería `[1,1,0]`, Admin `[1,1,1]`.
- **D5-4 = a.** La bóveda **no se abre ni se cierra**: no tiene sesión ni día.
- **D5-5 = a.** **Fondear directamente una caja abierta (Saldos) se mantiene** como atajo.
- **D5-6 = a.** En un traspaso, **cada extremo que no sea la bóveda tiene que tener una sesión
abierta hoy**; la bóveda no necesita ninguna.
- **D5-7.** Motivos de traspaso (catálogo cerrado): `Reposición de fondos`, `Devolución de fondos`,
`Otro` (con detalle).
- **D5-8 = a.** Los traspasos **no aparecen** en los extractos del país ni del PDV (suman cero); sí
en el historial de cada caja.
- **D5-9 = a.** En Fondeo PDVs, pestaña PDV, **«Fondear PDV» manda la plata a la bóveda y reemplaza
el formulario de J3.**
- **D5-10 = a.** La bóveda se vacía para dar de baja un PDV o apagar el módulo con un **ajuste negativo
de motivo `Retiro por baja de caja`, aceptado sobre la bóveda sin sesión**.
- **La bóveda es una `CashBox` con `number = 0`**, sin columna nueva; su `cash_session_id` es `null`.
- **ADR nuevo = ADR-029.** No uses 024 a 028: los reservan los branches de la migración a Azure.
- **Las migraciones son portables:** solo el schema builder de Laravel; nada de SQL crudo de
PostgreSQL (`::`, `ILIKE`, índices parciales, `jsonb`). Hay una migración a Azure/MySQL abierta.
## 3. La entrega: L3
Plan §3, **L3.0 a L3.6**. Es la especificación completa: el modelo, las migraciones, las reglas del
backend (la tabla de validaciones del traspaso y los códigos de error), las pantallas, los tests
obligatorios y la documentación.
**Leé entera la sección L3.7 del plan antes de escribir código: es la lista de todo lo que la bóveda
rompe en el backend, los tests y el frontend, con archivo y línea, y cada punto se cierra en el PR.**
Los cinco más graves: (1) la bóveda **no se puede abrir ni pagar** (guarda en `apertura` y en
`applyCashBoxDiscount`); (2) fondeo y ajuste necesitan una rama **sin sesión** para la bóveda; (3) el
bloqueo al desactivar un PDV o apagar el módulo con la bóveda con plata (D5-10); (4) los totales de
reportes tienen que sumar `traspaso` para conciliar; (5) las bóvedas se crean en los tres puntos de
alta y en la migración, no con un observer del modelo ni cambiando el default de `number`.
Cuidados que el plan marca y que son fáciles de pasar por alto:
- **`Station::cashBox()` es un `HasOne` sin orden** y `CashBoxService::ensureCashBoxesForCountry` usa
`doesntHave('cashBox')`: con la bóveda presente, hay que contar **solo las cajas operativas**.
Revisá todo uso con `grep -rn "cashBox()" backend/app`.
- **Concurrencia:** `pay()` bloquea la **sesión** de la caja; el traspaso tiene que tomar esos mismos
locks (más la fila de `cash_boxes` de la bóveda) **en orden fijo por `cash_box_id`** y releer los
saldos adentro de la transacción.
- **Sumas y conteos de cajas** que ahora incluyen la bóveda: «cajas abiertas» no la cuenta; el total
del PDV y lo «distribuido» del país sí.
- **El Cajero nunca recibe la bóveda** en `/caja/disponibles`, ni su saldo.
- **`CashBoxController::motivos` y `cajaApi.motivos`** hoy aceptan solo `FONDEO` y `AJUSTE`.
- **Los tres lugares con etiquetas de tipo de movimiento** (`CashBoxController`, `CajaReportesController`,
`TreasuryStatementService::cashConcept`).
- **Permiso nuevo:** seguí el camino de `reporte_cumplimiento` (migración de datos con
`EnsureRolePermissions::forModule` + `RoleSeeder::MATRIX` + `PermissionModules` +
`matriz-de-perfiles.json` + ADR-014 + manual). `php artisan permisos:diferencias` tiene que decir
«Sin diferencias».
## 4. Cómo trabajás
1. Tests en el mismo commit que el código. **Commits por capa**, en este orden: (1) migraciones y
modelo, (2) reglas del backend y sus tests, (3) extractos y reportes, (4) pantallas y sus tests,
(5) documentación. Cada commit con el trailer de atribución que indique el sistema.
2. **Antes de la primera corrida de la suite**, el canario de aislamiento:
`docker compose exec backend ./vendor/bin/phpunit --filter=DatabaseIsolationTest`.
**Si falla, no corras ningún otro test** (la suite usa `RefreshDatabase` y sin aislamiento vacía la
base de dev). Es lo único que te autoriza a parar: dejá el trabajo commiteado y explicá qué pasó.
3. Corré y pegá la salida real:
- `docker compose exec backend php artisan test` y
`docker compose exec backend ./vendor/bin/pint --test`;
- en `frontend/`: `npm run test` y `npm run build` (incluye `vue-tsc`);
- en `doc/`: `npm ci` y `npm run docs:build` (corta con links rotos).
No pushees en rojo.
4. **Verificá a mano en el stack local** el circuito completo, con tres usuarios (Tesorería,
Supervisor, Cajero) y datos de demo: (a) Tesorería fondea el PDV desde Fondeo PDVs → la plata
aparece en la bóveda y en el extracto del PDV, y el saldo del país **no** baja; (b) el Supervisor
pasa plata de la bóveda a una caja abierta, entre dos cajas y de una caja a la bóveda; (c) el Cajero
paga y su caja baja; (d) los extractos del país y del PDV **no** muestran los traspasos y su saldo
corrido cierra; (e) el Cajero no ve la bóveda. Anotá en el PR lo que viste.
5. `code-reviewer` sobre cada capa y **la lente de `security`** sobre el alcance de los traspasos y las
carreras. Corregí lo que marquen y recién ahí pusheá.
## 5. Documentación (L3.5)
ADR-029 (más su línea en `doc/architecture/index.md`), notas «Actualización» en ADR-007 y ADR-013,
el funcional de Caja, el manual (con la página nueva `33-caja-traspasos.md`), el plan de pruebas
`doc/qa/2026-10-19-l3-boveda-plan-de-pruebas.md`, `doc/environments/staging.md` (el deploy cambia
permisos de usuarios reales: avisar antes) y **un bullet corto en `CLAUDE.md`**, «Estado actual».
## 6. Autorización y límites
Te autorizo, sin pedirme confirmación, a:
- guardar con `git stash` cambios ajenos sin commitear (sección 1);
- crear el branch `feature/v3-ronda3-boveda`;
- implementar, testear y commitear;
- levantar, usar y reiniciar el stack de Docker local;
- correr migraciones sobre la base de dev;
- pushear ese branch;
- abrir y actualizar su PR contra `main`.
No hagas nada de esto:
- mergear;
- push, merge o deploy a `staging` o `production`;
- `terraform apply`;
- disparar workflows de GitHub Actions;
- correr comandos contra Staging o Producción;
- mandar mails o mensajes;
- force-push, `reset --hard` o rebase de un branch pusheado;
- tocar `docs/plan-respuesta-14-oct`, `feature/v3-ronda3-ajustes` ni los branches de la migración a
Azure (`feature/az-*`).
Si aparece algo que el plan no decide, tomá la opción más conservadora y más parecida a lo que ya
existe, anotala en «Decisiones que tomé sin Carlos» del PR y seguí. **Si toca plata o permisos y no
hay una opción conservadora clara, dejá esa parte sin hacer y explicá qué falta.**
## 7. Reglas que no se negocian
- Ningún dato personal en el código, los tests, los commits ni la documentación. En los tests, datos
inventados.
- **Ningún saldo se materializa** (ADR-005, ADR-007): todo se deriva del ledger. Los movimientos son
inmutables: un error se corrige con otro movimiento.
- **La bóveda no paga:** un `PAGO` solo sale de una caja operativa con sesión abierta hoy.
- **Un traspaso suma cero** dentro del PDV y **nunca cambia el saldo del país**.
- No se toca la integración C2P (`C2PController`, OAuth, `SendRequest`, `Cancel`, Notifications) ni
la lógica de `pay()` (salvo el texto de `INSUFFICIENT_CASH_BALANCE`).
- No se toca nada de lo que es de la sesión A: el A4, `PagoView.vue`, `MatchResultCard.vue`, la carta.
- Las migraciones son reversibles, idempotentes y no reescriben datos de transacciones.
## 8. Al terminar
Dejá en el chat y en la descripción del PR:
1. El link del PR y el estado del CI.
2. Qué parte de L3 quedó hecha, parcial o sin hacer, y qué verificaste a mano (el circuito de la
sección 4, punto 4) y qué no.
3. Las decisiones que tomaste sin Carlos.
4. **Lo que cambia para los usuarios reales de Staging al desplegar** (permisos del Supervisor, las
bóvedas nuevas, los textos «Distribuido en PDVs»).
5. Lo que le toca a Carlos, en orden: `git stash pop` si guardaste algo; revisar y mergear; promover
a Staging (cambia permisos: avisar antes); verificar con la lista de QA; actualizar la tabla de
estado del plan.
6. Lo que encontraste roto o raro y no era de este plan.
