Validaciones disponibles y pendientes

Esta página explica qué comprobar y dónde están las herramientas. La existencia de un test o script no demuestra que se haya ejecutado contra tu instalación.

Comprobar una instalación

1. GET /health devuelve 200, BD y storage disponibles.
2. Tablet: alta, activación, creación, firma real en PWA y descarga desde BC.
3. PAdES: código AL incorporado a tu extensión en sandbox, alias autorizado, PDF firmado y comprobación independiente.
4. Extracción: PDF real con texto conocido y PDF escaneado; OCR solo al pedirlo.

Usa un entorno y dispositivos dedicados a validación: los scripts crean/cancelan solicitudes y algunos modifican activación o datos de prueba.

Scripts operativos

Desde la raíz del repositorio, con Python:

python ops/scripts/smoke_e2e.py --api-base-url http://127.0.0.1:8080 --bc-token replace_me --device-id tablet-pruebas-1

replace_me es exclusivamente el token del laboratorio Compose. En otro entorno usa su credencial según la política de ejecución, sin pegar secretos en logs compartidos.

Script en ops/scripts/	Comprueba
smoke_e2e.py	Flujo HTTP completo de firma manuscrita
contract_negative.py	Autenticación, entrada y estados inválidos
concurrency_next.py	Reserva concurrente del mismo documento
device_lifecycle.py	Activación/revocación
multi_tablet_isolation.py	Aislamiento de colas
expiry_flow.py	Caducidad
signed_storage_failure.py	Fallo de almacenamiento al subir resultado
purge_retention.py	Retención

Consulta python ops/scripts/<script>.py --help antes de ejecutarlo; algunos requieren configuración temporal de retención/almacenamiento. La prueba del mismo documento no demuestra que distintas solicitudes no puedan quedar activas para una tablet: consulta Límites.

Pruebas automatizadas de backend

El proyecto está en backend/tests/Api.Tests/. Incluye validaciones HTTP de extracción/PAdES, almacenamiento y verificación criptográfica de CMS:

dotnet test backend/tests/Api.Tests/Api.Tests.csproj

Las pruebas HTTP de extracción con extractor simulado no sustituyen probar el extractor real con páginas, tildes, columnas e imágenes. La verificación criptográfica con certificado efímero no sustituye validar confianza de certificado ni validar tu extensión en el tenant.

Validación antes de producción

La versión 0.2.16 cuenta con 115 pruebas de backend superadas, pruebas reales de interacción, geometría, CSP, imágenes y formularios con PDF.js en navegador, y comprobaciones de coincidencia exacta de los bytes de CMaps y fuentes. El paquete AL completo 1.1.0.0 compila con Microsoft AL Compiler 17.0.34.45391 y símbolos BC 24.5/runtime 13 sin errores ni advertencias. Estas comprobaciones cubren el código y la compilación; la interfaz del tenant, la custodia real del certificado, la conexión a la API pública y la confianza de un lector independiente siguen requiriendo validación en sandbox. Consulta las instrucciones de compilación y pruebas de Business Central.

Siguen pendientes en TASKS.md la integración BC cloud contra la URL pública, documentos reales próximos al límite y la validación funcional de certificados en el sandbox objetivo.

Para cada ejecución registra versión API/tablet/AL, entorno, archivo/tamaño, resultado esperado, observado y traces. El plan detallado está en docs/TEST_PLAN.md del repositorio.

Validar documentación

python -m pip install -r requirements-docs.txt
python -m mkdocs build --strict

Comprueba además enlaces locales y anclas Markdown. La build valida navegación y generación del sitio; no prueba comportamiento de la aplicación.