feat: implement a full SSV_LireConfig output parsing, using deku for a declarative bytes parsing

Co-authored-by: theo <t.lettermann@criteo.com>

.env.linux.example

@@ -1,2 +1,3 @@
 SESAM_FSV_VERSION=1.40.13
 SESAM_INI_PATH=/etc/opt/santesocial/fsv/${SESAM_FSV_VERSION}/conf/sesam.ini
+DATABASE_URL=sqlite://p4pillon.sqlite?mode=rwc

.env.win.example

@@ -1,2 +1,3 @@
 SESAM_FSV_VERSION=1.40.13
 SESAM_INI_PATH=${ALLUSERSPROFILE}\\santesocial\\fsv\\${SESAM_FSV_VERSION}\\conf\\sesam.ini
+DATABASE_URL=sqlite://p4pillon.sqlite?mode=rwc

.gitattributes

@@ -0,0 +1 @@
+Cargo.lock -merge linguist-generated=false

.gitea/PULL_REQUEST_TEMPLATE.yaml

@@ -1,4 +1,5 @@
 name: Demande de fusion (Pull Request)
+about: Créez une demande de fusion pour partager votre travail avec le reste de l'équipe
 body:
   - type: markdown
     attributes:

.gitea/issue_template/BUG_REPORT.yaml

@@ -24,6 +24,10 @@ body:
       label: Ce problème est il relatif à un ou des modules en particulier ?
       multiple: true
       options:
-        - Clego
-        - Tauri
-        - Axum
+        - Interface utilisateur⋅ice (crates/app)
+        - Encapsulation Tauri (crates/desktop)
+        - Moteur SESAM-Vitale (crates/sesam-vitale)
+        - Librairie utilitaire (crates/utils)
+        - Documentation (docs)
+        - Scripts (scripts)
+        - Autre

.gitignore

@@ -21,3 +21,8 @@ target/
 *.sln
 *.sw?
 
+# Ignore .env files
+.env
+
+# Development Database
+*.sqlite

.ignore

@@ -0,0 +1,5 @@
+# Ignorer les fichiers dont ne dépent pas la compilation 
+*.md
+tailwind.config.js
+*.example
+scripts

Cargo.toml

@@ -1,7 +1,21 @@
 [workspace]
 resolver = "2"
 members = [
-    "crates/app",
+    "crates/backend",
+    "crates/desktop",
     "crates/sesam-vitale",
-    "crates/desktop"
+    "crates/fsv",
+    "crates/fsv-sys",
+    "crates/utils",
+    "migration",
+    "entity",
+    ".",
 ]
+
+[workspace.dependencies]
+anyhow = "1.0"
+dotenv = "0.15"
+sea-orm-cli = "1.0.1"
+sea-orm = "1.0.1"
+serde = { version = "1.0.210", features = ["derive"] }
+thiserror = "1.0"

README.md

@@ -2,38 +2,121 @@
 
 Logiciel de Pharmacie libre et open-source.
 
-## Crates
+## Modules applicatifs
 
-- `app`: Interface du logiciel, servie par un serveur web propulsé par Axum. Utilisable en mode endpoint ou encapsulé dans le client `desktop`
-- `desktop`: Client desktop propulsé par Tauri, encapsulant le serveur web `app`
-- `sesam-vitale`: Bibliothèque de gestion des services SESAM-Vitale (Lecture des cartes CPS et Vitale, téléservices ...)
+- `crates`: Dossier racine des modules Rust
+    - `crates/backend`: Serveur backend propulsé par Axum, exposant une API REST
+    - `crates/desktop`: Client desktop propulsé par Tauri, exposant le `frontend`
+    - `crates/sesam-vitale`: Bibliothèque de gestion des services SESAM-Vitale (Lecture des cartes CPS et Vitale, téléservices ...)
+    - `crates/utils`: Bibliothèque de fonctions utilitaires
+    - `crates/fsv-sys`: Bindings Rust pour les librairies dynamiques FSV (SESAM-Vitale)
+- `frontend`: Interface web du logiciel, propulsée par Nuxt.js
+
+## Installation
+
+### Fichiers de configuration
+
+Certaines librairies nécessitent de définir certaines paramètres de configuration pour fonctionner correctement, en particulier le moteur SESAM-Vitale.
+
+Ces paramètres sont définis dans un fichier de configuration `.env` situé dans un des dossiers suivant (par ordre de priorité) :
+- dans le dossier courant (`./.env`)
+- dans le dossier du manifeste (par exemple `crates/sesam-vitale/.env`)
+- dans le dossier de configuration standard de l'OS (par exemple, sur linux, `~/.config/krys4lide/.env` - [plus d'info](https://github.com/dirs-dev/directories-rs?tab=readme-ov-file#projectdirs))
+
+Des exemples de fichiers de configuration sont disponibles à la racine du projet : `.env.linux.example` et `.env.win.example`.
 
 ## Development
 
 ### Pré-requis
 
+#### Frontend (Nuxt + Typescript)
+
+Le frontend est propulsé par Nuxt.js, un framework TypeScript pour Vue.js. Pour le développement, il est nécessaire d'installer les dépendances suivantes :
+- [Bun](https://bun.sh/docs/installation), un gestionnaire de paquets, équivalent à `npm` en plus performant
+
+#### Tauri CLI
+
+TODO: Tauri CLI, réellement nécessaire ?
+
 La CLI Tauri est nécessaire au lancement du client `desktop`. Elle peut être installée via Cargo :
 
 ```bash
-cargo install tauri-cli
+cargo install tauri-cli --version "^2.0.0-rc"
 ```
 
-### Exécution de l'application cliente desktop
+#### SeaORM CLI
+
+SeaORM est notre ORM. Le CLI SeaORM est nécessaire pour la génération des modèles de la base de données et des migrations associées. Elle peut être installée via Cargo :
 
 ```bash
-cargo tauri dev
+cargo install sea-orm-cli
 ```
 
-### Exécution du serveur web `app` en mode endpoint
+L'applicatif va chercher les informations de connexion à la base de données dans la variable `DATABASE_URL` importée depuis les [fichiers de configuration](#fichiers-de-configuration).
+
+```.env
+DATABASE_URL=sqlite://p4pillon.sqlite?mode=rwc
+```
+
+Toutefois, l'usage de la CLI de SeaORM nécessite de renseigner les informations de connexion à la base de données dans un fichier `.env` situé à la racine du projet.
+
+> Astuce : utilisé un lien symbolique pour éviter de dupliquer le fichier `.env`.
+
+#### FSV-sys
+
+La crate `fsv-sys` nécessite la présence des librairies fournies par le package FSV et la CryptolibCPS. Les instructions d'installation sont disponibles dans le [README](crates/sesam-vitale/README.md) de la crate `fsv-sys`.
+
+#### Backend Hot-reload
+
+Voir le [README](crates/backend/README.md) de la crate `backend` pour les prérequis de développement du serveur backend.
+
+### Lancement
+
+Pour lancer l'application en mode développement, il est nécessaire d'exécuter plusieurs composants simultanément :
 
 ```bash
-cargo run --bin app 
+# Lancement du serveur backend
+systemfd --no-pid -s http::8080 -- cargo watch -w crates/backend -x 'run --bin backend'
 ```
 
+```bash
+# Lancement de l'interface utilisateur (frontend ou desktop)
+# - frontend (serveur web, accessible via navigateur)
+bun run --cwd frontend/ dev
+# - desktop (client desktop, basé sur Tauri)
+cargo tauri dev --no-watch
+```
+
+> Pour circonscrire les hot-reloads intempestifs mais peu utiles :
+> - le `backend` n'est rechargé que si des modifications sont détectées dans le dossier précisé par `-w crates/backend`
+> - le rechargement du `desktop` est désactivé par l'option `--no-watch` ; en effet, le rechargement du `frontend` est déjà pris en charge par `bun` et ne nécessite pas de rechargement du `desktop`
+
 ## Build
 
-Packager le client desktop
+Pour packager le client `desktop`, il est nécessaire de faire appel à la CLI Tauri, qui se charge de gérer le build du `frontend` et son intégration au bundle :
 
 ```bash
 cargo tauri build
 ```
+
+## Gestion de la base de données
+
+### Création d'une migration
+
+```bash
+sea-orm-cli migrate generate <nom_de_la_migration>
+```
+
+Cette commande génère un fichier de migration à adapter dans le dossier `migration/src`.
+
+### Appliquer les migrations
+
+```bash
+sea-orm-cli migrate up
+```
+
+### Génération des entitées
+
+```bash
+sea-orm-cli generate entity -o entity/src/entities --with-serde both
+```

crates/app/.gitignore

@@ -1 +0,0 @@
-/target

crates/app/Cargo.toml

@@ -1,12 +0,0 @@
-[package]
-name = "app"
-version = "0.1.0"
-edition = "2021"
-
-[dependencies]
-askama = "0.12.1"
-askama_axum = "0.4.0"
-axum = "0.7.5"
-tokio = { version = "1.39.1", features = ["macros", "rt-multi-thread"] }
-tower-http = { version = "0.5.2", features = ["fs"] }
-

crates/app/src/lib.rs

@@ -1,27 +0,0 @@
-mod templates;
-
-use std::path::Path;
-
-use askama_axum::IntoResponse;
-use templates::{hello::HelloResponse, index::GetIndexResponse};
-use tower_http::services::ServeDir;
-
-async fn root() -> impl IntoResponse {
-    return GetIndexResponse {}.into_response();
-}
-
-async fn hello() -> impl IntoResponse {
-    return HelloResponse {
-        name: "Theo".to_string(),
-    }
-    .into_response();
-}
-
-pub fn get_router(assets_path: &Path) -> axum::Router {
-    let router = axum::Router::new()
-        .nest_service("/assets", ServeDir::new(assets_path))
-        .route("/", axum::routing::get(root))
-        .route("/hello", axum::routing::get(hello));
-
-    router
-}

crates/app/src/main.rs

@@ -1,14 +0,0 @@
-use ::app::get_router;
-use std::env;
-use std::path::Path;
-
-#[tokio::main]
-async fn main() {
-    let manifest_dir = env::var("CARGO_MANIFEST_DIR").unwrap();
-    let assets_path = Path::new(&manifest_dir).join("assets");
-    let router = get_router(assets_path.as_path());
-
-    // TODO: select port based on available port (or ask in CLI)
-    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();
-    axum::serve(listener, router).await.unwrap();
-}

crates/app/src/templates/hello.rs

@@ -1,7 +0,0 @@
-use askama::Template;
-
-#[derive(Template)]
-#[template(path = "hello.html")]
-pub struct HelloResponse {
-    pub name: String,
-}

crates/app/src/templates/index.rs

@@ -1,5 +0,0 @@
-use askama::Template;
-
-#[derive(Template)]
-#[template(path = "index.html")]
-pub struct GetIndexResponse;

crates/app/src/templates/mod.rs

@@ -1,2 +0,0 @@
-pub mod hello;
-pub mod index;

crates/app/templates/base.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <title>{% block title %}{{ title }}{% endblock %}</title>
-
-    <script src="/assets/js/htmx.min.js"></script>
-
-    {% block head %}{% endblock %}
-  </head>
-  <body>
-    {% block body %}{% endblock %}
-  </body>
-</html>

crates/app/templates/hello.html

@@ -1 +0,0 @@
-<div>Hello {{name}}!</div>

crates/app/templates/index.html

@@ -1,23 +0,0 @@
-{% extends "base.html" %}
- 
-{% block title %}Pharma Libre{% endblock %}
- 
-{% block body %}
-
-<div>
-  <header>
-    <h1>Pharma Libre</h1>
-  </header>
-  <main>
-    <div
-      id="hello"
-      hx-get="/hello"
-      hx-target="this"
-      hx-trigger="load"
-      hx-swap="outerHTML"
-    >
-      Loading...
-    </div>
-  </main>
-</div>
-{% endblock %}

crates/backend/Cargo.toml

@@ -0,0 +1,29 @@
+[package]
+name = "backend"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+anyhow = "1.0.89"
+axum = { version = "0.7.6", features = ["macros"] }
+listenfd = "1.0.1"
+tokio = { version = "1.40.0", features = ["macros", "rt-multi-thread"] }
+tower-http = { version = "0.6.1", features = ["cors"] }
+
+sea-orm = { workspace = true, features = [
+    # Same `ASYNC_RUNTIME` and `DATABASE_DRIVER` as in the migration crate
+    "sqlx-sqlite",
+    "runtime-tokio-rustls",
+    "macros",
+] }
+serde.workspace = true
+thiserror.workspace = true
+
+entity = { path = "../../entity" }
+migration = { path = "../../migration" }
+utils = { path = "../utils" }
+
+[dev-dependencies]
+cargo-watch = "8.5.2"
+sea-orm-cli.workspace = true
+systemfd = "0.4.3"

crates/backend/README.md

@@ -0,0 +1,28 @@
+# Backend
+
+Ceci est un serveur backend, basé sur axum, et permettant d'offrir une gestion centralisée des accès aux données.
+
+## Prérequis
+
+En développement, le mécanisme de hot-reload nécessite de disposer de `cargo-watch` et `systemfd`. Pour les installer, exécutez la commande suivante :
+
+```bash
+cargo install cargo-watch systemfd
+```
+
+## Configuration
+
+> Astuce : lorsqu'on exécute directement la crate `backend` à des fins de développement, le système de configuration n'utilisera pas l'éventuel fichier `.env` situé à la racine du workspace Rust. Pour éviter de dupliquer le fichier `.env`, il est possible de créer un lien symbolique vers le fichier `.env` de la crate `backend` :
+
+```bash
+cd crates/backend
+ln -s ../../.env .env
+```
+
+## Développement
+
+Pour lancer le serveur en mode développement, exécutez la commande suivante :
+
+```bash
+systemfd --no-pid -s http::8080 -- cargo watch -w crates/backend -x 'run --bin backend'
+```

crates/backend/src/api/debug.rs

@@ -0,0 +1,48 @@
+use axum::{extract::State, routing, Json};
+use sea_orm::*;
+use serde::Serialize;
+
+use ::entity::{debug, debug::Entity as DebugEntity};
+
+use crate::{AppError, AppState};
+
+// DATABASE DEBUG CONTROLLERS
+
+async fn get_debug_entries(db: &DatabaseConnection) -> Result<Vec<debug::Model>, DbErr> {
+    DebugEntity::find().all(db).await
+}
+
+async fn add_random_debug_entry(State(AppState { db_connection }): State<AppState>) {
+    let random_entry = debug::ActiveModel {
+        title: Set("Random title".to_string()),
+        text: Set("Random text".to_string()),
+        ..Default::default()
+    };
+    random_entry.insert(&db_connection).await.unwrap();
+}
+
+// API HANDLER
+
+#[derive(Serialize, Debug)]
+struct DebugResponse {
+    db_ping_status: bool,
+    entries: Vec<debug::Model>,
+}
+
+#[axum::debug_handler]
+async fn debug(
+    State(AppState { db_connection }): State<AppState>,
+) -> Result<Json<DebugResponse>, AppError> {
+    let db_ping_status = db_connection.ping().await.is_ok();
+    let debug_entries = get_debug_entries(&db_connection).await?;
+    Ok(Json(DebugResponse {
+        db_ping_status,
+        entries: debug_entries,
+    }))
+}
+
+pub fn get_routes() -> axum::Router<crate::AppState> {
+    axum::Router::new()
+        .route("/", routing::get(debug))
+        .route("/add_random", routing::post(add_random_debug_entry))
+}

crates/backend/src/api/mod.rs

@@ -0,0 +1,9 @@
+use axum::Router;
+
+use crate::AppState;
+
+mod debug;
+
+pub fn get_routes() -> Router<AppState> {
+    Router::new().nest("/debug", debug::get_routes())
+}

crates/backend/src/db.rs

@@ -0,0 +1,11 @@
+use migration::{Migrator, MigratorTrait};
+use sea_orm::{Database, DatabaseConnection, DbErr};
+use std::env;
+
+pub async fn get_connection() -> Result<DatabaseConnection, DbErr> {
+    let database_url = env::var("DATABASE_URL").expect("DATABASE_URL must be set");
+
+    let db_connection = Database::connect(database_url).await?;
+    Migrator::up(&db_connection, None).await?;
+    Ok(db_connection)
+}

crates/backend/src/lib.rs

@@ -0,0 +1,72 @@
+use anyhow::Error as AnyError;
+use axum::http::{header, StatusCode, Uri};
+use axum::response::{IntoResponse, Response};
+use axum::{routing::get, Router};
+use sea_orm::{DatabaseConnection, DbErr};
+use thiserror::Error;
+use tower_http::cors::{Any, CorsLayer};
+
+use ::utils::config::{load_config, ConfigError};
+
+mod api;
+mod db;
+
+#[derive(Error, Debug)]
+pub enum InitError {
+    #[error(transparent)]
+    ConfigError(#[from] ConfigError),
+}
+
+pub fn init() -> Result<(), InitError> {
+    load_config(None)?;
+    Ok(())
+}
+
+#[derive(Clone)]
+pub struct AppState {
+    db_connection: DatabaseConnection,
+}
+
+pub async fn get_router() -> Result<Router, DbErr> {
+    let db_connection = db::get_connection().await?;
+    let state: AppState = AppState { db_connection };
+
+    let cors = CorsLayer::new()
+        .allow_methods(Any)
+        .allow_origin(Any)
+        .allow_headers([header::CONTENT_TYPE]);
+
+    Ok(Router::new()
+        .route("/", get(|| async { "Hello, world!" }))
+        .merge(api::get_routes())
+        .fallback(fallback)
+        .with_state(state)
+        .layer(cors))
+}
+
+async fn fallback(uri: Uri) -> (StatusCode, String) {
+    (StatusCode::NOT_FOUND, format!("No route for {uri}"))
+}
+
+struct AppError(AnyError);
+
+// To automatically convert `AppError` into a response
+impl IntoResponse for AppError {
+    fn into_response(self) -> Response {
+        (
+            StatusCode::INTERNAL_SERVER_ERROR,
+            format!("Internal Server Error: {}", self.0),
+        )
+            .into_response()
+    }
+}
+
+// To automatically convert `AnyError` into `AppError`
+impl<E> From<E> for AppError
+where
+    E: Into<AnyError>,
+{
+    fn from(err: E) -> Self {
+        Self(err.into())
+    }
+}

crates/backend/src/main.rs

@@ -0,0 +1,39 @@
+use listenfd::ListenFd;
+use thiserror::Error;
+use tokio::net::TcpListener;
+
+use backend::{get_router, init, InitError};
+
+#[derive(Error, Debug)]
+pub enum BackendError {
+    #[error("Error while setting up or serving the TCP listener")]
+    ServeTCPListener(#[from] std::io::Error),
+    #[error("Error while initialising the backend")]
+    InitError(#[from] InitError),
+    #[error("Error with the database connection")]
+    DatabaseConnection(#[from] sea_orm::DbErr),
+}
+
+#[tokio::main]
+async fn main() -> Result<(), BackendError> {
+    init()?;
+
+    let app = get_router().await?;
+
+    let mut listenfd = ListenFd::from_env();
+    let listener = match listenfd.take_tcp_listener(0)? {
+        // if we are given a tcp listener on listen fd 0, we use that one
+        Some(listener) => {
+            listener.set_nonblocking(true)?;
+            TcpListener::from_std(listener)?
+        }
+        // otherwise fall back to local listening
+        None => TcpListener::bind("0.0.0.0:8080").await?,
+    };
+
+    let local_addr = listener.local_addr()?;
+    println!("Listening on http://{}", local_addr);
+    axum::serve(listener, app).await?;
+
+    Ok(())
+}

crates/desktop/Cargo.toml

@@ -10,15 +10,15 @@ name = "desktop_lib"
 crate-type = ["lib", "cdylib", "staticlib"]
 
 [build-dependencies]
-tauri-build = { version = "2.0.0-beta", features = [] }
+tauri-build = { version = "2.0.0-rc", features = [] }
 
 [dependencies]
-axum = "0.7.5"
-tauri = { version = "2.0.0-beta", features = [] }
-tower = "0.4.13"
-tokio = "1.39.1"
-
-app = { path = "../app" }
-http = "1.1.0"
 bytes = "1.6.1"
+http = "1.1.0"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+tauri = { version = "2.0.0-rc", features = [] }
+tauri-plugin-shell = "2.0.0-rc"
+tower = "0.4.13"
 
+thiserror.workspace = true

crates/desktop/capabilities/default.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "identifier": "default",
+  "description": "Capability for the main window",
+  "windows": ["main"],
+  "permissions": [
+    "core:default",
+    "shell:allow-open"
+  ]
+}

crates/desktop/src/lib.rs

@@ -1,69 +1,14 @@
-use bytes::Bytes;
-use http::{request, response, Request, Response};
-use std::path::PathBuf;
-use std::sync::Arc;
-
-use axum::body::{to_bytes, Body};
-
-use axum::Router;
-
-use tauri::path::BaseDirectory;
-use tauri::Manager;
-use tokio::sync::{Mutex, MutexGuard};
-use tower::{Service, ServiceExt};
-
-async fn process_tauri_request(
-    tauri_request: Request<Vec<u8>>,
-    mut router: MutexGuard<'_, Router>,
-) -> Response<Vec<u8>> {
-    let (parts, body): (request::Parts, Vec<u8>) = tauri_request.into_parts();
-    let axum_request: Request<Body> = Request::from_parts(parts, body.into());
-
-    let axum_response: Response<Body> = router
-        .as_service()
-        .ready()
-        .await
-        .expect("Failed to get ready service from router")
-        .call(axum_request)
-        .await
-        .expect("Could not get response from router");
-
-    let (parts, body): (response::Parts, Body) = axum_response.into_parts();
-    let body: Bytes = to_bytes(body, usize::MAX).await.unwrap_or_default();
-
-    let tauri_response: Response<Vec<u8>> = Response::from_parts(parts, body.into());
-
-    tauri_response
+// Learn more about Tauri commands at https://tauri.app/v1/guides/features/command
+#[tauri::command]
+fn greet(name: &str) -> String {
+    format!("Hello, {}! You've been greeted from Rust!", name)
 }
 
 #[cfg_attr(mobile, tauri::mobile_entry_point)]
 pub fn run() {
     tauri::Builder::default()
-        .setup(|app| {
-            let assets_path: PathBuf = app
-                .path()
-                .resolve("assets", BaseDirectory::Resource)
-                .expect("Path should be resolvable");
-
-            // Adds Axum router to application state
-            // This makes it so we can retrieve it from any app instance (see bellow)
-            let router = Arc::new(Mutex::new(app::get_router(&assets_path)));
-
-            app.manage(router);
-
-            Ok(())
-        })
-        .register_asynchronous_uri_scheme_protocol("axum", move |app, request, responder| {
-            // Retrieve the router from the application state and clone it for the async block
-            let router = Arc::clone(&app.state::<Arc<Mutex<axum::Router>>>());
-
-            // Spawn a new async task to process the request
-            tauri::async_runtime::spawn(async move {
-                let router = router.lock().await;
-                let response = process_tauri_request(request, router).await;
-                responder.respond(response);
-            });
-        })
+        .plugin(tauri_plugin_shell::init())
+        .invoke_handler(tauri::generate_handler![greet])
         .run(tauri::generate_context!())
         .expect("error while running tauri application");
 }

crates/desktop/tauri.conf.json

@@ -1,20 +1,24 @@
 {
-  "productName": "Logiciel Pharma",
+  "$schema": "https://schema.tauri.app/config/2.0.0-rc",
+  "productName": "Chrys4lide LGO",
   "version": "0.0.1",
-  "identifier": "org.p4pillon.pharma.desktop",
+  "identifier": "org.p4pillon.chrys4lide.lgo",
   "build": {
     "beforeDevCommand": {
-        "cwd": "../app",
-        "script": "cargo run"
+      "cwd": "../../frontend",
+      "script": "bun run dev"
     },
-    "devUrl": "http://localhost:3000",
-    "frontendDist": "axum://place.holder/"
+    "devUrl": "http://localhost:1420",
+    "beforeBuildCommand": {
+      "cwd": "../../frontend",
+      "script": "bun run generate"
+    },
+    "frontendDist": "../../frontend/dist"
   },
   "app": {
-    "withGlobalTauri": true,
     "windows": [
       {
-        "title": "Logiciel Pharma",
+        "title": "Chrys4lide | LG0",
         "width": 800,
         "height": 600
       }
@@ -25,9 +29,6 @@
   },
   "bundle": {
     "active": true,
-    "resources": {
-        "../app/assets/": "./assets/"
-    },
     "targets": "all",
     "icon": [
       "icons/32x32.png",
@@ -37,5 +38,4 @@
       "icons/icon.ico"
     ]
   }
-                
-}
+}

crates/fsv-sys/Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "fsv-sys"
+version = "0.1.0"
+edition = "2021"
+
+links = "ssvlux64,ssvosx,Ssvw64"
+# Linux: Libssvlux64.so
+# Windows: Ssvw64.dll
+# macOS: ssvosx.framework
+
+[dependencies]
+libc = "0.2.159"
+libloading = "0.8.5"
+
+thiserror.workspace = true
+
+[build-dependencies]
+bindgen = "0.70.1"

crates/fsv-sys/PROGRESS.md

@@ -0,0 +1,32 @@
+# État d'avancement de l'implémentation des bindings FSV
+
+| Module      | Progression                        |
+|-------------|------------------------------------|
+| [SSV](#ssv) | ![](https://geps.dev/progress/5)   |
+| [SGD](#sgd) | ![](https://geps.dev/progress/0)   |
+| [SRT](#srt) | ![](https://geps.dev/progress/0)   |
+| [STS](#sts) | ![](https://geps.dev/progress/0)   |
+
+## SSV
+
+| Fonctions implémentées |
+|------------------------|
+| SSV_InitLIB2           |
+| SSV_LireConfig         |
+| SSV_LireCartePS        |
+
+## SGD
+
+| Fonctions implémentées |
+|------------------------|
+
+
+## SRT
+
+| Fonctions implémentées |
+|------------------------|
+
+## STS
+
+| Fonctions implémentées |
+|------------------------|

crates/fsv-sys/README.md

@@ -0,0 +1,36 @@
+# FSV-sys, bindings Rust pour le package FSV SESAM-Vitale
+
+## Librairies FSV
+
+### Versions supportées
+
+| Version FSV |
+|-------------|
+| 1.40.14     |
+| 1.40.13     |
+
+### État d'avancement de l'implémentation des bindings FSV
+
+Les détails de l'avancement de l'implémentation des bindings FSV sont donnés dans le fichier [PROGRESS.md](PROGRESS.md)
+
+## Utilisation
+
+### Pré-requis
+
+- Installer le [package FSV](https://industriels.sesam-vitale.fr/group/fournitures-sesam-vitale)
+    - Les librairies dynamiques (.lib, .dll, ...) fournies ne sont pas installés dans les emplacements standard du système, il faudra donc configurer leur chemin d'installation dans le fichier de configuration `.env.build` (voir ci-dessous)
+        - Le détail des chemins d'installation est donné dans la documentation du package FSV `fsv-mi-004_pack-FSV1.40.14_V2.3.pdf`
+            - Linux - par défaut : `/opt/santesocial/fsv/1.40.13/lib`
+            - Windows - par défaut : `C:\Program Files\santesocial\santesocial\fsv\1.40.14\lib` (ou dans Program Files (x86) si c'est le package 32bits qui a été installé)
+
+- Installer la [CryptolibCPS](https://industriels.sesam-vitale.fr/group/galss-cryptolib-cps)
+    - Ce package fourni également l'utilitaire "CPS Gestion" pour obtenir des informations sur le lecteur de carte, etc.
+        - Linux : `cpgeslux`
+        - Windows : `...`
+
+## Développement
+
+### Pré-requis
+
+- Pour la génération des bindings lors de la phase de `build` à l'aide de `bindgen`, il est nécessaire d'avoir installé `clang` ([documentation](https://rust-lang.github.io/rust-bindgen/requirements.html)).
+

crates/fsv-sys/bindgen-wrappers/1.40.13/wrapper.linux.h

@@ -0,0 +1,7 @@
+#ifndef WRAPPER_LINUX_H
+#define WRAPPER_LINUX_H
+
+#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/linux/mc_sys_def.h"
+#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.13/ssv.h"
+
+#endif // WRAPPER_LINUX_H

crates/fsv-sys/bindgen-wrappers/1.40.13/wrapper.macosx.h

@@ -0,0 +1,7 @@
+#ifndef WRAPPER_MACOSX_H
+#define WRAPPER_MACOSX_H
+
+#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/macosx/mc_sys_def.h"
+#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.13/ssv.h"
+
+#endif // WRAPPER_MACOSX_H

crates/fsv-sys/bindgen-wrappers/1.40.13/wrapper.win.h

@@ -0,0 +1,7 @@
+#ifndef WRAPPER_WIN_H
+#define WRAPPER_WIN_H
+
+#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/win/mc_sys_def.h"
+#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.13/ssv.h"
+
+#endif // WRAPPER_WIN_H

crates/fsv-sys/bindgen-wrappers/1.40.14/wrapper.linux.h

@@ -0,0 +1,7 @@
+#ifndef WRAPPER_LINUX_H
+#define WRAPPER_LINUX_H
+
+#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/linux/mc_sys_def.h"
+#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.14/ssv.h"
+
+#endif // WRAPPER_LINUX_H

crates/fsv-sys/bindgen-wrappers/1.40.14/wrapper.macosx.h

@@ -0,0 +1,7 @@
+#ifndef WRAPPER_MACOSX_H
+#define WRAPPER_MACOSX_H
+
+#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/macosx/mc_sys_def.h"
+#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.14/ssv.h"
+
+#endif // WRAPPER_MACOSX_H

crates/fsv-sys/bindgen-wrappers/1.40.14/wrapper.win.h

@@ -0,0 +1,7 @@
+#ifndef WRAPPER_WIN_H
+#define WRAPPER_WIN_H
+
+#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/win/mc_sys_def.h"
+#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.14/ssv.h"
+
+#endif // WRAPPER_WIN_H

crates/fsv-sys/build.rs

@@ -0,0 +1,57 @@
+use std::{env, path::PathBuf};
+
+// Supported versions of FSV
+static SUPPORTED_FSV_VERSIONS: [&str; 2] = ["1.40.14", "1.40.13"];
+
+fn build_bindings(version: &str, target_code: &str) -> PathBuf {
+    let target = env::var("TARGET").expect("TARGET not set");
+    let wrapper_path = format!("bindgen-wrappers/{}/wrapper.{}.h", version, target_code);
+    let bindings = bindgen::Builder::default()
+        // The input header we would like to generate
+        // bindings for.
+        .header(wrapper_path)
+        // To generate the bindings for specific target
+        .clang_arg(format!("--target={}", target))
+        // Limit the bindings generation to the SSV_ prefix
+        .allowlist_item("SSV_.*")
+        // Tell cargo to invalidate the built crate whenever any of the
+        // included header files changed.
+        .parse_callbacks(Box::new(bindgen::CargoCallbacks::new()))
+        // Finish the builder and generate the bindings.
+        .generate()
+        // Unwrap the Result and panic on failure.
+        .expect("Unable to generate bindings");
+
+    // Write the bindings to the $OUT_DIR/bindings.rs file.
+    let out_dir = PathBuf::from(env::var("OUT_DIR").unwrap());
+    let out_file = format!("bindings_{}.rs", version);
+    let out_path = out_dir.join(out_file);
+    bindings
+        .write_to_file(&out_path)
+        .expect("Couldn't write bindings! ");
+    out_path
+}
+
+fn get_target_code() -> String {
+    // Use CARGO configuration env Variable, because !cfg(target_os) is not available in build.rs
+    // Source: https://kazlauskas.me/entries/writing-proper-buildrs-scripts
+    let target_os = env::var("CARGO_CFG_TARGET_OS");
+
+    match target_os.as_ref().map(|x| &**x) {
+        Ok("linux") => "linux",  // lib_name = "ssvlux64";
+        Ok("windows") => "win",  // lib_name = "Ssvw64";
+        Ok("macos") => "macosx", // lib_name = "ssvosx";
+        tos => panic!("Unsupported target_os {:?}", tos),
+    }
+    .to_string()
+}
+
+fn main() {
+    let target_code = get_target_code();
+    // Build the bindings for each supported version of FSV
+    let bindings_paths: Vec<PathBuf> = SUPPORTED_FSV_VERSIONS
+        .iter()
+        .map(|version| build_bindings(version, &target_code))
+        .collect();
+    println!("FSV bindings generated: {:#?}", bindings_paths);
+}

crates/fsv-sys/src/bindings.rs

@@ -0,0 +1,12 @@
+#![allow(non_upper_case_globals)]
+#![allow(non_camel_case_types)]
+#![allow(non_snake_case)]
+#![allow(unused)]
+
+pub mod BINDINGS_V1_40_14 {
+    include!(concat!(env!("OUT_DIR"), "/bindings_1.40.14.rs"));
+}
+
+pub mod BINDINGS_V1_40_13 {
+    include!(concat!(env!("OUT_DIR"), "/bindings_1.40.13.rs"));
+}

crates/fsv-sys/src/lib.rs

@@ -0,0 +1,212 @@
+#![allow(non_snake_case)]
+
+use std::marker::PhantomData;
+
+mod bindings;
+use bindings::*;
+
+#[derive(Debug, Clone)]
+pub enum SupportedFsvVersion {
+    V1_40_14, // 1.40.14
+    V1_40_13, // 1.40.13
+}
+
+impl SupportedFsvVersion {
+    fn as_str(&self) -> &'static str {
+        match self {
+            Self::V1_40_14 => "1.40.14",
+            Self::V1_40_13 => "1.40.13",
+        }
+    }
+}
+
+#[derive(thiserror::Error, Debug)]
+pub enum Error {
+    #[error(transparent)]
+    LibLoading(#[from] libloading::Error),
+    #[error("Symbol missing: {0}")]
+    SymbolMissing(&'static str),
+}
+
+/// Macro to generate a function that implements a call to an external function in BINDINGS
+macro_rules! ssv_function {
+    ($binding:ty, $func_name:ident, {$($arg_name:ident: $arg_type:ty),*}) => {
+        /// # Safety
+        /// This function is unsafe because it calls an external function through FFI.
+        /// The caller must ensure that the provided arguments are valid and that the
+        /// external function is safe to call.
+        pub unsafe fn $func_name(&self, $($arg_name: $arg_type),*) -> Result<u16, Error> {
+            let symbol_name = match stringify!($binding)
+                .split(&[' ', ':'])
+                .last() {
+                    Some(name) => name,
+                    None => return Err(Error::SymbolMissing(stringify!($binding))),
+                };
+            let func_struct: libloading::Symbol<'_, $binding> =
+                unsafe { self.library.get(symbol_name.as_bytes())? };
+            let func = match *func_struct {
+                Some(func) => func,
+                None => return Err(Error::SymbolMissing(stringify!($binding))),
+            };
+            Ok(func($($arg_name),*))
+        }
+    };
+}
+
+/// `sealed::Sealed` trait is used to prevent external crates from implementing the LibVersion trait.
+mod sealed { pub trait Sealed {}}
+
+/// Wrapper around the SESAM-VITALE library
+/// This struct is responsible for loading the library and providing an interface to call its functions.
+/// The library is loaded at creation and kept in memory until the struct is dropped.
+pub trait SSVLibraryCommon {
+    fn new(path: &str) -> Result<Self, Error> where Self: Sized;
+}
+
+pub trait SSVLibraryVersion: sealed::Sealed {}
+
+pub struct V1_40_13 {}
+impl sealed::Sealed for V1_40_13 {}
+impl SSVLibraryVersion for V1_40_13 {}
+
+pub struct V1_40_14 {}
+impl sealed::Sealed for V1_40_14 {}
+impl SSVLibraryVersion for V1_40_14 {}
+
+pub struct SSVLibrary<Version: SSVLibraryVersion> {
+    _version: PhantomData<Version>,
+    library: libloading::Library,
+}
+
+impl<Version: SSVLibraryVersion> SSVLibraryCommon for SSVLibrary<Version> {
+    fn new(path: &str) -> Result<Self, Error> {
+        let library = unsafe { libloading::Library::new(path)?};
+        Ok(Self {
+            _version: PhantomData,
+            library
+        })
+    }
+}
+
+impl SSVLibrary<V1_40_14> {
+    pub fn library(&self) -> &libloading::Library {
+        &self.library
+    }
+
+    ssv_function!(BINDINGS_V1_40_14::SSV_InitLIB2, ssv_init_lib2, {
+        pcFichierSesam: *const i8
+    });
+
+    ssv_function!(BINDINGS_V1_40_14::SSV_LireConfig, ssv_lire_config, {
+        pZDataOut: *mut *mut libc::c_void,
+        psTailleDataOut: *mut usize
+    });
+
+    ssv_function!(BINDINGS_V1_40_14::SSV_LireCartePS, ssv_lire_carte_ps, {
+        NomRessourcePS: *const i8,
+        NomRessourceLecteur: *const i8,
+        CodePorteurPS: *const i8,
+        pZDataOut: *mut *mut libc::c_void,
+        pTailleZone: *mut usize
+    });
+}
+
+impl SSVLibrary<V1_40_13> {
+    ssv_function!(BINDINGS_V1_40_13::SSV_InitLIB2, ssv_init_lib2, {
+        pcFichierSesam: *const i8
+    });
+
+    ssv_function!(BINDINGS_V1_40_13::SSV_LireConfig, ssv_lire_config, {
+        pZDataOut: *mut *mut libc::c_void,
+        psTailleDataOut: *mut usize
+    });
+
+    ssv_function!(BINDINGS_V1_40_13::SSV_LireCartePS, ssv_lire_carte_ps, {
+        NomRessourcePS: *const i8,
+        NomRessourceLecteur: *const i8,
+        CodePorteurPS: *const i8,
+        pZDataOut: *mut *mut libc::c_void,
+        pTailleZone: *mut usize
+    });
+}
+
+pub fn get_library_path(version: &SupportedFsvVersion) -> String {
+    let root_path = get_library_root_path();
+    let library_name = get_library_name();
+    let version = version.as_str();
+    format!("{root_path}/{version}/lib/{library_name}")
+}
+
+pub fn sesam_ini_path(version: &SupportedFsvVersion) -> String {
+    let root_path = get_sesam_ini_root_path();
+    let version = version.as_str();
+    format!("{root_path}/{version}/conf/sesam.ini")
+}
+
+fn get_library_name() -> &'static str {
+    // TODO : Use libloading::library_filename to get platform-specific filename ?
+    "libssvlux64.so"
+}
+
+fn get_library_root_path() -> &'static str {
+    "/opt/santesocial/fsv"
+}
+
+fn get_sesam_ini_root_path() -> &'static str {
+    "/etc/opt/santesocial/fsv"
+}
+
+#[cfg(test)]
+mod test {
+    use std::{ffi::CString, ptr};
+
+    use super::*;
+
+    #[test]
+    fn test_initlib2() {
+        let lib_path = &get_library_path(&SupportedFsvVersion::V1_40_13);
+        let ssv_library = SSVLibrary::<V1_40_13>::new(lib_path).expect("SSVLibrary::new failed");
+
+        let sesam_ini_str =
+            CString::new(sesam_ini_path(&SupportedFsvVersion::V1_40_13)).expect("CString::new failed");
+        let result = unsafe { ssv_library.ssv_init_lib2(sesam_ini_str.as_ptr()) }.unwrap();
+        assert_eq!(result, 0);
+    }
+
+    #[test]
+    fn test_lire_config_and_carte_ps() {
+        let lib_path = &get_library_path(&SupportedFsvVersion::V1_40_13);
+        let ssv_library = SSVLibrary::<V1_40_13>::new(lib_path).expect("SSVLibrary::new failed");
+
+        let sesam_ini_str =
+            CString::new(sesam_ini_path(&SupportedFsvVersion::V1_40_13)).expect("CString::new failed");
+        let result = unsafe { ssv_library.ssv_init_lib2(sesam_ini_str.as_ptr()) }.unwrap();
+        assert_eq!(result, 0);
+
+        let mut buffer_ptr: *mut libc::c_void = ptr::null_mut();
+        let mut size: libc::size_t = 0;
+        let result = unsafe { ssv_library.ssv_lire_config(&mut buffer_ptr, &mut size) }.unwrap();
+        assert_eq!(result, 0);
+        unsafe { libc::free(buffer_ptr) };
+
+        let nom_ressource_ps =
+            CString::new("Gemalto PC Twin Reader (645D94C3) 00 00").expect("CString::new failed");
+        let nom_ressource_lecteur =
+            CString::new("Gemalto PC Twin Reader (645D94C3) 00 00").expect("CString::new failed");
+        let code_porteur_ps = CString::new("1234").expect("CString::new failed");
+        let mut buffer_ptr: *mut libc::c_void = ptr::null_mut();
+        let mut size: libc::size_t = 0;
+        let result = unsafe {
+            ssv_library.ssv_lire_carte_ps(
+                nom_ressource_ps.as_ptr(),
+                nom_ressource_lecteur.as_ptr(),
+                code_porteur_ps.as_ptr(),
+                &mut buffer_ptr,
+                &mut size,
+            )
+        }
+        .unwrap();
+        assert_eq!(result, 0);
+        unsafe { libc::free(buffer_ptr) };
+    }
+}

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SGD/sgd.h

@@ -0,0 +1,123 @@
+/*
+ * -------------------------------------------------------------------
+ * (c) 2001 GIE SESAM-VITALE
+ *
+ * PROJET   : Services de Gestion de Donnees
+ *
+ * FICHIER  : sgd.h (v4)
+ *
+ * Declaration des prototypes des fonctions SGD pour les progiciels.
+ * -------------------------------------------------------------------
+ */
+
+#ifndef __SGD_H__
+#define __SGD_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*
+ * Inclusions
+ */
+#include <stddef.h>
+#include "mc_sys_def.h"
+
+/* Reservation d'un session d'echange. */
+extern unsigned short API_ENTRY SGD_ReserverSession (size_t          Taille,                unsigned short* NumeroSession);
+
+/* Redimensionnement d'une zone d'entree interne. */
+extern unsigned short API_ENTRY
+SGD_RedimensionnerBuffer (unsigned short NumeroSession,
+                          size_t         NouvelleTaille);
+
+/* Liberation d'une session d'echange. */
+extern unsigned short API_ENTRY
+SGD_LibererSession (unsigned short NumeroSession);
+
+/* Ajout d'un groupe. */
+extern unsigned short API_ENTRY
+SGD_AjouterGroupe (unsigned short NumeroSession,
+                   unsigned short IdGroupe);
+
+/* Ajout d'un champ. */
+extern unsigned short API_ENTRY
+SGD_AjouterChamp (unsigned short NumeroSession,
+                  const char*    ValeurChamp);
+
+/* Ajout d'un champ d'octets. */
+extern unsigned short API_ENTRY
+SGD_AjouterChampBin (unsigned short NumeroSession,
+                     const char*    ValeurChamp,
+                     size_t         TailleChamp);
+
+/* Ajout d'un champ d'octets d'un Fichier. */
+extern unsigned short API_ENTRY
+SGD_AjouterChampFichier (unsigned short NumeroSession,
+                         const char*    NomFichier);
+
+/* Lecture du numero du groupe suivant. */
+extern unsigned short API_ENTRY
+SGD_LireGroupeSuivant (unsigned short  NumeroSession,
+                       unsigned short  IdGroupeCourant,
+                       unsigned short  OccurrenceGroupeCourant,
+                       unsigned short* IdGroupeSuivant,
+                       unsigned short* OccurrenceGroupeSuivant);
+
+/* Lecture d'un champ. */
+extern unsigned short API_ENTRY
+SGD_LireChamp (unsigned short NumeroSession,
+               unsigned short IdGroupe,
+               unsigned short OccurrenceGroupe,
+               unsigned short NumeroChamp,
+               char*          ValeurChamp,
+               size_t*        TailleMax);
+
+/* Lecture d'un champ d'octets. */
+extern unsigned short API_ENTRY
+SGD_LireChampBin (unsigned short NumeroSession,
+                  unsigned short IdGroupe,
+                  unsigned short OccurrenceGroupe,
+                  unsigned short NumeroChamp,
+                  char*          ValeurChamp,
+                  size_t*        TailleMax);
+
+/* Lecture d'un champ vers un fichier. */
+extern unsigned short API_ENTRY
+SGD_LireChampFichier (unsigned short NumeroSession,
+                      unsigned short IdGroupe,
+                      unsigned short OccurrenceGroupe,
+                      unsigned short NumeroChamp,
+                      const char*    NomFichier);
+
+/* Activation de la trace. */
+extern unsigned short API_ENTRY
+SGD_InitTrace (const char*    NomFichier,
+               const char*    ModeOuverture,
+               unsigned short Module,
+               unsigned char  Niveau);
+
+/*Initialisation de SGD*/
+unsigned short API_ENTRY SGD_Init(const char *fichierSesam);
+
+/* Transmission de la zone d'entrée. */
+extern unsigned short API_ENTRY SGD_LireZoneIn(unsigned short NumeroSession,
+				void**         ZDonneesEntree,
+				size_t*        TailleDonneesEntree);
+
+/* Transmission de la zone de sortie. */
+typedef void (API_ENTRY *LibererZoneMem) (void* Zone);
+
+
+extern unsigned short API_ENTRY SGD_EcrireZoneOut(unsigned short NumeroSession,
+				   void*          ZDonneesSortie,
+				   size_t         TailleDonneesSortie,
+				   LibererZoneMem Fonction);
+                   
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SRT/srt.h

@@ -0,0 +1,176 @@
+/*
+ * -------------------------------------------------------------------
+ * (c) 2001-2003 GIE SESAM-VITALE
+ *
+ * PROJET   : Services Reglementation et Tarification
+ *
+ * FICHIER  : srt.h (v5)
+ *
+ * Declaration des prototypes des fonctions SRT
+ * -------------------------------------------------------------------
+ */
+
+#ifndef __SRT_H__
+#define __SRT_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+    /*
+     * Inclusions
+     */
+#include <stddef.h>
+/* Inclure le fichier de d<>clarations sp<73>cifiques syst<73>me : win32def.h, macosdef.h, unixdef.h, etc. */
+
+
+/*
+* Declarations des fonctions publiques "standards"
+*/
+
+/* Recherche de codes CCAM par mot cle. */
+typedef unsigned short (API_ENTRY FARPTR SRT_RechercherParMotCle)
+    (const char*    MotCle,
+     unsigned long  CadreRecherche,
+     void**         ZDonneesSortie,
+     size_t*        TailleDonneesSortie);
+
+/* Recherche de codes CCAM par filtre. */
+typedef unsigned short (API_ENTRY FARPTR SRT_RechercherParFiltre)
+    (const char*    Filtre,
+     void**         ZDonneesSortie,
+     size_t*        TailleDonneesSortie);
+
+/* Consultation de donnees CCAM. */
+typedef unsigned short (API_ENTRY FARPTR SRT_ConsulterDonnee)
+    (const char*    Identifiant,
+     const char*    DateReference,
+     void*          ZDonneesEntree,
+     size_t         TailleDonneesEntree,
+     void**         ZDonneesSortie,
+     size_t*        TailleDonneesSortie);
+
+/* Modification d'un champ mono-occurrent. */
+typedef unsigned short (API_ENTRY FARPTR SRT_ModifierDonnee)
+    (const char*    Identifiant,
+     const char*    DateEffet,
+     void*          ZDonneesEntree,
+     size_t         TailleDonneesEntree);
+
+/* Annulation d'une modification */
+typedef unsigned short (API_ENTRY FARPTR SRT_AnnulerModification)
+    (const char*    Identifiant,
+     void*          ZDonneesEntree,
+     size_t         TailleDonneesEntree);
+
+/* Controle de la validite d'une ou plusieurs donnees. */
+typedef unsigned short (API_ENTRY FARPTR SRT_ControlerDonnees)
+    (const char*    Identifiant,
+     const char*    DateReference,
+     void*          ZDonneesEntree,
+     size_t         TailleDonneesEntree,
+     unsigned char* Resultat);
+
+/* Regle de gestion ou de tarification. */
+typedef unsigned short (API_ENTRY FARPTR SRT_AppliquerRegle)
+    (const char*    Identifiant,
+     void*          ZDonneesEntree,
+     size_t         TailleDonneesEntree,
+     void**         ZDonneesSortie,
+     size_t*        TailleDonneesSortie);
+
+/* Controle complet. */
+typedef unsigned short (API_ENTRY FARPTR SRT_ControleComplet)
+    (void*          ZDonneesEntree,
+     size_t         TailleDonneesEntree,
+     void**         ZDonneesSortie,
+     size_t*        TailleDonneesSortie);
+
+/* Chargement du referentiel. */
+typedef unsigned short (API_ENTRY FARPTR SRT_InitLIB2)(const char* SesamIni);
+
+/* Dechargement du referentiel. */
+typedef unsigned short (API_ENTRY FARPTR SRT_TermLIB)(void);
+
+/* Sauvegarde des modifications. */
+typedef unsigned short (API_ENTRY FARPTR SRT_SauvegarderReferentiel)(const char* Commentaire);
+
+/* Version du referentiel. */
+typedef unsigned short (API_ENTRY FARPTR SRT_LireVersion)
+    (void**         ZDonneesSortie,
+     size_t*        TailleDonneesSortie);
+
+/* Activation de la trace. */
+typedef unsigned short (API_ENTRY FARPTR SRT_InitTrace)
+	(const char*    pathConf,
+     const char*    ModeOuverture,
+     unsigned short Module,
+     unsigned char  Niveau);
+
+/* Allocation d'une zone memoire. */
+typedef unsigned short (API_ENTRY FARPTR SRT_AllouerZoneMem)
+    (void**         Zone,
+     size_t         Taille);
+
+/* Allocation d'une zone memoire. */
+typedef void (API_ENTRY FARPTR SRT_LibererZoneMem) (void*  Zone);
+
+/*
+* Declarations des fonctions publiques "simplifiees"
+*/
+
+/* Recherche de codes CCAM par mot cle. */
+typedef unsigned short (API_ENTRY FARPTR SRT_RechercherParMotCle_S)
+    (const char*    MotCle,
+     unsigned long  CadreRecherche,
+     unsigned short NumeroSession);
+
+/* Recherche de codes CCAM par filtre. */
+typedef unsigned short (API_ENTRY FARPTR SRT_RechercherParFiltre_S)
+    (const char*    Filtre,
+     unsigned short NumeroSession);
+
+/* Consultation de donnees CCAM. */
+typedef unsigned short (API_ENTRY FARPTR SRT_ConsulterDonnee_S)
+    (const char*    Identifiant,
+     const char*    DateReference,
+     unsigned short NumeroSession);
+
+/* Modification d'un champ mono-occurrent. */
+typedef unsigned short (API_ENTRY FARPTR SRT_ModifierDonnee_S)
+    (const char*    Identifiant,
+     const char*    DateEffet,
+     unsigned short NumeroSession);
+
+/* Annulation des modifications d'une donnee. */
+typedef unsigned short (API_ENTRY FARPTR SRT_AnnulerModification_S)
+    (const char*    Identifiant,
+     unsigned short NumeroSession);
+
+/* Controle de la validite d'une ou plusieurs donnees. */
+typedef unsigned short (API_ENTRY FARPTR SRT_ControlerDonnees_S)
+    (const char*    Identifiant,
+     const char*    DateReference,
+     unsigned short NumeroSession,
+     unsigned char* Resultat);
+
+/* Regle de gestion ou de tarification. */
+typedef unsigned short (API_ENTRY FARPTR SRT_AppliquerRegle_S)
+    (const char*    Identifiant,
+     unsigned short NumeroSession);
+
+/* Controle complet. */
+typedef unsigned short (API_ENTRY FARPTR SRT_ControleComplet_S)
+    (unsigned short NumeroSession);
+
+/* Version du referentiel. */
+typedef unsigned short (API_ENTRY FARPTR SRT_LireVersion_S)
+    (unsigned short NumeroSession);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.13/ssv.h

@@ -0,0 +1,327 @@
+/*
+ * -------------------------------------------------------------------
+ * (c) 2001-2003 GIE SESAM-VITALE
+ *
+ * PROJET   : Services SESAM Vitale
+ *
+ * FICHIER  : ssv.h 
+ *
+ * Declaration des prototypes des fonctions SSV
+ * -------------------------------------------------------------------
+ */
+
+#ifndef __SSV_H__
+#define __SSV_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+/*
+ * Inclusions
+ */
+#include <stddef.h>
+/* Inclure le fichier de d<>clarations sp<73>cifiques syst<73>me :
+   win32def.h, macosdef.h, aixdef.h, etc. */
+
+
+/****** FONCTIONS STANDARDS *********/
+						
+typedef unsigned short (API_ENTRY FARPTR SSV_TraduireARL)
+						 (short                   NbZDataIn,
+                          void   FARPTR FARPTR    TZDataIn,
+                          size_t FARPTR           TTailleZoneIn,
+                          void FARPTR FARPTR		pZDataOut,
+						  size_t FARPTR			pTailleZoneOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_LireCartePS)
+                (const char FARPTR NomRessourcePS, 
+                 const char FARPTR NomRessourceLecteur, 
+                 const char FARPTR CodePorteurPS, 
+                 void FARPTR FARPTR pZDataOut, 
+                 size_t FARPTR pTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_LireConfig)
+				(void FARPTR FARPTR pZDataOut, 
+				 size_t FARPTR psTailleDataOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_FormaterFactures)
+						(const char FARPTR NomRessourcePS,
+						const char FARPTR NomRessourceLecteur,
+						const char FARPTR CodePorteurPS,
+						char cFactureACreer,
+						char cModeSecur,
+						void FARPTR pZDataIn,
+						size_t TailleDataIn,
+						void FARPTR FARPTR pZDataOut,
+						size_t FARPTR pTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_FormaterLot)
+						(	const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				short				NBZDataIn,
+               				void FARPTR FARPTR	TZDataIn,
+               				size_t	FARPTR		TTailleZoneIn,
+			   				short FARPTR 		pNbZDataOut,
+                			void FARPTR FARPTR	TZDataOut,
+                			size_t	FARPTR		TTailleZoneOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_FormaterFichier)
+						 (void FARPTR pZDataIn,size_t TailleDataIn,
+						 void FARPTR FARPTR pZDataOut,size_t FARPTR pTailleZone);
+
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_InitTrace)
+						(char FARPTR pathConf, char FARPTR ModeOuverture,
+						 unsigned short Module, unsigned char Niveau);
+						  
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_AllouerZoneMem)
+						(void FARPTR FARPTR pZDataIn,
+						 size_t taille);
+						     
+typedef void (API_ENTRY FARPTR SSV_LibererZoneMem)
+						(void FARPTR pZone);
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_MajDateLecteur)
+						(const char FARPTR pcNomRessourceLecteur,
+						 const char FARPTR pcDateHeure);
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_LireDateLecteur)
+						(const char FARPTR pcNomRessourceLecteur,
+						 char FARPTR pcDateHeure);
+
+
+typedef unsigned short (API_ENTRY FARPTR SSV_LireDroitsVitale)
+                (const char FARPTR NomRessourcePS, 
+                 const char FARPTR NomRessourceLecteur, 
+                 const char FARPTR CodePorteurPS, 
+                 const char FARPTR DateConsultation, 
+                 void FARPTR FARPTR pZDataOut, 
+                 size_t FARPTR pTailleZone);
+
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_IdentifierTLA)
+						(const char FARPTR pcNomRessourceLecteur, 
+						 const char FARPTR NumVersionCDC,
+	    				 void FARPTR FARPTR pZDataOut, 
+	    				 size_t FARPTR tailleDataOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFacturesPdT)
+						(	const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+							short sNbZDataIn,
+						    void FARPTR FARPTR pvTZDataIn, 
+						    size_t FARPTR psTTailleDataIn,
+			   				short FARPTR 		pNbZDataOut,
+                			void FARPTR FARPTR	TZDataOut,
+                			size_t	FARPTR		TTailleZoneOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFSETLA)
+						(	const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+			   				short FARPTR 		pNbZDataOut,
+                			void FARPTR FARPTR	TZDataOut,
+                			size_t	FARPTR		TTailleZoneOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFSETLANC)
+						(	const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+			   				short FARPTR 		pNbZDataOut,
+                			void FARPTR FARPTR	TZDataOut,
+                			size_t	FARPTR		TTailleZoneOut);
+typedef unsigned short (API_ENTRY FARPTR SSV_EffacerTLA)
+					(const char FARPTR NomRessourcePS,
+					 const char FARPTR NomRessourceLecteur,
+					 const char FARPTR CodePorteurPS, 	
+					 const char FARPTR cNumFacturation,
+					 const char FARPTR cTypeDonnee);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_ChargerFacturesPdT)
+						(const char FARPTR pcNomRessourceLecteur,
+						const char FARPTR pcNumFacturation, 
+						short sNbZDataIn,
+						void FARPTR FARPTR pvTZDataIn, 
+						size_t FARPTR psTTailleDataIn,
+						short FARPTR 		pNbZDataOut,
+                		void FARPTR FARPTR	TZDataOut,
+                		size_t	FARPTR		TTailleZoneOut); 
+
+typedef unsigned short (API_ENTRY FARPTR SSV_ChargerAppli)
+						(const char FARPTR pcNomRessourceLecteur, 
+						short sNbZDataIn,
+						void FARPTR FARPTR pvTZDataIn, 
+						size_t FARPTR psTTailleDataIn);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_ChargerDonneesTLA)
+						(const char FARPTR pcNomRessourceLecteur, 
+						short sNbZDataIn,
+						void FARPTR FARPTR pvTZDataIn, 
+						size_t FARPTR psTTailleDataIn);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_DechargerBeneficiaires)                 
+                 (const char FARPTR   NomRessourcePS,
+		          const char FARPTR	  NomRessourceLecteur,
+		          const char FARPTR	  CodePorteurPS,
+		          const char FARPTR	  cNumFacturation,
+				  short FARPTR		  sNbZDataOut, 
+				  void FARPTR FARPTR  pTZDataOut, 
+				  size_t FARPTR		  sTTailleDataOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_TraduireFSE)
+				 (void FARPTR pZDataIn,
+				  size_t TailleDataIn,
+				  void FARPTR FARPTR pZDataOut,
+				  size_t FARPTR pTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_SecuriserFacture)
+                 (const char FARPTR pcNomRessourcePS,
+				  const char FARPTR pcNomRessourceLecteur,
+				  const char FARPTR pcCodePorteurPS, 
+				  char cNologSituation,
+				  const char FARPTR  pcNumFact,
+				  void FARPTR pvDataIn,
+				  size_t       szTailleDataIn ,
+				  void FARPTR FARPTR pvDataOut, 
+				  size_t FARPTR pszTailleDataOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_InitLIB2) (const char FARPTR pcFichierSesam);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_TermLIB)();
+
+
+
+/****** FONCTIONS SIMPLIFIEES *********/
+
+typedef unsigned short (API_ENTRY FARPTR SIS_TraduireARL)
+						 (unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_LireCartePS)
+                (const char FARPTR NomRessourcePS, 
+                 const char FARPTR NomRessourceLecteur, 
+                 const char FARPTR CodePorteurPS,
+                 unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_LireConfig)
+				(unsigned short numeroSession);
+
+
+typedef unsigned short (API_ENTRY FARPTR SIS_FormaterFactures)
+						(const char FARPTR NomRessourcePS,
+						const char FARPTR NomRessourceLecteur,
+						const char FARPTR CodePorteurPS,
+						char cFacturesACreer,
+						char ModeSecur,
+                        unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_FormaterLot)
+						( const char FARPTR	NomRessourcePS,
+              			 const char FARPTR	NomRessourceLecteur,
+               			 const char FARPTR	CodePorteurPS,
+				         unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_FormaterFichier)
+						 (unsigned short numeroSession);
+
+typedef unsigned short  (API_ENTRY FARPTR SIS_InitTrace)
+						(char FARPTR NomFichier, char FARPTR ModeOuverture,
+						 unsigned short Module, unsigned char Niveau);
+						  
+
+typedef unsigned short  (API_ENTRY FARPTR SIS_MajDateLecteur)
+						(const char FARPTR pcNomRessourceLecteur,
+						 const char FARPTR pcDateHeure);
+
+typedef unsigned short  (API_ENTRY FARPTR SIS_LireDateLecteur)
+						(const char FARPTR pcNomRessourceLecteur,
+						 char FARPTR pcDateHeure);
+
+
+typedef unsigned short (API_ENTRY FARPTR SIS_LireDroitsVitale)
+                (const char FARPTR NomRessourcePS, 
+                 const char FARPTR NomRessourceLecteur, 
+                 const char FARPTR CodePorteurPS, 
+                 const char FARPTR DateConsultation,
+                 unsigned short numeroSession); 
+
+typedef unsigned short  (API_ENTRY FARPTR SIS_IdentifierTLA)
+						(const char FARPTR pcNomRessourceLecteur, 
+						 const char FARPTR NumVersionCDC,
+                         unsigned short numeroSession );
+
+typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFacturesPdT)
+						( const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+                                         unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFSETLA)
+						(const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+                                        unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFSETLANC)
+						(const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+                                        unsigned short numeroSession);
+typedef unsigned short (API_ENTRY FARPTR SIS_EffacerTLA)
+					(const char FARPTR NomRessourcePS,
+					 const char FARPTR NomRessourceLecteur,
+					 const char FARPTR CodePorteurPS, 	
+					 const char FARPTR cNumFacturation,
+					 const char FARPTR cTypeDonnee);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_ChargerFacturesPdT)
+						(const char FARPTR pcNomRessourceLecteur,
+						 const char FARPTR pcNumFacturation,
+                                                 unsigned short numeroSession); 
+
+typedef unsigned short (API_ENTRY FARPTR SIS_ChargerAppli)
+						(const char FARPTR pcNomRessourceLecteur,
+                                                  unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_ChargerDonneesTLA)
+						(const char FARPTR pcNomRessourceLecteur,
+                                                unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_DechargerBeneficiaires)                 
+                 (	  const char FARPTR   NomRessourcePS,
+		          const char FARPTR	  NomRessourceLecteur,
+		          const char FARPTR	  CodePorteurPS,
+		          const char FARPTR	  cNumFacturation,
+                          unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_TraduireFSE)
+				 (unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_SecuriserFacture)
+                 ( const char FARPTR pcNomRessourcePS,
+				  const char FARPTR pcNomRessourceLecteur,
+				  const char FARPTR pcCodePorteurPS, 
+				  char cNologSituation,
+				  const char FARPTR  pcNumFact,
+                                  unsigned short numeroSession);
+						  
+
+
+
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.14/ssv.h

@@ -0,0 +1,412 @@
+/*
+ * -------------------------------------------------------------------
+ * (c) 2001-2003 GIE SESAM-VITALE
+ *
+ * PROJET   : Services SESAM Vitale
+ *
+ * FICHIER  : ssv.h 
+ *
+ * Declaration des prototypes des fonctions SSV
+ * -------------------------------------------------------------------
+ */
+
+#ifndef __SSV_H__
+#define __SSV_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+/*
+ * Inclusions
+ */
+#include <stddef.h>
+/* Inclure le fichier de d<>clarations sp<73>cifiques syst<73>me :
+   win32def.h, macosdef.h, aixdef.h, etc. */
+
+
+/****** FONCTIONS STANDARDS *********/
+						
+typedef unsigned short (API_ENTRY FARPTR SSV_TraduireARL)
+						 (short                   NbZDataIn,
+                          void   FARPTR FARPTR    TZDataIn,
+                          size_t FARPTR           TTailleZoneIn,
+                          void FARPTR FARPTR		pZDataOut,
+						  size_t FARPTR			pTailleZoneOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_LireCartePS)
+                (const char FARPTR NomRessourcePS, 
+                 const char FARPTR NomRessourceLecteur, 
+                 const char FARPTR CodePorteurPS, 
+                 void FARPTR FARPTR pZDataOut, 
+                 size_t FARPTR pTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_LireConfig)
+				(void FARPTR FARPTR pZDataOut, 
+				 size_t FARPTR psTailleDataOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_FormaterFactures)
+						(char cFactureACreer,
+						char cModeSecur,
+						char cTypeFlux,
+						void FARPTR pZDataIn,
+						size_t TailleDataIn,
+						void FARPTR FARPTR pZDataOut,
+						size_t FARPTR pTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_ChiffrerFacture)
+						(void * pZDataIn,
+						 size_t TailleDataIn, 
+						 void * * pZDataOut, 
+						 size_t * pTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_SignerFactureVitale)
+						(const char * pcNomRessourceVitale,
+						 void * pZDataIn, 
+						 size_t szTailleDataIn, 
+						 void * * pZDataOut, 
+						 size_t * pszTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_CalculerHashFactureAssure)
+						(const char * pcNumSerie,
+						 void * pZDataIn, 
+						 size_t szTailleDataIn, 
+						 void * * pZDataOut, 
+						 size_t * pszTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_AjouterSignatureAssureDansFacture)
+						(void * pZDataIn,
+						 size_t szTailleDataIn, 
+						 void * * pZDataOut, 
+						 size_t * pszTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_SignerFactureCPS)
+						(const char * pcNomRessourcePS,
+						const char * pcNomRessourceLecteur,
+						const char * pcCodePorteurPS,
+						char cNologSituation,
+						void * pZDataIn,
+						size_t szTailleDataIn,
+						void * * pZDataOut,
+						size_t * pszTailleZone);
+
+typedef unsigned short (API_ENTRY SSV_CalculerHashFacturePS)
+						(const char * pcNumSerieCPS,
+						void * pZDataIn, 
+						size_t usTailleDataIn, 
+						void * * pZDataOut, 
+						size_t * pusTailleZone);
+						
+typedef unsigned short (API_ENTRY SSV_AjouterSignaturePSFacture)
+						(void * pZDataIn,
+						size_t szTailleDataIn, 
+						 void * * pZDataOut, 
+						 size_t * pszTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_SignerLotCPS)
+						(const char * pcNomRessourcePS,
+						const char * pcNomRessourceLecteur,
+						const char * pcCodePorteurPS,
+						char cNologSituation,
+						void * pZDataIn,
+						size_t szTailleDataIn,
+						void * * pZDataOut,
+						size_t * pszTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_FormaterLot)
+						(	short				NBZDataIn,
+               				void FARPTR FARPTR	TZDataIn,
+               				size_t	FARPTR		TTailleZoneIn,
+			   				short FARPTR 		pNbZDataOut,
+                			void FARPTR FARPTR	TZDataOut,
+                			size_t	FARPTR		TTailleZoneOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_FormaterFichier)
+						 (void FARPTR pZDataIn,size_t TailleDataIn,
+						 void FARPTR FARPTR pZDataOut,size_t FARPTR pTailleZone);
+
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_InitTrace)
+						(char FARPTR pathConf, char FARPTR ModeOuverture,
+						 unsigned short Module, unsigned char Niveau);
+						  
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_AllouerZoneMem)
+						(void FARPTR FARPTR pZDataIn,
+						 size_t taille);
+						     
+typedef void (API_ENTRY FARPTR SSV_LibererZoneMem)
+						(void FARPTR pZone);
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_MajDateLecteur)
+						(const char FARPTR pcNomRessourceLecteur,
+						 const char FARPTR pcDateHeure);
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_LireDateLecteur)
+						(const char FARPTR pcNomRessourceLecteur,
+						 char FARPTR pcDateHeure);
+
+
+typedef unsigned short (API_ENTRY FARPTR SSV_LireDroitsVitale)
+                (const char FARPTR NomRessourcePS, 
+                 const char FARPTR NomRessourceLecteur, 
+                 const char FARPTR CodePorteurPS, 
+                 const char FARPTR DateConsultation, 
+                 void FARPTR FARPTR pZDataOut, 
+                 size_t FARPTR pTailleZone);
+
+
+typedef unsigned short  (API_ENTRY FARPTR SSV_IdentifierTLA)
+						(const char FARPTR pcNomRessourceLecteur, 
+						 const char FARPTR NumVersionCDC,
+	    				 void FARPTR FARPTR pZDataOut, 
+	    				 size_t FARPTR tailleDataOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFacturesPdT)
+						(	const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+							short sNbZDataIn,
+						    void FARPTR FARPTR pvTZDataIn, 
+						    size_t FARPTR psTTailleDataIn,
+			   				short FARPTR 		pNbZDataOut,
+                			void FARPTR FARPTR	TZDataOut,
+                			size_t	FARPTR		TTailleZoneOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFSETLA)
+						(	const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+			   				short FARPTR 		pNbZDataOut,
+                			void FARPTR FARPTR	TZDataOut,
+                			size_t	FARPTR		TTailleZoneOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFSETLANC)
+						(	const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+			   				short FARPTR 		pNbZDataOut,
+                			void FARPTR FARPTR	TZDataOut,
+                			size_t	FARPTR		TTailleZoneOut);
+typedef unsigned short (API_ENTRY FARPTR SSV_EffacerTLA)
+					(const char FARPTR NomRessourcePS,
+					 const char FARPTR NomRessourceLecteur,
+					 const char FARPTR CodePorteurPS, 	
+					 const char FARPTR cNumFacturation,
+					 const char FARPTR cTypeDonnee);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_ChargerFacturesPdT)
+						(const char FARPTR pcNomRessourceLecteur,
+						const char FARPTR pcNumFacturation, 
+						short sNbZDataIn,
+						void FARPTR FARPTR pvTZDataIn, 
+						size_t FARPTR psTTailleDataIn,
+						short FARPTR 		pNbZDataOut,
+                		void FARPTR FARPTR	TZDataOut,
+                		size_t	FARPTR		TTailleZoneOut); 
+
+typedef unsigned short (API_ENTRY FARPTR SSV_ChargerAppli)
+						(const char FARPTR pcNomRessourceLecteur, 
+						short sNbZDataIn,
+						void FARPTR FARPTR pvTZDataIn, 
+						size_t FARPTR psTTailleDataIn);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_ChargerDonneesTLA)
+						(const char FARPTR pcNomRessourceLecteur, 
+						short sNbZDataIn,
+						void FARPTR FARPTR pvTZDataIn, 
+						size_t FARPTR psTTailleDataIn);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_DechargerBeneficiaires)                 
+                 (const char FARPTR   NomRessourcePS,
+		          const char FARPTR	  NomRessourceLecteur,
+		          const char FARPTR	  CodePorteurPS,
+		          const char FARPTR	  cNumFacturation,
+				  short FARPTR		  sNbZDataOut, 
+				  void FARPTR FARPTR  pTZDataOut, 
+				  size_t FARPTR		  sTTailleDataOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_TraduireFSE)
+				 (void FARPTR pZDataIn,
+				  size_t TailleDataIn,
+				  void FARPTR FARPTR pZDataOut,
+				  size_t FARPTR pTailleZone);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_SecuriserFacture)
+                 (const char FARPTR pcNomRessourcePS,
+				  const char FARPTR pcNomRessourceLecteur,
+				  const char FARPTR pcCodePorteurPS, 
+				  char cNologSituation,
+				  const char FARPTR  pcNumFact,
+				  void FARPTR pvDataIn,
+				  size_t       szTailleDataIn ,
+				  void FARPTR FARPTR pvDataOut, 
+				  size_t FARPTR pszTailleDataOut);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_InitLIB2) (const char FARPTR pcFichierSesam);
+
+typedef unsigned short (API_ENTRY FARPTR SSV_TermLIB)();
+
+
+
+/****** FONCTIONS SIMPLIFIEES *********/
+
+typedef unsigned short (API_ENTRY FARPTR SIS_TraduireARL)
+						 (unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_LireCartePS)
+                (const char FARPTR NomRessourcePS, 
+                 const char FARPTR NomRessourceLecteur, 
+                 const char FARPTR CodePorteurPS,
+                 unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_LireConfig)
+				(unsigned short numeroSession);
+
+
+typedef unsigned short (API_ENTRY FARPTR SIS_FormaterFactures)
+						(char cFacturesACreer,
+						char ModeSecur,
+						char cTypeFlux,
+                        unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_ChiffrerFacture)
+						(unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_SignerFactureVitale)
+						(const char * pcNomRessourceVitale,
+						 unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_CalculerHashFactureAssure)
+						(const char * pcNumSerie,
+						 unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_AjouterSignatureAssureDansFacture)
+						(unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_SignerFactureCPS)
+						(const char * pcNomRessourcePS,
+						 const char * pcNomRessourceLecteur,
+						 const char * pcCodePorteurPS,
+						 char cNologSituation,
+						 unsigned short numeroSession);
+
+typedef unsigned short (SIS_CalculerHashFacturePS)
+						(const char * pcNumSerieCPS,
+						unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY SIS_AjouterSignaturePSFacture)
+						(unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_SignerLotCPS)
+						(const char * pcNomRessourcePS,
+						 const char * pcNomRessourceLecteur,
+						 const char * pcCodePorteurPS,
+						 char cNologSituation,
+						 unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_FormaterLot)
+						(unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_FormaterFichier)
+						 (unsigned short numeroSession);
+
+typedef unsigned short  (API_ENTRY FARPTR SIS_InitTrace)
+						(char FARPTR NomFichier, char FARPTR ModeOuverture,
+						 unsigned short Module, unsigned char Niveau);
+						  
+
+typedef unsigned short  (API_ENTRY FARPTR SIS_MajDateLecteur)
+						(const char FARPTR pcNomRessourceLecteur,
+						 const char FARPTR pcDateHeure);
+
+typedef unsigned short  (API_ENTRY FARPTR SIS_LireDateLecteur)
+						(const char FARPTR pcNomRessourceLecteur,
+						 char FARPTR pcDateHeure);
+
+
+typedef unsigned short (API_ENTRY FARPTR SIS_LireDroitsVitale)
+                (const char FARPTR NomRessourcePS, 
+                 const char FARPTR NomRessourceLecteur, 
+                 const char FARPTR CodePorteurPS, 
+                 const char FARPTR DateConsultation,
+                 unsigned short numeroSession); 
+
+typedef unsigned short  (API_ENTRY FARPTR SIS_IdentifierTLA)
+						(const char FARPTR pcNomRessourceLecteur, 
+						 const char FARPTR NumVersionCDC,
+                         unsigned short numeroSession );
+
+typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFacturesPdT)
+						( const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+                                         unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFSETLA)
+						(const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+                                        unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFSETLANC)
+						(const char FARPTR	NomRessourcePS,
+              			 	const char FARPTR	NomRessourceLecteur,
+               				const char FARPTR	CodePorteurPS,
+               				const char FARPTR	pcNumFact,
+                                        unsigned short numeroSession);
+typedef unsigned short (API_ENTRY FARPTR SIS_EffacerTLA)
+					(const char FARPTR NomRessourcePS,
+					 const char FARPTR NomRessourceLecteur,
+					 const char FARPTR CodePorteurPS, 	
+					 const char FARPTR cNumFacturation,
+					 const char FARPTR cTypeDonnee);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_ChargerFacturesPdT)
+						(const char FARPTR pcNomRessourceLecteur,
+						 const char FARPTR pcNumFacturation,
+                                                 unsigned short numeroSession); 
+
+typedef unsigned short (API_ENTRY FARPTR SIS_ChargerAppli)
+						(const char FARPTR pcNomRessourceLecteur,
+                                                  unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_ChargerDonneesTLA)
+						(const char FARPTR pcNomRessourceLecteur,
+                                                unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_DechargerBeneficiaires)                 
+                 (	  const char FARPTR   NomRessourcePS,
+		          const char FARPTR	  NomRessourceLecteur,
+		          const char FARPTR	  CodePorteurPS,
+		          const char FARPTR	  cNumFacturation,
+                          unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_TraduireFSE)
+				 (unsigned short numeroSession);
+
+typedef unsigned short (API_ENTRY FARPTR SIS_SecuriserFacture)
+                 ( const char FARPTR pcNomRessourcePS,
+				  const char FARPTR pcNomRessourceLecteur,
+				  const char FARPTR pcCodePorteurPS, 
+				  char cNologSituation,
+				  const char FARPTR  pcNumFact,
+                                  unsigned short numeroSession);
+						  
+
+/* inclusion temporaire dans ssv.h pour ne pas a avoir <20> relivrer Sedica (pas d'incidence sur le code) -> <20> inclure dans sedica.h ou commun.h*/
+/* Chaine discriminante d un nom de ressource TL PCSC */
+#define TL_PCSC " TL "
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/STS/sts.h

@@ -0,0 +1,353 @@
+/*
+%-----------------------------------------------------------------------------
+% PROJET  : STS INTERFACE
+%
+% MODULE  : HEADER STS INTERFACE
+%
+% VERSION : cf #define ci-apr<70>s
+%
+% FICHIER : sts.h
+%
+% D<>claration des prototypes des fonctions STS - INTERFACE
+%-----------------------------------------------------------------------------
+%
+% EDS DHU - 09/04/03 - Cr<43>ation du .h
+%
+% EDS OCL - 06/06/03 - Defect 91 : Rectification du prototype de InitTrace()
+%
+% EDS OCL - 04/07/03 - Defect 115 : Nettoyage de stsitf.h (devenu sts.h)
+%
+%-----------------------------------------------------------------------------
+*/
+
+#ifndef __STSITF_H
+#define __STSITF_H
+#define __STSITF_VERSION "0103"
+/* Ne pas oublier d'impacter idef.h aussi */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*
+% Biblioth<74>ques ANSI ou syst<73>me
+%------------------------------
+*/
+
+
+/*
+% Fichiers h inclus
+%------------------
+*/
+
+#include "sys_dep.h"
+/*
+% Macros et Constantes
+%---------------------
+*/
+
+/* OCL - Defect 115 : Suppression du #define G_xxx ici m<>me */
+
+/* OCL - Defect 115 : Suppression du second #ifdef _cplusplus ici m<>me */
+
+
+/*********************************************************************************
+ ************************* Fonctions r<>entrantes *********************************
+ *********************************************************************************/
+
+/*
+%-----------------------------------------------------------------------------
+% STS_Tarification
+%
+% R<>le : Tarification de la part compl<70>mentaire des actes de la facture
+%
+% Param<61>tres d'entr<74>e :
+%			MotifAppel (char) : 1er appel ('P') ou Appel sur echec de
+%				tarification ('E').
+%			ZDonneesEntree (void*) : Zone d'<27>change fournie par le Progiciel
+%				contenant toutes les informations sur la facture
+%			TailleDonneesEntree (size_t) : Taille de la zone d'<27>change Zin
+%
+% Param<61>tres de sortie :
+%			ZDonneesSortie (void**) : Zone d'<27>change fournie par le module STS appel<65>
+%				contenant toutes les informations modifi<66>es de la facture
+%				en entr<74>e et de nouvelles informations.
+%			TailleDonneesSortie (size_t*) : Taille de la zone d'<27>change Zout
+%
+% Valeur retourn<72>e :
+%			OK si pas d'erreur
+%			ERR_STS_NON_INITIALISE si module STS non initialis<69>
+%        et les codes d'erreurs de la tarification du module STS appel<65>
+% 
+%-----------------------------------------------------------------------------
+*/
+/* OCL - Defect 115 : Remplacement PTR par FARPTR */
+typedef unsigned short (API_ENTRY FARPTR STS_Tarification)(char	MotifAppel, void FARPTR	ZDonneesEntree,
+														   size_t TailleDonneesEntree, void FARPTR FARPTR ZDonneesSortie,
+														   size_t FARPTR TailleDonneesSortie);
+
+/* Fonction simplifi<66>e */
+/* OCL - Defect 115 : Remplacement STS_SIM par SGD */
+#ifdef SGD
+typedef unsigned short (API_ENTRY FARPTR STS_Tarification_S)(char MotifAppel, unsigned short NumeroSession);
+#endif
+
+/*
+%-----------------------------------------------------------------------------
+% STS_Assistance
+%
+% R<>le : Assistance <20> la facturation.
+%
+% Param<61>tres d'entr<74>e :
+%			MotifAppel (char) : 1er appel ('P') ou Appel sur echec de
+%				tarification ('E').
+%			PorteeAppel (ushort) : 0 pour une assistance sur toute la facture.
+%				1..n pour une assistance sur un acte de rang donn<6E> /zone
+%			ZDonneesEntree (void*) : Zone d'<27>change fournie par le Progiciel
+%				contenant toutes les informations sur la facture
+%			TailleDonneesEntree (size_t) : Taille de la zone d'<27>change Zin
+%
+% Param<61>tres de sortie :
+%			ZDonneesSortie (void**) : Zone d'<27>change fournie par le module STS appel<65>
+%			TailleDonneesSortie (size_t*) : Taille de la zone d'<27>change Zout
+%
+% Valeur retourn<72>e : (idem Tarification)
+%			OK si pas d'erreur
+%			ERR_STS_NON_INITIALISE si module STS non initialis<69>
+%        et les codes d'erreurs de la tarification du module STS appel<65>
+%
+%-----------------------------------------------------------------------------
+*/
+/* OCL - Defect 115 : Remplacement PTR par FARPTR */
+typedef unsigned short (API_ENTRY FARPTR STS_Assistance)(char MotifAppel, unsigned short PorteeAppel,
+														 void FARPTR ZDonneesEntree, size_t	TailleDonneesEntree,
+														 void FARPTR FARPTR	ZDonneesSortie, size_t FARPTR TailleDonneesSortie);
+
+/* Fonction simplifi<66>e */
+#ifdef SGD
+typedef unsigned short (API_ENTRY FARPTR STS_Assistance_S)(char MotifAppel, unsigned short PorteeAppel,
+														   unsigned short NumeroSession);
+#endif
+
+/*
+%-----------------------------------------------------------------------------
+% STS_LireVersion
+%
+% R<>le : Lecture de la version de ce module et du fichier de ces tables externes
+%			dans le groupe 3780. Appeller la lecture de version de chaque module STS 
+%        puis recopier la r<>ponse 3780 de chacun dans la zone de sortie.
+%
+% Param<61>tres d'entr<74>e : aucun
+%
+% Param<61>tres de sortie :
+%			ZDonneesSortie (void**) : Zone d'<27>change fournie par ce module
+%				contenant les versions (grp 3780) demand<6E>es.
+%			TailleDonneesSortie (size_t*) : Taille de la zone d'<27>change Zout
+%
+% Valeur retourn<72>e :
+%			OK si pas d'erreur
+%			ERR_STS_NON_INITIALISE si module STS non initialis<69>
+%			ERR_ZOUT si ZDonneesSortie==NULL ou TailleDonneesSortie==NULL
+%			ERR_ZONE_ALLOC si m<>moire insuffisante pour allouer la Zout
+%
+%-----------------------------------------------------------------------------
+*/
+/* OCL - Defect 115 : Remplacement PTR par FARPTR */
+typedef unsigned short (API_ENTRY FARPTR STS_LireVersion)(void FARPTR FARPTR ZDonneesSortie, size_t FARPTR TailleDonneesSortie);
+
+/* Fonction simplifi<66>e */
+#ifdef SGD
+typedef unsigned short (API_ENTRY FARPTR STS_LireVersion_S)(unsigned short NumeroSession);
+#endif
+
+/*
+%-----------------------------------------------------------------------------
+% STS_InitTrace
+%
+% R<>le : Initialisation des traces du module STS-Interface dans un fichier log.
+%			Cette fonction permet d'activer ou d<>sactiver (niveau 0) les
+%			traces. Une activation requiert un nom de fichier et un mode
+%			d'ouverture. Un changement de niveau peut se faire sur le m<>me
+%			fichier ou sur un diff<66>rent s'il est pr<70>cis<69> en entr<74>e
+%
+% Param<61>tres d'entr<74>e :
+%			NomFichier (char*) : Chemin et nom de fichier de trace
+%			ModeOuverture (char*) : Mode d'ouverture du fichier de trace
+%				"a", "w" (,"ab", "wb").
+%			Module (ushort) : n<> de module 0 <20> 5 (6=TOUS)
+%			Niveau (uchar) : Niveau de trace : 0 signifie pas de trace, 1
+%				signifie traces de profondeur 8 et >=2 signifie traces sans limite
+%				de profondeur et activation traces module STS_SI
+%
+% Param<61>tres de sortie : aucun
+%
+% Valeur retourn<72>e :
+%			OK si pas d'erreur
+%			ERR_PARAM si NomFichier/ModeOuverture incorrect quand Niveau > 0
+%			ERR_TRACE_FILE si erreur d'ouverture du fichier de trace
+%
+%-----------------------------------------------------------------------------
+*/
+/* OCL - Defect 91 : Rectification du prototype de InitTrace() */
+/* OCL - Defect 115 : Remplacement PTR par FARPTR */
+typedef unsigned short (API_ENTRY FARPTR STS_InitTrace)(const char FARPTR pathConf, const char FARPTR	ModeOuverture,
+														unsigned short Module, unsigned char Niveau);
+
+/*********************************************************************************
+ ************************* Fonctions d'initialisation et de terminaison  *********
+ *********************************************************************************/
+
+/*
+%-----------------------------------------------------------------------------
+% STS_InitLIB
+%
+% R<>le : Initialisation du module STS-Interface : Chargement des tables externes
+%			et suivi de parc. Appel de l'nitialisation de chaque module STS 
+%
+% Param<61>tres d'entr<74>e : aucun
+%			
+% Param<61>tres de sortie : aucun
+%
+% Valeur retourn<72>e :
+%			OK si pas d'erreur
+%			ERR_INTERNE_ITF si erreur interne du module STS-Interface (ou STS SI)
+%			ERR_MEM_DISPO si plus de m<>moire disponible
+%			ERR_PKG_PATH_INI si le chemin d'acc<63>s au fichier binaire est
+%				inconnu (fichier de configuration inaccessible ou information
+%				manquante)
+%			ERR_ITF_PKG_ACCES si fichier binaire de table inaccessible
+%			ERR_ITF_PKG_VER si version du fichier incoh<6F>rent avec version du
+%				module STS-Interface (dans les deux sens)
+%			ERR_ITF_PKG_CRC si CRC du fichier binaire est incorrect
+%			ERR_ITF_PKG_FORME si format du fichier incorrect
+%			ERR_ITF_PKG_INCPT s'il manque une table dans le fichier binaire
+%			ERR_ITF_PKG_NOM si le nom du fichier est diff<66>rent du nom dans
+%				l'en-t<>te du fichier.
+%			les codes suivants ne sont pas des erreurs fatales (non bloquant)
+%				mais juste des avertissements
+%				WAR_STS_DEJA_INITIALISE si module d<>j<EFBFBD> initialis<69>
+%				WAR_ADM_PATH si chemin au suivi de parc non trouv<75> dans fichier
+%					de configuration des produits SV
+%				WAR_ADM_FILE si impossible de cr<63>er les fichiers de suivi de
+%					parc
+%        ET les codes de retour de chaque module STS appel<65>
+%
+%-----------------------------------------------------------------------------
+*/
+/* extern unsigned short API_ENTRY STS_InitLIB(); */
+/*
+%-----------------------------------------------------------------------------
+% STS_InitLIB2
+%
+% R<>le : Initialisation du module STS-Interface : Chargement des tables externes
+%			et suivi de parc. Appel de l'nitialisation de chaque module STS 
+%
+% Param<61>tres d'entr<74>e :
+%			NomFichierIni (char*) : Chemin et nom du fichier de configuration des
+%				produits SESAM Vitale du poste de travail (sesam.ini)
+%
+% Param<61>tres de sortie : aucun
+%
+% Valeur retourn<72>e :
+%			OK si pas d'erreur
+%			ERR_INTERNE_ITF si erreur interne du module STS-Interface (ou STS SI)
+%			ERR_MEM_DISPO si plus de m<>moire disponible
+%			ERR_PKG_PATH_INI si le chemin d'acc<63>s au fichier binaire est
+%				inconnu (fichier de configuration inaccessible ou information
+%				manquante)
+%			ERR_ITF_PKG_ACCES si fichier binaire de table inaccessible
+%			ERR_ITF_PKG_VER si version du fichier incoh<6F>rent avec version du
+%				module STS-Interface (dans les deux sens)
+%			ERR_ITF_PKG_CRC si CRC du fichier binaire est incorrect
+%			ERR_ITF_PKG_FORME si format du fichier incorrect
+%			ERR_ITF_PKG_INCPT s'il manque une table dans le fichier binaire
+%			ERR_ITF_PKG_NOM si le nom du fichier est diff<66>rent du nom dans
+%				l'en-t<>te du fichier.
+%			les codes suivants ne sont pas des erreurs fatales (non bloquant)
+%				mais juste des avertissements
+%				WAR_STS_DEJA_INITIALISE si module d<>j<EFBFBD> initialis<69>
+%				WAR_ADM_PATH si chemin au suivi de parc non trouv<75> dans fichier
+%					de configuration des produits SV
+%				WAR_ADM_FILE si impossible de cr<63>er les fichiers de suivi de
+%					parc
+%        ET les codes de retour de chaque module STS appel<65>
+%
+%-----------------------------------------------------------------------------
+*/
+typedef unsigned short (API_ENTRY FARPTR STS_InitLIB2)(const char FARPTR nomFichierIni);
+
+/*
+%-----------------------------------------------------------------------------
+% STS_TermLIB
+%
+% R<>le : Terminaison du module STS-Interface : D<>chargement des tables externes.
+%
+% Param<61>tres d'entr<74>e : aucun
+%
+% Param<61>tres de sortie : aucun
+%
+% Valeur retourn<72>e :
+%			OK si pas d'erreur
+%			ERR_INTERNE_ITF si erreur interne du module STS-Interface (ou STS SI)
+%
+%-----------------------------------------------------------------------------
+*/
+typedef unsigned short (API_ENTRY FARPTR STS_TermLIB)(void);
+
+/*********************************************************************************
+ ************************* Fonctions de gestion de la m<>moire  *******************
+ *********************************************************************************/
+
+/*
+%-----------------------------------------------------------------------------
+% STS_AllouerZoneMem
+%
+% R<>le : Allocation d'une zone d'<27>change de sortie par STS Interface.
+%			Cette fonction permet la r<>allocation d'une zone d'<27>change.
+%			L'allocation d'une nouvelle zone d'<27>change n<>cessite un pointeur
+%			NULL en entr<74>e !
+%			Cette fonctio est <20> utiliser conjointement avec STS_LibererZoneMem
+%			pour faciliter le Debugage (zone allou<6F>e par l'<27>crivain)
+%
+% Param<61>tres d'entr<74>e :
+%			Taille (size_t) : Taille de la zone d'<27>change <20> allouer.
+%
+% Param<61>tres d'entr<74>e et de sortie :
+%			Zone (void**) : Zone d'<27>change pr<70>allou<6F>e en entr<74>e (ou NULL).
+%				Zone allou<6F>e (r<>allou<6F>e) par le module STS-Interface.
+%
+% Valeur retourn<72>e :
+%			OK si pas d'erreur
+%			ERR_ZOUT si Zone==NULL ou Taille==0
+%			ERR_ZONE_ALLOC si plus de m<>moire disponible
+%
+%-----------------------------------------------------------------------------
+*/
+/* OCL - Defect 115 : Remplacement PTR par FARPTR */
+typedef unsigned short (API_ENTRY FARPTR STS_AllouerZoneMem)(void FARPTR FARPTR	Zone, size_t Taille);
+
+
+/*
+%-----------------------------------------------------------------------------
+% STS_LibererZoneMem
+%
+% R<>le : Lib<69>ration de la zone d'<27>change de sortie par STS Interface.
+%
+% Param<61>tres d'entr<74>e :
+%			Zone (void*) : Zone d'<27>change <20> lib<69>rer (allou<6F>e pr<70>c<EFBFBD>demment par
+%				le module STS-Interce par STS_AllouerZoneMem).
+%
+% Param<61>tres de sortie : aucun
+%
+% Valeur retourn<72>e : aucune
+%
+%-----------------------------------------------------------------------------
+*/
+/* OCL - Defect 115 : Remplacement PTR par FARPTR */
+typedef void (API_ENTRY FARPTR STS_LibererZoneMem)(void FARPTR Zone);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __STSITF_H */

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SYS_DEF/linux/linuxdef.h

@@ -0,0 +1,189 @@
+/*---------------------------------------------------------------------------
+ PROJET     : Couche de portabilite multi-systeme
+ 
+ PLATE-FORME: LINUX
+ 
+ MODULE     : Definition des macros et des types utilises par la couche 
+              d'abstraction systeme pour la plate-forme LINUX.
+              
+              Le fichier de definition des types portable (ce fichier) doit 
+              etre inclus avant tout autre .h de definitions d'APIS gip-cps. 
+              Ce fichier definit tous les types et macros dependants du 
+              systeme. 
+
+ FICHIER    : common\linux\src\linuxdef.h
+
+ VERSION    : 1.00
+ 
+ DATE       : 10/01/2001
+ 
+ AUTEUR     : ALVARO ROCHA
+ 
+-----------------------------------------------------------------------------
+-----------------------------------------------------------------------------
+ Modifications:  (nouvelle version, date, auteur, explication)
+ ...
+
+ - V4.31 - AROC le 12/02/2001 :
+      Ajout des #define TRUE et FALSE ainsi que le typedef int BOOLEEN
+-----------------------------------------------------------------------------
+---------------------------------------------------------------------------*/
+
+
+#ifndef __CPSCASDF_H
+#define __CPSCASDF_H
+
+/*----------------- definition des macros portables ------------------------*/
+#ifndef far
+#define far
+#endif
+
+#ifndef FAR
+#define FAR
+#endif
+
+#ifndef PTR
+#define PTR *
+#endif
+
+#ifndef PVOID
+#define PVOID void PTR
+#endif
+
+#ifndef FARPTR
+#define FARPTR PTR
+#endif
+
+#ifndef FPVOID
+#define FPVOID void FARPTR
+#endif
+
+/* AROC 12/02/2001 debut : */
+#ifndef FALSE
+#define FALSE 0
+#endif
+
+#ifndef TRUE
+#define TRUE 1
+#endif
+/* AROC 12/02/2001 fin */
+
+/*----------------- definition des types portables ------------------------*/
+#ifndef CHAR
+#define CHAR char
+#endif
+
+#ifndef PCHAR
+#define PCHAR CHAR PTR
+#endif
+
+#ifndef PSTRG
+#define PSTRG CHAR PTR
+#endif
+
+#ifndef UCHAR
+#define UCHAR unsigned char
+#endif
+
+#ifndef PUCHAR
+#define PUCHAR UCHAR PTR
+#endif
+
+
+#ifndef INT8
+#define INT8 char
+#endif
+
+#ifndef INT16
+#define INT16 short
+#endif
+
+#ifndef INT32
+#define INT32 long
+#endif
+
+#ifndef PINT8
+#define PINT8 INT8 PTR
+#endif
+
+#ifndef PINT16
+#define PINT16 INT16 PTR
+#endif
+
+#ifndef PINT32
+#define PINT32 INT32 PTR
+#endif
+
+
+#ifndef UINT8
+#define UINT8 unsigned char
+#endif
+
+#ifndef UINT16
+#define UINT16 unsigned short
+#endif
+
+#ifndef UINT32
+#define UINT32 unsigned long
+#endif
+
+#ifndef PUINT8
+#define PUINT8 UINT8 PTR
+#endif
+
+#ifndef PUINT16
+#define PUINT16 UINT16 PTR
+#endif
+
+#ifndef PUINT32
+#define PUINT32 UINT32 PTR
+#endif
+
+
+/* 11/02/1997 : Ajout DRE pour CPSCAS */
+#ifndef VOID
+#define VOID void
+#endif
+#ifndef PSTR
+#define PSTR char PTR
+#endif
+/* 11/02/1997 : Fin */
+
+#ifndef WORD
+#define WORD unsigned short
+#endif
+
+#ifndef DWORD
+#define DWORD unsigned long
+#endif
+//typedef unsigned char BYTE;
+#ifndef BYTE
+#define BYTE unsigned char
+#endif
+//typedef BYTE far * LPBYTE;
+#ifndef LPBYTE
+#define LPBYTE BYTE far *
+#endif
+//typedef int BOOL;
+#ifndef BOOL
+#define BOOL int
+#endif
+
+#ifndef Unref
+#define Unref( a) a=a
+#endif
+
+#ifndef min
+#define min(a,b) ((a)>(b)?(b):(a))
+#endif
+
+#ifndef max
+#define max(a,b) ((a)<(b)?(b):(a))
+#endif
+
+/* Taille maximale allou<6F>e par la fonction "malloc" */
+#ifndef MAXBLOC
+#define MAXBLOC     4294967295
+#endif
+
+#endif

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SYS_DEF/linux/mc_sys_def.h

@@ -0,0 +1,85 @@
+/*
+ * -------------------------------------------------------------------
+ * (c) 2002 GIE SESAM-VITALE
+ *
+ * FICHIER : sys_def.h (v2)
+ *
+ * PLATE-FORME : Windows 32 bits
+ *
+ * D<>finitions d<>pendantes du syst<73>me.
+ * -------------------------------------------------------------------
+ */
+
+#include "linuxdef.h" 
+#include "stdlib.h" 
+
+#ifndef __SYS_DEF_H__
+#define __SYS_DEF_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+#ifndef API_ENTRY
+#define API_ENTRY
+#endif
+
+#ifndef _MAX_PATH
+#define _MAX_PATH 256 
+#endif
+
+#ifndef _MAX_FNAME
+#define _MAX_FNAME 160
+#endif
+
+#ifndef _MAX_DIR
+#define _MAX_DIR 800
+#endif
+
+#ifndef FARPTR
+#define FARPTR *
+#endif
+
+#ifndef SYS_MAX_PATH
+#define SYS_MAX_PATH				_MAX_PATH
+#endif
+
+#ifndef SYS_MAX_FNAME
+#define SYS_MAX_FNAME               _MAX_FNAME
+#endif
+
+#ifndef SYS_MAX_DIR
+#define SYS_MAX_DIR               _MAX_DIR
+#endif
+
+#ifndef SYS_HANDLE 
+#define SYS_HANDLE void *        
+#endif
+
+#ifndef PTR
+#define PTR *
+#endif
+
+#ifndef SYSFARPROC_
+#define SYSFARPROC_
+typedef unsigned short (API_ENTRY FARPTR SYSFARPROC)();
+#endif
+
+
+/* S<>parateur utilis<69> dans le nommage des arborescences de fichiers */
+#ifndef SEPARATEUR_REPERTOIRE
+#define SEPARATEUR_REPERTOIRE '/'
+#endif
+
+
+/* Activation des fonctions simplifi<66>es. */
+#ifndef SGD
+#define SGD
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SYS_DEF/macosx/mc_sys_def.h

@@ -0,0 +1,92 @@
+/*
+ * -------------------------------------------------------------------
+ * (c) 2002 GIE SESAM-VITALE
+ *
+ * FICHIER : sys_def.h (v2)
+ *
+ * PLATE-FORME : MAC OSX
+ *
+ * D<>finitions d<>pendantes du syst<73>me.
+ * -------------------------------------------------------------------
+ */
+
+//3/11/2004 Modification pour compilation MAC OS X
+#include "osxdef.h"
+
+#include <stdarg.h>
+#include <errno.h>
+#include "stdlib.h" 
+
+#ifndef __SYS_DEF_H__
+#define __SYS_DEF_H__
+
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+//3-11-2004 Ajout pour MAc OS X
+#define FALSE 0
+#define TRUE 1
+
+//3/11/2004 Modification pour compilation MAC OS X
+#ifndef API_ENTRY
+#define API_ENTRY
+#endif
+
+#ifndef FARPTR
+#define FARPTR *
+#endif
+
+#ifndef SYS_MAX_PATH
+#define SYS_MAX_PATH				_MAX_PATH
+#endif
+
+#ifndef SYS_MAX_FNAME
+#define SYS_MAX_FNAME               _MAX_FNAME
+#endif
+
+#ifndef SYS_MAX_DIR
+#define SYS_MAX_DIR               _MAX_DIR
+#endif
+
+
+
+#ifndef PTR
+#define PTR *
+#endif
+
+
+#ifndef SYS_HANDLE
+//typedef void * SYS_HANDLE;
+#define SYS_HANDLE void *
+#endif
+
+#ifndef SYSFARPROC_
+#define SYSFARPROC_
+typedef unsigned short (API_ENTRY FARPTR SYSFARPROC)();
+#endif
+
+
+
+/* S<>parateur utilis<69> dans le nommage des arborescences de fichiers */
+#ifndef SEPARATEUR_REPERTOIRE
+	#ifdef WIN32
+		#define SEPARATEUR_REPERTOIRE '\\'
+	#else
+		#define SEPARATEUR_REPERTOIRE '/'
+	#endif
+#endif
+
+
+/* Activation des fonctions simplifi<66>es. */
+#ifndef SGD
+#define SGD
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SYS_DEF/macosx/osxdef.h

@@ -0,0 +1,150 @@
+/*---------------------------------------------------------------------------
+ PROJET     : Couche de portabilite multi-systeme
+ 
+ PLATE-FORME: MAC OS X
+ 
+ MODULE     : Definition des macros et des types utilises par la couche 
+              d'abstraction systeme pour la plate-forme LINUX.
+              
+              Le fichier de definition des types portable (ce fichier) doit 
+              etre inclus avant tout autre .h de definitions d'APIS gip-cps. 
+              Ce fichier definit tous les types et macros dependants du 
+              systeme. 
+
+ FICHIER    : common\linux\src\linuxdef.h
+
+ VERSION    : 1.00
+ 
+ DATE       : 10/01/2001
+ 
+ AUTEUR     : ALVARO ROCHA
+ 
+-----------------------------------------------------------------------------
+-----------------------------------------------------------------------------
+ Modifications:  (nouvelle version, date, auteur, explication)
+ ...
+
+ - V4.31 - AROC le 12/02/2001 :
+      Ajout des #define TRUE et FALSE ainsi que le typedef int BOOLEEN
+-----------------------------------------------------------------------------
+---------------------------------------------------------------------------*/
+
+
+#ifndef __CPSCASDF_H
+#define __CPSCASDF_H
+
+//#ifndef __MACTYPES__
+/*#include <CarbonCore/MacTypes.h>*/
+//#include"/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/CarbonCore.framework/Versions/A/Headers/MacTypes.h"*/
+//#endif
+
+
+
+/*----------------- definition des macros portables ------------------------*/
+
+
+/* point d'entree exporte en DLL ?????????????????????????????????????????  */
+#define API_ENTRY /* pour l'instant */
+
+#define far
+#define FAR
+
+#define PTR *
+
+#define PVOID void PTR
+
+#ifndef FARPTR
+#define FARPTR PTR
+#endif
+#define FPVOID void FARPTR
+
+/* AROC 18/O4/2001 ajout pour io_comm*/
+#define HCOMM	unsigned int
+#define PHCOMM	HCOMM FARPTR
+
+/* AROC 12/02/2001 debut : */
+#ifndef FALSE
+#define FALSE 0
+#endif
+
+#ifndef TRUE
+#define TRUE 1
+#endif
+/* AROC 12/02/2001 fin */
+
+/*----------------- definition des types portables ------------------------*/
+
+/* AROC 12/02/2001 debut : */
+/* mise en commentaire de ce define car pb avec module sts où BOOLEEN est defini en char*/
+//#ifndef BOOLEEN
+//typedef int BOOLEEN;
+//#define BOOLEEN int
+//#endif
+/* AROC 12/02/2001 fin */
+/* Boolean */
+#define BOOL Boolean
+
+//#define _MAX_PATH 1024
+typedef char CHAR;
+typedef CHAR PTR PCHAR;
+
+typedef CHAR PTR PSTRG; 
+
+typedef unsigned char UCHAR;
+typedef UCHAR PTR PUCHAR;
+
+typedef char INT8;
+typedef short INT16;
+typedef long INT32;
+
+typedef INT8 PTR PINT8;
+typedef INT16 PTR PINT16;
+typedef INT32 PTR PINT32;
+
+typedef unsigned char UINT8;
+typedef unsigned short UINT16;
+typedef unsigned long UINT32;
+
+typedef UINT8 PTR PUINT8;
+typedef UINT16 PTR PUINT16;
+typedef UINT32 PTR PUINT32;
+
+/* 11/02/1997 : Ajout DRE pour CPSCAS */
+typedef void VOID;
+typedef char PTR PSTR;
+/* 11/02/1997 : Fin */
+
+typedef unsigned short WORD;
+typedef unsigned long DWORD;
+typedef unsigned char BYTE;
+typedef BYTE far * LPBYTE;
+
+#define Unref( a) a=a
+
+#ifndef min
+#define min(a,b) ((a)>(b)?(b):(a))
+#endif
+
+#ifndef max
+#define max(a,b) ((a)<(b)?(b):(a))
+#endif
+
+#ifdef LITTLE_ENDIAN
+#undef LITTLE_ENDIAN
+#endif
+
+#ifndef PATH_MAX
+#define PATH_MAX		 1024
+#endif
+#ifndef _MAX_PATH
+#define _MAX_PATH PATH_MAX /*  PATH_MAX defini dans <usr/include/sys/syslimits.h> */
+#endif
+
+
+
+/* Taille maximale allouÈe par la fonction "malloc" */
+#ifndef MAXBLOC
+#define MAXBLOC    0x7FFFFFFF
+#endif
+
+#endif

crates/fsv-sys/vendor/fsv/1.40.14.13/includes/SYS_DEF/win/mc_sys_def.h

@@ -0,0 +1,69 @@
+/*
+ * -------------------------------------------------------------------
+ * (c) 2002 GIE SESAM-VITALE
+ *
+ * FICHIER : sys_def.h (v2)
+ *
+ * PLATE-FORME : Windows 32 bits
+ *
+ * D<>finitions d<>pendantes du syst<73>me.
+ * -------------------------------------------------------------------
+ */
+
+#include <stdlib.h>
+
+#ifndef __SYS_DEF_H__
+#define __SYS_DEF_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+#ifndef API_ENTRY
+#define API_ENTRY __stdcall
+#endif
+
+#ifndef FARPTR
+#define FARPTR *
+#endif
+
+#ifndef SYS_MAX_PATH
+#define SYS_MAX_PATH				_MAX_PATH
+#endif
+
+#ifndef SYS_MAX_FNAME
+#define SYS_MAX_FNAME               _MAX_FNAME
+#endif
+
+#ifndef SYS_MAX_DIR
+#define SYS_MAX_DIR               _MAX_DIR
+#endif
+
+typedef void *        SYS_HANDLE;
+
+#ifndef PTR
+#define PTR *
+#endif
+
+
+typedef unsigned short (API_ENTRY FARPTR SYSFARPROC)();
+
+
+
+/* S<>parateur utilis<69> dans le nommage des arborescences de fichiers */
+#ifndef SEPARATEUR_REPERTOIRE
+#define SEPARATEUR_REPERTOIRE '\\'
+#endif
+
+
+/* Activation des fonctions simplifi<66>es. */
+#ifndef SGD
+#define SGD
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

crates/fsv/Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "fsv"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+anyhow = "1.0.89"
+libc = "0.2.159"
+num_enum = { version = "0.7.3", features = ["complex-expressions"] }
+deku = { version = "0.18.1", features = ["logging"] }
+
+thiserror.workspace = true
+serde.workspace = true
+
+fsv-sys = { path = "../fsv-sys" }
+utils = { path = "../utils" }
+
+#[dev-dependencies]
+log = "0.4.22"
+env_logger = "0.11.5"

crates/fsv/src/fsv_parsing/blocks.rs

@@ -0,0 +1,223 @@
+use deku::deku_derive;
+
+use super::{ groups, size_read };
+
+#[derive(Debug, PartialEq)]
+#[deku_derive(DekuRead)]
+/// # Data: FSV data structure
+/// This structure is the core structure to read FSV raw data
+/// It handles directly the raw data returned by the FSV library
+/// A `Data` structure is composed of multiple `DataBlock` structures
+pub struct Data {
+    #[deku(read_all)]
+    pub blocks: Vec<DataBlock>,
+}
+
+#[derive(Debug, PartialEq)]
+#[deku_derive(DekuRead)]
+/// # Data block structure
+/// The `DataBlock` are the main structures inside a `Data` struct
+pub struct DataBlock {
+    pub header: BlockHeader,
+    #[deku(ctx = "header.group_id.0")]
+    pub content: DataGroup,
+}
+
+#[derive(Debug, PartialEq)]
+#[deku_derive(DekuRead)]
+/// # Block header structure
+/// The `BlockHeader` structure is the header of a `DataBlock`
+/// It contains the group ID and the size of the `DataBlock` contained data (`inner` field)
+pub struct BlockHeader {
+
+    pub group_id: GroupId,
+    #[deku(reader = "size_read(deku::reader)")]
+    pub data_size: u64, // This field is not really used, but we have to parse it to move the reader cursor
+}
+
+#[derive(Debug, PartialEq)]
+#[deku_derive(DekuRead)]
+/// # Group ID
+/// Allow to identify the type of data contained in a `DataBlock`
+/// It is use as matching ID in the `DataGroup` enum. All the 
+/// IDs are documented on the SSV documentation, pages 23-28
+pub struct GroupId(
+    #[deku(endian="big", bytes= 2)]
+    pub u16,
+);
+
+/// # Data group enum
+/// This enum is used to match a `DataBlock` content with the
+/// correct data structure, able to parse the data contained in
+#[derive(Debug, PartialEq)]
+#[deku_derive(DekuRead)]
+#[deku(ctx = "group_id: u16", id = "group_id")]
+#[allow(non_camel_case_types)]
+pub enum DataGroup {
+    #[deku(id = 60)]
+    LireConfig_Group60_ConfigHeader(groups::ssv_lire_config::group_60_header_config::ConfigHeader),
+    #[deku(id = 61)]
+    LireConfig_Group61_ReaderConfig(groups::ssv_lire_config::group_61_reader_config::ReaderConfig),
+    #[deku(id = 64)]
+    LireConfig_Group64_SVComponentsConfig(groups::ssv_lire_config::group_64_sv_config::SVComponentsConfig),
+    #[deku(id = 67)]
+    LireConfig_Group67_PCSCReaderConfig(groups::ssv_lire_config::group_67_pcsc_config::PCSCReaderConfig),
+}
+
+#[cfg(test)]
+mod tests {
+    use deku::DekuContainerRead as _;
+
+    use super::*;
+
+    mod deku_testing {
+        use super::*;
+
+        #[derive(Debug, PartialEq)]
+        #[deku_derive(DekuRead)]
+        #[deku(endian = "big")]
+        pub struct DekuTest {
+            #[deku(bits = 4)]
+            pub a: u8,
+            #[deku(bits = 4)]
+            pub b: u8,
+            pub c: u16,
+        }
+
+        #[derive(Debug, PartialEq)]
+        #[deku_derive(DekuRead)]
+        #[deku(endian = "big")]
+        pub struct DekuTestWithSizeReader {
+            #[deku(bytes = 2)]
+            pub id: u16,
+            #[deku(reader = "size_read(deku::reader)")]
+            pub size: u64,
+        }
+
+        #[derive(Debug, PartialEq)]
+        #[deku_derive(DekuRead)]
+        pub struct DekuTestWithGroupId {
+            pub group_id: GroupId,
+        }
+    }
+
+    #[test]
+    fn test_deserialize_deku_test() {
+        let buffer: &[u8] = &[0b0110_1001, 0xBE, 0xEF];
+        let offset: usize = 0;
+        let ((rest, offset), val) = deku_testing::DekuTest::from_bytes((buffer, offset)).unwrap();
+        
+        assert_eq!(val.a, 0b0110);
+        assert_eq!(val.b, 0b1001);
+        assert_eq!(val.c, 0xBEEF);
+
+        assert_eq!(offset, 0);
+        assert_eq!(rest, &[]);
+    }
+
+    #[test]
+     fn test_deserialize_deku_test_with_offset() {
+        let buffer: &[u8] = &[0b0000_1111, 0b0110_1001, 0xBE, 0xEF];
+        let offset: usize = 8;
+        let ((rest, offset), val) = deku_testing::DekuTest::from_bytes((buffer, offset)).unwrap();
+
+        assert_eq!(val.a, 0b0110);
+        assert_eq!(val.b, 0b1001);
+        assert_eq!(val.c, 0xBEEF);
+
+        assert_eq!(offset, 0);
+        assert_eq!(rest, &[]);
+    }
+
+    #[test]
+    fn test_serialize_deku_test_with_rest() {
+        let buffer: &[u8] = &[0b0110_1001, 0xBE, 0xEF, 0x1F, 0x2F];
+        let offset: usize = 0;
+        let ((rest, offset), val) = deku_testing::DekuTest::from_bytes((buffer, offset)).unwrap();
+
+        assert_eq!(val.a, 0b0110);
+        assert_eq!(val.b, 0b1001);
+        assert_eq!(val.c, 0xBEEF);
+
+        assert_eq!(offset, 0);
+        assert_eq!(rest, &[0x1F, 0x2F]);
+    }
+
+    #[test]
+    fn test_size_read() {
+        let buffer: &[u8] = &[
+            0, 60, // ID (60)
+            0b0100_0000, // Size type bit (0) + Size (64)
+            3, 4, 5, 6, 7, 8, 9, 10, 11, 12 // Extra data (10 bytes ; should be 64)
+        ];
+        let ((rest, _offset), val) = deku_testing::DekuTestWithSizeReader::from_bytes((buffer, 0)).unwrap();
+        assert_eq!(val.id, 60, "EX1: ID");
+        assert_eq!(val.size, 64, "EX1: Size");
+        assert_eq!(rest.len(), 10, "EX1: Rest");
+
+        let buffer: &[u8] = &[
+            0, 60, // ID (60)
+            0b1000_0010, // Size type bit (1) + Size block length (2)
+            0b0000_0001, 0b0100_0000, // Size (320)
+            3, 4, 5, 6, 7, 8, 9, 10, 11, 12 // Extra data (10 bytes ; should be 320)
+        ];
+        let ((rest, _offset), val) = deku_testing::DekuTestWithSizeReader::from_bytes((buffer, 0)).unwrap();
+        assert_eq!(val.id, 60, "EX2: ID");
+        assert_eq!(val.size, 320, "EX2: Size");
+        println!("{:?}", rest);
+        // assert_eq!(val.size, 320, "EX2: Size");
+    }
+
+    #[test]
+    fn test_endianness() {
+        #[derive(Debug, PartialEq)]
+        #[deku_derive(DekuRead)]
+        struct DekuTest {
+            #[deku(endian = "big")]
+            field_be: u16,
+            #[deku(endian = "little")]
+            field_le: u16,
+            field_default: u16,
+        }
+    
+        let buffer: &[u8] = &[
+            0xAB, 0xCD,
+            0xAB, 0xCD,
+            0xAB, 0xCD,
+        ];
+        let (_rest, result) = DekuTest::from_bytes((buffer, 0)).unwrap();
+        assert_eq!(result.field_be, 0xABCD, "0xAB,0xCD - Big Endian");
+        assert_eq!(result.field_le, 0xCDAB, "0xAB,0xCD - Little Endian");
+        assert_eq!(deku::ctx::Endian::default(), deku::ctx::Endian::Little, "Default Endian");
+        assert_eq!(result.field_default, 0xCDAB, "0xAB,0xCD - Default Endian");
+
+        let buffer: &[u8] = &[
+            0, 64,
+            0, 64,
+            0, 64,
+        ];
+        let (_rest, result) = DekuTest::from_bytes((buffer, 0)).unwrap();
+        assert_eq!(result.field_be, 64, "0,64 - Big Endian");
+        assert_eq!(result.field_le, 16384, "0,64 - Little Endian");
+        assert_eq!(deku::ctx::Endian::default(), deku::ctx::Endian::Little);
+        assert_eq!(result.field_default, 16384, "0,64 - Default Endian");
+        
+    }
+
+    #[test]
+    fn test_group_id() {
+        // env_logger::init(); // Uncomment and run with RUST_LOG=trace for deku debugging
+        let buffer: &[u8] = &[
+            0, 60, // ID (60)
+        ];
+        let (_rest, val) = deku_testing::DekuTestWithGroupId::from_bytes((buffer, 0)).unwrap();
+        assert_eq!(val.group_id.0, 60, "EX1: ID");
+
+        let buffer: &[u8] = &[
+            7, 118, // ID (1910)
+        ];
+        let (_rest, val) = deku_testing::DekuTestWithGroupId::from_bytes((buffer, 0)).unwrap();
+        assert_eq!(val.group_id.0, 1910, "EX2: ID");
+    }
+
+}

crates/fsv/src/fsv_parsing/groups/mod.rs

@@ -0,0 +1,102 @@
+use std::{fmt, str::FromStr};
+
+use deku::{deku_derive, DekuError};
+
+use super::{ size_read, map_bytes_to_lossy_string };
+
+pub mod ssv_lire_config;
+
+/// # Convert a DataField to a specific type
+/// Using this as deku map function to fill a field value from
+/// a DataField
+fn map_from_data_field<T>(data_field: DataField) -> Result<T, DekuError>
+where
+    T: FromStr,
+    T::Err: std::fmt::Display,
+{
+    let text = String::from_utf8(data_field.data)
+        .map_err(|e| DekuError::Parse(e.to_string().into()))?;
+    T::from_str(&text)
+        .map_err(|e| DekuError::Parse(e.to_string().into()))
+}
+
+// ------------------- DATA FIELD TYPES -------------------
+
+/// # Data field structure
+/// This structure is the core structure to read data fields
+/// It is usually used by other structures implementing the
+/// `#[deku(map = "map_from_data_field")]` attribute
+#[deku_derive(DekuRead)]
+#[derive(Debug, PartialEq)]
+struct DataField {
+    #[deku(temp, reader = "size_read(deku::reader)")]
+    pub data_size: u64,
+    #[deku(bytes_read = "data_size")]
+    pub data: Vec<u8>,
+}
+
+#[deku_derive(DekuRead)]
+#[derive(Debug, Clone, PartialEq)]
+/// # Numeric string
+/// TODO: check if all the characters are numeric
+pub struct NumericString(
+    #[deku(map = "map_from_data_field")]
+    String
+);
+
+#[deku_derive(DekuRead)]
+#[derive(Debug, Clone, PartialEq)]
+pub struct AlphaNumericString(
+    #[deku(map = "map_from_data_field")]
+    String
+);
+impl From<&str> for AlphaNumericString {
+    fn from(s: &str) -> Self {
+        AlphaNumericString(s.to_string())
+    }
+}
+
+#[deku_derive(DekuRead)]
+#[derive(Debug, Clone, PartialEq)]
+#[deku(endian = "big")]
+/// # Software version
+/// An almost standard software version structure in FSV
+/// It is composed of a version and a revision, encoded on 2 bytes each
+pub struct SoftwareVersion {
+    #[deku(temp, reader = "size_read(deku::reader)", assert_eq = "4")]
+    data_size: u64,
+    #[deku(bytes= 2, map = "|x: [u8; 2]| map_bytes_to_lossy_string(&x)")]
+    pub version: String,
+    #[deku(bytes= 2, map = "|x: [u8; 2]| map_bytes_to_lossy_string(&x)")]
+    pub revision: String,
+}
+impl fmt::Display for SoftwareVersion {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        write!(f, "{}.{}", self.version, self.revision)
+    }
+}
+
+#[cfg(test)]
+mod test {
+    use deku::DekuContainerRead as _;
+
+    use super::*;
+
+    #[test]
+    fn test() {
+        let version_bytes: [u8; 2] = [48, 55];
+        let version = map_bytes_to_lossy_string(&version_bytes).unwrap();
+        assert_eq!(version, "07");
+    }
+
+    #[test]
+    fn test_software_version() {
+        // env_logger::init(); // Uncomment and run with RUST_LOG=trace for deku debugging
+        let data: [u8; 5] = [4, 48, 55, 50, 48];
+
+        let (_rest, software_version) = SoftwareVersion::from_bytes((&data, 0)).unwrap();
+        // assert_eq!(software_version.data_size, 4);
+        assert_eq!(software_version.version, "07");
+        assert_eq!(software_version.revision, "20");
+    }
+}

crates/fsv/src/fsv_parsing/groups/ssv_lire_config.rs

@@ -0,0 +1,295 @@
+//! # Structures de parsing des données de la fonction SSV_LireConfig
+
+//! Le groupe `ReaderConfig61` décrit ci-dessous est renseigné en cas d’utilisation d’un
+//! lecteur homologué sesam-vitale uniquement et non en cas
+//! d’utilisation de lecteur(s) PC/SC. dans le cas d’un TL ou TLA
+//! configuré en mode PC/SC, un groupe `ReaderConfig61` est restitué pour chaque
+//! lecteur exposé par le gestionnaire de ressources PC/SC. les
+//! informations sont alors dupliquées dans chacun des groupes `ReaderConfig61`.
+//! les informations sur les lecteurs PC/SC sont disponibles
+//! dans les groupes `PCSCReaderConfig67`.
+
+use deku::deku_derive;
+
+use super::{AlphaNumericString, NumericString, SoftwareVersion};
+
+/// # En-tête de configuration
+/// 1 occurence
+pub mod group_60_header_config {
+    use super::*;
+
+    /// Groupe 60 - En-tête de configuration
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct ConfigHeader {
+        pub ssv_version: SSVVersionNumber,
+        pub galss_version: GALSSVersionNumber,
+        pub pss_version: PSSVersionNumber,
+    }
+    
+    // Fields
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct SSVVersionNumber(pub SoftwareVersion);
+
+
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct GALSSVersionNumber(pub SoftwareVersion);
+
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct PSSVersionNumber(pub SoftwareVersion);
+}
+
+/// # Configuration du lecteur
+/// 0 à 15 occurences
+pub mod group_61_reader_config {
+    use super::*;
+
+    /// Groupe 61 - Configuration du lecteur
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct ReaderConfig {
+        pub manufacturer_name: AlphaNumericString, // 15 CA
+        pub reader_type: AlphaNumericString, // 30 CA
+        pub serial_number: AlphaNumericString, // 20 CA
+        pub os: NumericString, // 2 CN
+        pub software_count: NumericString, // 2 CN
+        pub software_name: AlphaNumericString, // 30 CA
+        pub software_version: ReaderSoftwareVersion, // 4 CA
+        pub reader_datetime: ReaderSoftwareDate, // 12 CN
+        pub software_checksum: AlphaNumericString, // 4 CA
+    }
+
+    // Fields
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct ReaderSoftwareVersion(pub SoftwareVersion);
+
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    /// Format « AAAAMMJJhhmm »
+    /// TODO: Build a generic date-time structure
+    /// TODO: Implement a date parsing, like chrono crate
+    pub struct ReaderSoftwareDate(pub AlphaNumericString);
+}
+
+/// # Configuration SESAM-Vitale
+/// N occurences
+pub mod group_64_sv_config {
+    use super::*;
+
+    /// Groupe 64 - Configuration SESAM-Vitale
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct SVComponentsConfig {
+        pub id: ComponentID,
+        pub description: ComponentDescription,
+        pub version: ComponentVersion,
+    }
+
+    // Fields
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct ComponentID(pub NumericString);
+
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct ComponentDescription(pub AlphaNumericString);
+
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct ComponentVersion(pub AlphaNumericString);
+}
+
+/// # Configuration du lecteur PC/SC
+/// N occurences
+pub mod group_67_pcsc_config {
+    use super::*;
+
+    /// Groupe 67 - Configuration du lecteur PC/SC
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct PCSCReaderConfig {
+        pub name: ReaderName,
+        pub card_type: CardType,
+    }
+
+    // Fields
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct ReaderName(pub AlphaNumericString);
+
+    #[deku_derive(DekuRead)]
+    #[derive(Debug, PartialEq)]
+    pub struct CardType(pub NumericString);
+}
+
+#[cfg(test)]
+mod tests {
+    use deku::DekuContainerRead as _;
+
+    use crate::fsv_parsing::blocks::{BlockHeader, Data, DataBlock, DataGroup};
+
+    mod data {
+        pub const BUFFER: &[u8] = &[
+            0, 60, // Block ID
+                15, // Block Size
+                    4, // SSV Version
+                        48, 55, 50, 48, // 0720
+                    4, // GALSS Version
+                        48, 48, 48, 48, // 0000
+                    4, // PSS Version
+                        48, 48, 48, 48, // 0000
+            0, 67, // Block ID
+                42, // Block Size
+                    39, // PCSC Reader Name
+                        71, 101, 109, 97, 108, 116, 111, 32, 80, 67,
+                        32, 84, 119, 105, 110, 32, 82, 101, 97, 100,
+                        101, 114, 32, 40, 54, 52, 53, 68, 57, 52, 
+                        67, 51, 41, 32, 48, 48, 32, 48, 48,
+                    1, // Card type
+                        50,
+            0, 64, // Block ID
+                44, // Block Size
+                    2, // Component ID
+                        49, 49,
+                    35, // Component label
+                        86, 69, 82, 83, 73, 79, 78, 32, 68, 69,
+                        32, 76, 65, 32, 66, 73, 66, 76, 73, 79,
+                        84, 72, 69, 81, 85, 69, 32, 68, 85, 32,
+                        71, 65, 76, 83, 83,
+                    4, // Component version
+                        48, 48, 48, 48,
+            0, 64, // Block ID
+                69, // Block Size
+                    3, // Component ID
+                        49, 53, 49,
+                    27, // Component label
+                        73, 68, 69, 78, 84, 73, 70, 73, 65, 78,
+                        84, 32, 85, 78, 73, 81, 85, 69, 32, 68,
+                        85, 32, 80, 79, 83, 84, 69,
+                    36, // Component version
+                        50, 54, 57, 102, 99, 55, 101, 98, 45, 49,
+                        100, 56, 53, 45, 52, 55, 57, 51, 45, 98,
+                        55, 48, 101, 45, 51, 55, 49, 99, 51, 56,
+                        102, 57, 49, 54, 51, 52,
+            0, 61, // Block ID
+                62, // Block Size
+                    17, // Manufacturer Name
+                        84, 69, 83, 84, 32, 77, 65, 78, 85, 70,
+                        65, 67, 84, 85, 82, 69, 82,
+                    4, // Reader Type
+                        84, 69, 83, 84,
+                    4, // Serial Number
+                        84, 69, 83, 84,
+                    2, // OS
+                        79, 83,
+                    2, // Software Count
+                        48, 49,
+                    4, // Software Name
+                        84, 69, 83, 84,
+                    4, // Software Version
+                        48, 49, 53, 53,
+                    12, // Reader Datetime
+                        50, 48, 50, 52, // 2024
+                        48, 54, 50, 53, // 06-25
+                        49, 50, 52, 53, // 12:45
+                    4, // Software Checksum
+                        49, 50, 51, 52,
+        ];
+    }
+
+    #[test]
+    fn test_lire_config_first_header() {
+        // env_logger::init(); // Uncomment and run with RUST_LOG=trace for deku debugging
+        let buffer = data::BUFFER;
+        let offset: usize = 0;
+
+        let ((_rest, _offset), block_header) = BlockHeader::from_bytes((buffer, offset)).unwrap();
+        assert_eq!(block_header.group_id.0, 60, "Header ID");
+        // assert_eq!(block_header.data_size, 15, "Header Size");
+    }
+
+    #[test]
+    fn test_lire_config_first_block() {
+        // env_logger::init(); // Uncomment and run with RUST_LOG=trace for deku debugging
+        let buffer = data::BUFFER;
+        let offset: usize = 0;
+
+        let ((_rest, _offset), block) = DataBlock::from_bytes((buffer, offset)).unwrap();
+        let header = block.header;
+        let content = match block.content {
+            DataGroup::LireConfig_Group60_ConfigHeader(content) => content,
+            _ => panic!("Unexpected data block type"),
+        };
+        assert_eq!(header.group_id.0, 60, "Header ID");
+        assert_eq!(header.data_size, 15, "Header Size");
+        assert_eq!(content.ssv_version.0.version, "07", "SSV Version");
+        assert_eq!(content.ssv_version.0.revision, "20", "SSV Revision");
+        assert_eq!(content.galss_version.0.to_string(), "00.00", "GALSS Version");
+        assert_eq!(content.pss_version.0.to_string(), "00.00", "PSS Version");        
+    }
+
+    #[test]
+    fn test_lire_config_all() {
+        // env_logger::init(); // Uncomment and run with RUST_LOG=trace for deku debugging
+        let buffer = data::BUFFER;
+        let offset: usize = 0;
+
+        let ((_rest, _offset), data) = Data::from_bytes((buffer, offset)).unwrap();
+        let blocks = data.blocks;
+        assert_eq!(blocks.len(), 5, "Number of blocks");
+        for block in blocks {
+            match block.content {
+                DataGroup::LireConfig_Group60_ConfigHeader(content) => {
+                    assert_eq!(block.header.group_id.0, 60, "Header ID");
+                    assert_eq!(block.header.data_size, 15, "Header Size");
+                    assert_eq!(content.ssv_version.0.version, "07", "SSV Version");
+                    assert_eq!(content.ssv_version.0.revision, "20", "SSV Revision");
+                    assert_eq!(content.galss_version.0.to_string(), "00.00", "GALSS Version");
+                    assert_eq!(content.pss_version.0.to_string(), "00.00", "PSS Version");
+                },
+                DataGroup::LireConfig_Group61_ReaderConfig(content) => {
+                    assert_eq!(block.header.group_id.0, 61, "Header ID");
+                    assert_eq!(block.header.data_size, 62, "Header Size");
+                    assert_eq!(content.manufacturer_name.0, "TEST MANUFACTURER", "Manufacturer Name");
+                    assert_eq!(content.reader_type.0, "TEST", "Reader Type");
+                    assert_eq!(content.serial_number.0, "TEST", "Serial Number");
+                    assert_eq!(content.os.0, "OS", "OS");
+                    assert_eq!(content.software_count.0, "01", "Software Count");
+                    assert_eq!(content.software_name.0, "TEST", "Software Name");
+                    assert_eq!(content.software_version.0.version, "01", "Software Version");
+                    assert_eq!(content.software_version.0.revision, "55", "Software Revision");
+                    assert_eq!(content.reader_datetime.0.0, "202406251245", "Reader Datetime");
+                    assert_eq!(content.software_checksum.0, "1234", "Software Checksum");
+                },
+                DataGroup::LireConfig_Group64_SVComponentsConfig(content) => {
+                    assert_eq!(block.header.group_id.0, 64, "Header ID");
+                    match content.id.0.0.as_str() {
+                        "11" => {
+                            assert_eq!(block.header.data_size, 44, "Header Size");
+                            assert_eq!(content.id.0.0, "11", "G64 - 11 : Component ID");
+                            assert_eq!(content.description.0.0, "VERSION DE LA BIBLIOTHEQUE DU GALSS", "G64 - 11 : Component Description");
+                            assert_eq!(content.version.0.0, "0000", "G64 - 11 : Component Version");
+                        },
+                        "151" => {
+                            assert_eq!(block.header.data_size, 69, "Header Size");
+                            assert_eq!(content.id.0.0, "151", "G64 - 151 : Component ID");
+                            assert_eq!(content.description.0.0, "IDENTIFIANT UNIQUE DU POSTE", "G64 - 151 : Component Description");
+                            assert_eq!(content.version.0.0, "269fc7eb-1d85-4793-b70e-371c38f91634", "G64 - 151 : Component Version");
+                        },
+                        _ => panic!("Unexpected Component ID"),
+                    }
+                },
+                DataGroup::LireConfig_Group67_PCSCReaderConfig(content) => {
+                    assert_eq!(block.header.group_id.0, 67, "Header ID");
+                    assert_eq!(block.header.data_size, 42, "Header Size");
+                    assert_eq!(content.name.0.0, "Gemalto PC Twin Reader (645D94C3) 00 00", "Reader Name");
+                    assert_eq!(content.card_type.0.0, "2", "Card Type");
+                },
+            }
+        }
+    }
+}

crates/fsv/src/fsv_parsing/mod.rs

@@ -0,0 +1,45 @@
+use deku::ctx::BitSize;
+use deku::prelude::*;
+use deku::reader::ReaderRet;
+use deku::{reader::Reader, DekuError};
+
+pub mod blocks;
+pub mod groups;
+pub mod prelude;
+
+pub use blocks::Data;
+
+/// # Read the size of a FSV block / field
+/// Documentation: SSV Documentation, page 29
+fn size_read<R: std::io::Read + std::io::Seek>(reader: &mut Reader<R>) -> Result<u64, DekuError> {
+    let size_bytes = u8::from_reader_with_ctx(reader, BitSize(8))?;
+    let size: u64 = if size_bytes & 0b1000_0000 == 0 {
+        // If the Most Significant Bit is 0, the size is encoded on 7 bits
+        size_bytes.into()
+    } else {
+        // Else, the 7 following bits indicate the number of bytes of the block containing the size
+        let size_block_len: usize = (size_bytes & 0b0111_1111).into();
+        if size_block_len > 4 {
+            return Err(DekuError::Parse(format!("Unexpected size block length: {}", size_block_len).into()));
+        };
+        // The block containing the size is encoded on 1 to 4 bytes
+        let buffer: &mut [u8; 4] = &mut [0; 4];
+        let write_offset = 4 - size_block_len;
+        match reader.read_bytes(size_block_len, &mut buffer[write_offset..])? {
+            ReaderRet::Bits(_bit_vec) => return Err(DekuError::Parse("Unexpected result reading size bytes: got bits".into())),
+            ReaderRet::Bytes => u32::from_be_bytes(*buffer).into(),
+        }
+    };
+    Ok(size)
+}
+
+
+/// # Map bytes to a lossy string
+/// This function is used to map bytes to a string, ignoring invalid UTF-8 characters
+/// Example: [0x41, 0x42] -> "AB"
+/// Example: [48, 49, 50, 51] -> "0123"
+fn map_bytes_to_lossy_string(data: &[u8]) -> Result<String, DekuError> {
+    // let data = data.to_vec();
+    let version: String = String::from_utf8_lossy(data).to_string();
+    Ok(version)
+}

crates/fsv/src/fsv_parsing/prelude.rs

@@ -0,0 +1,6 @@
+/*! Crate prelude
+
+[What is a prelude?](std::prelude)
+*/
+pub use deku::DekuContainerRead as _;
+pub use super::Data;

crates/fsv/src/lib.rs

@@ -0,0 +1,2 @@
+pub mod fsv_parsing;
+pub mod ssv;

crates/fsv/src/ssv/errors_ssv.rs

@@ -0,0 +1,183 @@
+use num_enum::FromPrimitive;
+use thiserror::Error;
+
+#[derive(Error, Debug, Eq, PartialEq, FromPrimitive)]
+#[repr(u16)]
+/// Liste des codes d'erreur retournés par la librairie C SSV
+/// Documentation: Manuel de programmation SSV - Annexe A (p. 215)
+pub enum SSVErrorCodes {
+    #[error("La Carte du Professionnel de Santé est absente du lecteur.")]
+    CPSMissing = 0xF001,
+    #[error("La Carte du Professionnel de Santé bloquée après trois codes porteur erronés.")]
+    CPSBlocked = 0xF002,
+    #[error("Le code porteur présenté est erroné.")]
+    CPSPinWrong = 0xF003,
+    #[error("Carte du Professionnel de Santé non valide ou inexploitable par le Logiciel Lecteur. Vérifier la présence d'un Domaine d'Assurance Maladie (DAM).")]
+    CPSInvalid = 0xF004,
+    #[error("La Carte du Professionnel de Santé est retirée du lecteur.")]
+    CPSRemoved = 0xF005,
+    /// - Sécurisation d'une série de lots en cours.
+    /// - Pour les fonctions TLA (sauf Identifier TLA) : Cette erreur survient lorsque le simulateur TLA est en mode 1.50.
+    /// - Lire Date Lecteur, Mettre à jour Date Lecteur, Lire Droits Vitale : Cette erreur peut survenir lorsque le Logiciel Lecteur ne connaît pas la fonction sollicitée, c'est-à-dire si la version du Logiciel Lecteur est antérieure à 2.00.
+    /// - Décharger Données Bénéficiaires : cette erreur peut survenir pour signaler que le format des données issues du lecteur est incompatible avec cette version de SSV.
+    #[error("F022: Erreur commune à plusieurs fonctions.")]
+    F022 = 0xF022,
+    #[error("Message du lecteur incohérent. Débrancher et rebrancher le lecteur.")]
+    PCSCInconsistentMessage = 0xF0FF,
+    #[error("Le nom de lecteur fourni ne correspond à aucun lecteur reconnu.")]
+    PCSCReaderNotFound = 0xF101,
+    #[error("La fonction InitLIB2 n'est pas encore appelée ou la fonction TermLIB a déjà été appelée.")]
+    FunctionInitLib2NotCalled = 0xF600,
+    #[error("La bibliothèque SSV n’est pas chargée en mémoire. Vérifier que la fonction InitLIB2 a bien été appelée.")]
+    LibraryNotLoaded = 0xF690, // Warning
+    #[error("Carte vitale en opposition.")]
+    VitaleOpposition = 0xF6A1,
+    #[error("Zone de mémoire non allouée en sortie.")]
+    MemoryNotAllocated = 0xF800,
+    #[error("Erreur d'allocation de la zone de mémoire en sortie.")]
+    MemoryAllocationError = 0xF801,
+    #[error("Un des paramètres obligatoires d'entrée est non alloué ou invalide.")]
+    InputParameterNotAllocatedOrInvalid = 0xF802,
+    #[error("Zone de mémoire spécifiée en entrée non valide. Vérifier que la zone allouée ne dépasse pas la taille maximale autorisée (MAXBLOC).")]
+    InputMemoryInvalid = 0xF803,
+    #[error("Le format de la zone de mémoire d'entrée ou le nombre de zones mémoire est incorrect.")]
+    InputMemoryFormatIncorrect = 0xF810,
+    #[error("Problème lors de l’initialisation du protocole. Erreur du Ressource Manager PC/SC. Vérifiez le lecteur.")]
+    PCSCProtocolInitError = 0xFF01,
+    #[error("Time-out au niveau protocolaire ou transmission déjà en cours avec le lecteur. Vérifiez le lecteur et l'insertion de la carte.")]
+    PCSCProtocolTimeout = 0xFF02,
+    #[error("Taille insuffisante allouée en entrée d’une fonction du Resource Manager.")]
+    PCSCProtocolInputMemoryTooSmall = 0xFF03,
+    #[error("Erreur de transmission du protocole. Vérifiez le lecteur et l'insertion de la carte.")]
+    PCSCProtocolTransmissionError = 0xFF04,
+    #[error("Lecteur absent ou indisponible.")]
+    PCSCReaderMissingOrUnavailable = 0xFF05,
+    #[error("Le nom du lecteur transmis est inconnu du Resource Manager PC/SC.")]
+    PCSCReaderUnknown = 0xFF06,
+    #[error("Erreur inconnue remontée par le Resource Manager PC/SC.")]
+    PCSCUnknownError = 0xFF07,
+    #[error("Erreur interne Resource Manager PC/SC.")]
+    PCSCInternalError = 0xFF08,
+    #[error("Ressource PC/SC déjà prise en exclusivité. Vérifiez qu'une autre application n'utilise pas le lecteur.")]
+    PCSCResourceAlreadyExclusive = 0xFF09,
+    #[error("Protocole incompatible avec la carte à puce. Vérifiez l'insertion de la carte et son état.")]
+    PCSCProtocolIncompatible = 0xFF0A,
+    #[error("Paramètre incorrect. Erreur interne à la librairie SSV.")]
+    PCSCIncorrectParameter = 0xFF0B,
+    #[error("Carte absente. Insérez une carte dans le lecteur.")]
+    PCSCCardMissing = 0xFF0C,
+    #[error("L'état de la carte a été modifié (RAZ ou mise hors tension). Vérifiez si la carte n'a pas été retirée ou si une autre application n'utilise pas la carte.")]
+    PCSCCardStateChanged = 0xFF0D,
+    #[error("Carte muette ou non supportée. Vérifiez l'insertion de la carte.")]
+    PCSCCardUnsupported = 0xFF0E,
+    #[error("Code porteur CPS non renseigné.")]
+    CPSPinMissing = 0xFF21,
+    #[error("Ressource PC/SC déjà prise en exclusivité. Vérifiez que le processus en cours n'utilise pas déjà le lecteur.")]
+    PCSCReaderAlreadyExclusiveForCurrentProcess = 0xFF24,
+    #[error("Plusieurs lecteurs ou cartes de même type identifiés lors de la détection automatique.")]
+    PCSCDuplicatedReadersOrCardsDetected = 0xFF29,
+    #[error("Problème de chargement de la librairie cryptographique ou erreur retournée par la librairie cryptographique.")]
+    CryptoLibraryError = 0xFF30,
+    #[error("Erreurs internes aux Services SESAM-Vitale. Vérifiez les traces.")]
+    #[num_enum(alternatives = [0xFFF1..=0xFFFF])]
+    SSVInternalError = 0xFFF0,
+    #[error("Le fichier `tablebin.smc` est inaccessible en lecture (inexistant ou pas de droits d'accès).")]
+    FileMissingTablebinMsc = 0xF610, // tablebin.smc
+    #[error("Le fichier `scripts.sms` est inaccessible en lecture (inexistant ou pas de droits d'accès).")]
+    FileMissingScriptsSms = 0xF611, // scripts.sms
+    #[error("Le fichier `tablebin.ssv` est inaccessible en lecture (inexistant ou pas de droits d'accès).")]
+    FileMissingTablebinSsv = 0xF612, // tablebin.ssv
+    #[error("Le fichier `script.ssv` est inaccessible en lecture (inexistant ou pas de droits d'accès).")]
+    FileMissingScriptSsv = 0xF613, // script.ssv
+    #[error("La version du fichier `tablebin.smc` est incompatible avec la bibliothèque des SSV.")]
+    FileVersionIncompatibleTablebinMsc = 0xF620, // tablebin.smc
+    #[error("La version du fichier `scripts.sms` est incompatible avec la bibliothèque des SSV.")]
+    FileVersionIncompatibleScriptsSms = 0xF621, // scripts.sms
+    #[error("La version du fichier `tablebin.ssv` est incompatible avec la bibliothèque des SSV.")]
+    FileVersionIncompatibleTablebinSsv = 0xF622, // tablebin.ssv
+    #[error("La version du fichier `script.ssv` est incompatible avec la bibliothèque des SSV.")]
+    FileVersionIncompatibleScriptSsv = 0xF623, // script.ssv
+    #[error("L'intégrité du fichier `tablebin.smc` est incorrecte.")]
+    FileIntegrityIncorrectTablebinMsc = 0xF630, // tablebin.smc
+    #[error("L'intégrité du fichier `scripts.sms` est incorrecte.")]
+    FileIntegrityIncorrectScriptsSms = 0xF631, // scripts.sms
+    #[error("L'intégrité du fichier `tablebin.ssv` est incorrecte.")]
+    FileIntegrityIncorrectTablebinSsv = 0xF632, // tablebin.ssv
+    #[error("L'intégrité du fichier `script.ssv` est incorrecte.")]
+    FileIntegrityIncorrectScriptSsv = 0xF633, // script.ssv
+    #[error("La structure interne du fichier `tablebin.smc` est invalide.")]
+    FileStructureInvalidTablebinMsc = 0xF640, // tablebin.smc
+    #[error("La structure interne du fichier `scripts.sms` est invalide.")]
+    FileStructureInvalidScriptsSms = 0xF641, // scripts.sms
+    #[error("La structure interne du fichier `tablebin.ssv` est invalide.")]
+    FileStructureInvalidTablebinSsv = 0xF642, // tablebin.ssv
+    #[error("La structure interne du fichier `script.ssv` est invalide.")]
+    FileStructureInvalidScriptSsv = 0xF643, // script.ssv
+    #[error("Le fichier `tablebin.smc` n'a pas pu être chargé en mémoire. Essayez de libérer de la mémoire.")]
+    FileLoadFailedTablebinMsc = 0xF650, // tablebin.smc
+    #[error("Le fichier `scripts.sms` n'a pas pu être chargé en mémoire. Essayez de libérer de la mémoire.")]
+    FileLoadFailedScriptsSms = 0xF651, // scripts.sms
+    #[error("Le fichier `tablebin.ssv` n'a pas pu être chargé en mémoire. Essayez de libérer de la mémoire.")]
+    FileLoadFailedTablebinSsv = 0xF652, // tablebin.ssv
+    #[error("Le fichier `script.ssv` n'a pas pu être chargé en mémoire. Essayez de libérer de la mémoire.")]
+    FileLoadFailedScriptSsv = 0xF653, // script.ssv
+    #[error("Le nom du fichier `tablebin.smc` est invalide.")]
+    FileNameInvalidTablebinMsc = 0xF660, // tablebin.smc
+    #[error("Le nom du fichier `scripts.sms` est invalide.")]
+    FileNameInvalidScriptsSms = 0xF661, // scripts.sms
+    #[error("Le nom du fichier `tablebin.ssv` est invalide.")]
+    FileNameInvalidTablebinSsv = 0xF662, // tablebin.ssv
+    #[error("Le nom du fichier `script.ssv` est invalide.")]
+    FileNameInvalidScriptSsv = 0xF663, // script.ssv
+    #[error("La fonction Initialiser Librairie est déjà appelée.")]
+    FunctionInitLib2AlreadyCalled = 0xF670, // Warning
+    #[error("Le fichier SESAM.INI est inaccessible en lecture (fichier ou droit d’accès manquant) ou ne contient pas le chemin des tables binaires des SSV.")]
+    SesamIniMissingFileOrTablebinPath = 0xF680,
+    #[error("Le chemin du répertoire de travail est absent du fichier SESAM.INI.")]
+    SesamIniMissingWorkDir = 0xF6F1,
+    #[error("Les fichiers d’extension adm ne sont pas accessibles en écriture.")]
+    AdmFilesNotWritable = 0xF6F2, // Warning
+    #[error("Aucune version de FSV du socle technique trouvé. Vérifier que la version du fichier script.sms est bonne.")]
+    NoFsvVersionFound = 0xF6F4,
+    #[error("Librairie SGD absente ou incomplète.")]
+    LibraryMissingOrIncompleteSGD = 0xF6F5,
+    #[error("Librairie SMC absente ou incomplète.")]
+    LibraryMissingOrIncompleteSMC = 0xF6F6,
+    #[error("Librairie SJS absente ou incomplète.")]
+    LibraryMissingOrIncompleteSJS = 0xF6F7,
+    #[error("Librairie SMS absente ou incomplète.")]
+    LibraryMissingOrIncompleteSMS = 0xF6F8,
+    #[error("Section MGC absente / clé RepertoireConfigTrace absente / fichier log4crc.xml non trouvé à l’emplacement indiqué par la clé RepertoireConfigTrace du fichier SESAM.INI.")]
+    SesamIniTracingConfigMissing = 0xFF22, // Warning
+    #[error("Interface Full PC/SC : problème de chargement de la librairie cryptographique ou erreur retournée par la librairie cryptographique.")]
+    PCSCInterfaceCryptoLibraryError = 0xFF25,
+    #[error("Valorisation incorrecte des paramètres de gestion de l'accès aux ressources dans le SESAM.INI. Vérifier les valeurs des clés tempoexclusivite, repetitionexclusivite, tempoexclusivitePCSC, repetitionexclusivitePCSC")]
+    SesamIniResourceAccessParamsIncorrect = 0xFF2A,
+    #[num_enum(catch_all)]
+    #[error("Erreur inattendue de la librairie SSV (code d'erreur: {0}).")]
+    Unexpected(u16),
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_code_ranges() {
+        let error_code = 0xFFF1;
+        let error = SSVErrorCodes::from(error_code);
+        assert_eq!(error, SSVErrorCodes::SSVInternalError);
+
+        let error_code = 0xFFF8;
+        let error = SSVErrorCodes::from(error_code);
+        assert_eq!(error, SSVErrorCodes::SSVInternalError);
+    }
+
+    #[test]
+    fn test_catch_all() {
+        let error_code = 0xFBFF; // Not a valid error code
+        let error = SSVErrorCodes::from(error_code);
+        assert_eq!(error, SSVErrorCodes::Unexpected(0xFBFF));
+    }
+}
+    

crates/fsv/src/ssv/mod.rs

@@ -0,0 +1,227 @@
+use std::{ffi::CString, ptr};
+
+use thiserror::Error;
+
+use fsv_sys::{
+    get_library_path,
+    Error as FsvError,
+    SSVLibrary,
+    SSVLibraryCommon,
+    SupportedFsvVersion,
+    V1_40_13,
+    V1_40_14
+};
+
+mod errors_ssv;
+
+use errors_ssv::SSVErrorCodes;
+use crate::fsv_parsing::prelude::*;
+
+#[derive(Error, Debug)]
+pub enum Error {
+    #[error(transparent)]
+    FSVSysLibrary(#[from] FsvError),
+    #[error(transparent)]
+    SSVError(#[from] SSVErrorCodes),
+}
+
+/// Enum to hold the different versions of the SSV library
+pub enum SsvLibraryVersion {
+    V1_40_13(SSVLibrary<V1_40_13>),
+    V1_40_14(SSVLibrary<V1_40_14>),
+}
+
+/// Struct to hold the SSV library and access its functions
+pub struct SSV {
+    library: SsvLibraryVersion,
+}
+
+impl SSV {
+    pub fn new(version: SupportedFsvVersion) -> Result<Self, Error> {
+        let library = match version {
+            SupportedFsvVersion::V1_40_13 => {
+                let lib_path = get_library_path(&version);
+                let library = SSVLibrary::<V1_40_13>::new(&lib_path)?;
+                SsvLibraryVersion::V1_40_13(library)
+            },
+            SupportedFsvVersion::V1_40_14 => {
+                let lib_path = get_library_path(&version);
+                let library = SSVLibrary::<V1_40_14>::new(&lib_path)?;
+                SsvLibraryVersion::V1_40_14(library)
+            },
+        };
+        Ok(Self { 
+            library,
+        })
+    }
+
+    /// # Initialize the SSV library
+    /// Implement: SSV_InitLIB2
+    pub fn init_library(&self, sesam_ini_path: &str) -> Result<(), Error> {
+        let sesam_ini_path = CString::new(sesam_ini_path).expect("CString::new failed");
+        let result = match &self.library {
+            SsvLibraryVersion::V1_40_13(library) => {
+                unsafe { library.ssv_init_lib2(sesam_ini_path.as_ptr()) }?
+            },
+            SsvLibraryVersion::V1_40_14(library) => {
+                unsafe { library.ssv_init_lib2(sesam_ini_path.as_ptr()) }?
+            },
+        };
+        if result != 0 {
+            let error = SSVErrorCodes::from(result);
+            return Err(Error::SSVError(error));
+        }
+        Ok(())
+    }
+
+    /// # Read the CPS card
+    /// Implement: SSV_LireCartePS
+    pub fn read_professional_card(&self, pin_code: &str) -> Result<(), Error> {
+        let pcsc_reader_name = "Gemalto PC Twin Reader (645D94C3) 00 00";
+
+        let pin_code = CString::new(pin_code).expect("CString::new failed");
+        let pcsc_reader_name = CString::new(pcsc_reader_name).expect("CString::new failed");
+        let mut out_buffer_ptr: *mut libc::c_void = ptr::null_mut();
+        let mut out_buffer_size: libc::size_t = 0;
+
+        let result = match &self.library {
+            SsvLibraryVersion::V1_40_13(library) => {
+                unsafe { library.ssv_lire_carte_ps(
+                    pcsc_reader_name.as_ptr(),
+                    pcsc_reader_name.as_ptr(),
+                    pin_code.as_ptr(),
+                    &mut out_buffer_ptr,
+                    &mut out_buffer_size)
+                }?
+            },
+            SsvLibraryVersion::V1_40_14(library) => {
+                unsafe { library.ssv_lire_carte_ps(
+                    pcsc_reader_name.as_ptr(),
+                    pcsc_reader_name.as_ptr(),
+                    pin_code.as_ptr(),
+                    &mut out_buffer_ptr,
+                    &mut out_buffer_size)
+                }?
+            },
+        };
+
+        if result != 0 {
+            // Free memory
+            unsafe { libc::free(out_buffer_ptr) };
+            let error = SSVErrorCodes::from(result);
+            return Err(Error::SSVError(error));
+        }
+        // Print 10 bytes of the buffer
+        let buffer = unsafe { std::slice::from_raw_parts(out_buffer_ptr as *const u8, 10) };
+        println!("{:?}", buffer);
+        // Free memory
+        unsafe { libc::free(out_buffer_ptr) };
+        Ok(())
+    }
+
+    /// # Get the configuration of the SSV library
+    /// Implement: SSV_LireConfig
+    pub fn get_config(&self) -> Result<Data, Error> {
+        let mut out_buffer_ptr: *mut libc::c_void = ptr::null_mut();
+        let mut out_buffer_size: libc::size_t = 0;
+
+        let result = match &self.library {
+            SsvLibraryVersion::V1_40_13(library) => {
+                unsafe { library.ssv_lire_config(&mut out_buffer_ptr, &mut out_buffer_size) }?
+            },
+            SsvLibraryVersion::V1_40_14(library) => {
+                unsafe { library.ssv_lire_config(&mut out_buffer_ptr, &mut out_buffer_size) }?
+            },
+        };
+
+        if result != 0 {
+            // Free memory
+            unsafe { libc::free(out_buffer_ptr) };
+            let error = SSVErrorCodes::from(result);
+            return Err(Error::SSVError(error));
+        }
+        // Parse the buffer into a Data struct
+        let buffer = unsafe { std::slice::from_raw_parts(out_buffer_ptr as *const u8, out_buffer_size) };
+        let (_rest, config_blocks) = Data::from_bytes((buffer, 0)).unwrap();
+
+        // Free memory
+        unsafe { libc::free(out_buffer_ptr) };
+        Ok(config_blocks)
+    }  
+}
+
+#[cfg(test)]
+mod tests {
+    use std::env;
+
+    use utils::config::load_config;
+    use anyhow::{bail, Result};
+
+    use crate::fsv_parsing::blocks::DataGroup;
+
+    use super::*;
+
+    mod setup {
+        use super::*;
+
+        pub fn init() -> Result<SSV> {
+            load_config(None)?;
+            let sesam_ini_path = env::var("SESAM_INI_PATH").expect("SESAM_INI_PATH must be set");
+            let lib = SSV::new(SupportedFsvVersion::V1_40_13)?;
+            lib.init_library(&sesam_ini_path)?;
+            Ok(lib)
+        }
+    }
+
+    #[test]
+    #[ignore="Not working with other tests using SSV library in parallel - Need to fix"]
+    // We should implement a way to initialize the library only once
+    // Or implement them sequentially with [serial_test crate](https://docs.rs/serial_test/latest/serial_test)
+    fn test_init_library() -> Result<()> {
+        setup::init()?;
+        Ok(())
+    }
+
+    #[test]
+    #[ignore="WARNING: Read the card with PIN 1234 - Risk of blocking the card"]
+    fn test_read_professional_card_good_pin() -> Result<()> {
+        let lib = setup::init()?;
+        let pin_code = "1234";
+        lib.read_professional_card(pin_code)?;
+        Ok(())
+    }
+
+    #[test]
+    #[ignore="WARNING: Read the card with PIN 0000 - Risk of blocking the card"]
+    fn test_read_professional_card_bad_pin() -> Result<()> {
+        let lib = setup::init()?;
+        let pin_code = "0000";
+        // Should return an error
+        let err = lib.read_professional_card(pin_code).unwrap_err();
+        assert_eq!(err.to_string(), "Le code porteur présenté est erroné.");
+        match err {
+            Error::SSVError(err) => {
+                assert_eq!(err as SSVErrorCodes, SSVErrorCodes::CPSPinWrong);
+            },
+            _ => bail!("Error type is not SSVError"),
+        }
+        Ok(())
+    }
+
+    #[test]
+    // #[ignore="Needs a valid FSV installation"]
+    fn test_get_config() -> Result<()> {
+        let lib = setup::init()?;
+        let data = lib.get_config()?;
+        // I don't know what to assert here ...
+        let header_group = data.blocks.first().unwrap();
+        assert_eq!(header_group.header.group_id.0, 60);
+        let header_content = match &header_group.content {
+            DataGroup::LireConfig_Group60_ConfigHeader(content) => { content },
+            _ => bail!("Wrong group type"),
+        };
+        assert_eq!(header_content.ssv_version.0.version, "07");
+        assert_eq!(header_content.ssv_version.0.revision, "20");
+        Ok(())
+    }
+}

crates/sesam-vitale/Cargo.toml

@@ -4,8 +4,11 @@ version = "0.1.0"
 edition = "2021"
 
 [dependencies]
-dotenv = "0.15"
+anyhow.workspace = true
 libc = "0.2"
+thiserror.workspace = true
+
+utils = { path = "../utils" }
 
 [build-dependencies]
-dotenv = "0.15"
+dotenv.workspace = true

crates/sesam-vitale/build.rs

@@ -1,13 +1,13 @@
-extern crate dotenv;
-
 use std::env;
 use std::path::PathBuf;
 
+use dotenv::from_path;
+
 fn main() {
     // Load the .env.build file for build-time environment variables
-    let manifest_dir = env::var("CARGO_MANIFEST_DIR").unwrap();
+    let manifest_dir = env::var("CARGO_MANIFEST_DIR").expect("CARGO_MANIFEST_DIR must be set");
     let manifest_path = PathBuf::from(manifest_dir);
-    dotenv::from_path(manifest_path.join(".env.build")).ok();
+    from_path(manifest_path.join(".env.build")).ok();
 
     println!("cargo::rerun-if-env-changed=SESAM_FSV_LIB_PATH");
     println!("cargo::rerun-if-env-changed=SESAM_FSV_SSVLIB");
@@ -16,21 +16,28 @@ fn main() {
 
     // Add local lib directory to the linker search path (for def files and static libs)
     let static_lib_path = manifest_path.join("lib");
-    println!("cargo::rustc-link-search=native={}", static_lib_path.display());
+    println!(
+        "cargo::rustc-link-search=native={}",
+        static_lib_path.display()
+    );
 
     // Add the SESAM_FSV_LIB_PATH to the linker search path
-    let fsv_lib_path = PathBuf::from(env::var("SESAM_FSV_LIB_PATH").unwrap());
+    let fsv_lib_path =
+        PathBuf::from(env::var("SESAM_FSV_LIB_PATH").expect("SESAM_FSV_LIB_PATH must be set"));
     println!("cargo::rustc-link-search=native={}", fsv_lib_path.display());
 
     // Add the SESAM_FSV_LIB_PATH to the PATH environment variable
     if cfg!(target_os = "windows") {
-        let path = env::var("PATH").unwrap_or(String::new());
+        let path = env::var("PATH").unwrap_or_default();
         println!("cargo:rustc-env=PATH={};{}", fsv_lib_path.display(), path);
     } else if cfg!(target_os = "linux") {
         println!("cargo:rustc-env=LD_LIBRARY_PATH={}", fsv_lib_path.display());
     }
 
     // Link the SESAM_FSV_SSVLIB dynamic library
-    println!("cargo::rustc-link-lib=dylib={}", env::var("SESAM_FSV_SSVLIB").unwrap());
+    println!(
+        "cargo::rustc-link-lib=dylib={}",
+        env::var("SESAM_FSV_SSVLIB").expect("SESAM_FSV_SSVLIB must be set")
+    );
     // TODO : try `raw-dylib` instead of `dylib` on Windows to avoid the need of the `lib` headers compiled from the `def`
 }

crates/sesam-vitale/src/cps.rs

@@ -0,0 +1,400 @@
+use libc::{c_void, size_t};
+use std::ffi::CString;
+use std::ptr;
+use thiserror::Error;
+
+use crate::libssv::{self, SSV_LireCartePS};
+use crate::ssv_memory::{decode_ssv_memory, Block, SSVMemoryError};
+
+#[derive(Error, Debug)]
+pub enum CartePSError {
+    #[error("Unknown (group, field) pair: ({group}, {field})")]
+    UnknownGroupFieldPair { group: u16, field: u16 },
+    #[error("CString creation error: {0}")]
+    CString(#[from] std::ffi::NulError),
+    #[error("Unable to get the last situation while parsing a CartePS")]
+    InvalidLastSituation,
+    #[error(transparent)]
+    SSVMemory(#[from] SSVMemoryError),
+    #[error(transparent)]
+    SSVLibErrorCode(#[from] libssv::LibSSVError),
+}
+
+#[derive(Debug, Default)]
+pub struct CartePS {
+    titulaire: TitulairePS,
+    situations: Vec<SituationPS>,
+}
+
+// 1. CB = Caractères Binaires »
+// 2. CE = Caractères « Etendus » (ISO 8859-1)
+// 3. CA = Caractères Alphanumériques (ASCII?)
+// 4. CN = Caractères Numériques
+#[derive(Debug, Default)]
+struct TitulairePS {
+    type_de_carte_ps: String,                         // CN
+    type_d_identification_nationale: String,          // CN
+    numero_d_identification_nationale: String,        // CE - 8 -> 30
+    cle_du_numero_d_identification_nationale: String, // CN
+    code_civilite: String,                            // CN
+    nom_du_ps: String,                                // CE - 27
+    prenom_du_ps: String,                             // CE - 27
+    categorie_carte: char,                            // CA
+}
+
+#[derive(Debug, Default)]
+struct SituationPS {
+    numero_logique_de_la_situation_de_facturation_du_ps: u8,
+    mode_d_exercice: String,
+    statut_d_exercice: String,
+    secteur_d_activite: String,
+    type_d_identification_structure: String,
+    numero_d_identification_structure: String,
+    cle_du_numero_d_identification_structure: String,
+    raison_sociale_structure: String,
+    numero_d_identification_de_facturation_du_ps: String,
+    cle_du_numero_d_identification_de_facturation_du_ps: String,
+    numero_d_identification_du_ps_remplaçant: String,
+    cle_du_numero_d_identification_du_ps_remplaçant: String,
+    code_conventionnel: String,
+    code_specialite: String,
+    code_zone_tarifaire: String,
+    code_zone_ik: String,
+    code_agrement_1: String,
+    code_agrement_2: String,
+    code_agrement_3: String,
+    habilitation_à_signer_une_facture: String,
+    habilitation_à_signer_un_lot: String,
+}
+
+pub fn lire_carte(code_pin: &str, lecteur: &str) -> Result<CartePS, CartePSError> {
+    let resource_ps = CString::new(lecteur)?;
+    let resource_reader = CString::new("")?;
+    let card_number = CString::new(code_pin)?;
+
+    let mut buffer: *mut c_void = ptr::null_mut();
+    let mut size: size_t = 0;
+    let mut hex_values: &[u8] = &[];
+    unsafe {
+        let result = SSV_LireCartePS(
+            resource_ps.as_ptr(),
+            resource_reader.as_ptr(),
+            card_number.as_ptr(),
+            &mut buffer,
+            &mut size,
+        );
+        println!("SSV_LireCartePS result: {}", result);
+        if result != 0 {
+            return Err(libssv::LibSSVError::StandardErrorCode {
+                code: result,
+                function: "SSV_LireCartePS",
+            }
+            .into());
+        }
+
+        if !buffer.is_null() {
+            hex_values = std::slice::from_raw_parts(buffer as *const u8, size);
+            libc::free(buffer);
+        }
+    }
+    let groups =
+        decode_ssv_memory(hex_values, hex_values.len()).map_err(CartePSError::SSVMemory)?;
+    decode_carte_ps(groups)
+}
+
+fn get_last_mut_situation(carte_ps: &mut CartePS) -> Result<&mut SituationPS, CartePSError> {
+    carte_ps
+        .situations
+        .last_mut()
+        .ok_or(CartePSError::InvalidLastSituation)
+}
+
+fn decode_carte_ps(groups: Vec<Block>) -> Result<CartePS, CartePSError> {
+    let mut carte_ps = CartePS::default();
+    for group in groups {
+        for field in group.content {
+            match (group.id, field.id) {
+                (1, 1) => {
+                    carte_ps.titulaire.type_de_carte_ps =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (1, 2) => {
+                    carte_ps.titulaire.type_d_identification_nationale =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (1, 3) => {
+                    carte_ps.titulaire.numero_d_identification_nationale =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (1, 4) => {
+                    carte_ps.titulaire.cle_du_numero_d_identification_nationale =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (1, 5) => {
+                    carte_ps.titulaire.code_civilite =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (1, 6) => {
+                    carte_ps.titulaire.nom_du_ps =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (1, 7) => {
+                    carte_ps.titulaire.prenom_du_ps =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (1, 8) => {
+                    let byte = field.content[0];
+                    carte_ps.titulaire.categorie_carte = byte as char;
+                }
+                (2..=16, 1) => {
+                    carte_ps.situations.push(SituationPS::default());
+                    get_last_mut_situation(&mut carte_ps)?
+                        .numero_logique_de_la_situation_de_facturation_du_ps = field.content[0];
+                }
+                (2..=16, 2) => {
+                    get_last_mut_situation(&mut carte_ps)?.mode_d_exercice =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 3) => {
+                    get_last_mut_situation(&mut carte_ps)?.statut_d_exercice =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 4) => {
+                    get_last_mut_situation(&mut carte_ps)?.secteur_d_activite =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 5) => {
+                    get_last_mut_situation(&mut carte_ps)?.type_d_identification_structure =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 6) => {
+                    get_last_mut_situation(&mut carte_ps)?.numero_d_identification_structure =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 7) => {
+                    get_last_mut_situation(&mut carte_ps)?
+                        .cle_du_numero_d_identification_structure =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 8) => {
+                    get_last_mut_situation(&mut carte_ps)?.raison_sociale_structure =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 9) => {
+                    get_last_mut_situation(&mut carte_ps)?
+                        .numero_d_identification_de_facturation_du_ps =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 10) => {
+                    get_last_mut_situation(&mut carte_ps)?
+                        .cle_du_numero_d_identification_de_facturation_du_ps =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 11) => {
+                    get_last_mut_situation(&mut carte_ps)?
+                        .numero_d_identification_du_ps_remplaçant =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 12) => {
+                    get_last_mut_situation(&mut carte_ps)?
+                        .cle_du_numero_d_identification_du_ps_remplaçant =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 13) => {
+                    get_last_mut_situation(&mut carte_ps)?.code_conventionnel =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 14) => {
+                    get_last_mut_situation(&mut carte_ps)?.code_specialite =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 15) => {
+                    get_last_mut_situation(&mut carte_ps)?.code_zone_tarifaire =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 16) => {
+                    get_last_mut_situation(&mut carte_ps)?.code_zone_ik =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 17) => {
+                    get_last_mut_situation(&mut carte_ps)?.code_agrement_1 =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 18) => {
+                    get_last_mut_situation(&mut carte_ps)?.code_agrement_2 =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 19) => {
+                    get_last_mut_situation(&mut carte_ps)?.code_agrement_3 =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 20) => {
+                    get_last_mut_situation(&mut carte_ps)?.habilitation_à_signer_une_facture =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                (2..=16, 21) => {
+                    get_last_mut_situation(&mut carte_ps)?.habilitation_à_signer_un_lot =
+                        String::from_utf8_lossy(field.content).to_string();
+                }
+                _ => {
+                    return Err(CartePSError::UnknownGroupFieldPair {
+                        group: group.id,
+                        field: field.id,
+                    });
+                }
+            }
+        }
+    }
+    Ok(carte_ps)
+}
+
+#[cfg(test)]
+mod test_decode_carte_ps {
+    use super::*;
+
+    #[test]
+    fn test_francoise_pharmacien0052419() {
+        let bytes: &[u8] = &[
+            0, 1, 51, // Block 01, Content size 51
+            1, 48, // Field 01, Content size 1
+            1, 56, // Field 02, Content size 1
+            11, 57, 57, 55, 48, 48, 53, 50, 52, 49, 57, 52, // Field 03, Content size 11
+            1, 52, // Field 04, Content size 1
+            2, 50, 50, // Field 05, Content size 2
+            17, 80, 72, 65, 82, 77, 65, 67, 73, 69, 78, 48, 48, 53, 50, 52, 49,
+            57, // Field 06, Content size 17
+            9, 70, 82, 65, 78, 67, 79, 73, 83, 69, // Field 07, Content size 9
+            1, 84, // Field 08, Content size 1
+            0, 2, 83, // Block 02, Content size 83
+            1, 1, 1, 48, 1, 49, 2, 56, 54, 1, 49, 9, 48, 66, 48, 50, 50, 49, 57, 53, 56, 1, 56, 24,
+            80, 72, 65, 82, 77, 65, 67, 73, 69, 32, 68, 85, 32, 67, 69, 78, 84, 82, 69, 50, 50, 49,
+            57, 53, 8, 48, 48, 50, 48, 50, 52, 49, 57, 1, 56, 0, 1, 48, 1, 49, 2, 53, 48, 2, 49,
+            48, 2, 48, 48, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49,
+        ];
+        let blocks = decode_ssv_memory(bytes, bytes.len()).unwrap();
+        let carte_ps = decode_carte_ps(blocks).unwrap();
+
+        assert_eq!(carte_ps.titulaire.type_de_carte_ps, "0");
+        assert_eq!(carte_ps.titulaire.type_d_identification_nationale, "8");
+        assert_eq!(
+            carte_ps.titulaire.numero_d_identification_nationale,
+            "99700524194"
+        );
+        assert_eq!(
+            carte_ps.titulaire.cle_du_numero_d_identification_nationale,
+            "4"
+        );
+        assert_eq!(carte_ps.titulaire.code_civilite, "22");
+        assert_eq!(carte_ps.titulaire.nom_du_ps, "PHARMACIEN0052419");
+        assert_eq!(carte_ps.titulaire.prenom_du_ps, "FRANCOISE");
+        assert_eq!(carte_ps.titulaire.categorie_carte, 'T');
+
+        assert_eq!(carte_ps.situations.len(), 1);
+        assert_eq!(
+            carte_ps.situations[0].numero_logique_de_la_situation_de_facturation_du_ps,
+            1
+        );
+        assert_eq!(carte_ps.situations[0].mode_d_exercice, "0");
+        assert_eq!(carte_ps.situations[0].statut_d_exercice, "1");
+        assert_eq!(carte_ps.situations[0].secteur_d_activite, "86");
+        assert_eq!(carte_ps.situations[0].type_d_identification_structure, "1");
+        assert_eq!(
+            carte_ps.situations[0].numero_d_identification_structure,
+            "0B0221958"
+        );
+        assert_eq!(
+            carte_ps.situations[0].cle_du_numero_d_identification_structure,
+            "8"
+        );
+        assert_eq!(
+            carte_ps.situations[0].raison_sociale_structure,
+            "PHARMACIE DU CENTRE22195"
+        );
+        assert_eq!(
+            carte_ps.situations[0].numero_d_identification_de_facturation_du_ps,
+            "00202419"
+        );
+        assert_eq!(
+            carte_ps.situations[0].cle_du_numero_d_identification_de_facturation_du_ps,
+            "8"
+        );
+        assert_eq!(
+            carte_ps.situations[0].numero_d_identification_du_ps_remplaçant,
+            ""
+        );
+        assert_eq!(
+            carte_ps.situations[0].cle_du_numero_d_identification_du_ps_remplaçant,
+            "0"
+        );
+        assert_eq!(carte_ps.situations[0].code_conventionnel, "1");
+        assert_eq!(carte_ps.situations[0].code_specialite, "50");
+        assert_eq!(carte_ps.situations[0].code_zone_tarifaire, "10");
+        assert_eq!(carte_ps.situations[0].code_zone_ik, "00");
+        assert_eq!(carte_ps.situations[0].code_agrement_1, "0");
+        assert_eq!(carte_ps.situations[0].code_agrement_2, "0");
+        assert_eq!(carte_ps.situations[0].code_agrement_3, "0");
+        assert_eq!(
+            carte_ps.situations[0].habilitation_à_signer_une_facture,
+            "1"
+        );
+        assert_eq!(carte_ps.situations[0].habilitation_à_signer_un_lot, "1");
+    }
+
+    #[test]
+    fn test_multiple_situations() {
+        let bytes: &[u8] = &[
+            0, 1, 51, // Block 01, Content size 51
+            1, 48, 1, 56, 11, 57, 57, 55, 48, 48, 53, 50, 52, 49, 57, 52, 1, 52, 2, 50, 50, 17, 80,
+            72, 65, 82, 77, 65, 67, 73, 69, 78, 48, 48, 53, 50, 52, 49, 57, 9, 70, 82, 65, 78, 67,
+            79, 73, 83, 69, 1, 84, 0, 2, 83, // Block 02, Content size 83
+            1, 1, 1, 48, 1, 49, 2, 56, 54, 1, 49, 9, 48, 66, 48, 50, 50, 49, 57, 53, 56, 1, 56, 24,
+            80, 72, 65, 82, 77, 65, 67, 73, 69, 32, 68, 85, 32, 67, 69, 78, 84, 82, 69, 50, 50, 49,
+            57, 53, 8, 48, 48, 50, 48, 50, 52, 49, 57, 1, 56, 0, 1, 48, 1, 49, 2, 53, 48, 2, 49,
+            48, 2, 48, 48, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49, 0, 3,
+            83, // Block 03, Content size 83
+            1, 1, 1, 48, 1, 49, 2, 56, 54, 1, 49, 9, 48, 66, 48, 50, 50, 49, 57, 53, 56, 1, 56, 24,
+            80, 72, 65, 82, 77, 65, 67, 73, 69, 32, 68, 85, 32, 67, 69, 78, 84, 82, 69, 50, 50, 49,
+            57, 53, 8, 48, 48, 50, 48, 50, 52, 49, 57, 1, 56, 0, 1, 48, 1, 49, 2, 53, 48, 2, 49,
+            48, 2, 48, 48, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49, 0, 4,
+            83, // Block 04, Content size 83
+            1, 1, 1, 48, 1, 49, 2, 56, 54, 1, 49, 9, 48, 66, 48, 50, 50, 49, 57, 53, 56, 1, 56, 24,
+            80, 72, 65, 82, 77, 65, 67, 73, 69, 32, 68, 85, 32, 67, 69, 78, 84, 82, 69, 50, 50, 49,
+            57, 53, 8, 48, 48, 50, 48, 50, 52, 49, 57, 1, 56, 0, 1, 48, 1, 49, 2, 53, 48, 2, 49,
+            48, 2, 48, 48, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49,
+        ];
+        let blocks = decode_ssv_memory(bytes, bytes.len()).unwrap();
+        let carte_ps = decode_carte_ps(blocks).unwrap();
+
+        assert_eq!(carte_ps.situations.len(), 3);
+        assert_eq!(
+            carte_ps.situations[0].raison_sociale_structure,
+            "PHARMACIE DU CENTRE22195"
+        );
+        assert_eq!(
+            carte_ps.situations[1].raison_sociale_structure,
+            "PHARMACIE DU CENTRE22195"
+        );
+        assert_eq!(
+            carte_ps.situations[2].raison_sociale_structure,
+            "PHARMACIE DU CENTRE22195"
+        );
+    }
+
+    #[test]
+    #[should_panic]
+    fn test_missing_field() {
+        todo!();
+    }
+
+    #[test]
+    #[should_panic]
+    fn test_unknown_group_field_pair() {
+        todo!();
+    }
+
+    #[test]
+    #[should_panic]
+    fn test_invalid_field_format() {
+        todo!();
+    }
+}

crates/sesam-vitale/src/lib.rs

@@ -1,3 +1,8 @@
+pub mod cps;
+pub mod libssv;
+pub mod ssv_memory;
+pub mod ssvlib_demo;
+
 pub fn add(left: usize, right: usize) -> usize {
     left + right
 }

crates/sesam-vitale/src/libssv.rs

@@ -1,17 +1,30 @@
-/**
- * libssv.rs
- * 
- * Low level bindings to the SSVLIB dynamic library.
- * TODO : look for creating a dedicated *-sys crate : https://kornel.ski/rust-sys-crate
- */
+/// libssv.rs
+///
+/// Low level bindings to the SSVLIB dynamic library.
+// TODO : look for creating a dedicated *-sys crate : https://kornel.ski/rust-sys-crate
+use libc::{c_char, c_ushort, c_void, size_t};
+use thiserror::Error;
 
-use libc::{ c_char, c_void, c_ushort, size_t };
+#[derive(Debug, Error)]
+pub enum LibSSVError {
+    #[error("SSV library error in {function}: {code}")]
+    StandardErrorCode { code: u16, function: &'static str },
+}
 
 #[cfg_attr(target_os = "linux", link(name = "ssvlux64"))]
 #[cfg_attr(target_os = "windows", link(name = "ssvw64"))]
 extern "C" {
     pub fn SSV_InitLIB2(pcRepSesamIni: *const c_char) -> c_ushort;
-    pub fn SSV_LireCartePS(NomRessourcePS: *const c_char, NomRessourceLecteur: *const c_char, CodePorteurPS: *const c_char, ZDonneesSortie: *mut *mut c_void, TTailleDonneesSortie: *mut size_t) -> c_ushort;
-    pub fn SSV_LireConfig(ZDonneesSortie: *mut *mut c_void, TTailleDonneesSortie: *mut size_t) -> c_ushort;
+    pub fn SSV_LireCartePS(
+        NomRessourcePS: *const c_char,
+        NomRessourceLecteur: *const c_char,
+        CodePorteurPS: *const c_char,
+        ZDonneesSortie: *mut *mut c_void,
+        TTailleDonneesSortie: *mut size_t,
+    ) -> c_ushort;
+    pub fn SSV_LireConfig(
+        ZDonneesSortie: *mut *mut c_void,
+        TTailleDonneesSortie: *mut size_t,
+    ) -> c_ushort;
 }
-/* TODO : replace void* by Rust struct : https://doc.rust-lang.org/nomicon/ffi.html#representing-opaque-structs */
+// TODO : replace void* by Rust struct : https://doc.rust-lang.org/nomicon/ffi.html#representing-opaque-structs

crates/sesam-vitale/src/main.rs

@@ -1,6 +1,10 @@
-mod ssvlib_demo;
+mod cps;
 mod libssv;
+mod ssv_memory;
+mod ssvlib_demo;
 
-fn main() {
-    ssvlib_demo::demo();
+use anyhow::{Context, Result};
+
+fn main() -> Result<()> {
+    ssvlib_demo::demo().context("Error while running the SSV library demo")
 }

crates/sesam-vitale/src/ssv_memory.rs

@@ -0,0 +1,358 @@
+/// # SSV Memory
+/// Provide functions to manipulate raw memory from SSV library.
+use std::convert::TryFrom;
+use thiserror::Error;
+
+#[derive(Debug, Error)]
+pub enum BytesReadingError {
+    #[error("Empty bytes input")]
+    EmptyBytes,
+    #[error("Invalid memory: not enough bytes ({actual}) to read the expected size ({expected})")]
+    InvalidSize { expected: usize, actual: usize },
+    #[error("Invalid memory: size ({actual}) is expected to be less than {expected} bytes")]
+    SizeTooBig { expected: usize, actual: usize },
+    #[error("Invalid memory: not enough bytes to read the block id")]
+    InvalidBlockId(#[from] std::array::TryFromSliceError),
+    #[error("Error while reading field at offset {offset}")]
+    InvalidField {
+        source: Box<BytesReadingError>,
+        offset: usize,
+    },
+}
+
+#[derive(Debug, Error)]
+pub enum SSVMemoryError {
+    #[error("Error while parsing block at offset {offset}")]
+    BlockParsing {
+        source: BytesReadingError,
+        offset: usize,
+    },
+}
+
+#[derive(PartialEq, Debug)]
+struct ElementSize {
+    pub size: usize,
+    pub pad: usize,
+}
+
+// TODO : Est-ce qu'on pourrait/devrait définir un type custom pour représenter les tableaux de bytes ?
+impl TryFrom<&[u8]> for ElementSize {
+    type Error = BytesReadingError;
+
+    fn try_from(bytes: &[u8]) -> Result<Self, Self::Error> {
+        if bytes.is_empty() {
+            return Err(BytesReadingError::EmptyBytes);
+        }
+
+        let mut element_size = ElementSize { size: 0, pad: 1 };
+        // Longueur:
+        //   - si le bit de poids fort du premier octet est à 0, la longueur est codée sur un octet
+        //   - si le bit de poids fort du premier octet est à 1, les 7 bits de poids faible codent le nombre d'octets utilisés pour coder la longueur
+        if bytes[0] & 0b1000_0000 == 0 {
+            // Size coded on 1 byte
+            element_size.size = bytes[0] as usize;
+        } else {
+            // Size coded on N bytes
+            // N are the 7 lower bits of the first byte
+            let size_bytes_len = (bytes[0] & 0b0111_1111) as usize;
+            if size_bytes_len > bytes.len() - 1 {
+                return Err(BytesReadingError::InvalidSize {
+                    expected: size_bytes_len,
+                    actual: bytes.len() - 1,
+                });
+            } else if size_bytes_len > 4 {
+                return Err(BytesReadingError::SizeTooBig {
+                    expected: 4,
+                    actual: size_bytes_len,
+                });
+            }
+            let size_bytes = &bytes[1..1 + size_bytes_len];
+
+            // u32::from_be_bytes() requires a 4 bytes array
+            let mut padded_bytes = [0u8; 4];
+            padded_bytes[size_bytes_len..].copy_from_slice(size_bytes);
+
+            element_size.size = u32::from_be_bytes(padded_bytes) as usize;
+            element_size.pad += size_bytes_len;
+        }
+        Ok(element_size)
+    }
+}
+
+#[derive(Debug)]
+pub struct Block<'a> {
+    pub id: u16,
+    pub size: usize,
+    pub content: Vec<Field<'a>>,
+}
+
+impl<'a> TryFrom<&'a [u8]> for Block<'a> {
+    type Error = BytesReadingError;
+
+    fn try_from(bytes: &'a [u8]) -> Result<Self, Self::Error> {
+        let mut offset = 0;
+        let id = u16::from_be_bytes(
+            bytes[..2]
+                .try_into()
+                .map_err(BytesReadingError::InvalidBlockId)?,
+        );
+        offset += 2;
+        let ElementSize {
+            size: block_size,
+            pad,
+        } = bytes[2..].try_into()?;
+        offset += pad;
+        let raw_content = &bytes[offset..];
+        let mut field_offset = 0;
+        // While there is still content to read, parse Fields
+        let mut content = Vec::new();
+        let mut field_id = 1;
+        while field_offset < block_size {
+            let mut field: Field<'a> = raw_content[field_offset..].try_into().map_err(|err| {
+                BytesReadingError::InvalidField {
+                    source: Box::new(err),
+                    offset: field_offset,
+                }
+            })?;
+            field.id = field_id;
+            field_offset += field.size;
+            field_id += 1;
+            content.push(field);
+        }
+        Ok(Block {
+            id,
+            size: offset + block_size,
+            content,
+        })
+    }
+}
+
+#[derive(Debug)]
+pub struct Field<'a> {
+    pub id: u16,
+    pub size: usize,
+    pub content: &'a [u8],
+}
+
+impl<'a> TryFrom<&'a [u8]> for Field<'a> {
+    type Error = BytesReadingError;
+
+    fn try_from(bytes: &'a [u8]) -> Result<Self, Self::Error> {
+        let ElementSize { size, pad } = bytes.try_into()?;
+        let contenu = &bytes[pad..pad + size];
+        Ok(Field {
+            id: 0,
+            size: pad + size,
+            content: contenu,
+        })
+    }
+}
+
+pub fn decode_ssv_memory(bytes: &[u8], size: usize) -> Result<Vec<Block>, SSVMemoryError> {
+    let mut blocks: Vec<Block> = Vec::new();
+    let mut offset = 0;
+    while offset < size {
+        let block: Block =
+            bytes[offset..]
+                .try_into()
+                .map_err(|err| SSVMemoryError::BlockParsing {
+                    source: err,
+                    offset,
+                })?;
+        offset += block.size;
+        blocks.push(block);
+    }
+    Ok(blocks)
+}
+
+#[cfg(test)]
+mod test_element_size {
+    use std::any::Any;
+
+    use super::*;
+
+    #[test]
+    fn short_size() {
+        let bytes: &[u8] = &[0b_0000_0001_u8];
+        let element_size: ElementSize = bytes.try_into().unwrap();
+        assert_eq!(element_size.size, 1);
+        assert_eq!(element_size.pad, 1);
+
+        let bytes: &[u8] = &[0b_0100_0000_u8];
+        let element_size: ElementSize = bytes.try_into().unwrap();
+        assert_eq!(element_size.size, 64);
+        assert_eq!(element_size.pad, 1);
+    }
+
+    #[test]
+    fn long_size() {
+        let bytes: &[u8] = &[0b_1000_0010_u8, 0b_0000_0001_u8, 0b_0100_0000_u8];
+        let element_size: ElementSize = bytes.try_into().unwrap();
+        assert_eq!(element_size.size, 320);
+        assert_eq!(element_size.pad, 3);
+    }
+
+    #[test]
+    fn null_size() {
+        let bytes: &[u8] = &[];
+        let result: Result<ElementSize, BytesReadingError> = bytes.try_into();
+        assert!(result.is_err());
+        assert_eq!(
+            result.unwrap_err().type_id(),
+            BytesReadingError::EmptyBytes.type_id()
+        );
+    }
+
+    #[test]
+    fn invalid_memory() {
+        let bytes: &[u8] = &[0b_1000_0001_u8];
+        let result: Result<ElementSize, BytesReadingError> = bytes.try_into();
+        assert!(result.is_err());
+        assert_eq!(
+            result.unwrap_err().to_string(),
+            BytesReadingError::InvalidSize {
+                expected: 1,
+                actual: 0
+            }
+            .to_string()
+        );
+
+        let bytes: &[u8] = &[0b_1000_0010_u8, 1];
+        let result: Result<ElementSize, BytesReadingError> = bytes.try_into();
+        assert!(result.is_err());
+        assert_eq!(
+            result.unwrap_err().to_string(),
+            BytesReadingError::InvalidSize {
+                expected: 2,
+                actual: 1
+            }
+            .to_string()
+        );
+
+        let bytes: &[u8] = &[0b_1000_0101_u8, 1, 1, 1, 1, 1];
+        let result: Result<ElementSize, BytesReadingError> = bytes.try_into();
+        assert!(result.is_err());
+        assert_eq!(
+            result.unwrap_err().to_string(),
+            BytesReadingError::SizeTooBig {
+                expected: 4,
+                actual: 5
+            }
+            .to_string()
+        );
+    }
+}
+
+#[cfg(test)]
+mod test_field {
+    use super::*;
+
+    #[test]
+    fn short_size() {
+        let bytes: &[u8] = &[
+            51, 1, 48, 1, 56, 11, 57, 57, 55, 48, 48, 53, 50, 52, 49, 57, 52, 1, 52, 2, 50, 50, 17,
+            80, 72, 65, 82, 77, 65, 67, 73, 69, 78, 48, 48, 53, 50, 52, 49, 57, 9, 70, 82, 65, 78,
+            67, 79, 73, 83, 69, 1, 84,
+        ];
+        let element: Field = bytes.try_into().unwrap();
+        assert_eq!(element.size, 52);
+        assert_eq!(element.content[..5], [1, 48, 1, 56, 11]);
+    }
+
+    #[test]
+    fn long_size() {
+        let mut bytes_vec = vec![
+            0b_1000_0010_u8,
+            0b_0000_0001_u8,
+            0b_0000_0000_u8, // size = 256
+        ];
+        // Add 256 bytes to the content
+        bytes_vec.append(&mut vec![1; 256]);
+        let bytes: &[u8] = &bytes_vec;
+        let element: Field = bytes.try_into().unwrap();
+        assert_eq!(element.size, 259);
+        assert_eq!(element.content.len(), 256);
+    }
+}
+
+#[cfg(test)]
+mod test_block {
+    use super::*;
+
+    #[test]
+    fn test_francoise_pharmacien0052419_partial_block_1() {
+        let bytes: &[u8] = &[1, 48, 1, 56, 11, 57, 57, 55, 48, 48, 53, 50, 52, 49, 57, 52];
+
+        let field1: Field = bytes.try_into().unwrap();
+        assert_eq!(field1.size, 2);
+        assert_eq!(field1.content, &[48]);
+
+        let field2: Field = bytes[field1.size..].try_into().unwrap();
+        assert_eq!(field2.size, 2);
+        assert_eq!(field2.content, &[56]);
+
+        let field3: Field = bytes[field1.size + field2.size..].try_into().unwrap();
+        assert_eq!(field3.size, 12);
+        assert_eq!(
+            field3.content,
+            &[57, 57, 55, 48, 48, 53, 50, 52, 49, 57, 52]
+        );
+    }
+
+    #[test]
+    fn test_francoise_pharmacien0052419() {
+        let bytes: &[u8] = &[
+            0, 1, 51, // 3
+            1, 48, // 2
+            1, 56, // 2
+            11, 57, 57, 55, 48, 48, 53, 50, 52, 49, 57, 52, // 12
+            1, 52, // 2
+            2, 50, 50, // 3
+            17, 80, 72, 65, 82, 77, 65, 67, 73, 69, 78, 48, 48, 53, 50, 52, 49, 57, // 18
+            9, 70, 82, 65, 78, 67, 79, 73, 83, 69, // 10
+            1, 84, // 2
+            // total: 54
+            0, 2, 83, 1, 1, 1, 48, 1, 49, 2, 56, 54, 1, 49, 9, 48, 66, 48, 50, 50, 49, 57, 53, 56,
+            1, 56, 24, 80, 72, 65, 82, 77, 65, 67, 73, 69, 32, 68, 85, 32, 67, 69, 78, 84, 82, 69,
+            50, 50, 49, 57, 53, 8, 48, 48, 50, 48, 50, 52, 49, 57, 1, 56, 0, 1, 48, 1, 49, 2, 53,
+            48, 2, 49, 48, 2, 48, 48, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49,
+        ];
+
+        let first_block: Block = bytes.try_into().unwrap();
+        assert_eq!(first_block.id, 1);
+        assert_eq!(first_block.size, 54);
+        assert_eq!(first_block.content.len(), 8);
+
+        let second_block: Block = bytes[first_block.size..].try_into().unwrap();
+        assert_eq!(second_block.id, 2);
+        assert_eq!(second_block.size, 86);
+        assert_eq!(second_block.content.len(), 21);
+    }
+}
+
+#[cfg(test)]
+mod test_decode_ssv_memory {
+    use super::*;
+
+    #[test]
+    fn test_francoise_pharmacien0052419() {
+        let bytes: &[u8] = &[
+            0, 1, 51, // 3
+            1, 48, // 2
+            1, 56, // 2
+            11, 57, 57, 55, 48, 48, 53, 50, 52, 49, 57, 52, // 12
+            1, 52, // 2
+            2, 50, 50, // 3
+            17, 80, 72, 65, 82, 77, 65, 67, 73, 69, 78, 48, 48, 53, 50, 52, 49, 57, // 18
+            9, 70, 82, 65, 78, 67, 79, 73, 83, 69, // 10
+            1, 84, // 2
+            // total: 54
+            0, 2, 83, 1, 1, 1, 48, 1, 49, 2, 56, 54, 1, 49, 9, 48, 66, 48, 50, 50, 49, 57, 53, 56,
+            1, 56, 24, 80, 72, 65, 82, 77, 65, 67, 73, 69, 32, 68, 85, 32, 67, 69, 78, 84, 82, 69,
+            50, 50, 49, 57, 53, 8, 48, 48, 50, 48, 50, 52, 49, 57, 1, 56, 0, 1, 48, 1, 49, 2, 53,
+            48, 2, 49, 48, 2, 48, 48, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49,
+        ];
+        let blocks = decode_ssv_memory(bytes, bytes.len()).unwrap();
+        assert_eq!(blocks.len(), 2);
+    }
+}

crates/sesam-vitale/src/ssvlib_demo.rs

@@ -1,69 +1,56 @@
-/**
- * High level API for the SSV library,
- * based on the low level bindings in libssv.rs.
- * 
- */
-
-extern crate libc;
-extern crate dotenv;
-
-use libc::{ c_void, size_t };
-use std::ffi::CString;
-use std::path::PathBuf;
-use std::ptr;
-
+/// High level API for the SSV library,
+/// based on the low level bindings in libssv.rs.
+use libc::{c_void, size_t};
 use std::env;
+use std::ffi::CString;
+use std::ptr;
+use thiserror::Error;
 
-use crate::libssv:: {
-    SSV_InitLIB2,
-    SSV_LireCartePS,
-    SSV_LireConfig
-};
+use crate::cps::lire_carte;
+use crate::libssv::{SSV_InitLIB2, SSV_LireConfig};
 
-fn ssv_init_lib_2() {
+use ::utils::config::{load_config, ConfigError};
+
+#[derive(Error, Debug)]
+pub enum SSVDemoError {
+    #[error(transparent)]
+    CartePSReading(#[from] crate::cps::CartePSError),
+    #[error(transparent)]
+    SSVLibErrorCode(#[from] crate::libssv::LibSSVError),
+    #[error(transparent)]
+    Configuration(#[from] ConfigError),
+}
+
+fn ssv_init_lib_2() -> Result<(), SSVDemoError> {
     let ini_str = env::var("SESAM_INI_PATH").expect("SESAM_INI_PATH must be set");
     let ini = CString::new(ini_str).expect("CString::new failed");
     unsafe {
         let result = SSV_InitLIB2(ini.as_ptr());
         println!("SSV_InitLIB2 result: {}", result);
-    }
-}
-
-fn ssv_lire_carte_ps() {
-    let resource_ps = CString::new("PS").expect("CString::new failed");
-    let resource_reader = CString::new("TRANSPA1").expect("CString::new failed");
-    let card_number = CString::new("1234567890").expect("CString::new failed");
-
-    let mut buffer: *mut c_void = ptr::null_mut();
-    let mut size: size_t = 0;
-    unsafe {
-        let result = SSV_LireCartePS(
-            resource_ps.as_ptr(),
-            resource_reader.as_ptr(),
-            card_number.as_ptr(),
-            &mut buffer,
-            &mut size
-        );
-        println!("SSV_LireCartePS result: {}", result);
-
-        if !buffer.is_null() {
-            let hex_values = std::slice::from_raw_parts(buffer as *const u8, size);
-            for &byte in hex_values {
-                print!("{:02X} ", byte);
+        if result != 0 {
+            return Err(crate::libssv::LibSSVError::StandardErrorCode {
+                code: result,
+                function: "SSV_InitLIB2",
             }
-            println!();
-
-            libc::free(buffer);
+            .into());
         }
     }
+    Ok(())
 }
 
-fn ssv_lire_config() {
+fn ssv_lire_config() -> Result<(), SSVDemoError> {
     let mut buffer: *mut c_void = ptr::null_mut();
     let mut size: size_t = 0;
     unsafe {
         let result = SSV_LireConfig(&mut buffer, &mut size);
         println!("SSV_LireConfig result: {}", result);
+        if result != 0 {
+            return Err(crate::libssv::LibSSVError::StandardErrorCode {
+                code: result,
+                function: "SSV_LireConfig",
+            }
+            .into());
+        }
 
         if !buffer.is_null() {
             let hex_values = std::slice::from_raw_parts(buffer as *const u8, size);
@@ -75,22 +62,26 @@ fn ssv_lire_config() {
             libc::free(buffer);
         }
     }
+    Ok(())
 }
 
-pub fn demo() {
-    /*
-     * TODO : this is probably not working on release, because I'm not sure it exists a CARGO_MANIFEST_DIR and so it can find the `.env`
-     * Maybe we could use a system standard config path to store a config file
-     */ 
-    let manifest_dir = env::var("CARGO_MANIFEST_DIR").unwrap();
-    let manifest_path = PathBuf::from(manifest_dir);
-    dotenv::from_path(manifest_path.join(".env")).ok();
+pub fn demo() -> Result<(), SSVDemoError> {
+    // TODO : this is probably not working on release, because I'm not sure it exists a CARGO_MANIFEST_DIR and so it can find the `.env`
+    // Maybe we could use a system standard config path to store a config file
 
     println!("------- Demo for the SSV library --------");
 
-    ssv_init_lib_2();
-    ssv_lire_carte_ps();
-    ssv_lire_config();
+    load_config(None)?;
+
+    ssv_init_lib_2()?;
+
+    let code_pin = "1234";
+    let lecteur = "HID Global OMNIKEY 3x21 Smart Card Reader 0";
+    let carte_ps = lire_carte(code_pin, lecteur)?;
+    println!("CartePS: {:#?}", carte_ps);
+
+    ssv_lire_config()?;
 
     println!("-----------------------------------------");
+    Ok(())
 }

crates/utils/Cargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "utils"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+anyhow.workspace = true
+directories = "5.0"
+dotenv.workspace = true
+thiserror.workspace = true

crates/utils/src/config.rs

@@ -0,0 +1,68 @@
+use std::{env, path::PathBuf, sync::atomic::AtomicBool};
+
+use directories::ProjectDirs;
+use dotenv::from_path;
+use thiserror::Error;
+
+const CONFIG_FILE_NAME: &str = ".env";
+
+static CONFIG_INITIALIZED: AtomicBool = AtomicBool::new(false);
+
+#[derive(Debug, Error)]
+pub enum ConfigError {
+    #[error("No config file {0} found in the following directories: {1:#?}")]
+    ConfigFileNotFound(String, Vec<PathBuf>),
+    #[error("Failed to load config file: {0}")]
+    LoadConfigError(#[from] dotenv::Error),
+    #[error("Environment variable error: {0}")]
+    EnvVarError(#[from] std::env::VarError),
+}
+
+pub fn get_config_dirs() -> Vec<PathBuf> {
+    let mut config_dirs = vec![
+        PathBuf::from(""), // Current directory
+    ];
+    if let Ok(manifest_dir) = env::var("CARGO_MANIFEST_DIR") {
+        config_dirs.push(PathBuf::from(manifest_dir));
+    }
+    if let Some(proj_dirs) = ProjectDirs::from("org", "P4pillon", "Krys4lide") {
+        config_dirs.push(proj_dirs.config_dir().to_path_buf());
+    }
+    config_dirs
+}
+
+pub fn get_config_files() -> Result<Vec<PathBuf>, ConfigError> {
+    let config_dirs = get_config_dirs();
+    let mut config_files = Vec::new();
+    for config_dir in config_dirs.iter() {
+        let config_file = config_dir.join(CONFIG_FILE_NAME);
+        if config_file.exists() {
+            config_files.push(config_file);
+        }
+    }
+    if config_files.is_empty() {
+        return Err(ConfigError::ConfigFileNotFound(
+            CONFIG_FILE_NAME.to_string(),
+            config_dirs,
+        ));
+    }
+    Ok(config_files)
+}
+
+pub fn load_config(force: Option<bool>) -> Result<(), ConfigError> {
+    let force = force.unwrap_or(false);
+    if CONFIG_INITIALIZED.load(std::sync::atomic::Ordering::Relaxed) && force {
+        println!("DEBUG: Config already initialized, skipping");
+        return Ok(());
+    }
+    let config_files = get_config_files()?;
+    // Load the first config file found
+    // TODO: add a verbose log to list all config files found
+    println!(
+        "DEBUG: Config files found (1st loaded): {:#?}",
+        config_files
+    );
+    from_path(config_files[0].as_path()).map_err(ConfigError::LoadConfigError)?;
+    CONFIG_INITIALIZED.store(true, std::sync::atomic::Ordering::Relaxed);
+    Ok(())
+}

crates/utils/src/lib.rs

@@ -0,0 +1 @@
+pub mod config;

docs/errors.md

@@ -0,0 +1,85 @@
+# Gestion des erreurs
+
+Ce document décrit comment les erreurs sont gérées dans le projet.
+
+## Gestion native
+
+Par principe, en Rust, on évite au maximum la gestion par exception, ne la réservant qu'aux situations où un crash du programme est la meilleure solution.
+En temps normal, on renvoie des `Result<Valeur, Erreur>` (pour les situations réussite/erreur) ou des `Option<Valeur>` (pour les situations valeur non-nulle/nulle).
+
+Quand on fait face à une situation d'erreur, on cherchera à la gérer de manière explicite (voir [Récupération des erreurs](#récupération-des-erreurs)) ou à la remonter à un niveau supérieur, généralement à l'aide de l'opérateur `?`.
+
+On évitera, par contre, au maximum de générer des exceptions (appelées "panics" en Rust), que ce soit par l'usage de `panic!` ou par des appels à des fonctions qui paniquent en cas d'erreur (comme `unwrap` ou `expect`).
+
+De nombreux exemples des idiomes natifs de gestion des erreurs en Rust sont disponibles dans la documentation [Rust by example](https://doc.rust-lang.org/rust-by-example/error.html).
+
+## Librairies de gestion des erreurs
+
+Deux librairies sont utilisées pour gérer les erreurs dans le projet :
+- [`anyhow`](https://docs.rs/anyhow/latest/anyhow/) : qui permet de renvoyer des erreurs faiblement typées, mais très facile à enrichir avec des messages d'explication. On l'utilise pour communiquer facilement des erreurs de haut niveau avec un utilisateur final.
+    ```rust
+    use anyhow::{anyhow, Result};
+
+    fn get_cluster_info() -> Result<ClusterInfo> {
+        let data = fs::read_to_string("cluster.json")
+            .with_context(|| "failed to read cluster config")?;
+        let info: ClusterInfo = serde_json::from_str(&data)
+            .with_context(|| "failed to parse cluster config")?;
+        Ok(info)
+    }
+    ```
+- [`thiserror`](https://docs.rs/thiserror/latest/thiserror/) : qui fournit des macros pour définir des erreurs fortement typées. On l'utilise pour définir des erreurs spécifiques à une partie du code, contextualisées avec des données structurées plutôt que de simples messages d'erreurs, afin de favoriser la "récupération" face aux erreurs.
+    ```rust
+    use thiserror::Error;
+
+    #[derive(Error, Debug)]
+    pub enum DataStoreError {
+        #[error("data store disconnected")]
+        Disconnect(#[from] io::Error),
+        #[error("the data for key `{0}` is not available")]
+        Redaction(String),
+        #[error("invalid header (expected {expected:?}, found {found:?})")]
+        InvalidHeader {
+            expected: String,
+            found: String,
+        },
+        #[error("unknown data store error")]
+        Unknown,
+    }
+    ```
+
+## Récupération des erreurs
+
+Dans la mesure du possible, on essaie de privilégier la "récupération" face à une erreur plutôt que le "crash". Les stratégies de récupération sont :
+- Réessayer l'opération, tel quel ou avec des paramètres différents
+- Contourner l'opération, en la remplaçant par une autre
+- À défaut, informer l'utilisateur de l'erreur et :
+    - arrêter / annuler l'opération en cours
+    - ignorer l'erreur et continuer l'exécution
+
+Quand on ne peut pas récupérer une erreur, on la remonte à un niveau supérieur, si besoin en la convertissant dans un type d'erreur plus générique et approprié au niveau considéré.
+
+## Conversion des erreurs
+
+Quand on remonte une erreur à un niveau supérieur, on peut être amené à la convertir dans un type d'erreur plus générique et approprié au niveau considéré. Pour faciliter cette conversion, on implémente le trait `From`. Avec `thiserror`, on peut utiliser l'attribut `#[from]` ou le paramètre `source` pour automatiser l'implémentation de telles conversions.
+
+On peut ensuite, lors de la gestion d'une erreur, on pourra :
+- soit directement renvoyer l'erreur à l'aide de l'opérateur `?`, qui se chargera de la conversion ;
+- soit convertir l'erreur explicitement, par exemple en utilisant la méthode `map_err` sur un `Result`, en particulier quand on veut enrichir l'erreur avec des informations supplémentaires.
+
+## Usages exceptionnels de `unwrap` et `expect`
+
+Provoquant des "panics" en cas d'erreur, les fonctions `unwrap` et `expect` ne doivent être utilisées que dans des cas exceptionnels :
+- Dans les tests, pour signaler une erreur de test
+- Au plus haut niveau de l'application, pour signaler une erreur fatale qui ne peut pas être récupérée
+- Dans des situations où l'erreur ne peut pas se produire, par exemple après une vérification de préconditions
+
+Dans l'idéal, on préférera l'usage de `expect` à `unwrap`, car il permet de donner un message d'erreur explicite.
+
+## Ressources
+
+- [The Rust Programming Language - Ch. 9: Error Handling](https://doc.rust-lang.org/book/ch09-00-error-handling.html)
+- [The NRC Book - Error Handling in Rust](https://nrc.github.io/error-docs/intro.html)
+- [The Error Design Patterns Book - by Project Error Handling WG](https://github.com/rust-lang/project-error-handling/blob/master/error-design-patterns-book/src/SUMMARY.md)
+- [The Rust Cookbook - Error Handling](https://rust-lang-nursery.github.io/rust-cookbook/error-handling.html)
+- [Le ticket initial de l'intégration de la gestion des erreurs dans le projet](https://forge.p4pillon.org/P4Pillon/Krys4lide/issues/34)

entity/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "entity"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+name = "entity"
+path = "src/lib.rs"
+
+[dependencies]
+sea-orm.workspace = true
+serde.workspace = true
+
+[dev-dependencies]
+sea-orm-cli.workspace = true

entity/src/entities/debug.rs

@@ -0,0 +1,18 @@
+//! `SeaORM` Entity, @generated by sea-orm-codegen 1.0.1
+
+use sea_orm::entity::prelude::*;
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Debug, PartialEq, DeriveEntityModel, Eq, Serialize, Deserialize)]
+#[sea_orm(table_name = "debug")]
+pub struct Model {
+    #[sea_orm(primary_key)]
+    pub id: i32,
+    pub title: String,
+    pub text: String,
+}
+
+#[derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]
+pub enum Relation {}
+
+impl ActiveModelBehavior for ActiveModel {}

entity/src/entities/mod.rs

@@ -0,0 +1,5 @@
+//! `SeaORM` Entity, @generated by sea-orm-codegen 1.0.1
+
+pub mod prelude;
+
+pub mod debug;

entity/src/entities/prelude.rs

@@ -0,0 +1,3 @@
+//! `SeaORM` Entity, @generated by sea-orm-codegen 1.0.1
+
+pub use super::debug::Entity as Debug;

entity/src/lib.rs

@@ -0,0 +1,2 @@
+mod entities;
+pub use entities::*;

frontend/.gitignore

@@ -0,0 +1,24 @@
+# Nuxt dev/build outputs
+.output
+.data
+.nuxt
+.nitro
+.cache
+dist
+
+# Node dependencies
+node_modules
+
+# Logs
+logs
+*.log
+
+# Misc
+.DS_Store
+.fleet
+.idea
+
+# Local env files
+.env
+.env.*
+!.env.example

frontend/README.md

@@ -0,0 +1,77 @@
+# Nuxt 3 Minimal Starter
+
+TODO : Faire un vrai README pour `frontend` (Nuxt 3)
+
+Look at the [Nuxt 3 documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.
+
+## Setup
+
+Make sure to install the dependencies:
+
+```bash
+# npm
+npm install
+
+# pnpm
+pnpm install
+
+# yarn
+yarn install
+
+# bun
+bun install
+```
+
+## Development Server
+
+Start the development server on `http://localhost:3000`:
+
+```bash
+# npm
+npm run dev
+
+# pnpm
+pnpm run dev
+
+# yarn
+yarn dev
+
+# bun
+bun run dev
+```
+
+## Production
+
+Build the application for production:
+
+```bash
+# npm
+npm run build
+
+# pnpm
+pnpm run build
+
+# yarn
+yarn build
+
+# bun
+bun run build
+```
+
+Locally preview production build:
+
+```bash
+# npm
+npm run preview
+
+# pnpm
+pnpm run preview
+
+# yarn
+yarn preview
+
+# bun
+bun run preview
+```
+
+Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.

frontend/app.vue

@@ -0,0 +1,8 @@
+<template>
+  <div>
+    <NuxtLoadingIndicator />
+    <NuxtRouteAnnouncer />
+    <NavBar />
+    <NuxtPage />
+  </div>
+</template>

frontend/app/spa-loading-template.html

@@ -0,0 +1,43 @@
+<!-- 
+    This component is used to show a loading spinner when the SPA is loading.
+    Source: https://github.com/barelyhuman/snips/blob/dev/pages/css-loader.md
+-->
+<div class="loader"></div>
+<style>
+.loader {
+  display: block;
+  position: fixed;
+  z-index: 1031;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  width: 18px;
+  height: 18px;
+  box-sizing: border-box;
+  border: solid 2px transparent;
+  border-top-color: #000;
+  border-left-color: #000;
+  border-bottom-color: #efefef;
+  border-right-color: #efefef;
+  border-radius: 50%;
+  -webkit-animation: loader 400ms linear infinite;
+  animation: loader 400ms linear infinite;
+}
+
+\@-webkit-keyframes loader {
+  0% {
+    -webkit-transform: translate(-50%, -50%) rotate(0deg);
+  }
+  100% {
+    -webkit-transform: translate(-50%, -50%) rotate(360deg);
+  }
+}
+\@keyframes loader {
+  0% {
+    transform: translate(-50%, -50%) rotate(0deg);
+  }
+  100% {
+    transform: translate(-50%, -50%) rotate(360deg);
+  }
+}
+</style>

frontend/components/Avatar.vue

@@ -0,0 +1,22 @@
+<template>
+    <div class="avatar">
+        <div class="rounded-full">
+            <img :src="getAvatarUrl(user)" />
+        </div>
+    </div>
+</template>
+
+<script setup lang="ts">
+    import type { User } from '~/types/user';
+
+    const props = defineProps<{
+        user: User,
+    }>();
+
+    const getAvatarUrl = (user: User) => {
+        if (user.avatar) {
+            return user.avatar;
+        }
+        return 'https://i.pravatar.cc/150?u=' + user.name;
+    };
+</script>

frontend/components/LoginModal.vue

@@ -0,0 +1,71 @@
+<template>
+    <dialog
+        id="login_modal"
+        ref="login_modal"
+        @cancel.prevent=""
+        @keyup="handleKeyPress"
+        class="modal"
+    >
+        <div class="modal-box">
+            <h3 class="text-3xl text-center mb-6">Connexion</h3>
+            <div class="flex flex-wrap gap-5 justify-center">
+                <template v-for="(user, index) in users" :key="user.id">
+                    <LoginModalAvatar
+                        :user="user"
+                        :rank="index+1"
+                        @selectUser="login"
+                    />
+                </template>
+            </div>
+        </div>
+        <form method="dialog" class="modal-backdrop">
+            <button class="cursor-default">close</button>
+        </form>
+    </dialog>
+</template>
+
+<script setup lang="ts">
+    import type { User } from '~/types/user';
+
+    const users: User[] = [
+        { id: 1, name: 'John Doe', avatar: 'https://img.daisyui.com/images/stock/photo-1534528741775-53994a69daeb.webp' },
+        { id: 2, name: 'Jane Doe', avatar: 'https://i.pravatar.cc/150?u=JANEDOE728' },
+        { id: 3, name: 'Michel Moulin' },
+        { id: 4, name: 'Jean Paris' },
+        { id: 5, name: 'Marie Dupont' },
+        { id: 6, name: 'Émilie Fournier' },
+        { id: 7, name: 'Pierre Lefevre' },
+        { id: 8, name: 'Sophie Lemoine' },
+        { id: 9, name: 'Lucie Simon' },
+        { id: 10, name: 'Kevin Boucher' },
+    ];
+
+    const loginModal = useTemplateRef('login_modal');
+
+    const current_user = useCurrentUser();
+
+    const login = (user: User) => {
+        console.log('login', user);
+        current_user.value = user;
+        loginModal.value?.close();
+    };
+
+    const handleKeyPress = (event: KeyboardEvent) => {
+        // Extract the rank from the event.code : Digit7 -> 7
+        const rank = event.code.match(/\d/);
+        if (!rank) {
+            console.debug('Not handled key event', { event });
+            return;
+        }
+        const user = getUserByRank(parseInt(rank[0]));
+        if (user) {
+            login(user);
+        } else {
+            console.debug('Not handled key event', { event });
+        }
+    };
+
+    const getUserByRank = (rank: number): User => {
+        return users[rank - 1];
+    };
+</script>

frontend/components/LoginModalAvatar.vue

@@ -0,0 +1,17 @@
+<template>
+    <button class="relative" @click="$emit('selectUser', user)">
+        <Avatar class="w-24" :user="user" />
+        <div class="absolute w-fit mx-auto bottom-0 inset-x-0">
+            <kbd class="kbd kbd-sm">{{ rank }}</kbd>
+        </div>
+    </button>
+</template>
+
+<script setup lang="ts">
+    import type { User } from '~/types/user';
+
+    const props = defineProps<{
+        user: User,
+        rank: Number,
+    }>();
+</script>

frontend/components/NavBar.vue

@@ -0,0 +1,36 @@
+<template>
+    <div class="navbar">
+        <div class="navbar-start">
+            <a class="btn btn-ghost text-xl" href="/">Chrys4lide</a>
+        </div>
+        <nav class="navbar-center">
+            <NuxtLink to="/" class="btn btn-ghost">Accueil</NuxtLink>
+            <NuxtLink to="/CPS" class="btn btn-ghost">Carte CPS</NuxtLink>
+            <NuxtLink to="/debug" class="btn btn-ghost">Debug</NuxtLink>
+        </nav>
+        <div class="navbar-end">
+            <template v-if="!current_user">
+                <button class="btn btn-ghost" type="button" onclick="login_modal.showModal()">
+                    Connexion
+                </button>
+            </template>
+            <template v-else>
+                <details class="dropdown dropdown-end">
+                    <summary class="block"><Avatar :user="current_user" class="w-12" role="button" /></summary>
+                    <ul class="menu dropdown-content bg-base-100 rounded-box z-[1] w-52 p-2 shadow">
+                        <li><a @click="logout">Déconnexion</a></li>
+                    </ul>
+                </details>
+            </template>
+        </div>
+    </div>
+    <LoginModal />
+</template>
+
+<script setup lang="ts">
+    const current_user = useCurrentUser();
+
+    const logout = () => {
+        current_user.value = null;
+    };
+</script>

frontend/composables/currentUser.ts

@@ -0,0 +1,3 @@
+import type { User } from '@/types/user';
+
+export const useCurrentUser = () => useState<User | null>('currentUser', () => null);

frontend/nuxt.config.ts

@@ -0,0 +1,39 @@
+// https://nuxt.com/docs/api/configuration/nuxt-config
+export default defineNuxtConfig({
+  compatibilityDate: '2024-04-03',
+  // Enables the development server to be discoverable by other devices for mobile development
+  devServer: { host: '0.0.0.0', port: 1420 },
+  devtools: { enabled: true },
+  modules: [
+    '@nuxtjs/tailwindcss',
+    '@nuxtjs/color-mode',
+  ],
+  // Disable SSR for Tauri
+  ssr: false,
+  vite: {
+    // Better support for Tauri CLI output
+    clearScreen: false,
+    // Enable environment variables
+    // Additional environment variables can be found at
+    // https://v2.tauri.app/reference/environment-variables/
+    envPrefix: ['VITE_', 'TAURI_'],
+    server: {
+      // Tauri requires a consistent port
+      strictPort: true,
+      hmr: {
+        // Use websocket for mobile hot reloading
+        protocol: 'ws',
+        // Make sure it's available on the network
+        host: '0.0.0.0',
+        // Use a specific port for hmr
+        port: 5183,
+      },
+    },
+  },
+  colorMode: {
+    // Add `data-theme` attribute to the `html` tag, allowing DaisyUI to handle dark mode automatically
+    dataValue: 'theme',
+    // Remove the default `-mode` suffix from the class name, letting have `dark` and `light` as class names, for DaisyUI compatibility
+    classSuffix: '',
+  },
+})

frontend/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "nuxt-app",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "nuxi build",
+    "dev": "nuxi dev",
+    "generate": "nuxi generate",
+    "preview": "nuxi preview",
+    "postinstall": "nuxi prepare"
+  },
+  "dependencies": {
+    "@nuxtjs/color-mode": "^3.5.1",
+    "daisyui": "^4.12.10",
+    "nuxt": "^3.13.0",
+    "vue": "latest",
+    "vue-router": "latest"
+  },
+  "devDependencies": {
+    "@nuxtjs/tailwindcss": "^6.12.1"
+  }
+}

frontend/pages/CPS.vue

@@ -0,0 +1,8 @@
+<template>
+    <div>
+        <h1 class="text-xl">Carte CPS</h1>
+    </div>
+</template>
+
+<script setup>
+</script>

frontend/pages/debug.vue

@@ -0,0 +1,67 @@
+<template>
+    <div>
+        <h1 class="text-3xl mb-8">Debug</h1>
+        <div class="stats shadow mb-8">
+            <div class="stat">
+                <div class="stat-title">DB Ping Status</div>
+                <div class="stat-value">{{ data?.db_ping_status || "?" }}</div>
+            </div>
+            <div class="stat">
+                <div class="stat-title">Entries Count</div>
+                <div class="stat-value">{{ data?.entries.length || "?" }}</div>
+                <div class="stat-actions">
+                    <button class="btn btn-sm" @click="addRandomEntry">Add entry</button>
+                </div>
+            </div>
+            <div class="stat">
+                <div class="stat-title">Network status</div>
+                <div class="stat-value">{{ status }}</div>
+                <div class="stat-description">{{ error }}</div>
+            </div>
+        </div>
+        <div>
+            <h2 class="text-2xl mb-4">Entries</h2>
+            <table class="table">
+                <thead>
+                    <tr>
+                        <th>Id</th>
+                        <th>Title</th>
+                        <th>Text</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <tr v-for="entry in data?.entries" :key="entry.id">
+                        <td>{{ entry.id }}</td>
+                        <td>{{ entry.title }}</td>
+                        <td>{{ entry.text }}</td>
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+    </div>
+</template>
+
+<script setup lang="ts">
+    type Entry = {
+        id: number;
+        title: string;
+        text: string;
+    };
+    type DebugResponse = {
+        db_ping_status: string;
+        entries: Entry[];
+    };
+
+    
+    // TODO : handle a default backend URL by building a custom `$fetch` and `useFetch` functions with a `baseURL` option : https://nuxt.com/docs/guide/recipes/custom-usefetch#custom-fetch
+    
+    const { data, refresh, error, status } = await useFetch<DebugResponse>('http://127.0.0.1:8080/debug');
+
+    async function addRandomEntry() {
+        await $fetch('http://127.0.0.1:8080/debug/add_random', {
+            method: 'POST',
+        });
+        refresh();
+    }
+
+</script>

frontend/pages/index.vue

@@ -0,0 +1,17 @@
+<template>
+    <div>
+        <h1 class="text-xl">Welcome to your {{ appName }}!</h1>
+        <p v-if="current_user">Logged in as {{ current_user.name }}</p>
+    </div>
+</template>
+
+<script setup lang="ts">
+    const current_user = useCurrentUser();
+    const appName = 'Nuxt App';
+</script>
+
+<style scoped>
+h1 {
+    color: #42b983;
+}
+</style>

frontend/public/robots.txt

@@ -0,0 +1 @@
+

frontend/server/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../.nuxt/tsconfig.server.json"
+}

frontend/tailwind.config.ts

@@ -0,0 +1,7 @@
+import type { Config } from 'tailwindcss'
+
+export default <Partial<Config>>{
+    plugins: [
+        require('daisyui'),
+    ],
+}

frontend/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  // https://nuxt.com/docs/guide/concepts/typescript
+  "extends": "./.nuxt/tsconfig.json"
+}