« Info::pcGrudGen README » : différence entre les versions
Aucun résumé des modifications |
Aucun résumé des modifications |
||
| (2 versions intermédiaires par le même utilisateur non affichées) | |||
| Ligne 2 : | Ligne 2 : | ||
[[Info::pcCrudGen premiere version]] | [[Info::pcCrudGen premiere version]] | ||
[[Info::pcCrudgen:script d'exemple de génération de site Web avec gestion CRUD en C++]] | |||
'''Le 16/06/2026:''' | '''Le 16/06/2026:''' '''''Reprise de pcCrudGen par claude:''''' | ||
Le but premier de pcCrudgen est de fabriquer un CRUD sur un SGBD (mariadb, mysql, postgresql, sqlite | |||
= pcCrudGen = | = pcCrudGen = | ||
{| class="wikitable" | {| class="wikitable" | ||
Dernière version du 17 novembre 2026 à 11:32
KEYWORDS: CRUDGEN, PCCRUDGEN
Info::pcCrudGen premiere version Info::pcCrudgen:script d'exemple de génération de site Web avec gestion CRUD en C++
Le 16/06/2026: Reprise de pcCrudGen par claude: Le but premier de pcCrudgen est de fabriquer un CRUD sur un SGBD (mariadb, mysql, postgresql, sqlite
pcCrudGen
| Version | Date | Langage | Licence |
|---|---|---|---|
| 1.55 | 16/11/2026 | C++17 (g++), CMake ≥ 3.16 | Propriétaire (APSI) |
Présentation
pcCrudGen lit le schéma d'une base de données existante (PostgreSQL, MariaDB ou SQLite) et génère une interface web CRUD complète :
- un CGI C++ par table (actions
list,create,update,delete,lock,unlock), compilé avecg++; - une page PHP + une grille JavaScript Tabulator par table ;
- un
index.phpavec menu, thèmes, fontes, About ; - des pages globales : ERD, Description, Doc, Manuel, Requis, Couleurs ;
- un vhost Apache, une configuration d'exécution des CGI, un script de post-installation et un tarball
pcCrudGen.<base>.tgzprêt à être déployé.
Les clés étrangères sont détectées par le nom de colonne : fk_
_<colonne_affichée> (ex. ) produit une jointure et affiche au lieu de l'identifiant.
Installation
Paquets Debian
apt install g++ cmake make ccache libpq-dev libmariadb-dev \
libsqlite3-dev libboost-system-dev libboost-dev nlohmann-json3-dev
# Exécution / déploiement (cible) :
apt install apache2 php-fpm php-pgsql openssh-client tar gzip
# Facultatif (dumps SQL) : postgresql-client mariadb-client sqlite3
Compilation
cd /home/local/src/Atelier/GENERATOR/V1.55.withClass
cmake -B build
cmake --build build -j$(nproc)
Le binaire est build/pcCrudGen (lien symbolique ./pcCrudGen). L'option CMake -DWITH_THEMES=ON active le sélecteur de thèmes dans index.php.
Installation système (pour déployer le générateur sur une VM vierge) :
cmake --install build # /usr/local/{bin,include/pcCrudGen,lib}
Syntaxe
pcCrudGen <moteur> <base> [--deploy]
pcCrudGen -v | --version
pcCrudGen -h | --help
fk_CIP_nom
nom
Élément
Description
Exemple
<moteur>
postgresql, mariadb ou sqlite (alias : postgres, pg, mysql)
pcCrudGen pg tld2
<base>
Nom de la base. Lettres, chiffres, _ - . ; 64 caractères max ; ne commence pas par - ni .. Pour SQLite : identifiant substitué dans {dbname} du chemin du fichier.
pcCrudGen mariadb zorro
--deploy
Après génération, envoie le tarball vers deploy.target (scp), l'extrait (ssh tar xzf) et lance le post-installation distant. Sans cette option, rien ne quitte la machine.
pcCrudGen postgresql tld2 --deploy
-v, --version
Affiche la version et la date du dernier build
pcCrudGen -v
-h, --help
Affiche l'aide
pcCrudGen --help
Toute autre option est refusée (code retour 1).
Mode d'emploi
1. Premier lancement : création de la configuration
pcCrudGen postgresql tld2
Si /var/lib/<moteur>/pcCrudGen.config.json n'existe pas, il est créé avec des valeurs par défaut (mot de passe <A_REMPLIR>) et le programme s'arrête en vous demandant de l'éditer.
2. Éditer la configuration
vim /var/lib/postgresql/pcCrudGen.config.json
Exemple :
{
"database": { "type": "postgresql",
"postgresql": { "host": "127.0.0.1", "port": 5432, "user": "postgres",
"password": "secret", "name": "{dbname}" } },
"site": { "server": "ovh2.pcstreet.org",
"base_url": "https://{dbname}.{server}",
"web_root": "/var/www/html/{dbname}.{server}" },
"deploy": { "target": "ovh2", "php_fpm": "8.4" },
"paths": { "generated_src": "GENERATED/{dbname}/controllers",
"html_dir": "html/{dbname}", "web_dir": "web/{dbname}" },
"cgi": { "cgi_bin_dir": "/var/www/html/{dbname}.{server}/cgi-bin" }
}
Clé
Rôle
database.<moteur>.*
Connexion (host, port, user, password, name ; SQLite : seulement name = chemin du fichier)
site.server
Suffixe DNS du vhost (localhost est remappé sur pcstreet.org)
site.web_root
Racine web générée/déployée
deploy.target
Alias ~/.ssh/config ou user@hôte pour --deploy (vide = pas d'envoi)
deploy.php_fpm
Version PHP-FPM du socket (php8.4-fpm.sock)
paths.*, cgi.cgi_bin_dir
Répertoires de génération et de CGI
{dbname} (en minuscules) et {server} sont substitués partout.
3. Générer
pcCrudGen postgresql tld2
Le programme travaille dans /usr/local/IA/<base>/ (créé si besoin) et enchaîne :
- GRANT automatiques best-effort sur les bases locales (
sudo -n -u postgres psql / sudo -n mariadb) ;
- connexion avec cascade d'hôtes :
host du config → 10.0.2.18 → 10.0.1.18 → bois-dery.fr ;
- introspection du schéma ; création idempotente des tables internes
lock et labels_in_menu ;
- métadonnées : lit
metadata.cfg s'il existe, sinon les génère à partir des noms de colonnes ;
- génération et compilation des CGI (un PCH partagé accélère la compilation), pages PHP, JS, pages globales ;
- staging dans
web_root, écriture du vhost, de la config CGI et du post-install, dump SQL, tarball.
4. Personnaliser les libellés (facultatif)
Fichier metadata.cfg dans /usr/local/IA/<base>/ ; une ligne par colonne, séparateur | :
# table|colonne|titre|infobulle|options
CALIBRE|strNom|Nom du calibre|Nom commercial|
Table et colonne sont comparées sans accents ni casse.
5. Déployer
pcCrudGen postgresql tld2 --deploy
ou manuellement sur le serveur cible :
tar xzf pcCrudGen.tld2.tgz -C /
/home/local/bin/pcCrudGen.tld2.ovh2.pcstreet.org.postinstall.sh
Le post-install est idempotent : droits, bootstrap de /etc/pcCrudGen/config.<vhost>.json depuis le .example (à éditer pour la production), a2ensite, reload Apache. Si le certificat Let's Encrypt est absent : certbot --apache -d <vhost>.
Exemple complet : base MariaDB pcArpScan
Le script exemple_pcArpScan.sh enchaîne compilation (si besoin), vérification de la configuration et génération :
./exemple_pcArpScan.sh # génération locale + tarball
./exemple_pcArpScan.sh --deploy # idem + envoi vers deploy.target
./exemple_pcArpScan.sh --reconfigure # refaire le questionnaire
Si /var/lib/mariadb/pcCrudGen.config.json n'existe pas, le script vous interroge (hôte, port, utilisateur, mot de passe saisi deux fois sans écho, domaine, cible ssh — « aucune » pour ne pas déployer —, version PHP-FPM), affiche un récapitulatif, demande confirmation puis écrit le fichier (droits 640). Les réponses sont validées avec la même liste blanche que le générateur. --reconfigure reposera les questions (ancien fichier sauvegardé en .bak). Ce fichier est commun à toutes les bases MariaDB générées sur la machine. Résultats : /usr/local/IA/pcArpScan/GENERATED/pcarpscan/controllers et /usr/local/IA/pcArpScan/pcCrudGen.pcarpscan.tgz.
Équivalent manuel : pcCrudGen mariadb pcArpScan.
Fichiers produits
Chemin
Contenu
GENERATED/<base>/controllers/
Sources C++ des CGI + cgi_pch.hpp(.gch)
html/<base>/, web/<base>/
Pages PHP, JavaScript Tabulator
<web_root>/
Site prêt à servir (php/ js/ css/ cgi-bin/ sql/)
/etc/apache2/sites-available/<vhost>.conf
Vhost HTTP + HTTPS
/etc/pcCrudGen/config.<vhost>[.example].json
Configuration d'exécution des CGI (mot de passe : droits 0640, groupe www-data)
pcCrudGen.<base>.tgz
Tarball portable (site + vhost + config + post-install + toolkit sous /usr/local)
Sécurité
- Toutes les valeurs interpolées dans des commandes shell (chemins, hôtes, utilisateur, cible ssh, nom de base) sont validées par liste blanche avant usage ; une valeur douteuse arrête le programme avec un message explicite.
- Les CGI générés utilisent des requêtes préparées ; les noms de colonnes venant du JSON sont filtrés par une liste blanche issue du schéma.
web_root/sql/ (dumps schéma + données) est protégé par un .htaccess « Require all denied » ; il reste présent dans le tarball.
- Les mots de passe des dumps passent par l'environnement (
PGPASSWORD, MYSQL_PWD) et non en argument visible dans ps.
- Attention : le fichier
.example.json embarqué dans le tarball contient le mot de passe de la base de développement. Ne diffusez pas le tarball hors de vos serveurs.
Dépannage
Symptôme
Cause / solution
« CONFIG CREEE — A REVISER »
Normal au premier lancement : éditer le JSON puis relancer.
« Aucun hôte DB joignable »
Vérifier host/user/password ; la cascade essaie 4 hôtes.
« Configuration : caractère interdit dans … »
Une valeur du config contient un caractère non autorisé (espace, ;, '…). La corriger.
« compile raté » (WARN)
Lire l'erreur g++ au-dessus ; vérifier que build/libpccrudgen_multi.a existe (sinon cmake --build build).
Reload Apache échoué
Certificat SSL absent : certbot --apache -d <vhost>.
Pagination : une seule page
Corrigé en 1.55 (comptage exact sous 100 000 lignes).
Historique
1.55 (16/11/2026)
- Correctif :
--deploy était ignoré ; scp/ssh partaient dès que deploy.target était renseigné. L'envoi n'a plus lieu que si --deploy est donné.
- Correctif : options inconnues et arguments en trop refusés (une faute de frappe devenait un nom de base).
- Sécurité : validation par liste blanche (config + CLI) contre l'injection shell ; quoting des mots de passe de dump ; répertoire de staging créé par
mkdtemp ; sql/ interdit en HTTP ; config avec mot de passe en 0640 ; requêtes d'introspection échappées.
- CGI générés : clé primaire numérique acceptée (plantage
type_error 302) ; paramètres de requête lus proprement (page ne matche plus last_page) ; pagination exacte pour les tables < 100 000 lignes (reltuples = -1 sous PostgreSQL) ; SQL MariaDB sans nom de base figé (la base de production peut différer).
- Introspection : colonnes triées par
ordinal_position (ordre déterministe).
- Interface : version affichée dans « About » dynamique (était « 1.45 » en dur) ; Tabulator 6.2 ; code mort supprimé.
Améliorations suggérées (non faites)
- Menu : la liste
CALIBRE, CIP, ARME… est codée en dur dans ClassHtmlGenerator ; la sortir en configuration.
index.php ne charge les libellés labels_in_menu que pour PostgreSQL (MariaDB/SQLite : repli sur le nom brut).
- Les
std::system() restants gagneraient à être remplacés par posix_spawn sans shell.
- Les classes
ClassDatabase / ClassSchemaLoader (mode MONOBASE) sont signalées orphelines.
- Ajouter des tests automatiques (génération sur SQLite temporaire + exécution du CGI).