A Wiki in Doli capdoliwiki

Étapes: ouvrir la configuration du module (admin/setup.php), modifier une constante (ex. durée du verrou, largeur max des images, rétention corbeille) et enregistrer. Attendu: les constantes CAPDOLIWIKI_* sont persistées et prises en compte; aucune erreur à l'enregistrement.

Étapes: ouvrir la page à propos (admin/about.php); envoyer un message de feedback. Attendu: l'encart infos module (version, éditeur, licence, versions min Dolibarr/PHP), le formulaire de feedback, l'encart de don et les liens utiles s'affichent; l'envoi du feedback fonctionne (ou journalise l'erreur le cas échéant).

Précondition: instance de test (CAPDOLIWIKI_ALLOW_DEMO_DATA = 1 ou MAIN_FEATURES_LEVEL >= 2). Étapes: onglet Mode démonstration de la configuration, cocher la confirmation, générer ; relancer la génération sans purge ; puis supprimer les données de démonstration. Attendu: le wiki d'une entreprise de 50 salariés est créé (plus de 400 pages par service, historique sur onze mois daté depuis le jour de la génération, tags, liens, schémas, quatorze comptes en trois groupes) ; une seconde génération ne duplique rien ; la purge supprime tout ce qui a été créé.

Précondition: installation sans CAPDOLIWIKI_ALLOW_DEMO_DATA, MAIN_FEATURES_LEVEL inférieur à 2 et sans DEMO_INSTANCE. Étapes: tenter de générer puis de purger les données de démonstration. Attendu: les deux actions sont refusées avec un message ; aucune page ni aucun compte n'est créé ou supprimé.

Étapes: supprimer une page depuis la liste ou la fiche. Attendu: la page passe en corbeille (statut -1) avec date et auteur de suppression; elle disparaît de l'arborescence active mais reste récupérable.

Précondition: une page en corbeille. Étapes: ouvrir la corbeille et restaurer la page. Attendu: la page revient à l'état publié et réapparaît dans l'arborescence; les champs de suppression sont réinitialisés.

Précondition: une page en corbeille, utilisateur avec droit delete. Étapes: supprimer définitivement la page depuis la corbeille. Attendu: la page, toutes ses versions, ses verrous et son répertoire de fichiers sont supprimés définitivement; l'opération est journalisée.

Étapes: tenter de supprimer la page racine "index". Attendu: aucune action de suppression n'est proposée pour la page index; une tentative directe est refusée. La page d'accueil du wiki reste toujours disponible.

Précondition: CAPDOLIWIKI_TRASH_RETENTION_DAYS > 0, une page en corbeille depuis plus longtemps que ce délai. Étapes: exécuter la tâche cron de purge (cron/purge_trash.php). Attendu: les pages en corbeille au-delà du délai de rétention sont supprimées définitivement; avec la valeur 0, aucune purge n'a lieu.

Précondition: une page en corbeille. Étapes: ouvrir directement son édition ; consulter son historique avec un simple lecteur. Attendu: l'édition est refusée tant que la page n'est pas restaurée ; l'historique n'est pas visible d'un simple lecteur.

Étapes: ouvrir edit.php sur une page contenant du Markdown varié (titres, listes, gras, code). Attendu: l'éditeur Milkdown se charge et affiche le rendu WYSIWYG du Markdown; la saisie met à jour le champ caché wiki_content; l'enregistrement conserve le Markdown.

Étapes: dans l'éditeur, tester chaque bouton de la toolbar: gras, italique, titres, listes, lien, code, ligne horizontale, plein écran. Attendu: chaque bouton applique le formatage attendu sur la sélection ou à la position du curseur.

Étapes: modifier une page sans enregistrer, quitter/recharger la page d'édition. Attendu: un brouillon est sauvegardé périodiquement en localStorage; au retour, une proposition de restauration du brouillon est offerte; après enregistrement réel, le brouillon est effacé.

Étapes: dans l'éditeur, tester Ctrl+S (enregistrer), Ctrl+Shift+F (plein écran), Échap (quitter le plein écran). Attendu: Ctrl+S soumet le formulaire; Ctrl+Shift+F bascule en plein écran; Échap en sort.

Étapes: depuis une page, lancer l'export PDF de la page seule (export_pdf.php). Attendu: un PDF (TCPDF) est généré avec le titre et le contenu Markdown converti en HTML mis en forme; les images et la mise en page sont correctes.

Précondition: une page ayant des sous-pages. Étapes: lancer l'export PDF de la branche (page + sous-pages). Attendu: le PDF contient la page et toutes ses sous-pages collectées récursivement, dans l'ordre hiérarchique.

Étapes: modifier une page et l'enregistrer plusieurs fois, éventuellement avec un commentaire de version. Attendu: chaque enregistrement crée une nouvelle entrée de version (numéro incrémenté); l'historique (history.php) liste toutes les versions avec auteur, date et commentaire.

Étapes: dans l'historique, sélectionner deux versions et afficher le diff. Attendu: un diff LCS met en évidence les ajouts et suppressions ligne à ligne entre les deux versions.

Étapes: depuis l'historique, restaurer une version antérieure. Attendu: le contenu et le titre de la version choisie deviennent le contenu courant; une nouvelle version est créée (le rollback ne détruit pas l'historique).

Étapes: dans l'éditeur, coller une image depuis le presse-papier (capture d'écran). Attendu: l'image est uploadée via ajax/upload_image.php, redimensionnée côté serveur (GD) selon CAPDOLIWIKI_IMAGE_MAX_WIDTH et CAPDOLIWIKI_IMAGE_QUALITY, puis insérée dans le contenu; le fichier est rangé dans le répertoire de la page.

Étapes: glisser-déposer un fichier image dans l'éditeur. Attendu: même comportement que le collage (upload + redimensionnement + insertion), sans erreur.

Étapes: consulter une page contenant des images; vérifier l'URL de service des images (ajax/viewimage.php ou document.php). Attendu: les images s'affichent; l'accès au fichier respecte le contrôle de permission du wiki (pas d'accès direct sans droit de lecture).

Étapes: ouvrir l'onglet Pièces jointes d'une page, envoyer un fichier, consulter la liste, supprimer le fichier (droit d'écriture). Attendu: le fichier est rangé dans le répertoire de la page et listé avec sa taille ; la suppression fonctionne avec le droit d'écriture ; les images collées dans l'éditeur apparaissent aussi dans cet onglet.

Étapes: coller une image dans l'éditeur ; dans la fenêtre qui s'ouvre, choisir originale, grande (800 px), moyenne (480 px) puis petite (160 px) sur quatre collages. Attendu: chaque image est insérée à la taille choisie et la garde après enregistrement ; en lecture, un clic l'affiche en plein écran.

Précondition: module capDoliWiki non activé. Étapes: Accueil > Configuration > Modules/Applications, rechercher capDoliWiki, cliquer pour l'activer. Attendu: le module passe à l'état actif sans erreur; une entrée de menu "Wiki" apparaît; les tables llx_capdoliwiki_page, _page_version, _page_lock, _page_link et _categorie_capdoliwiki_page sont créées; une page racine "index" existe et n'est pas supprimable.

Étapes: désactiver le module puis le réactiver. Attendu: aucune erreur; les pages existantes et leur historique sont conservés; les migrations (colonne content_plain, index FULLTEXT sur MySQL, backfill) se rejouent sans casse; la constante CAPDOLIWIKI_MODULE_VERSION reflète la version active.

Précondition: page avec des blocs de code fences (php, js, etc.). Étapes: consulter la page (page.php). Attendu: les blocs de code sont colorés par Prism.js (15 langages supportés); pas de bloc mermaid coloré par erreur.

Précondition: page avec un bloc ```mermaid (ex. flowchart). Étapes: consulter la page. Attendu: le bloc mermaid est remplacé par un SVG rendu; le chunk Mermaid (~3 Mo) est chargé dynamiquement uniquement si un diagramme est présent.

Précondition: page avec des blocs :::info, :::tip, :::warning, :::danger. Étapes: consulter la page. Attendu: chaque bloc est rendu en encart stylisé avec la couleur/icône correspondant au type.

Précondition: page avec plusieurs titres (h2/h3). Étapes: consulter la page. Attendu: une table des matières est générée dans la sidebar sticky; les liens pointent vers les sections; comportement responsive correct.

Étapes: survoler un titre; consulter une image ayant un texte alternatif. Attendu: un lien d'ancre (#) apparaît au survol des titres et copie l'URL de la section; les images avec alt sont enveloppées dans figure/figcaption affichant la légende.

Étapes: cliquer sur une image; tester les raccourcis E (éditer), H (historique), flèches (navigation). Attendu: le clic ouvre l'image en lightbox (GLightbox, zoom); E ouvre l'édition, H l'historique, les flèches naviguent entre pages.

Précondition: une page A contenant une syntaxe [[Titre d'une page B]]. Étapes: consulter la page A. Attendu: le wikilink est rendu comme un lien cliquable vers la page B; le lien mène bien à la bonne page.

Précondition: plusieurs pages pointant (via wikilink) vers la page cible C. Étapes: consulter la page C. Attendu: la liste des backlinks (pages qui référencent C) est affichée et chaque entrée est cliquable.

Précondition: au moins une page qu'aucune autre ne référence. Étapes: ouvrir la page de maintenance (maintenance.php). Attendu: la page orpheline apparaît dans la liste des pages orphelines; un message s'affiche s'il n'y en a aucune.

Étapes: créer une page A avec un wikilink [[Page inexistante]]; vérifier la maintenance (lien cassé signalé); créer ensuite la page cible portant ce titre. Attendu: tant que la cible n'existe pas, le lien est signalé comme cassé; à la création de la page cible, les liens entrants sont réconciliés automatiquement et ne sont plus cassés.

Étapes: dans l'éditeur, déclencher la recherche de page (ajax/pages_search.php) en saisissant quelques lettres du titre. Attendu: la liste des pages correspondantes est proposée; la sélection insère un wikilink correct vers la page choisie.

Étapes: ouvrir la page de maintenance (maintenance.php). Attendu: la page liste les pages orphelines et les wikilinks cassés, avec des liens cliquables vers les pages concernées; des messages dédiés s'affichent quand il n'y a ni orphelines ni liens cassés.

Étapes: ouvrir la page d'accueil du wiki (index.php) avec plusieurs pages parent/enfant. Attendu: l'arborescence hiérarchique s'affiche avec indentation par niveau; la page index apparaît; les dates de modification et auteurs sont corrects.

Étapes: créer une page sans parent, puis créer une seconde page en choisissant la première comme parent. Attendu: la sous-page apparaît sous son parent dans l'arbre; le slug (ref) est généré automatiquement et unique; un suffixe numérique est ajouté en cas de collision de titre.

Précondition: une page imbriquée sur plusieurs niveaux. Étapes: ouvrir la page enfant la plus profonde (page.php). Attendu: le fil d'ariane affiche le chemin complet de la racine jusqu'à la page courante, chaque niveau étant cliquable.

Précondition: utilisateur avec uniquement le droit "Lire les pages wiki". Étapes: ouvrir le wiki, consulter une page. Attendu: la consultation fonctionne; aucun bouton Créer/Modifier/Supprimer n'est proposé; l'accès direct à edit.php est refusé.

Précondition: utilisateur avec droits read + write (sans delete). Étapes: créer une page, la modifier, l'enregistrer. Attendu: création et modification possibles; le bouton de suppression et l'accès à la corbeille restent indisponibles.

Précondition: utilisateur avec droit delete. Étapes: supprimer une page, ouvrir la corbeille, forcer le déverrouillage d'une page verrouillée par un autre utilisateur. Attendu: accès à la corbeille, à la restauration, à la suppression définitive et au forçage de verrou.

Précondition: utilisateur sans aucun droit capdoliwiki. Étapes: tenter d'ouvrir index.php du wiki. Attendu: accès refusé par restrictedArea (message d'erreur Dolibarr), pas de fuite de contenu.

Précondition: une page dont un mot n'apparaît que dans le corps (pas dans le titre). Étapes: saisir ce mot dans la barre de recherche de l'accueil du wiki. Attendu: la page est trouvée (recherche sur le corps, pas seulement le titre); un extrait de contexte est affiché avec le terme surligné.

Étapes: rechercher un terme présent à la fois dans un titre et dans le corps d'autres pages; puis rechercher deux mots. Attendu: les résultats sont classés par pertinence (correspondance de titre remontée en premier); une recherche à plusieurs mots ne retourne que les pages contenant tous les termes (ET).

Étapes: rechercher un terme introuvable; puis rechercher un mot accentué (ex. déploiement). Attendu: un message dédié "aucun résultat" s'affiche quand rien ne correspond; les termes accentués sont correctement trouvés et surlignés.

Précondition: Dolibarr multi-société, une page dans l'entité 2. Étapes: depuis l'entité 1, appeler directement l'édition, l'historique, les pièces jointes, le verrou, la mise en corbeille, la restauration et la suppression définitive de cette page. Attendu: chaque action est refusée et la page de l'autre entité reste intacte.

Étapes: inspecter les liens de suppression de la liste des pages et les liens de restauration et de suppression définitive de la corbeille ; rejouer une action sans jeton. Attendu: chaque lien porte le jeton de session ; une action soumise sans jeton valide est refusée.

Étapes: éditer une page, renseigner des tags dans le champ dédié et/ou utiliser des #tags en ligne dans le contenu, enregistrer. Attendu: les tags saisis et les #tags détectés dans le contenu sont fusionnés puis associés à la page (catégories de type capdoliwiki_page); les tags s'affichent sur la fiche en lecture.

Étapes: ouvrir la page des tags (tags.php); cliquer sur un tag. Attendu: un nuage de tags s'affiche avec les libellés existants; le clic sur un tag liste toutes les pages portant ce tag.

Étapes: dans le champ de tags en édition, commencer à saisir quelques lettres. Attendu: l'autocomplétion (ajax/tags.php) propose les tags existants correspondants; la sélection ajoute le tag sans doublon.

Étapes: ouvrir une page en édition avec l'utilisateur A. Attendu: un verrou est posé (ajax/lock.php) pour la durée CAPDOLIWIKI_LOCK_DURATION; un heartbeat rafraîchit le verrou tant que l'édition est ouverte.

Précondition: page ouverte en édition par l'utilisateur A. Étapes: l'utilisateur B tente d'éditer la même page. Attendu: B est averti que la page est verrouillée par A et ne peut pas écraser; il peut consulter en lecture.

Précondition: page verrouillée par un autre utilisateur. Étapes: un utilisateur avec droit delete force le déverrouillage. Attendu: le verrou est supprimé; l'admin peut éditer; une trace est journalisée (dol_syslog).