Structure du projet et chargement

Statut documentaire : reference — voir Maturité et preuves.

Une application logiCells est assemblée à partir d’artefacts déclaratifs coordonnés. La présence d’un fichier sur disque ne suffit pas : il doit être atteignable par la chaîne de chargement application, package et manifest.

Principales familles d’artefacts

Artefact	Responsabilité
.application.yaml / .application.xml	Assemblage Runtime : packages, services, stockage, ressources et options d’exécution.
.package.yaml / .package.xml	Module chargeable, items, services et ressources du package.
ClassItems.manifest.yaml / .xml	Allow-list explicite des classes chargeables dans un dossier de modèles.
*.model.yaml / .xml	Concepts, facettes, champs, relations, collections, actions, événements et vues.
*.form.yaml / .form	Projection de vue/page, cache de données, DataSources, curseurs, page model et composants.
*.service.yaml / .xml	Contrat de publication pour routes, endpoints, actions ou pages virtuelles.

Une structure publique utile est :

project/
  configurations/
    BaseConsole.Memory.application.yaml
    BaseConsole.Persistent.application.yaml
  packages/
    TaskManagement.package.yaml
  meta/
    TaskManagement/
      ClassItems.manifest.yaml
      Task.model.yaml
      Project.model.yaml
      TaskBelongsToProject.model.yaml
  views/
    TaskEdit.form.yaml
    TaskList.form.yaml
  services/
    TaskManagement.service.yaml
  tests/

Chaîne de chargement

Considérer cette séquence comme le premier invariant de diagnostic :

configuration application
  -> package activé
  -> chemin schéma/modèle
  -> ClassItems manifest
  -> déclaration du modèle
  -> compilation des métadonnées
  -> initialisation de la mémoire conceptuelle

Si une classe n’est pas résolue, diagnostiquer cette chaîne avant le code métier, les vues ou les actions.

XML et YAML

XML et YAML sont deux représentations du même contrat déclaratif. Ne pas migrer la notation pendant un premier diagnostic. Préserver la convention source-of-truth d’un projet existant ; pour un nouveau projet, choisir une représentation canonique.

Stratégie de premier succès

Commencer par le chemin exécutable minimal : charger un package, exposer une classe par le manifest, compiler un modèle d’entité, attacher la projection de persistance si nécessaire, lier une vue, créer/modifier/enregistrer un objet, puis ajouter progressivement collections, actions, événements et services.