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-filespour 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
.dhspdu zoom ; le.dhsfassocie (produit parmanipulating-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 parlinting-diva-code).