NumaHOP permet de gérer une chaîne de numérisation de documents de l’import des notices et du constat d’état des documents physiques à la diffusion et à l’archivage grâce à un interfaçage largement automatisé entre les différentes étapes de la numérisation impliquant les acteurs concernés (prestataires de numérisation, bibliothèques, diffuseurs, CINES). Le bénéfice de cette réalisation est triple :

• privilégier l’usage de formats normalisés
• favoriser la standardisation des méthodes de travail
• permettre la mutualisation et l’échange des savoir-faire entre les établissements qui utilisent cette plate-forme.

NumaHOP est composé de plusieurs modules fonctionnels permettant :

• de convertir des notices au format UNIMARC ou EAD dans des formats interopérables : Dublin Core, Dublin Core qualifié
• de réaliser des constats d’état pour les lots de documents à numériser envoyés vers les prestataires de numérisation
• de recevoir les lots numérisés par le prestataire (images et métadonnées) et de les contrôler
• d’utiliser des fonctions de workflow, de contrôle et de structuration des projets
• de valider les unités documentaires numérisées (images + métadonnées) et de les exporter vers les diffuseurs et les archiveurs
• de produire des fichiers OCR, METS, images dérivées...

NumaHOP offre la possibilité de disséminer largement et de manière automatisée les contenus numérisés, à la fois sous l’identité des établissements à travers leurs bibliothèques numériques, mais aussi vers des plates-formes externes telles qu’Internet Archive ou OMEKAS.

NumaHop est une application SpringBoot construite avec Maven.

Vous pouvez cloner le repository.

Les instructions suivantes permettent d'installer NumaHop sur un poste de développement.

Numahop nécessite au préalable l'installation des outils listés ci-dessous.

• OpenJdk 17
• MariaDB
• Elasticsearch 8
• Tesseract
• ImageMagick
• Exiftool

Les versions proposées sont valides dans un environnement Debian 11.

Il vous faudra également un user linux dédié disposant d'un repository maven (.m2).

Pour des recherches Z39.50, il faudra également installer la librairie libyaz4 - Voir yaz4.md

Configuration minimale : application.yml | application-[PROFILE].yml

Les fichiers de configuration .yml doivent être mis à jour pour se conformer à votre installation.

Le profil "dev" est dédié à la mise en place d'un environnement de developpement.

Pour simplement lancer NumaHop, l'utilisation du profil "prod" est préconisée.

MariaDB : il faut simplement créer une base et un utilisateur autorisé. La structure et les données paramétrées seront créées lors du 1er démarrage de l'application.

Exemple de fichier application-prod.yml à compléter avec vos informations :

spring:
 # configuration de l'accès à la base de données
 datasource:
 url: jdbc:mariadb://**urlDataBase**
 username: **userName**
 password: **userpassword**
 # configuration de l'accès à elasticsearch
 elasticsearch:
 uris:
 - http://localhost:9200
 # configuration du serveur SMTP
 mail:
 host: localhost
 port: 25
 user:
 password:
 protocol: smtp
 tls: false
 auth: false
 activated: false
 from: test@test.com
# nom de l'index elasticsearch
elasticsearch:
 index:
 name: **indexName**
# chemins vers imagemagick
imageMagick:
 convert: **imConvertPath**
 identify: **imIdentifyPath**
# Chemin vers exiftool
exifTool:
 process: **exiftoolPath**
 quot_char: ''
# Chemin vers tesseract
tesseract:
 process: **tesseractPath**
# lister les bibliotheques utilisatrices comme suit: library_identifier1, library_identifier2, etc..
instance:
 libraries: library_bibliotheque
# répertoires de stockage des images
storage:
 binaries: **path to Image Dir repository**
# répertoires de travail **path to workBaseDir**
uploadPath:
 condition_report: **path to workBaseDir**/upload/condition_report
 ead: **path to workBaseDir**/upload/ead
 import: **path to workBaseDir**/upload/import
 library: **path to workBaseDir**/upload/library
 user: **path to workBaseDir**/upload/user
 template: **path to workBaseDir**/upload/templates
# fichier de logs
logging:
 file:
 name: **path to workBaseDir**/logs/numahop
# Services externes
services:
 cines:
 aip: **path to workBaseDir**/cines/aip
 cache: **path to workBaseDir**/cines/cache
 facile: https://facile.cines.fr/xml
 xsd:
 sip: **path to workBaseDir**/xsd/sip.xsd
 archive:
 alto: **path to workBaseDir**/archive/alto
 text: **path to workBaseDir**/archive/text
 metaDatas:
 path: **path to workBaseDir**/metadatas
 deliveryreporting:
 path: **path to workBaseDir**/deliveryReporting
 omeka:
 cache: **path to workBaseDir**/omeka/cache
 ftpexport:
 cache: **path to workBaseDir**/ftpexport/cache
 digitalLibraryDiffusion:
 cache: **path to workBaseDir**/digitalLibraryDiffusion/cache
# Clés utilisées pour le chiffrement de données chiffrées en BDD.
# Vous pouvez utiliser par exemple openssl pour générer des clés alétoires :
# openssl rand -hex 44
crypto:
 password: ***********
 salt: **********
admin:
 login: admin
 password: 2ドルa10ドル$xsRQ/2khgr0sblEfy6SjTujCnI3jGxj6q.yNQkKKaz4.ZIsuBT05O
 # le mot de passe par défaut est password. Pour changer ce mot de passe, il faut le chiffrer en BCrypt.

Pour démarrer l'application:

• se connecter avec votre utilisateur dédié disposant d'un repository maven
• se positionner à la racine du projet
• exécuter la commande suivante:

$ mvn clean spring-boot:run -Pprod -Dspring-boot.run.profiles=prod

En fin de build, l'application est lancée sur le port 8080. Vous pouvez vous logger en admin (mot de passe par défaut : password) afin d'effectuer le paramétrage de base, créer des utilisateurs autorisés etc..

• Bibliothèque Sainte-Geneviève
• Bibliothèque de Sciences Po
• BULAC

• TECH'advantage - https://www.tech-advantage.com/

TECH'advantage reste responsable de la version principale. Les issues et/ou merge requests doivent nous être adressées.

TECH'advantage étudiera également toute demande d'évolution de l'application.

Le projet est sous licence AGPLv3 - Voir le fichier LICENSE.md pour plus d'informations.