Plan de Pruebas — G1: soportes de pago que sobreviven a un deploy
Fecha: 2026-10-06 Decisión: ADR-019 (D3-1 del plan de ajustes v3) Alcance: RV3-06 (no deja adjuntar PDF/JPG) y RV3-07 (no se puede abrir lo adjuntado) Ambiente: la parte 1 a 4 en Dev local (./start-dev.sh, http://localhost:5173, disco local); la parte 5, en Staging, después del despliegue de G1 (lo corre Carlos, con el runbook de Staging)
Qué cubre este plan además de lo nuevo: el hueco heredado de Pago, que nunca tuvo una prueba manual de subir y abrir un soporte real ni de qué pasa con un archivo que ya no está.
Antes de empezar
Usuarios de prueba: los de
doc/environments/dev.md. Hace falta un Cajero (elbackoffice@…) y un Admin.Una transacción
ACCEPTEDde GT. Si no hay,docker compose exec backend php artisan demo:seed-accepted 5.Archivos de prueba. Los tres del repo (
backend/tests/fixtures/soporte.{pdf,jpg,png}) pesan menos de 1 KB. Para los demás tamaños se les agregan ceros después del contenido (siguen siendo un PDF, un JPG y un PNG válidos para el servidor, que mira los primeros bytes y no la extensión):bashrellenar() { cp "$1" "$2"; head -c "$(( $3 * 1024 * 1024 - $(wc -c < "$1") ))" /dev/zero >> "$2"; } rellenar backend/tests/fixtures/soporte.pdf /tmp/qa-2mb.pdf 2 rellenar backend/tests/fixtures/soporte.jpg /tmp/qa-2mb.jpg 2 rellenar backend/tests/fixtures/soporte.png /tmp/qa-2mb.png 2 rellenar backend/tests/fixtures/soporte.pdf /tmp/qa-19mb.pdf 19 rellenar backend/tests/fixtures/soporte.pdf /tmp/qa-21mb.pdf 21Para el de 100 KB usá un archivo real chico (o cualquiera de los fixtures). No uses el documento de una persona real.
1. Subir y abrir un soporte real
| # | Paso | Resultado esperado |
|---|---|---|
| 1.1 | Como Cajero, buscar la ACCEPTED en Pago y subir la Carta con soporte.pdf (menos de 1 KB) | El documento aparece con el tilde verde; el badge baja a "Faltan 2" |
| 1.2 | Click en el nombre del documento | El preview carga el PDF; en DevTools → Network, GET …/documentos/{id} da 200 |
| 1.3 | Subir Identificación (anverso) con /tmp/qa-2mb.jpg | Tilde verde; el preview muestra la imagen |
| 1.4 | Subir Identificación (reverso) con /tmp/qa-2mb.png | Tilde verde; badge "Completa"; el botón "Iniciar pago" se habilita |
| 1.5 | Subir un PDF de 19 MB (/tmp/qa-19mb.pdf) como Selfie | Se sube (201) y se abre. Es el tope razonable: el límite es 20 MB |
| 1.6 | Mirar la auditoría (Admin → Auditoría) | Una fila TRANSACTION_DOCUMENT_UPLOADED por cada subida y una TRANSACTION_DOCUMENT_VIEWED por cada apertura, sin el contenido |
2. Lo que la pantalla corta antes de enviar
Con DevTools → Network abierto, en ningún caso de esta tabla tiene que salir un POST …/documentos.
| # | Archivo | Resultado esperado |
|---|---|---|
| 2.1 | /tmp/qa-21mb.pdf | «El archivo pesa 21 MB y el máximo es 20 MB. Probá con uno más chico.» |
| 2.2 | Una foto HEIC (o cualquier archivo .heic) | «El archivo tiene que ser PDF, JPG o PNG.» |
| 2.3 | Un .zip | El mismo aviso |
| 2.4 | Debajo del botón "Subir", antes de elegir nada | Se lee «PDF, JPG o PNG, de hasta 20 MB» |
| 2.5 | Subir directo por la API un archivo de 21 MB (Postman o curl con el Bearer del usuario) | 422 de Laravel con errors.archivo: el backend también corta |
| 2.6 | Subir por la API un archivo de texto con extensión .pdf y Content-Type: application/pdf | 422: manda el contenido real y no el nombre |
3. Un soporte cuyo archivo ya no está (lo que veía el cliente después de cada deploy)
| # | Paso | Resultado esperado |
|---|---|---|
| 3.1 | Con un soporte ya subido, borrar el archivo del disco: docker compose exec backend sh -c 'rm storage/app/documents/transacciones/<id de la transacción>/*' | — |
| 3.2 | Recargar Pago y tocar el nombre del documento | «El archivo no está disponible. Un Supervisor o Admin puede volver a subirlo.» En Network el pedido da 404 con code: DOCUMENT_FILE_MISSING, no un 500 |
| 3.3 | Mirar la auditoría | No hay un TRANSACTION_DOCUMENT_VIEWED de ese intento: no se le entregó nada a nadie |
| 3.4 | Mirar el badge de la documentación | Sigue diciendo "Completa": la completitud se calcula sobre filas. Es lo esperado (ver el punto 6) |
| 3.5 | Como Admin, Reemplazar ese documento con un archivo válido | Se sube; ahora se abre |
| 3.6 | Cortar la conexión (DevTools → Network → Offline) y volver a tocar el nombre | «No se pudo abrir el documento: revisá la conexión» |
4. documentos:verificar
| # | Paso | Resultado esperado |
|---|---|---|
| 4.1 | Con el estado del punto 3.1 (un soporte sin archivo), docker compose exec backend php artisan documentos:verificar --detalle | Lista Falta el archivo: soporte … (transacción … RS-…, TIPO, disco documents, subido …) y los totales Soportes revisados, Con archivo y Sin archivo: 1. Sin el nombre del archivo, la ruta ni el MTCN |
| 4.2 | Repetir después de Reemplazar (3.5) | Sin archivo: 0 y Sin archivo pero ya reemplazados por uno más nuevo: 1: reparar baja el número. La fila vieja sigue en la base (un soporte no se borra) |
| 4.3 | Sin --detalle | Solo los totales y una línea que dice que no se cambió nada |
| 4.4 | Mirar la auditoría y la base | El comando no audita ni cambia nada: solo lectura |
5. En Staging (después del despliegue de G1; lo corre Carlos)
Es la parte que no se puede probar en local: el bucket real. Los pasos y comandos exactos están en el runbook de Staging; acá, el criterio de aceptación.
| # | Paso | Resultado esperado |
|---|---|---|
| 5.1 | Subir un JPG de 100 KB a una ACCEPTED de prueba | 201 y el documento aparece. Es la primera escritura real contra el bucket: confirma o descarta la ACL private (ADR-019). Si da 503, el detalle está en CloudWatch y el runbook dice qué sigue |
| 5.2 | Abrirlo | El preview carga (200) |
| 5.3 | Sobrevive a un redeploy: aws ecs update-service … --force-new-deployment, esperar a que estabilice y volver a abrirlo | Se abre igual. Antes de G1 daba 404 |
| 5.4 | El objeto en el bucket, con la CLI de AWS | Está, ServerSideEncryption es AES256, el bloqueo de acceso público tiene los cuatro valores en true y un curl sin credenciales da 403 |
| 5.5 | Matriz: PDF, JPG y PNG de 100 KB, 2 MB y 19 MB | Todos 201 y se abren; el tamaño del objeto (head-object) coincide con el del archivo |
| 5.6 | El de 21 MB y un HEIC | Avisos de la parte 2, sin POST |
| 5.7 | Prueba de humo de 1 MB y 15 MB tras cada apply que toque waf o ecs (P3-6) | 201 y se abren. Un 403 sin Access-Control-Allow-Origin es el WAF; un 413 es nginx; un 422 es la app |
| 5.8 | documentos:verificar --detalle con el workflow de artisan | Lista las filas viejas (las anteriores a G1); abrir una da el mensaje de 3.2. Después de volver a subir una, Sin archivo baja en uno |
| 5.9 | Antes de avisarle al cliente: las ACCEPTED que figuran en 5.8 | Se vuelven a subir su Carta y su identificación: el chequeo que bloquea el pago mira filas, no archivos, y deja pagar con el archivo perdido |
| 5.10 | El simulador de IAM para el task role | PutObject, GetObject, AbortMultipartUpload y ListBucket dan allowed; DeleteObject da implicitDeny |
6. Qué NO es parte de este cambio (no reportar como bug)
- Que los soportes subidos antes del despliegue de G1 no se puedan abrir: se perdieron con los deploys y no se recuperan; se vuelven a subir. G1 arregla que no vuelva a pasar, no los trae de vuelta.
- Que la pantalla siga diciendo "Completa" con una fila cuyo archivo no está (3.4), y que el pago se deje confirmar con ella: la completitud y el chequeo de ADR-008 se calculan sobre filas. Está documentado en el ADR-019 ("Lo que cuesta") y se cubre a mano con
documentos:verificar. - Que quien pagó pueda Reemplazar un documento: eso es del cambio de G5 (documentos del pago), no de este.
- Que el backup de
demo:reseed --wipe-onlyen Staging quede en el bucket: se limpia a mano (el task role no puede borrar).

