« Info::pcGrudGen README » : différence entre les versions

De wiki_pcwiki2
Aller à la navigationAller à la recherche
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é avec g++ ;
  • une page PHP + une grille JavaScript Tabulator par table ;
  • un index.php avec 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>.tgz prê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 :

  1. GRANT automatiques best-effort sur les bases locales (sudo -n -u postgres psql / sudo -n mariadb) ;
  2. connexion avec cascade d'hôtes : host du config → 10.0.2.18 → 10.0.1.18 → bois-dery.fr ;
  3. introspection du schéma ; création idempotente des tables internes lock et labels_in_menu ;
  4. métadonnées : lit metadata.cfg s'il existe, sinon les génère à partir des noms de colonnes ;
  5. génération et compilation des CGI (un PCH partagé accélère la compilation), pages PHP, JS, pages globales ;
  6. 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).