📘 Documentation — CV Luvumbu

1. 🧭 Présentation

CV Luvumbu est une application web (PHP / MySQL) pour créer, mettre en forme, partager et suivre des CV.

• Éditeur WYSIWYG : l'aperçu à l'écran = le rendu imprimé / PDF.
• Modèles de CV (dont « Tableautier / DC2Scale »), couleurs, sections.
• Export PDF via l'impression du navigateur.
• Partage public par lien + QR code (sans compte).
• Corbeille (suppression douce, restauration).
• Suivi de candidatures et API REST par clé.
• Connexion par identifiants de base, par e-mail ou via Google.

2. 🔑 Connexion

Le point d'entrée index.php redirige automatiquement :

Trois façons de se connecter

• Identifiant + mot de passe de la base de données (méthode garantie, la « solution ultime »). L'identifiant = l'utilisateur MySQL (ex. root), le mot de passe = celui de la base (pas hPanel).
• E-mail + mot de passe si un e-mail a été enregistré dans les Paramètres.
• Se connecter avec Google (adresse devant figurer dans la liste blanche).

3. 📊 Tableau de bord

Page d'accueil une fois connecté (dashboard.php). Elle sert au suivi des candidatures (§9) et affiche des statistiques : total, en attente, réponses positives/négatives, relances programmées et relances à faire (date atteinte ou dépassée).

4. 🗂️ Mes CV

mes_cv.php liste vos CV actifs. Pour chacun : ✏️ Éditer, 👁️ Aperçu, 🔗 Partager, 🗑️ Supprimer (corbeille).

En haut : ➕ Nouveau CV, 🗑️ Corbeille, et une aide contextuelle (pastilles ⓘ + un Mode aide qui affiche toutes les explications).

5. 🎨 Éditeur de CV (WYSIWYG)

L'éditeur cv_builder.php s'appuie sur le moteur assets/js/cv-builder.js. L'aperçu à droite est exactement le rendu final.

💾 Enregistrer envoie le profil JSON au serveur. 🎓 Tutoriel lance une visite guidée pas à pas.

6. 🖨️ Aperçu, impression et PDF

cv_view.php?id=… affiche le CV au format A4, identique à l'éditeur. Bouton 🖨 Imprimer / Enregistrer en PDF → choisir « Enregistrer au format PDF » comme imprimante.

7. 🔗 Partage public + QR code

Depuis Mes CV → 🔗 Partager, l'application crée un jeton (share_token) et fournit :

• un lien public cv_public.php?token=… (visible sans compte) ;
• un QR code vers ce lien ;
• un partage désactivable à tout moment (le lien cesse de fonctionner).

8. 🗑️ Corbeille

Supprimer un CV le place en corbeille (suppression douce, colonne deleted_at). Depuis la corbeille : ♻️ Restaurer ou ❌ Supprimer définitivement.

9. 💼 Suivi des candidatures

10. ⚙️ Paramètres

1. Connexion avec Google
   ├─ Statut (Activée / Désactivée)
   ├─ Comptes Google autorisés  → liste + Ajouter / Retirer
   └─ Configuration avancée (ID client / secret)   (replié)
2. Mon compte administrateur
   ├─ Adresse e-mail
   └─ Changer le mot de passe
3. Clés API

11. 🟦 Connexion avec Google

Fonctionne « clés en main ». Sécurité par liste blanche :

1. Paramètres → Connexion avec Google → Comptes Google autorisés.
2. Ajouter votre adresse Gmail.
3. Se déconnecter, puis tester « Se connecter avec Google ».

Clic « Se connecter avec Google » → choix du compte
   ├─ adresse autorisée → connecté
   └─ adresse absente   → refusé

12. 🔁 Mot de passe oublié

1. Lien « Mot de passe oublié ? » sur la connexion.
2. Saisir l'identifiant ou l'e-mail.
3. Réception d'un lien valable 1 h, à usage unique.
4. Ouvrir reset_password.php?token=… et choisir un nouveau mot de passe.

13. 🔌 Clés API (côté utilisateur)

Paramètres → Clés API : nom + permissions. La clé cvk_… n'est affichée qu'une fois (seul son SHA-256 est stocké). Révocation immédiate possible.

Permissions

cv:read, cv:write, cv:delete, profile:read, profile:write.

curl -H "X-API-Key: cvk_xxxx" https://luvumbu.com/cv_luvumbu/api/cv.php

14. 🩺 Matrice de santé

Sur architecture.php, bouton « Matrice de santé — Afficher ». Une fois ouverte, elle se rafraîchit toutes les 4 s et indique, par pastille 🟢/🟡/🔴 : configuration, base, tables (présence + lignes), modules et API. « Masquer » arrête le polling ; il se met aussi en pause si l'onglet est caché.

A. 🏗️ Architecture technique

Application PHP procédurale, sans framework :

• Pages (*.php racine) : écrans visibles.
• Modules (includes/) : logique réutilisable.
• API (api/) : endpoints JSON.
• Assets (assets/) : CSS, JS (dont cv-builder.js), images.
• Config (config/config.php) : généré, jamais versionné.

B. 📋 Pré-requis

C. 📁 Arborescence

cv_luvumbu/
├── index.php / install.php / login.php / logout.php
├── forgot_password.php / reset_password.php
├── google_login.php / google_callback.php
├── dashboard.php / mes_cv.php / cv_builder.php
├── cv_view.php / cv_public.php / parametres.php / architecture.php
├── config/config.php          ⚙️ généré — NE PAS versionner
├── includes/  (db, guard, auth, account, password_reset,
│               google_auth, settings, cv, applications, api_keys)
├── api/       (cv.php, cv_profile.php, health.php)
├── assets/    (css, js/cv-builder.js, img)
└── cv_doc/    (index.html  ← cette documentation unique,
                CV-...DC2Scale.pdf  ← CV source,
                _archive/  ← anciens guides conservés pour référence)

D. 💻 Installation locale (XAMPP)

1. Démarrer Apache + MySQL dans XAMPP.
2. Placer le projet dans htdocs/luvumbu/cv_luvumbu.
3. Ouvrir http://localhost/luvumbu/cv_luvumbu/.
4. Assistant : Hôte 127.0.0.1, Base cv_luvumbu, Utilisateur root, Mot de passe vide.
5. Installer et continuer → se connecter avec root + mot de passe vide.

E. 🌐 Installation en production (Hostinger)

1. Créer la base MySQL dans hPanel ; noter nom, utilisateur, mot de passe de la base (≠ mot de passe hPanel).
2. Uploader les fichiers (sans config/config.php ; dossier config/ inscriptible).
3. Ouvrir l'URL → assistant → hôte (souvent localhost), base, utilisateur, mot de passe.
4. Installer et continuer, puis se connecter.

F. 🛠️ L'assistant d'installation (install.php)

1. Connexion MySQL (essaie l'hôte saisi puis localhost↔127.0.0.1).
2. Création de la base si le droit existe, sinon utilisation de l'existante.
3. Table users : nettoyage des tables résiduelles si incompatible (évite errno 150), puis création propre.
4. Table api_keys.
5. Compte admin : username = utilisateur BDD, mot de passe = mot de passe BDD (ON DUPLICATE KEY UPDATE).
6. Écriture de config/config.php si tout a réussi.

G. ⚙️ Fichier de configuration

<?php
return array (
  'host'   => '127.0.0.1',
  'port'   => 3306,
  'dbname' => 'cv_luvumbu',
  'user'   => 'root',
  'pass'   => '',
);

H. 🗄️ Base de données

Toutes les tables : InnoDB, utf8mb4_unicode_ci.

Table users

id, username (unique), email (unique, migration), password_hash, must_change_password (migration), created_at.

Table cvs

id, user_id (FK→users, cascade), full_name, title, email, phone, summary, skills, experience, education, profile_json (profil riche, migration), deleted_at (corbeille, migration), share_token (partage, migration), created_at, updated_at.

Table applications

id, user_id (FK, cascade), cv_id (FK→cvs, set null), company, sent_at, status, followup, followup_date (migration), notes, extra_json (migration), created_at, updated_at.

Table api_keys

id, user_id (FK, cascade), label, scopes (migration), key_prefix, key_hash (SHA-256, unique), created_at, last_used_at, revoked_at.

Tables password_resets & settings

Créées automatiquement : jetons de réinitialisation (usage unique, 1 h) ; réglages clé/valeur (config Google, liste blanche).

I. 🔄 Migrations automatiques

Aucune migration manuelle. Les fonctions ensure_* créent les tables manquantes et ajoutent les colonnes au fil des versions. On déploie par simple upload des fichiers, sans toucher à phpMyAdmin.

Colonnes ajoutées : users.email, users.must_change_password, cvs.profile_json, cvs.deleted_at, cvs.share_token, applications.followup_date, applications.extra_json, api_keys.scopes.

J. 🔌 API REST (api/cv.php)

Auth par en-tête X-API-Key (ou Authorization: Bearer). JSON entrant/sortant.

Codes : 200/201 OK · 401 clé KO · 403 permission · 404 introuvable · 405 méthode · 422 champ manquant · 500 serveur.

# Créer un CV
curl -X POST -H "X-API-Key: cvk_xxxx" -H "Content-Type: application/json" \
  -d '{"full_name":"Jean Dupont","title":"Électricien"}' \
  https://luvumbu.com/cv_luvumbu/api/cv.php

# Activer le partage et récupérer l'URL publique
curl -X PUT -H "X-API-Key: cvk_xxxx" -H "Content-Type: application/json" \
  -d '{"id":12,"share":true}' https://luvumbu.com/cv_luvumbu/api/cv.php

K. 🔒 Sécurité

• Mots de passe hachés (password_hash / bcrypt).
• Sessions régénérées à la connexion ; jeton CSRF sur formulaires + API profil.
• Requêtes préparées PDO partout (EMULATE_PREPARES=false).
• Clés API : seul le SHA-256 stocké ; clé en clair affichée une fois ; révocation immédiate.
• Partage : jeton aléatoire 32 car. ; page publique noindex.
• Isolation : toutes les requêtes filtrent par user_id.
• Ne jamais exposer : config/config.php, includes/google_auth.php (secret Google).

L. 💾 Sauvegarde & restauration

Sauvegarder la base + config/config.php.

# Sauvegarde
mysqldump -u UTILISATEUR -p NOM_BASE > sauvegarde.sql
# Restauration
mysql -u UTILISATEUR -p NOM_BASE < sauvegarde.sql

Déploiement d'une mise à jour : sauvegarder → uploader les fichiers (sans écraser config.php) → recharger une page (migrations auto) → vérifier via la matrice de santé.

M. 🚑 Dépannage