129 lines
4.6 KiB
Markdown
129 lines
4.6 KiB
Markdown
# Exécution et runtime Lardon3D
|
|
|
|
## Modèle d'exécution
|
|
|
|
### Threads
|
|
- Thread principal : TUI ncursesw (exclusif)
|
|
- Thread worker : exécution des tâches métier
|
|
|
|
### Synchronisation
|
|
- Mutex pour les accès partagés
|
|
- Variables de condition pour la coordination
|
|
- Atomicité des opérations critiques
|
|
|
|
## Cycle de vie d'une tâche
|
|
|
|
```text
|
|
1. Création (PENDING)
|
|
2. Soumission à la file
|
|
3. Sélection par le scheduler
|
|
4. Réservation obligatoire
|
|
5. Exécution (RUNNING)
|
|
- Pause/reprise coopérative
|
|
- Annulation coopérative
|
|
- Séquences adaptatives
|
|
6. Complétion (COMPLETED) ou Échec (FAILED)
|
|
7. Nettoyage des ressources
|
|
```
|
|
|
|
## Synchronisation
|
|
|
|
### Mutex
|
|
- Protection des données partagées
|
|
- Accès exclusif aux ressources critiques
|
|
|
|
### Variables de condition
|
|
- Coordination entre threads
|
|
- Notification de changement d'état
|
|
- Attente passive (pas de polling)
|
|
|
|
### Atomicité
|
|
- Opérations indivisibles
|
|
- État cohérent garanti
|
|
|
|
## Gestion des erreurs
|
|
|
|
### Rollback
|
|
- Retour à l'état précédent en cas d'échec
|
|
- Nettoyage complet des ressources
|
|
- Aucun état partiellement appliqué
|
|
|
|
### Récupération
|
|
- Reprise à la dernière frontière connue
|
|
- Ignorance des artefacts partiels
|
|
- Validation avant publication
|
|
|
|
## Limites actuelles
|
|
|
|
- Worker unique (pas de pools multiples)
|
|
- Pas de parallélisme inter-tâches
|
|
- Reprise automatique limitée aux tâches indépendantes reconstructibles
|
|
|
|
## Reprise durable
|
|
|
|
Un snapshot ne conserve que l'état logique d'une tâche. `RUNNING` et `PAUSED`
|
|
sont normalisés vers `PENDING`; aucun worker, callback brut, pointeur, contrat
|
|
ou réservation n'est restauré. Le propriétaire fournit un nouveau callback et
|
|
resoumet la tâche. Les états terminaux sont conservés.
|
|
|
|
`started_at` désigne le début de la tentative d'exécution courante, pas le
|
|
premier démarrage historique. Un checkpoint `RUNNING` restauré en `PENDING`
|
|
conserve temporairement l'horodatage de la tentative interrompue pour
|
|
l'observation ; lors de `lardon3d_task_start()`, `started_at` est remplacé par le
|
|
nouveau démarrage et `finished_at` est remis à zéro. `finished_at` n'est fixé
|
|
qu'à la terminaison de cette tentative.
|
|
|
|
**IMPLEMENTED** — snapshot, codec v1 et restauration isolée.
|
|
|
|
**IMPLEMENTED** — l'import `import.images` se sauvegarde à chaque fin de lot et
|
|
se reconstruit explicitement avec un userdata neuf lié au projet rouvert. Son
|
|
intention durable contient `source_path + scanset_id`; le hash/copie et la
|
|
transaction catalogue restent hors mutex Task et hors mutex DB pendant l'I/O.
|
|
|
|
**IMPLEMENTED** — `project_open()` inventorie par pages de 8, restaure puis
|
|
resoumet automatiquement les tâches production valides. Il retourne après
|
|
l'enqueue et n'attend jamais leur terminaison.
|
|
|
|
L'ordre d'initialisation production est : profil matériel, governor, queue et
|
|
worker, TUI, puis ouverture DB/projet et reprise synchrone. Une fermeture ne
|
|
peut commencer qu'après le retour de `project_open()`. Le worker peut consommer
|
|
pendant le scan ; chaque tâche exécutée est néanmoins réadmise normalement.
|
|
|
|
**NOT_YET_WIRED** — autosave générique des autres kinds et reprise ordonnée par
|
|
dépendances.
|
|
|
|
**PLANNED** — reprise globale du scheduler via la Project Database.
|
|
|
|
## Accès Project Database
|
|
|
|
**IMPLEMENTED** — une connexion SQLite opaque sérialisée par mutex interne ;
|
|
les opérations multi-tables sont transactionnelles et bornées.
|
|
|
|
**IMPLEMENTED** — le cycle de vie projet ouvre/crée `project.db`, vérifie
|
|
l'identité et ferme la connexion. L'application arrête la task queue avant la
|
|
fermeture finale du projet.
|
|
|
|
**IMPLEMENTED** — la registry reconstruit explicitement callback/userdata hors
|
|
mutex DB pour un kind connu ; elle ne soumet aucune tâche.
|
|
|
|
**IMPLEMENTED** — la queue accepte un identifiant restauré préassigné s'il
|
|
n'entre en collision avec aucune tâche connue. L'import production peut donc
|
|
être reconstruit puis soumis explicitement.
|
|
|
|
**IMPLEMENTED** — la resoumission automatique utilise la registry production,
|
|
conserve le task ID et laisse le worker obtenir une nouvelle réservation.
|
|
Kinds inconnus, tâches legacy, checkpoints invalides et sources absentes ne
|
|
bloquent pas l'ouverture.
|
|
|
|
**IMPLEMENTED** — `visual_index.update` reprend à la dernière membership
|
|
commitée. Un segment temporaire n'est jamais visible et un rejeu exclut les
|
|
Feature Sets déjà membres.
|
|
|
|
## Invariants
|
|
|
|
- ncurses appartient exclusivement au thread principal
|
|
- Aucune tâche ne démarre sans réservation active
|
|
- Les réservations sont libérées exactement une fois
|
|
- Les buffers sont strictement bornés
|
|
|
|
## Statut : DOCUMENTATION DE L'IMPLÉMENTATION ACTUELLE
|