Captua 0.2.0

Versión en español abajo

0.2.0 keeps the archive's digitisation lists on the unit, lists the records waiting to be retaken, and puts retakes ahead of new volumes. It can also rebuild a volume digitised before Captua from images already in the bucket.

Digitisation lists (Cola)

• Lists imported from Fisqua are now kept on the unit. The Cola screen shows them one at a time, with each list's items in the list's order.
• Admins and operators import from Cola. If a list's project does not exist yet, only an admin can import it, and Captua creates the project.
• After an import, Cola reports how many volumes Captua created, and each item it set aside, with the reason.
• Each item shows:
  • its title and reference code;
  • what the list asks for: a full digitisation, a full rescan, a spot recapture, or the completion of a volume;
  • the list's instructions, in full;
  • the stage and progress of its volume.
• The list can be filtered by what each item asks for.
• Siguiente marks the first item that is not yet done and can be opened for capture. While retakes are pending, items whose volumes have retakes come first.
• A full digitisation counts as done once every record in its volume is approved. An admin or reviewer can mark any item done, and remove the mark. Captua records who marked it and when.
• Lists imported before 0.2.0 show their items once they are imported again.

The instruction on the capture screen

• When you capture into a volume named in a list, the instruction from the newest list naming it appears at the top of the capture screen. An example is the openings to recapture.
• By default the screen shows two lines. If the text is longer, Mostrar todo opens the rest, and the preview, the capture button and the thumbnail strip stay clear of it.

Retakes

• Por recapturar lists every record rejected in review, whether on the unit or in Fisqua, oldest rejection first.
  • Each row shows the volume, the reason with its explanation, the reviewer's note, and who rejected it and when.
  • The list can be filtered by volume.
  • The side menu shows how many records are rejected.
• For admins and operators, Volver a capturar starts a guided recapture through the volume's pending records, in order.
  • After each retake, Captua opens the next record.
  • Saltar por ahora moves a record to the end.
  • The retake window shows why the record was rejected.
• The overview shows how many openings are waiting, in how many volumes, and which volume has the most.
• A record is pending while it is rejected. It stays pending after it has been prepared for retake, until a new capture replaces its image.

The recapture turn

• While any record on the unit is pending, an operator can't start an empty volume.
  • Finishing the retakes of one volume allows one new volume.
  • The first capture into that new volume hands the turn back to retakes. Turns don't accumulate.
  • Captures into volumes that already have records are never blocked, and neither are retakes.
• The capture screen explains the block and links to a volume to retake. An admin can capture anyway. Cola shows whose turn it is.
• No one can send a volume with pending records to review. The volume page shows how many retakes are left.

Volumes digitised before Captua

• With shell access to the unit, an admin can rebuild a volume digitised with two cameras before Captua, using python -m app.core.rebuild_volume <stem> <bundle> --apply.
  • The command reads a prepared bundle: the plan of records, plus each source image's digests and thumbnail.
  • The masters must already be copied to the bucket under Captua names.
  • Each opening becomes a paired record, with each camera's rotation from the plan. An image without a partner becomes a single record.
  • The masters stay in the bucket. Only thumbnails and metadata are kept on the unit.
  • Without --apply, the command only reports what it would do.
  • A rerun keeps finished records only if they match the plan.
• A rebuilt volume is handed over like any other. Openings rejected in Fisqua come back to Por recapturar.

Rotation sent to Fisqua (optional)

• With CAPTUA_FISQUA_ROTATE_DEG=true, Captua writes the capture manifest as version 1.5, and each image carries its rotation as rotateDeg.
• The default is false, which leaves the manifest at version 1.1, unchanged. Turn it on only for a Fisqua that reads contract 1.5.

Other changes

• A project's volume list shows each volume's real stage. Before, it showed placeholder states.
• On a freed record, the note that the master is in the bucket no longer covers the thumbnail.

Fixes

• An import refuses a list containing a number too large to read, as it already refused NaN, instead of writing the value into the volume.
• An item whose stem ends in a line break is set aside as an invalid stem before it reaches the database.
• A record's rejection history starts with the rejection Por recapturar shows, also when two rejections were made at the same moment.

For integrators

• New routes:
  • GET /imports/digitisation-lists
  • PUT /imports/digitisation-lists/{list_id}/items/{position}/done
  • GET /records/to-retake, /to-retake/count, /to-retake/summary
• New 409 responses: recapture_turn on POST /cameras/capture and /capture/dual, and recaptures_pending on POST /collections/{id}/promote.
• New setting: CAPTUA_FISQUA_ROTATE_DEG (or DTK_), default false.
• New CLI: app.core.rebuild_volume.

Español

Con 0.2.0, las listas de digitalización quedan guardadas en el equipo, Captua muestra los registros que hay que volver a capturar y las recapturas van antes que los volúmenes nuevos. También se puede reconstruir un volumen que se digitalizó antes de Captua a partir de las imágenes que ya están en la copia externa.

Listas de digitalización (Cola)

• Las listas que se importan desde Fisqua ahora se guardan en el equipo. La pantalla Cola muestra una lista a la vez, con sus elementos en el orden de la lista.
• Los administradores y los operadores importan las listas desde Cola. Si el proyecto de una lista todavía no existe, solo un administrador puede importarla, y Captua crea el proyecto.
• Después de importar, Cola dice cuántos volúmenes creó Captua y qué elementos dejó por fuera, con el motivo de cada uno.
• Cada elemento de la lista muestra:
  • su título y su código de referencia
  • lo que pide la lista: digitalizarlo completo, volver a escanearlo completo, recapturar algunos pares de páginas o completar el volumen
  • las instrucciones de la lista, completas
  • la etapa y el avance de su volumen
• Puedes filtrar la lista según lo que pide cada elemento.
• Siguiente señala el primer elemento que todavía no está hecho y que se puede abrir para capturar. Mientras haya recapturas pendientes, van primero los elementos cuyos volúmenes tienen recapturas.
• Un elemento de digitalización completa aparece como hecho cuando todos los registros de su volumen están aprobados. Un administrador o un revisor puede marcar como hecho cualquier elemento, y también quitarle la marca. Captua guarda quién lo marcó y cuándo.
• Para ver los elementos de una lista importada antes de 0.2.0, vuelve a importarla.

La instrucción en la pantalla de captura

• Cuando capturas en un volumen que figura en una lista, en la parte de arriba de la pantalla de captura aparece la instrucción de la lista más reciente que lo nombra; por ejemplo, los pares de páginas que hay que recapturar.
• Al principio se ven dos líneas. Si el texto es más largo, Mostrar todo lo abre entero, sin tapar la vista previa, el botón de captura ni la tira de miniaturas.

Recapturas

• Por recapturar muestra todos los registros rechazados en la revisión, en el equipo o en Fisqua, empezando por el rechazo más antiguo.
  • En cada fila están el volumen, el motivo con su explicación, la nota de quien revisó, y quién lo rechazó y cuándo.
  • Puedes filtrar por volumen.
  • El menú lateral muestra cuántos registros están rechazados.
• Para los administradores y los operadores, Volver a capturar abre una recaptura guiada por los registros pendientes del volumen, en orden.
  • Después de cada recaptura, Captua abre el registro siguiente.
  • Saltar por ahora deja el registro para el final.
  • La ventana de recaptura muestra por qué se rechazó el registro.
• El resumen muestra cuántos pares de páginas faltan por recapturar, en cuántos volúmenes, y cuál tiene más pendientes.
• Un registro queda pendiente mientras está rechazado. Aunque ya se haya preparado para la recaptura, sigue pendiente hasta que una captura nueva reemplace su imagen.

El turno de recapturas

• Mientras haya algún registro pendiente en el equipo, un operador no puede empezar un volumen vacío.
  • Al terminar las recapturas de un volumen, se puede empezar un solo volumen nuevo.
  • La primera captura en ese volumen nuevo le devuelve el turno a las recapturas. Los turnos no se acumulan.
  • Siempre puedes seguir capturando en un volumen que ya tiene registros, y siempre puedes recapturar.
• Cuando la captura está bloqueada, la pantalla explica por qué y ofrece ir a un volumen con recapturas. Un administrador puede capturar de todos modos. Cola muestra a qué le toca el turno: recapturas o volumen nuevo.
• Nadie puede enviar a revisión un volumen con registros pendientes. La página del volumen dice cuántas recapturas faltan.

Volúmenes digitalizados antes de Captua

• Un administrador con acceso a la terminal del equipo puede reconstruir un volumen que se digitalizó con dos cámaras antes de Captua. El comando es python -m app.core.rebuild_volume <raíz> <paquete> --apply.
  • El comando lee un paquete preparado de antemano: el plan de los registros y, de cada imagen original, sus sumas de verificación y su miniatura.
  • Los originales tienen que estar ya en la copia externa, con los nombres de archivo de Captua.
  • Cada par de páginas queda como un registro de dos imágenes, con la rotación de cada cámara tomada del plan. Una imagen sin pareja queda como un registro de una sola imagen.
  • Los originales se quedan en la copia externa. En el equipo solo se guardan las miniaturas y los metadatos.
  • Sin --apply, el comando solo informa lo que haría.
  • Si se vuelve a ejecutar, conserva los registros ya terminados solo si coinciden con el plan.
• Un volumen reconstruido se entrega como cualquier otro. Los pares de páginas que se rechacen en Fisqua aparecen en Por recapturar.

Rotación enviada a Fisqua (opcional)

• Con CAPTUA_FISQUA_ROTATE_DEG=true, Captua escribe el manifiesto de captura en la versión 1.5, y cada imagen lleva su rotación en rotateDeg.
• El valor predeterminado es false: el manifiesto sigue en la versión 1.1, sin cambios. Actívalo solo si tu instalación de Fisqua lee la versión 1.5 del contrato.

Otros cambios

• La lista de volúmenes de un proyecto muestra la etapa real de cada volumen. Antes mostraba etapas provisionales.
• En un registro cuyo original ya se liberó de la tarjeta, el aviso de que está en la copia externa ya no tapa la miniatura.

Correcciones

• Captua ya no guarda en el volumen un número demasiado grande para leerlo: al importar, rechaza la lista, como ya hacía con NaN.
• Captua deja por fuera, por raíz no válida, un elemento cuya raíz termina en un salto de línea, sin enviarlo a la base de datos.
• El historial de rechazos de un registro empieza por el rechazo que muestra Por recapturar, aun cuando dos rechazos tengan la misma hora.

Para integraciones

• Rutas nuevas:
  • GET /imports/digitisation-lists
  • PUT /imports/digitisation-lists/{list_id}/items/{position}/done
  • GET /records/to-retake, /to-retake/count y /to-retake/summary
• Respuestas 409 nuevas: recapture_turn en POST /cameras/capture y /capture/dual, y recaptures_pending en POST /collections/{id}/promote.
• Opción de configuración nueva: CAPTUA_FISQUA_ROTATE_DEG (o DTK_FISQUA_ROTATE_DEG), con false como valor predeterminado.
• Comando nuevo: app.core.rebuild_volume.