| name | generating-zoom-sql |
| description | Genere un fichier Zoom SQL (.dhsp) complet avec les 27 procedures obligatoires du cycle de vie ecran CRUD (creation, modification, suppression, consultation). Inclut les appels framework (Select, PreInsert, PostInsert, etc.), la construction de conditions de selection, la gestion des reservations, et les hooks de personnalisation. Ecrit en ISO-8859-1+CRLF. A utiliser pour creer l'interface utilisateur d'une entite metier (troisieme fichier du pattern 3 fichiers).
|
Generating Zoom SQL
Contenu
- Utilisation rapide
- Workflow complet
- Validation
- Scripts disponibles
- References
Utilisation rapide
py .claude/skills/generating-zoom-sql/scripts/generate_zoom.py \
--params --domaine Retail --entite FamRglt --table RtlFamRglt \
--champ-cle RgltFam --description "Famille de reglement" \
--output "output/rttzfamrglt_sql.dhsp"
Workflow complet
1. Generer le fichier .dhsp
Mode autonome (calcul des tokens integre) :
py .claude/skills/generating-zoom-sql/scripts/generate_zoom.py \
--params --domaine {DOMAINE} --entite {ENTITE} --table {TABLE_SQL} \
--champ-cle {CHAMP_CLE} --description "{DESCRIPTION}" \
--output "{fichier_zoom}"
Mode tokens JSON (si les tokens sont deja calcules) :
py .claude/skills/generating-zoom-sql/scripts/generate_zoom.py \
--file tokens.json --output "{fichier_zoom}"
2. Valider le fichier genere
py .claude/skills/generating-zoom-sql/scripts/validate_zoom.py \
--path "{fichier_zoom}" --tokens tokens.json
3. Corriger si erreurs
- Z01 (procedures manquantes) : le template inclut les 27 — si absentes, le template est corrompu
- Z03 (prefixe domaine) : verifier que le bon domaine est passe en parametre
- M04 (majuser=true) : le template l'inclut dans ZoomAvantRewrite
- ENC (encodage) : utiliser le skill
writing-diva-files pour convertir le fichier
4. Verifier l'encodage
Utiliser le skill writing-diva-files pour verifier l'encodage du fichier genere.
Validation
Le script validate_zoom.py verifie 11 categories de regles :
| Regle | Severite | Quoi |
|---|
| Z01 | error | 27 procedures obligatoires presentes |
| Z02 | warning | preturn apres Zoom.OK = 'I'/'S'/'C' |
| Z03 | error | Pas de melange de prefixes domaine |
| Z08 | error | Module ficsql present |
| Z10 | warning | Gestion du prefixe - dans Scevaleur |
| OWB | warning | OverWrittenBy present et coherent |
| M04 | error | majuser=true dans PreUpdate |
| S08 | warning | Zoom.Valretour initialise |
| ENC | error | Encodage ISO-8859-1 + CRLF |
| NAMING_CONV | warning | 4e lettre du nom = z (convention zoom) |
| NAMING | warning | Nommage coherent avec tokens |
Avec --tokens, des verifications croisees supplementaires sont effectuees (Z03, OWB, NAMING).
Scripts disponibles
| Script | Role | Entree | Sortie |
|---|
scripts/generate_zoom.py | Genere le fichier .dhsp | --params (autonome) ou JSON tokens (stdin/fichier) + --output | JSON rapport + fichier .dhsp |
scripts/validate_zoom.py | Valide un .dhsp existant | --path fichier [+ --tokens JSON] | JSON rapport (errors/warnings) |
scripts/templates/zoom_sql.dhsp.j2 | Template Jinja2 | (utilise par generate_zoom.py) | — |
scripts/_naming.py | Calcul des tokens de nommage (vendored) | (utilise par generate_zoom.py en mode --params) | — |
References
- Les 27 procedures avec patterns : Voir reference/zoom-procedures.md
- Regles Z01-Z12 avec exemples : Voir reference/zoom-anti-patterns.md
- Patterns observes dans le corpus (advisory, snapshot de fraicheur inconnue) : Voir reference/corpus-patterns.md — taux de presence des 27 procedures, extensions recurrentes, ecart sur le nom
Construire_Condition_Selection. Croiser avec le filesystem X.13 avant decision.
- Coherence avec le masque .dhsf (normes graphiques) : Voir reference/normes-graphiques.md -- ce skill genere le
.dhsp du zoom ; le .dhsf associe (produit par manipulating-dhsf-screens) doit exposer les champs audit du dictionnaire dans l'onglet Identifiants selon l'ordre canonique. Les 2 fichiers doivent etre coherents (regle E16-E17 verifiee par linting-diva-code).
