Bibliothèque d'éléments Plaisir-Maths : liens vers des maîtres, visserie, panneau, Publier et Vérifier #9

Merged
pgp merged 7 commits from bibliotheque into main 2026-11-18 15:54:16 +00:00
Contributor

Contenu

Implémente la bibliothèque d'éléments Plaisir-Maths (spécification CONCEPTION/Bibliothèque/Bibliothèque - spécification.md, § 6 et § 8.1) : un seul nom et une seule référence pour une pièce partagée entre plusieurs jeux.

  • Export : une pièce venue d'un App::Link vers un maître prend nom, référence, matériau, procédé, volume et dimensions du maître. Champ optionnel bibliotheque dans pieces[] (chemin relatif à CONCEPTION/Bibliothèque/), format v1 inchangé. Exemple : docs/exemples/bom-avec-bibliotheque.json.
  • Fichiers : les fichiers STEP/3MF d'un élément sont écrits dans l'export de chaque jeu, nommés d'après pm_nom (Cheville jaune.step). Variante retenue du § 6.1 « à défaut ».
  • Quantités : liens, tableaux de liens (ElementCount), clones Draft d'un lien.
  • Miroirs (règle de Pierre du 06/11) : un Part::Mirroring est une pièce différente (nom et référence propres). Propriété pm_miroir sur le miroir : piece_differente (défaut) ou memes_pieces (original + image = 2 exemplaires par unité de pm_quantite, pour une pièce, un élément, une vis ou un composé). « Ajouter les propriétés » la pré-remplit d'après le comptage d'avant ; le Ménage affiche la colonne. pm_symetrique est supprimé.
  • Visserie Fasteners : reconnue sans maître, cherchée dans Visserie/Visserie.csv ; procédé achat, nom et référence de la table ; ligne absente : avertissement avec la ligne à ajouter et nom canonique.
  • Avertissements : miroir sans pm_miroir dont l'image est identique à sa source, miroir en pièce différente sans nom ni référence, miroir memes_pieces avec quantité > 1, lien ou maître introuvable (pièce ignorée), maître avec modifications non enregistrées, apparence remplacée (Override Material), pièce locale avec référence de la plage 1500-1599, ressemblance à un élément (nom ou géométrie à 0,1 %).
  • Interface : panneau « Bibliothèque » (arbre, vignettes, recherche, Insérer), commandes « Publier dans la bibliothèque » et « Vérifier la bibliothèque » (génère bibliotheque.json).

Écarts avec la spécification (vérifiés sous FreeCAD 1.1.3)

  • Un App::Link transmet ShapeMaterial à sa cible : affecter le matériau d'un lien écrit dans le maître. Pas de surcharge de matériau possible côté objet (règles retenues avec toutatis-app : matériau lu sur le maître, avertissement si le maître est modifié).
  • Maître d'une variante de couleur : un App::Link seul ne convient pas (les quatre couleurs partageraient le matériau de la géométrie). Structure testée : clone Draft (_STEP, matériau propre) d'un App::Link local vers <Famille> - géométrie.FCStd. Chemins relatifs vérifiés entre deux arbres, y compris après ré-enregistrement.
  • Fasteners : la propriété de norme est Type (pas baseType).
  • Test « image identique à la source » : volume et boîte à 0,1 % (spécification), puis recouvrement des formes une fois les boîtes alignées. Sans ce second test, tout miroir par un plan aligné sur les axes serait signalé, tiroirs et coins compris.
  • Un tableau de liens est suivi par LinkedObject : getLinkedObject(True) renvoie le lien lui-même.

Vérification

FreeCAD 1.1.3 sans interface, sur des copies :

  • Comparaison avec les bom.json existants : ADP, HexaGo (hors vis) et Hex Junior/Hex Voyage (hors vis) identiques.
  • Bibliothèque et CAD de jeu synthétiques : lien, tableau de liens (x3), clone Draft d'un lien, miroir symétrique (x2), miroir non symétrique (avertissement), lien cassé, copie locale, ressemblance, maître modifié, export des fichiers, publication (maître créé, liens, clones d'un autre matériau laissés en place, ligne dans Table des références.csv), insertion.
  • Panneau et boîte de publication instanciés dans une application Qt offscreen : liste, recherche, insertion.

Non vérifié

  • Interface réelle de FreeCAD : barre d'outils, panneau ancré, vignettes, boîtes de dialogue modales, Override Material. Seuls les widgets ont été testés hors fenêtre principale.
  • Bibliothèque réelle : aucun fichier maître n'existe encore (à créer par Pierre avec le module).
  • Fichiers sur plusieurs machines : seulement simulé par copie d'arbre.

Reprise des documents existants (essai sur copies, après « Ajouter les propriétés »)

Aucune quantité ne change, sauf les vis (renommées d'après Visserie.csv, memes_pieces) : Hex Junior x2 ; Hex Voyage et HexaGo x4 tant que pm_quantite du miroir vaut 2 (à ramener à 1 par Pierre, avertissement émis). ADP et Portique : identiques. Sans le pré-remplissage, Hex Junior changerait en silence (chevilles vertes 8 -> 4, Compound004 (Mirror #6) deviendrait une pièce) : le pré-remplissage est donc nécessaire.

À vérifier avec Pierre

  • Les valeurs pré-remplies de pm_miroir (liste transmise à toutatis-app).
  • references.py : H14_LUXE passe à 1600 et LABYCOOP à 1700 (la plage 1500-1599 est réservée à la bibliothèque).

🤖 Generated with Claude Code

https://claude.ai/code/session_01LS84uAQiGAWYafoV5kLXRa

## Contenu Implémente la bibliothèque d'éléments Plaisir-Maths (spécification `CONCEPTION/Bibliothèque/Bibliothèque - spécification.md`, § 6 et § 8.1) : un seul nom et une seule référence pour une pièce partagée entre plusieurs jeux. - **Export** : une pièce venue d'un `App::Link` vers un maître prend nom, référence, matériau, procédé, volume et dimensions du maître. Champ optionnel `bibliotheque` dans `pieces[]` (chemin relatif à `CONCEPTION/Bibliothèque/`), format v1 inchangé. Exemple : `docs/exemples/bom-avec-bibliotheque.json`. - **Fichiers** : les fichiers STEP/3MF d'un élément sont écrits dans l'export de chaque jeu, nommés d'après `pm_nom` (`Cheville jaune.step`). Variante retenue du § 6.1 « à défaut ». - **Quantités** : liens, tableaux de liens (`ElementCount`), clones Draft d'un lien. - **Miroirs (règle de Pierre du 06/11)** : un `Part::Mirroring` est une pièce différente (nom et référence propres). Propriété `pm_miroir` sur le miroir : `piece_differente` (défaut) ou `memes_pieces` (original + image = 2 exemplaires par unité de `pm_quantite`, pour une pièce, un élément, une vis ou un composé). « Ajouter les propriétés » la pré-remplit d'après le comptage d'avant ; le Ménage affiche la colonne. `pm_symetrique` est supprimé. - **Visserie Fasteners** : reconnue sans maître, cherchée dans `Visserie/Visserie.csv` ; procédé `achat`, nom et référence de la table ; ligne absente : avertissement avec la ligne à ajouter et nom canonique. - **Avertissements** : miroir sans `pm_miroir` dont l'image est identique à sa source, miroir en pièce différente sans nom ni référence, miroir `memes_pieces` avec quantité > 1, lien ou maître introuvable (pièce ignorée), maître avec modifications non enregistrées, apparence remplacée (Override Material), pièce locale avec référence de la plage 1500-1599, ressemblance à un élément (nom ou géométrie à 0,1 %). - **Interface** : panneau « Bibliothèque » (arbre, vignettes, recherche, Insérer), commandes « Publier dans la bibliothèque » et « Vérifier la bibliothèque » (génère `bibliotheque.json`). ## Écarts avec la spécification (vérifiés sous FreeCAD 1.1.3) - Un `App::Link` transmet `ShapeMaterial` à sa cible : affecter le matériau d'un lien écrit dans le maître. Pas de surcharge de matériau possible côté objet (règles retenues avec toutatis-app : matériau lu sur le maître, avertissement si le maître est modifié). - **Maître d'une variante de couleur** : un `App::Link` seul ne convient pas (les quatre couleurs partageraient le matériau de la géométrie). Structure testée : clone Draft (`_STEP`, matériau propre) d'un `App::Link` local vers `<Famille> - géométrie.FCStd`. Chemins relatifs vérifiés entre deux arbres, y compris après ré-enregistrement. - Fasteners : la propriété de norme est `Type` (pas `baseType`). - Test « image identique à la source » : volume et boîte à 0,1 % (spécification), puis recouvrement des formes une fois les boîtes alignées. Sans ce second test, tout miroir par un plan aligné sur les axes serait signalé, tiroirs et coins compris. - Un tableau de liens est suivi par `LinkedObject` : `getLinkedObject(True)` renvoie le lien lui-même. ## Vérification FreeCAD 1.1.3 sans interface, sur des copies : - Comparaison avec les `bom.json` existants : ADP, HexaGo (hors vis) et Hex Junior/Hex Voyage (hors vis) identiques. - Bibliothèque et CAD de jeu synthétiques : lien, tableau de liens (x3), clone Draft d'un lien, miroir symétrique (x2), miroir non symétrique (avertissement), lien cassé, copie locale, ressemblance, maître modifié, export des fichiers, publication (maître créé, liens, clones d'un autre matériau laissés en place, ligne dans `Table des références.csv`), insertion. - Panneau et boîte de publication instanciés dans une application Qt offscreen : liste, recherche, insertion. ## Non vérifié - **Interface réelle de FreeCAD** : barre d'outils, panneau ancré, vignettes, boîtes de dialogue modales, `Override Material`. Seuls les widgets ont été testés hors fenêtre principale. - Bibliothèque réelle : aucun fichier maître n'existe encore (à créer par Pierre avec le module). - Fichiers sur plusieurs machines : seulement simulé par copie d'arbre. ## Reprise des documents existants (essai sur copies, après « Ajouter les propriétés ») Aucune quantité ne change, sauf les vis (renommées d'après `Visserie.csv`, `memes_pieces`) : Hex Junior x2 ; Hex Voyage et HexaGo x4 tant que `pm_quantite` du miroir vaut 2 (à ramener à 1 par Pierre, avertissement émis). ADP et Portique : identiques. Sans le pré-remplissage, Hex Junior changerait en silence (chevilles vertes 8 -> 4, `Compound004 (Mirror #6)` deviendrait une pièce) : le pré-remplissage est donc nécessaire. ## À vérifier avec Pierre - Les valeurs pré-remplies de `pm_miroir` (liste transmise à `toutatis-app`). - `references.py` : `H14_LUXE` passe à 1600 et `LABYCOOP` à 1700 (la plage 1500-1599 est réservée à la bibliothèque). 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01LS84uAQiGAWYafoV5kLXRa
Spécification : CONCEPTION/Bibliothèque/Bibliothèque - spécification.md (§ 6, § 8.1).

- bibliotheque.py : emplacement, maîtres, index bibliotheque.json, Visserie.csv, ressemblance,
  prochaine référence libre (1500-1599), insertion par App::Link relatif, publication.
- Export : une pièce venue d'un lien prend tout du maître ; champ optionnel « bibliotheque »
  (format v1 inchangé) ; identité des objets par (document, nom) ; fichiers nommés d'après pm_nom.
- Tableaux de liens (ElementCount) comptés ; un lien est suivi par LinkedObject (getLinkedObject
  renvoie le lien lui-même pour un tableau).
- Miroirs : le miroir d'un élément symétrique (pm_symetrique) ou de la visserie compte comme une
  instance de plus ; sinon pièce distincte avec avertissement.
- Visserie Fasteners : procédé achat, nom et référence de Visserie.csv, avertissement avec la ligne à ajouter.
- Avertissements : lien cassé, maître modifié non enregistré, Override Material, copie locale (plage
  1500-1599), ressemblance à un élément.
- Panneau « Bibliothèque », commandes « Publier dans la bibliothèque » et « Vérifier la bibliothèque ».
- Un maître de couleur est un clone Draft d'un lien local vers la géométrie : un App::Link seul
  transmet ShapeMaterial à la géométrie.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LS84uAQiGAWYafoV5kLXRa
Décision de Pierre du 06/11 (spécification § 3, § 5, § 6.1, § 6.2, § 6.5).

- pm_miroir (App::PropertyEnumeration, groupe PlaisirMaths) sur l'objet Part::Mirroring :
  piece_differente (défaut) ou memes_pieces (original + image = 2 exemplaires par unité de pm_quantite,
  pour une pièce, un élément de bibliothèque, une vis Fasteners ou le contenu d'un composé).
- « Ajouter les propriétés » pré-remplit pm_miroir d'après le comptage d'avant, pour les seuls miroirs
  rangés dans une collection : aucune quantité ne change en silence ; le Ménage affiche la colonne.
- Avertissements : miroir sans pm_miroir dont l'image est identique à sa source (volume et boîte à 0,1 %,
  puis recouvrement, pour ne pas signaler les pièces chirales), miroir en pièce différente sans nom ni
  référence, miroir memes_pieces avec pm_quantite > 1.
- pm_symetrique retiré des maîtres et de bibliotheque.json ; la visserie suit la même règle que les autres miroirs.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LS84uAQiGAWYafoV5kLXRa
pgp merged commit 571d1586f0 into main 2026-11-18 15:54:16 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
thomalex.moreau/MultiExport-FreeCAD!9
No description provided.