Entender la puntuación

Cada caso completado lleva una score (puntuación) — un número entero de 0 a 100 que valora la calidad de accesibilidad del resultado PDF/UA remediado. La lees desde GET /job-status/{caseId}:

{ "jobStatus": "completed", "stage": "finished", "score": 87 }

Cuanto más alta, mejor: 100 significa que no quedó ningún problema de accesibilidad tras la remediación.

Cuándo es definitiva la puntuación

El número solo es significativo una vez que el trabajo está completed (stage: finished). Antes de eso es un valor provisional — un caso queued informa "score": 0, y durante revalidating la puntuación todavía se está recalculando sobre el archivo remediado. Léela solo tras el estado terminal completed; ignórala en cualquier otro estado.

Nota

La puntuación describe el resultado que producimos, no tu subida. Mide lo que sigue estando mal después de que Accessful haya corregido todo lo posible — así que responde a «qué tan accesible es el archivo que voy a descargar», no «qué tan malo era el original».

Cómo se calcula

La puntuación se basa en penalizaciones. Cada archivo empieza en 100, y cada problema de accesibilidad que permanece en el resultado resta. Cuatro factores moldean el número:

• La gravedad domina. Un bloqueante estructural cuesta mucho más que un hallazgo cosmético. Las gravedades, de la más alta a la más baja:

  Gravedad	Qué cubre
  Bloqueante	Estructura de etiquetas básica, imágenes sin etiquetar, falta de idioma del documento
  Mayor	Problemas estructurales importantes para la tecnología de asistencia
  Menor	Metadatos, marcadores, numeración de páginas, artefactos
  Info	Hallazgos de buenas prácticas / informativos

• Lo corregido no cuesta nada. Solo cuentan los hallazgos abiertos. Todo lo que Accessful remedió con éxito es gratis — ese es justamente el objetivo de la conversión.

• Las repeticiones no dominan. Muchos hallazgos del mismo tipo se amortiguan de forma logarítmica, de modo que el mismo problema en 200 páginas no se penaliza 200× más que en una sola página.

• La revisión manual es barata. Algunos problemas no se pueden corregir automáticamente con confianza (p. ej. «¿este texto alternativo es realmente significativo?»). Esos llevan una pequeña penalización fija en lugar del peso completo de la gravedad y se dejan para que una persona los confirme.

Una señal de calidad, no un certificado legal

Una puntuación alta significa que quedan pocos problemas de accesibilidad — no es una garantía de conformidad legal PDF/UA ni un sustituto de una auditoría de accesibilidad manual. Trátala como un indicador fuerte, no como una aprobación de conformidad.

La ponderación exacta se ajusta con el tiempo a medida que mejora la remediación; solo el rango 0–100 y «más alta es mejor» forman parte del contrato de la API.

Leer una puntuación

La API devuelve solo el número. Como regla práctica:

Puntuación	Cómo leerla	Acción típica
90–100	Excelente — esencialmente limpio	Publícalo.
75–89	Buena — quedan problemas menores	Utilizable tal cual; revisa los documentos críticos.
50–74	Aceptable — quedan brechas reales	Revisa antes de publicar; la fuente probablemente tenía debilidades estructurales.
Menos de 50	Pobre	La fuente fue difícil de remediar automáticamente; mejórala y vuelve a subirla.

Por qué una puntuación no es más alta

La razón más común de que una puntuación se estanque por debajo de 100 es el documento de origen: un PDF escaneado sin capa de texto, imágenes que no se pueden describir con confianza, o contenido cuyo orden de lectura no se puede inferir con seguridad. Accessful corrige estructura, etiquetas, metadatos, idioma y texto alternativo allí donde puede determinarlos de forma fiable, y deja el resto como hallazgos abiertos o de revisión manual en lugar de adivinar.

Para mover el número, mejora la fuente — añade una capa de texto real, aporta encabezados auténticos — y sube el nuevo archivo. Reenviar los mismos bytes no ayuda: el contenido idéntico se detecta como duplicado y se omite.