Prompt de ejecución — Pendientes del Excel «Soterex GT - ajustes v3»
Date: 2026-10-13
Uso. Copiar el bloque como primer mensaje de una sesión nueva de Claude Code. Ejecuta 2026-10-13-ajustes-v3-excel-pendientes.md, que vive en el branch claude/kind-archimedes-je953t hasta que se mergee. La sesión trabaja en el directorio del repo, sin worktree, y de corrido, sin preguntar.
Revisá la sección «2. Decisiones» del bloque. Trae las recomendaciones del plan (D4-1 a D4-4, todas en la opción a). Si decidiste otra cosa, cambiá esa línea: la sesión no te va a preguntar.
Arrancala 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.). Si querés que no frene nunca, está--permission-mode bypassPermissions. Con ese modo 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.
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.**
Preparalo así:
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. Guardalos con
`git stash push -u -m "antes de feature/v3-excel-pendientes"` y anotá que lo hiciste. Al
terminar se lo avisás a Carlos con el branch original, para que haga `git stash pop` ahí.
- Después:
git fetch origin
git checkout -b feature/v3-excel-pendientes origin/claude/kind-archimedes-je953t
El branch nuevo arranca desde el commit del plan; el plan entra a `main` con tu PR. Todo lo
que sigue (código, tests, commits, push) se hace en este branch y en este directorio.
2. Ya en el branch nuevo, leé `CLAUDE.md`.
3. Leé entero `doc/plans/2026-10-13-ajustes-v3-excel-pendientes.md`. Es la fuente de verdad:
§2 dice qué falta, §3 cómo se hace cada entrega, §4 las decisiones y §5 las preguntas nuevas.
4. **El Excel del cliente no está en el repo y no lo vas a tener**: tiene datos personales. El plan
transcribe todo lo que hace falta. No lo pidas ni lo busques.
5. Para contexto de cada entrega:
- El plan de ajustes v3, `doc/plans/2026-10-04-ajustes-v3-cliente-gt.md` (RV3 y QC).
- `doc/architecture/ADR-023-las-reglas-de-formato-del-documento-de-identidad-viven-en-el-catalogo.md`.
- ADR-007 y ADR-013 para el modelo de Caja.
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` para que la base de dev tenga las migraciones
del branch. **Nunca `migrate:fresh`, `db:wipe` ni `demo:reseed`** sobre la base de dev.
## 2. Decisiones (ya tomadas: no las reabras)
- **D4-1 = a. Operador enmascarado en los dos formatos (A4 y tirilla).** La regla, en una función
de `PapeletaService`, es esta:
- Se toma la parte del mail anterior a «@» y se muestran sus primeros 4 caracteres, o menos si
es más corta.
- Siempre se agregan «••••»: un largo fijo, para no revelar el largo real.
- El dominio no se muestra. Sin quien resolvió, sigue «—».
- Ejemplo: `backoffice@cislatam.test` → `back••••`.
- Verificá en el PDF de los dos formatos que «•» se vea (la tirilla usa Arial). Si no se ve,
usá «****» y anotalo.
- El mail completo sigue igual en Auditoría y en «Procesada por».
- **D4-2 = a. La nacionalidad se guarda como código de país de 2 letras**, igual que
`identification_country`.
- Los valores viejos en texto libre no se migran.
- Las `PAID` no cambian.
- Una `ACCEPTED` con texto libre en el borrador tiene que elegir un país antes de pagar.
- **D4-3 = a. Fondear un PDV desde Fondeo PDVs se hace sobre una caja con sesión abierta hoy**, con
el mismo endpoint que usa Saldos (`POST /api/caja/{cashBox}/fondeo`). No hay plata en tránsito ni
confirmación de recepción: eso es G13.B y no se hace acá.
- **D4-4 = a. La carta al cliente pide que vuelvan a probar ya.** Vos solo escribís el borrador;
lo manda Carlos.
## 3. Qué hacés, en este orden
1. **J1**: recibo A4 reordenado y operador enmascarado (plan §3).
2. **J2**: nacionalidad como desplegable de países.
3. **J3**: fondear un PDV desde Fondeo PDVs.
4. **J0.1 y J0.2**, solo la parte escrita:
- el borrador nuevo de la carta al cliente;
- la pregunta S-6 sumada al borrador del mail a Soterex.
Van al final, porque cuentan lo que quedó hecho.
**No hagas:**
- J0.3 y J0.4: son de Carlos, piden entrar a Staging.
- J4: solo si J0.3 reproduce el error.
- J5: solo si el cliente contesta QC-3.
- G13 y RV3-67: esperan al cliente.
Si el tiempo no alcanza, el orden de arriba es la prioridad.
**Un solo branch (`feature/v3-excel-pendientes`), un PR contra `main`, un commit o más por entrega:**
- `feat(recibo): J1 — …`
- `feat(pago): J2 — …`
- `feat(tesoreria): J3 — …`
- `docs(plan): J0 — …`
Abrí el PR al terminar J1 (`gh pr create --base main`) y actualizá su descripción con cada entrega.
Usá los agentes que necesites:
- `backend-dev` y `frontend-dev` para el código;
- `tech-writer` para el manual y las cartas;
- `code-reviewer` sobre el diff de cada entrega antes de pushearla;
- `security` sobre J3, que mueve plata: alcance por país y por PDV del fondeo.
## 4. Cada entrega, con lo que tiene que quedar
### J1 — Recibo A4 (`backend/resources/views/pdf/partials/papeleta-a4-copia.blade.php`, `backend/app/Services/PapeletaService.php`)
- El orden de §3 del plan, sin agregar ni sacar campos:
1. Agencia · Ciudad · Operador.
2. MTCN · Fecha / Hora.
3. Remitente · País de origen.
4. Beneficiario; Tipo de identificación · N.º · País de emisión; Provincia / Estado · Ciudad;
Dirección; Teléfono · Mail.
5. Montos y moneda.
6. Transacción fija · Tipo de transacción.
7. Declaración (los cuatro incisos de hoy) y firmas.
- Las dos copias del A4 salen iguales.
- El operador enmascarado según D4-1, en A4 y tirilla.
- Tests en `backend/tests/Feature/PapeletaFormatosTest.php`:
- el orden de los rótulos en el A4;
- el enmascarado con un mail normal, uno con parte local de menos de 4 caracteres y sin quien
resolvió;
- que el mail completo no aparezca en ninguno de los dos PDF.
- Manual: la sección de la papeleta en `doc/manual/10-pago.md`.
### J2 — Nacionalidad (`frontend/src/components/DatosPagoForm.vue`, `backend/app/Http/Controllers/TransactionController.php`)
- **Frontend.** El input de texto (alrededor de la línea 550) pasa a ser un `<select>` con:
- la misma lista `paisesId` que «País de la identificación»;
- el mismo `conOpcionLibre`, para que un valor viejo en texto libre se siga viendo como opción;
- el mismo comportamiento en solo lectura (`PAID` y `CANCELLED`).
- **Backend.** La regla de `nationality` copia la de `identification_country`:
- `size:2` y existir en el catálogo `COUNTRY` global y activo, con `whereNull('country_id')`;
- sin la regla del país emisor;
- se borra el comentario «Texto libre y corto, a propósito…», que deja de ser cierto.
- **Salidas.** Buscá `nationality` en todo el backend y el frontend y resolvé la etiqueta donde se
muestre:
- Cumplimiento, columna 4 (`ReporteCumplimientoService.php`): usá `EtiquetasDeCatalogo::etiqueta`,
que devuelve el texto tal cual si no es un código;
- y las demás salidas que encuentres.
- **Tests.**
- `DatosPagoForm.spec.ts`: el combo, la opción libre con un valor viejo y el solo lectura.
- Feature test de guardar datos y de pagar: código válido; código inexistente o inactivo da 422;
una `ACCEPTED` con texto viejo no se paga hasta elegir un país; una `PAID` con texto viejo no
cambia.
- Cumplimiento, columna 4, con código y con texto libre.
- **Manual.** `doc/manual/10-pago.md` (datos del pago) y `doc/manual/61-reportes-cumplimiento.md`
(columna 4).
- **Demo.** Si `DemoTransactionSeeder` genera nacionalidades en texto, pasalas a códigos.
### J3 — Fondear un PDV (`frontend/src/views/PrefondeoPaisView.vue`)
- En la pestaña PDV, un formulario a la derecha de los filtros, solo con `fondeo_caja:write`
(Tesorería y Admin). El Supervisor no lo ve. Lleva:
- el PDV elegido arriba;
- la caja, solo las que tienen sesión abierta hoy;
- el monto (`MoneyInput`);
- el motivo, del catálogo de fondeo (`cajaApi.motivos('FONDEO')`) y con el detalle que pida el
motivo;
- «Fondear caja».
- **Sin ninguna caja abierta en ese PDV**, el formulario dice por qué no se puede y que alguien
tiene que abrir una caja (no inventes otra salida).
- **Los avisos y errores salen igual que en Saldos** (`CajaView.vue`), con los mismos textos donde
se pueda: `OVER_COUNTRY_PREFUNDING`, `CASH_SESSION_CLOSED` y el de una caja de un día anterior
(ADR-013).
- Después de fondear se refresca el extracto del PDV y se ve el movimiento.
- **Backend.** Reusá el endpoint de fondeo. Para listar las cajas abiertas de un PDV, usá el listado
que ya usa Saldos, si con el alcance de Tesorería alcanza; si no, sumá un `GET` chico, de solo
lectura y con el mismo alcance que el fondeo (`authorizeStationScope`), con test en
`CashBoxApiTest.php`.
- **Tests.** `PrefondeoPaisView.spec.ts`:
- formulario visible o no según el permiso;
- sin cajas abiertas;
- fondeo OK con refresco del extracto;
- cada error.
Y un test de API: una Tesorería asignada solo a un país no fondea una caja de otro país.
- **Documentación.**
- `doc/manual/41-prefondeo-pais.md` y `doc/manual/32-caja-fondeo.md`: las dos vías para fondear.
- El funcional de Caja (`doc/functional/2026-08-05-modulo-caja/`), donde describe el fondeo.
### J0.1 y J0.2 — Las cartas (solo borradores; no mandes nada)
- **Escribí `doc/plans/2026-10-13-borrador-respuesta-al-cliente-excel-v3.md`.** Se arma sobre
`doc/plans/2026-10-07-borrador-respuesta-al-cliente-ajustes-v3.md` y respeta sus reglas: español
neutro, sin voseo, sin claves internas (ni J, RV3, D3, ADR ni números de PR) y la marca de
borrador arriba. Tiene que decir:
- que lo de sus respuestas del 2/10 **está instalado en el ambiente de pruebas desde el 7/10**, y
pedir que vuelvan a probar los 15 ítems que marcaron «PENDIENTE» (lista de §2 del plan);
- por qué tres de ellos quedan como están: los documentos al solo consultar, con la pregunta
QC-3; el catálogo de formas de pago; el selector de perfil;
- la variante de quién cierra una caja;
- que ya pueden volver a probar documentos (QC-4);
- los cuatro pedidos nuevos: cuáles quedaron hechos en tu PR, «en desarrollo» si no se
instalaron todavía, y que Pago 15 lo estamos revisando;
- las seis preguntas del borrador anterior más QC-3, QC-40 y QC-41 (§5 del plan).
- **En el borrador del 07/10**, agregá arriba una línea que diga que lo reemplaza el nuevo.
- **Sumá S-6** (§5 del plan) al borrador
`doc/integracion/2026-10-07-borrador-preguntas-a-soterex-ajustes-v3.md`, con el mismo formato que
S-1 a S-5.
## 5. Cómo trabajás cada entrega
1. Tests en el mismo commit que el código.
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`;
- si tocás el frontend, `npm run test` y `npm run build` (incluye `vue-tsc`) en `frontend/`,
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:
- J1: generá y abrí los dos PDF de un pago de demo;
- J2: cargá un pago con el combo, mirá la ficha pagada y bajá el Excel de Cumplimiento;
- J3: con un Admin, abrí una caja como Cajero, fondeala desde Fondeo PDVs y mirá Saldos y el
extracto.
5. `code-reviewer` sobre el diff de la entrega; corregí lo que marque y recién ahí pusheá.
## 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-excel-pendientes`;
- 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 `claude/kind-archimedes-je953t`.
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: nada de nombres,
documentos o mails reales. En los tests, datos inventados.
- Ningún saldo se materializa (ADR-005, ADR-007). J3 no agrega una forma nueva de mover plata: usa
el fondeo que existe.
- No se cambia ningún permiso de la matriz (`RoleSeeder::MATRIX`) ni se agrega una migración de
permisos.
- No se toca la integración C2P (`C2PController`, OAuth, `SendRequest`, `Cancel`, Notifications).
- Las migraciones, si hacen falta, son reversibles y no reescriben datos de transacciones
`PAID`/`CANCELLED`.
- Si una decisión de arquitectura nueva aparece, va en un ADR nuevo en `doc/architecture/` (y en su
`index.md`), no en un comentario.
## 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. Lo que le toca a Carlos, en orden:
- si guardaste cambios con `git stash`: en qué branch estaba el repo y que haga `git stash pop`
ahí;
- revisar y mergear;
- promover a Staging;
- J0.3 y J0.4 del plan;
- mandar las dos cartas.
5. Lo que encontraste roto o raro y no era de este plan.
