Skip to content

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 (el backoffice@…) y un Admin.

  • Una transacción ACCEPTED de 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):

    bash
    rellenar() { 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 21

    Para 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 ​

#PasoResultado esperado
1.1Como 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.2Click en el nombre del documentoEl preview carga el PDF; en DevTools → Network, GET …/documentos/{id} da 200
1.3Subir Identificación (anverso) con /tmp/qa-2mb.jpgTilde verde; el preview muestra la imagen
1.4Subir Identificación (reverso) con /tmp/qa-2mb.pngTilde verde; badge "Completa"; el botón "Iniciar pago" se habilita
1.5Subir un PDF de 19 MB (/tmp/qa-19mb.pdf) como SelfieSe sube (201) y se abre. Es el tope razonable: el límite es 20 MB
1.6Mirar 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.

#ArchivoResultado 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.2Una foto HEIC (o cualquier archivo .heic)«El archivo tiene que ser PDF, JPG o PNG.»
2.3Un .zipEl mismo aviso
2.4Debajo del botón "Subir", antes de elegir nadaSe lee «PDF, JPG o PNG, de hasta 20 MB»
2.5Subir 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.6Subir por la API un archivo de texto con extensión .pdf y Content-Type: application/pdf422: 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) ​

#PasoResultado esperado
3.1Con 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.2Recargar 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.3Mirar la auditoríaNo hay un TRANSACTION_DOCUMENT_VIEWED de ese intento: no se le entregó nada a nadie
3.4Mirar el badge de la documentaciónSigue diciendo "Completa": la completitud se calcula sobre filas. Es lo esperado (ver el punto 6)
3.5Como Admin, Reemplazar ese documento con un archivo válidoSe sube; ahora se abre
3.6Cortar 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 ​

#PasoResultado esperado
4.1Con el estado del punto 3.1 (un soporte sin archivo), docker compose exec backend php artisan documentos:verificar --detalleLista 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.2Repetir 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.3Sin --detalleSolo los totales y una línea que dice que no se cambió nada
4.4Mirar la auditoría y la baseEl 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.

#PasoResultado esperado
5.1Subir un JPG de 100 KB a una ACCEPTED de prueba201 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.2AbrirloEl preview carga (200)
5.3Sobrevive a un redeploy: aws ecs update-service … --force-new-deployment, esperar a que estabilice y volver a abrirloSe abre igual. Antes de G1 daba 404
5.4El objeto en el bucket, con la CLI de AWSEstá, ServerSideEncryption es AES256, el bloqueo de acceso público tiene los cuatro valores en true y un curl sin credenciales da 403
5.5Matriz: PDF, JPG y PNG de 100 KB, 2 MB y 19 MBTodos 201 y se abren; el tamaño del objeto (head-object) coincide con el del archivo
5.6El de 21 MB y un HEICAvisos de la parte 2, sin POST
5.7Prueba 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.8documentos:verificar --detalle con el workflow de artisanLista 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.9Antes de avisarle al cliente: las ACCEPTED que figuran en 5.8Se 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.10El simulador de IAM para el task rolePutObject, 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-only en Staging quede en el bucket: se limpia a mano (el task role no puede borrar).

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