Skip to content

docs(naming): conformité NAMING_CONVENTIONS — en-têtes, renvois et structure - #529

Merged
donovan-dev-web merged 2 commits into
developfrom
docs/conformite-naming-en-tetes-renvois
Oct 11, 2026
Merged

docs(naming): conformité NAMING_CONVENTIONS — en-têtes, renvois et structure#529
donovan-dev-web merged 2 commits into
developfrom
docs/conformite-naming-en-tetes-renvois

Conversation

@donovan-dev-web

@donovan-dev-web donovan-dev-web commented Oct 11, 2026

Copy link
Copy Markdown
Owner

Objet

Mise en conformité complète avec NAMING_CONVENTIONS.md (§4, §9, §10) et nettoyage du dépôt : en-têtes de fichier, commentaires/docstrings, nommage des fichiers, retrait des documents obsolètes.

Contenu

  • En-têtes (§9.2) — 353/353 fichiers de code : docstring de module en tête (Python, bandeau # redondant supprimé), bloc JSDoc (JavaScript), bandeau // complété (C# et C++). Écart C# documenté : §9.3 prescrit ///, mais un commentaire XML avant les using déclenche error CS1587 dès que GenerateDocumentationFile=true (cas de Simulation.Core et Simulation.Console, CI en --warnaserror) — le bandeau // est la seule forme possible. 199 rôles tronqués (…) réécrits depuis les blocs de doc natifs.
  • Renvois (§9.4) — références à des documents/paragraphes retirées des commentaires et docstrings (0 restant, contrôle exhaustif lignes + docstrings + fins de ligne) ; les références d'issue (SYNE-nnn, ECHOS-nnn…) sont conservées.
  • Nommage (§4) — scripts Python en snake_case, ADR transverses numérotés ADR-005 → ADR-011 (+ index docs/adr/README.md), Livex-status.md → LIVEX-STATUS.md.
  • Dépôt nettoyé — 11 documents obsolètes supprimés (ROADMAP-V01, RAPPORT-ELEMENTS-OUVERTS, UI_DESIGN, USER_STORIES, FRONTEND_VISION, MIGRATION_MORPHOLOGY, DECISIONS_V01, ADR-001 Godot, ADR-003 Electron, ADR Perception, Note Couche Affective) ; les renvois qui les citaient sont explicitement neutralisés (« document retiré du dépôt ») dans les changelogs, ADR et ISSUES ; métadonnées §10 complétées sur les documents PRISM et docs/README.md ; docstring de scripts/batch_analysis.py traduite en français.

Vérifications locales

  • dotnet build -c Release --warnaserror : 0 avertissement / 0 erreur (syne + launcher)
  • Tests : SYNE 548 + 86, Launcher (unit + intégration + E2E), npm test syne-mock 46 ✓ / 0 échec / 2 ignorés
  • flake8 : parité avec develop (38 E501 préexistants, 0 nouvel écart) ; compileall exit 0
  • Contrôles conformité : 0 renvoi documentaire restant, 0 lien markdown mort, 0 en-tête manquant (hors boilerplate Epic prism/LDK et snapshot Monographie)

🤖 Generated with Codebuff

protection-test and others added 2 commits October 11, 2026 12:47
protection-test @codebuff-team
docs(naming): conformité NAMING_CONVENTIONS — en-têtes, renvois et st…
9699af1 
…ructure

- En-tête de fichier conforme §9.2 dans les 353 fichiers de code : docstring de
  module (Python, bandeau # redondant supprimé), bloc JSDoc (JavaScript),
  bandeau // en tête (C# et C++ — écart « /// » documenté : un commentaire XML
  avant les using déclenche CS1587 dès que GenerateDocumentationFile=true).
- Rôles tronqués (…) réécrits depuis les blocs de doc natifs des fichiers
  (199 bandeaux C# touchés).
- Références à des documents et paragraphes retirées des commentaires et
  docstrings (X.md, §n, Annexe, ADR, Monographie, noms de documents sans
  extension) ; les références d'issue (SYNE-nnn, ECHOS-nnn…) sont conservées.
- Nommage : scripts Python en snake_case, ADR transverses numérotés
  (ADR-005 → ADR-011 + index docs/adr/README.md), Livex-status.md →
  LIVEX-STATUS.md.
- 11 documents obsolètes retirés du dépôt (ROADMAP-V01, RAPPORT-ELEMENTS-OUVERTS,
  UI_DESIGN, USER_STORIES, FRONTEND_VISION, MIGRATION_MORPHOLOGY, DECISIONS_V01,
  ADR-001 Godot, ADR-003 Electron, ADR Perception, Note Couche Affective) ; les
  renvois qui les citaient sont neutralisés (« document retiré du dépôt ») dans
  les changelogs, ADR et ISSUES ; métadonnées §10 complétées sur les documents
  PRISM et docs/README.md ; docstring de batch_analysis.py traduite en français.

Vérifié : builds Release --warnaserror 0/0 (syne + launcher), tests SYNE 548 +
86, tests Launcher, npm test syne-mock 46 ✓, flake8 à parité avec HEAD
(38 E501 préexistants, 0 nouvel écart), compileall exit 0.

🤖 Generated with Codebuff
Co-Authored-By: Codebuff <noreply@codebuff.com>
protection-test @codebuff-team
fix(echos): restaure le DDL et les INSERT corrompus par la passe de c…
3f348b8 
…onformité

La passe de suppression des renvois avait retiré la parenthèse ouvrante de
8 `CREATE TABLE` (DDL de `storage/sqlite.py`), de 5 `INSERT` inline et du
schéma de test de `test_sqlite_store.py` : les suites ECHOS tombaient en
`sqlite3.OperationalError: near "key"/"run_id"` (4 jobs CI en échec). Le
diff AST hors docstrings contre develop ne révèle aucune autre altération de
code ; quatre artefacts de docstring résiduels sont aussi nettoyés (crochet
vide, « cf., » orphelin, espace perdu en début de ligne, reflow).

Vérifié : pytest complet vert (couverture 90,55 % ≥ 80 %), flake8 à parité
avec develop (38 E501 préexistants), compileall exit 0.

🤖 Generated with Codebuff
Co-Authored-By: Codebuff <noreply@codebuff.com>
@donovan-dev-web
donovan-dev-web merged commit 6c12421 into develop Oct 11, 2026
13 checks passed
@donovan-dev-web
donovan-dev-web deleted the docs/conformite-naming-en-tetes-renvois branch October 11, 2026 11:32
@donovan-dev-web donovan-dev-web mentioned this pull request Oct 12, 2026
Merged
5 tasks done
donovan-dev-web added a commit that referenced this pull request Oct 12, 2026
@donovan-dev-web protection-test @codebuff-team
fix(launcher): IHM fenêtre/carte composant + docs: cohérence versions…
0f42ab4 
…, badges et LIVEX-STATUS (#530)

* fix(launcher): fenêtre sans chrome et carte composant — coins arrondis, débordement corrigé

- Fenêtre : CornerRadius 16 + ClipToBounds, fond déplacé du Window vers la
  Border principale pour que le dégradé radial soit découpé aux coins.
- Carte composant : rangée « pastille d'état + Console » puis rangée
  « Démarrer/Arrêter + Configurer » — le Grid à rangées implicites
  débordait de la carte.
- Boutons de fenêtre 40 → 32 px, padding 0 → 10.

Vérifié : build Release --warnaserror 0/0, suites Launcher 164 unitaires +
20 intégration verts.

🤖 Generated with Codebuff
Co-Authored-By: Codebuff <noreply@codebuff.com>

* docs(livex): cohérence doc/code — versions, badges de tests et LIVEX-STATUS au 12/10

- LIVEX-STATUS : réécriture avec suites rejouées (1 258 tests, 16 ignorés,
  0 échec), couverture ECHOS 90,55 % et SYNE 87,41 % (union coverlet),
  inventaire 640 fichiers / 65 142 lignes tokei ; renvois « étapes »
  réalignés sur ROADMAP.md + launcher/ROADMAP-V1.md (le plan ROADMAP-V01 a
  été retiré par la PR #529) ; CI develop 13/13 jobs au 11/10.
- VERSIONING §8 : lignes composants manquantes — Launcher 0.1.0,
  syne-mock 0.1.0, ECHOS 0.1.0, PRISM sans version propre (DRAFT).
- Badges : CI + Tests 1 258 + Couverture ≥ 80 % (README racine, ancre §5),
  contrat obs. 0.2.1 → 0.4.0, docs-syne 634 / 87,4 %, docs-echos 361 /
  90,5 %, ligne Launcher ajoutée à la table des composants.
- API_CONTRACTS : « implémentation actuelle, contrat 0.2.1 » → contrat
  courant 0.4.0 ; en-têtes VERSIONING / docs-syne / docs-prism au 12/10.
- Lignes de version dans syne/README, echos/README, launcher/README,
  syne-mock/README (48 tests) ; docs-launcher dans l'arborescence README.

Vérifié le 12/10 : suites SYNE 634, Launcher 217, ECHOS 361+14 ignorés,
syne-mock 46+2 ignorés, tokei 13.0.0 sur les fichiers suivis.

🤖 Generated with Codebuff
Co-Authored-By: Codebuff <noreply@codebuff.com>

---------

Co-authored-by: protection-test <protection-test@example.com>
Co-authored-by: Codebuff <noreply@codebuff.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@donovan-dev-web