Skip to content

docs: guía E2E y referencias a PHP 8.5 en AGENTS.md (+ helper de smoke test)#54

Merged
erseco merged 1 commit into
mainfrom
docs/agents-e2e-and-php85
May 31, 2026
Merged

docs: guía E2E y referencias a PHP 8.5 en AGENTS.md (+ helper de smoke test)#54
erseco merged 1 commit into
mainfrom
docs/agents-e2e-and-php85

Conversation

@erseco
Copy link
Copy Markdown
Owner

@erseco erseco commented May 31, 2026

Probé a fondo en local con make up y Chrome + extracción real de Gemini todos los PRs mezclados hoy (#27, #29, #46, #48, #41, #31, #52). No encontré errores funcionales — todo funciona end-to-end. Lo que sí faltaba/estaba desactualizado es la documentación, que es lo que corrige este PR.

Cambios

  • AGENTS.md — guía de validación E2E: documenta el flujo real (subir → extracción IA → revisión → importar) con make up, puerto (8080, o 18080 por el docker-compose.override.yml), login, selección de proveedor de IA y uso de las fixtures, igual que la receta de ScheduledMail. Así cualquier agente puede reproducir la verificación contra un proveedor real.
  • Test/e2e-smoke.php: helper no interactivo que recorre las fixtures y ejecuta extracción + mapeo + import, reportando factura/adjunto/avisos. Pensado para correr dentro del contenedor de desarrollo.
  • Corrección de referencias desactualizadas: la matriz de CI pasó a 8.1-8.5 (tras añadir 8.5), pero AGENTS.md seguía diciendo 8.1-8.4 en dos sitios.
  • PHPCS: se excluye el helper de dev del lint, como ya se hace con Test/bootstrap.php e install-plugins.php.

Verificación realizada (resumen)

…S.md

- Document the live upload -> AI extraction -> review -> import flow (make up,
  port, login, provider selection, fixtures) so the merged features can be
  exercised against a real provider, mirroring the ScheduledMail recipe.
- Add Test/e2e-smoke.php: a non-interactive helper that runs the extraction +
  map + import path over the fixtures and reports invoice/attachment/warnings.
- Fix outdated CI matrix references (8.1-8.4 -> 8.1-8.5 after the 8.5 addition).
- Exclude the dev-only smoke helper from PHPCS, like the other Test/ scripts.

No functional defects were found end-to-end testing today's merged PRs
(#27 keyboard nav, #29 image attachments, #46 stock/purchase data, #48 payment
method, #41 localized warnings, #31 tax-inclusive receipts); this PR only adds
the validation guide, the smoke helper and the doc fixes.
@github-actions
Copy link
Copy Markdown

FacturaScripts Playground Preview

Open this PR in FacturaScripts Playground
Try this PR in your browser

This preview is generated automatically for the docs/agents-e2e-and-php85 branch and loads the plugin directly from the PR branch ZIP in FacturaScripts Playground.

@erseco erseco requested a review from AnaLaRama May 31, 2026 21:30
@erseco erseco merged commit 9632d03 into main May 31, 2026
7 checks passed
@erseco erseco deleted the docs/agents-e2e-and-php85 branch May 31, 2026 21:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant