Skip to content

CHANGELOG.md

Latest commit

 

History

History
901 lines (740 loc) · 55 KB

CHANGELOG.md

File metadata and controls

901 lines (740 loc) · 55 KB

Changelog — Hypostasia V3

Journal des modifications par phase. Format bilingue FR/EN. Reverse chronological order.

2026-05-02 — Session A.8 : Statuts binaires + drawer-only + FALC additionnel

Quoi / What : simplification massive de la couche debat — ExtractedEntity.statut_debat passe de 6 valeurs (nouveau, discutable, discute, consensuel, controverse, non_pertinent) a 2 valeurs binaires (nouveau, commente) auto-derivees par signal Django depuis l'existence de commentaires. Refonte UX en drawer-only : suppression de la carte inline (fusion vers _card_body.html unique). Retrait additionnel FALC : edition d'extraction, edition/suppression de commentaire, onglet "Tous les commentaires", bouton "Replier la carte", tri "Statut de debat".

Pourquoi / Why : suite logique du brainstorming YAGNI 2026-05-01 et de la session A.7. Les 6 statuts manuels (consensuel/controverse/etc.) demandaient un effort cognitif non valide par l'usage : sur l'instance live, la majorite des entites restaient en "nouveau" et la curation manuelle etait quasi-inexistante. La logique de gating "synthese bloquee si <80% consensus" empechait de lancer des syntheses dont l'utilisateur voulait quand meme tester la qualite. La carte inline + drawer = 2 templates a maintenir pour le meme objet ; la fusion supprime la divergence. Les autres retraits FALC (edition d'extraction, edition/suppression de commentaire, onglet doublon, replier) ciblent des features a usage faible/nul.

Changements principaux / Main changes

  1. Signal Django auto-update : nouveau hypostasis_extractor/signals.py. Le statut statut_debat est auto-derive de l'existence de commentaires (post_save + post_delete sur CommentaireExtraction). Plus de set manuel.
  2. Enum reduit : StatutDebat passe de 6 valeurs a 2 (NOUVEAU, COMMENTE). Migration data + AlterField.
  3. Fusion non_pertinent -> masquee : le statut non_pertinent disparait, ses instances en DB sont fusionnees dans masquee=True. Le champ masquee devient independant du statut.
  4. Action changer_statut retiree : 4 boutons UI supprimes de la carte.
  5. Refonte drawer-only : suppression de carte_inline.html + JS de creation dynamique de carte sous les paragraphes. Clic pastille -> ouvre drawer + scroll vers la carte concernee. Le drawer est l'unique endroit pour voir et commenter une extraction.
  6. _card_body.html unique : retrait du parametre mode, partial unique pour le drawer (et le bottom_sheet mobile). Le formulaire commenter cible closest .extraction-content avec swap outerHTML -> les commentaires apparaissent immediatement sans toast ni rechargement.
  7. Pastille triangle orange : le statut commente s'affiche en triangle orange (clip-path CSS) au lieu d'un cercle vert. Plus distinctif visuellement et coherent avec le code couleur "discussion en cours".
  8. Layout commentaires Facebook-like : pseudo en haut (gras), commentaire en dessous. Plus lisible que l'ancien layout horizontal avec typo Srisakdi.
  9. Dashboard consensus simplifie : graphique 6 segments remplace par barre binaire commentees / total. Le bouton "Lancer la synthese" reste present (sans gate).
  10. _calculer_consensus simplifie de ~30 a ~10 lignes.
  11. Action vue_commentaires retiree + template + onglet "Tous les commentaires" (redondant avec le drawer).
  12. Actions modifier_commentaire + supprimer_commentaire retirees + serializers.
  13. YAGNI edition d'extraction : actions editer + modifier, helper _peut_editer_extraction, bouton "Modifier" et modale d'edition retires entierement.
  14. Tri "Statut de debat" retire du selecteur du drawer (plus de sens binaire).
  15. Bouton "Replier la carte" (▴) retire (drawer a son ✕).
  16. Bouton "tâches" (A.6) : distingue maintenant analyse vs synthese dans le dropdown, lien "Voir le resultat" pointe vers la page V2/V3 creee pour les syntheses.
  17. CSS : 6 paires de variables --statut-* reduites a 2.
  18. Marginalia.js : matrice 6 statuts -> 2 (couleur orange #E69F00 pour commente).
  19. Templates aide (aide_desktop, aide_mobile, onboarding_vide) simplifies : section explicative des 6 statuts -> bloc binaire + mention "le statut est automatique".
  20. Fixtures (charger_fixtures_demo.py) : valeurs riches statut_debat retirees -> nouveau (le signal complete a commente quand les commentaires sont crees).

Migrations DB / DB migrations

  • hypostasis_extractor/migrations/0029_a8_recalcul_statuts_fusion_non_pertinent.py : RunPython qui fusionne non_pertinent -> masquee=True puis recalcule tous les statuts depuis les commentaires (option A : recalcul pur).
  • hypostasis_extractor/migrations/0030_a8_alter_statut_debat_choices.py : AlterField qui reduit l'enum a 2 valeurs.

Solde net / Net balance

  • 8 phases (1-8) + 4-bis : ~-2950 lignes nettes sur cette session
  • Cumul cleanup A.1 -> A.8 : ~15500 lignes net retirees en 8 sessions

Verification anti-regression / Anti-regression check

  • Snapshot tests pre-A.8 : 743 tests / 723 OK / 0 fail / 20 errors préexistantes
  • Snapshot tests post-A.8 : 690 tests / 658 OK / 0 fail / 20 errors préexistantes (mêmes E2E + test_analysis)
  • 53 tests obsoletes retires/adaptes, aucune regression introduite
  • Test UI Chrome : page lecture, drawer Analyses (avec hypostases visibles, commentaires inline, bouton commenter), creation/suppression commentaire (signal -> statut auto), dashboard consensus avec bouton synthese, mobile (bottom_sheet) — tous OK.

Hors perimetre / Out of scope (conserve intact)

  • Synthese deliberative + analyseurs synthetiseurs
  • Versionning de pages (parent_page, versions_enfants)
  • Bouton "Historique" + "Comparer V1↔V2" + tabs versions
  • Suppression d'extraction (btn-supprimer-extraction) + masquer/restaurer
  • Filtre contributeurs avec dimming
  • Bouton "tâches" A.6 + signal WebSocket + dropdown + marquer-lue
  • Systeme de commentaires (CommentaireExtraction)

References / References

  • Spec A.8 : PLAN/A.8-statuts-binaires-fusion-templates-spec.md
  • Plan d'execution : PLAN/A.8-statuts-binaires-fusion-templates-plan.md
  • Spec maître YAGNI : PLAN/REVUE_YAGNI_2026-05-01.md

2026-05-02 — Session A.7 : Retrait Reformulation IA + Restitution IA + Restitution manuelle

Quoi / What : retrait integral des fonctionnalites Reformulation IA, Restitution IA et Restitution manuelle (code mort en pratique : 0/134 extractions utilisaient ces champs en DB, sections invisibles dans l'UI). Conservation totale de la Synthese (seul mecanisme IA reellement utilise) et du versionning de pages (utilise par la Synthese).

Pourquoi / Why : suite logique du brainstorming YAGNI 2026-05-01 (cf. PLAN/REVUE_YAGNI_2026-05-01.md) et de la refonte WebSocket A.6. Audit DB + Chrome a confirme l'absence d'usage : aucune entite avec texte_reformule, aucune avec texte_restitution_ia, aucune restitution_page non-null sur les 134 extractions de l'instance live. Aucun bouton Reformuler/Restituer/Pre-remplir-IA visible dans l'UI courante (sidebar droite cachee + sections conditionnees a des champs DB vides). Le code mort cumule represente une dette technique non justifiee qui complique la refonte RAG a venir.

Changements principaux / Main changes

  1. 2 taches Celery supprimees / 2 Celery tasks removed : reformuler_entite_task (~110 lignes), restituer_debat_task (~115 lignes) dans front/tasks.py.
  2. 9 actions ViewSet retirees / 9 ViewSet actions removed : 3 actions reformulation IA (choisir_reformulateur, previsualiser_reformulation, reformuler), 4 actions restitution IA (choisir_restituteur, previsualiser_restitution, generer_restitution, restitution_ia_status), 1 action restitution manuelle (creer_restitution), 1 action fil_discussion
    • helper _re_rendre_fil_discussion.
  3. 3 serializers retires / 3 serializers removed : RunReformulationSerializer, RunRestitutionSerializer, RestitutionDebatSerializer.
  4. 7 templates supprimes / 7 templates deleted : reformulation_en_cours.html, choisir_reformulateur.html, confirmation_reformulation.html, restitution_ia_en_cours.html, choisir_restituteur.html, confirmation_restitution.html, fil_discussion.html.
  5. 13 champs DB retires / 13 DB fields removed via migration consolidee :
    • ExtractedEntity : texte_reformule, reformule_par, reformulation_en_cours, reformulation_lancee_a, reformulation_erreur, restitution_page, restitution_texte, restitution_date, restitution_ia_en_cours, restitution_ia_lancee_a, restitution_ia_erreur, texte_restitution_ia
    • ExtractionJob : est_reformulation
  6. Enum TypeAnalyseur reduit de 4 a 2 valeurs : suppression de REFORMULER et RESTITUER. Reste ANALYSER + SYNTHETISER.
  7. Modele vestige core.Reformulation supprime : zero usage en code et zero ligne en DB. Heritage d'une architecture TextBlock-based abandonnee.
  8. Related_name renomme : Page.parent_page.related_name passe de restitutions a versions_enfants pour coherence semantique (la Synthese aussi cree des versions enfants).
  9. Templates branches nettoyes : sections {% if reformulation_* %} / {% if restitution_* %} retirees de vue_commentaires.html ; bouton hover btn-commenter-extraction (qui pointait vers fil_discussion) retire de extraction_results.html et bottom_sheet_extraction.html ; logique de timeout reset des reformulations bloquees (~50 lignes) retiree de l'action vue_commentaires ; contexte analyseurs_reformuler_existent / analyseurs_restituer_existent retire des actions ViewSet.
  10. JS nettoye / JS cleaned : handler clic .restitution-ancre retire de hypostasia.js (pastille violette inline orpheline) ; options select <option value="reformuler"> et <option value="restituer"> retirees du SwAlert d'edition d'analyseur.
  11. Templates de l'editeur d'analyseur mis a jour : analyseur_editor.html (2 options <option> retirees), analyseur_item.html (couleur badge bg-amber-400 pour reformuler retiree), modale_prompt_readonly.html (2 branches {% elif %} retirees + ajout d'une branche synthetiser manquante).
  12. Vestige template : core/templates/core/includes/sidebar_items_partial.html referencait block.reformulations.all (related_name du modele supprime). Aurait plante au prochain rendu de la sidebar — VIEW 3 (reformulations), VIEW 7 (edit_reformulations) et bouton toolbar « Re-ecriture » retires (~75 lignes).
  13. 3 fichiers fixtures JSON nettoyes des 13 champs DB retires : exemple_deliberation.json, demo_alignement_versions.json, demo_completes.json.
  14. Fixture analyseur "FALC" (type reformuler) retiree de charger_fixtures_demo.py.
  15. Tests morts retires : 1 classe Phase24IntegrationReformulationMockTest + 4 methodes individuelles dans test_phases.py + adaptation de 3 methodes de tests survivants (Phase04ModifierCommentaireTest, Phase04SupprimerCommentaireTest, Phase24ResolveModelParamsAnthropicTest) qui referençaient des chaines obsoletes.

Migrations DB / DB migrations

  • hypostasis_extractor/migrations/0028_a7_retrait_reformulation_restitution_fields.py : 13 RemoveField + 1 AlterField (TypeAnalyseur).
  • core/migrations/0033_a7_retrait_modele_reformulation.py : 1 DeleteModel.
  • core/migrations/0034_a7_renommer_related_name_versions_enfants.py : 1 AlterField (related_name).

Solde net / Net balance

  • 28 fichiers modifies, 7 templates supprimes, 3 nouvelles migrations
  • +304 / −4794 = −4490 lignes nettes
  • Cumul cleanup A.1 → A.7 : ~12900 lignes net retirees en 7 sessions

Verification anti-regression / Anti-regression check

  • Snapshot tests pre-A.7 : 748 tests, 728 OK, 0 fail, 20 errors (preexistantes E2E playwright + script orphelin)
  • Snapshot tests post-A.7 : 743 tests, 723 OK, 0 fail, 20 errors (memes 20 preexistantes — zero regression introduite)
  • manage.py check : System check identified no issues (0 silenced)
  • Test UI Chrome : page /lire/4/ se charge proprement (33 cartes inline + 59 pastilles + onglets V1/V2/V3/V4 + Synthese deliberative). Endpoint /extractions/vue_commentaires/?page_id=4 rend 77 KB sans aucune ref obsolete. Aucun lien hx-get/hx-post avec URL obsolete dans le DOM.

Hors perimetre / Out of scope (conserve intact)

  • Tache Celery synthetiser_page_task et helper _construire_prompt_synthese
  • Type analyseur SYNTHETISER + 3 analyseurs synthetiseurs en fixture (Charte, Mathemagique, Synthese deliberative)
  • Versionning Page (parent_page, version_number, version_label)
  • Carte inline carte_inline.html + bouton "Commenter" inline (pure JS local)
  • Systeme de commentaires (CommentaireExtraction) + statuts de debat + action changer_statut
  • Helper core/llm_providers.py:appeler_llm (utilise par la Synthese)

References / References

  • Plan d'execution : PLAN/A.7-retrait-reformulation-restitution.md
  • Spec maitre : PLAN/REVUE_YAGNI_2026-05-01.md
  • Sessions precedentes A.1-A.6 : retrait Explorer / Heatmap / Mode focus / Stripe / Bibliotheque analyseurs / refonte WebSocket

2026-04-29 — PHASE-29 : Synthese deliberative dans le drawer + bool est_par_defaut + fix WebSocket OOB + audit HTMX (alpha:0.3.1)

Quoi / What: Refonte UX complete de la synthese deliberative dans le drawer (miroir du flow extraction), avec markdown server-side, sélecteur d'analyseurs en boutons, notification cross-page via WebSocket, audit HTMX complet et nombreux fix adjacents.

Pourquoi / Why: Le modal de synthese etait construit en JS (anti-pattern djc) et manquait l'estimation prix / le prompt complet / la gate Stripe. L'utilisateur voulait le meme niveau d'information que pour l'extraction. Les bool inclure_extractions et inclure_texte_original etaient sauvegardes mais ignores par la tache Celery. Long audit HTMX en fin de session pour stabiliser les retours et ne plus avoir de "bordel" dans les comportements selon la page.

Changements principaux / Main changes

  1. Endpoint previsualiser_synthese sur PageViewSet : calcule estimation tokens (50% output, sans chunking), consensus complet (compteurs + bloquantes), compteurs d'extractions/commentaires disponibles, gate Stripe, conditions de blocage.
  2. Drawer de confirmation (confirmation_synthese.html) : selecteur d'analyseur, encart consensus, infos analyseur, estimation, bouton « Voir le prompt complet ».
  3. Polling drawer : synthese_en_cours_drawer.html (spinner pendant la synthese, message d'erreur + retry sinon). Auto-fermeture du drawer + chargement V2 en zone-lecture via HX-Trigger: fermerDrawer + OOB sur #zone-lecture.
  4. Bool est_par_defaut sur l'analyseur (un par type) : save() decoche automatiquement les autres du meme type. Toast info quand un autre est decoche.
  5. Bool inclure_extractions / inclure_texte_original branches dans _construire_prompt_synthese : sections injectees selon les bool de l'analyseur. Validation « au moins l'un des deux » dans la vue.
  6. Helper _calculer_consensus(page) extrait de la vue dashboard, reutilise par le drawer de confirmation.
  7. WebSocket synthese terminee : la tache Celery envoie au groupe notifications_user_{user.pk} un message synthese_terminee. Le NotificationConsumer emet un toast OOB cliquable « Voir la version V{N} ». Notification cross-page : meme si l'utilisateur a navigue ailleurs, il est notifie.
  8. Tableau analyseurs dans /api/analyseurs/ : Nom / Type / Texte / Extractions / Actif / Defaut. La liste affiche TOUS les analyseurs (actifs et inactifs). Le filtre is_active=True ne s'applique qu'au selecteur du drawer.
  9. Markdown server-side pour la synthese : ajout de la lib markdown Python. Le prompt impose explicitement le format markdown (titres, gras, citations, listes). Le rendu HTML passe par html.escape() puis markdown.markdown(...) : securite XSS preservee + structure HTML propre. Avant : split paragraphes nu.
  10. Selecteur d'analyseur en boutons dans le drawer (vs select deroulant). Titre « Quel moteur utiliser ? » + sous-titre explicatif. Bouton actif en violet, etoile bleue pour le defaut. Au clic = recharge le drawer (estimation/prompt re-calcules pour le nouvel analyseur).
  11. Bouton « Voir le prompt complet » deplace juste sous le selecteur d'analyseur pour comparer rapidement les prompts entre moteurs.
  12. Toggle is_active dans l'editeur d'analyseur : permet de desactiver un analyseur sans le supprimer (il reste visible dans la liste mais exclu du selecteur du drawer).
  13. Bouton « Supprimer cette version » dans lecture_principale.html (a cote de Historique) : visible uniquement si parent_page non-null ET utilisateur proprietaire du dossier. Action LectureViewSet.destroy() qui refuse : (a) la racine, (b) les versions avec commentaires (preserve le travail collaboratif), (c) les non-proprietaires. Apres suppression : HX-Location vers la racine.
  14. Empecher l'import sans connexion : data-user-authenticated sur <body>
    • guard JS sur les 3 inputs d'import (toolbar, overlay, onboarding) qui dispatch authRequise -> SweetAlert connexion.
  15. URL push apres import : header X-Hypostasia-Page-Url cote serveur + history.pushState() cote JS. L'URL change apres import (avant : restait sur l'ancien document).
  16. Titre de version = nom de l'analyseur : version_label = analyseur_synthese.name (ex: « V2 - Mathemagique » au lieu de « V2 - Synthese deliberative »). Permet de distinguer les versions selon l'analyseur utilise.
  17. Audit HTMX en fin de session : 3 agents Explore deployes en parallele pour cartographier les hx-target/hx-swap-oob, valider les fallbacks F5 (15/15 vues OK), et tracer les flows analyse + synthese. Resultat : projet globalement sain, 3 vrais problemes corriges (voir ci-dessous).

Ameliorations issues de l'audit HTMX (fin de session)

# Action Resolution
P1 Polling synthese qui continue apres navigation cross-page (fuite ~60 requetes inutiles sur 3 min) Filtre conditionnel every 3s [document.querySelector('#zone-lecture [data-page-id]')?.dataset.pageId === '{{ page.pk }}'] : HTMX evalue la condition a chaque tick, pas de requete si l'utilisateur a navigue ailleurs
P3 OOB complexe synthese_terminee_oob.html (3 swaps + HX-Trigger) en fin de synthese Remplace par HX-Location natif HTMX vers /lire/V{N}/ + HX-Trigger fermerDrawer. URL pushed proprement, etat coherent, pas d'OOB fragile. Partial supprime
P5 comparer_hypostases sans fallback F5 (URL partagee = page nue) Si non-HTMX, redirige vers la vue parente /lire/{pk}/comparer/?v2=... qui affiche l'onglet correctement
Doublon Toast Synthese terminee envoye deux fois (SweetAlert + WS) Retire le SweetAlert de synthese_status completed, garde le toast WS qui est plus riche (lien cliquable)
Cohérence Liste/api/analyseurs/ filtrait is_active=True (analyseurs disparaissaient) Affiche TOUS les analyseurs, le filtre is_active=True ne s'applique qu'au selecteur du drawer

Bugs corriges / Bugs fixed

Bug Cause Fix
Option « Synthetiser » absente du formulaire de creation hypostasia.js:273-277 n'avait que 3 options dans le SweetAlert +1 option
Analyseur disparait apres save BooleanField(required=False) de DRF rempli validated_data avec False quand le PATCH est en form-urlencoded sans le champ. Le setattr desactivait alors is_active partial_update ne setter QUE les champs explicitement dans request.data.keys()
analyseurId is not defined dans le JS de l'editeur La variable etait declaree dans le scope local d'un callback de click Hisser au scope du IIFE global
Le toast WS HTMX ne s'affichait jamais htmx-ext-ws-2.0.4 ne gere pas la syntaxe courte <div id="X" hx-swap-oob="beforeend">. Bug touchait aussi notification standard du projet Utiliser la syntaxe explicite <div hx-swap-oob="beforeend:#X">
Migration synthetiser manquante Le model avait 4 types mais la migration 0011 n'en avait que 3 Migration 0025_alter_analyseursyntaxique_type_analyseur.py (ajoutee dans le merge precedent)
analyseurId is not defined dans le JS de l'editeur (callbacks externes au scope) Variable declaree dans le scope local d'un callback de click Hisser au scope du IIFE global
Selecteur d'analyseur de synthese : changement non pris en compte hx-vals codait l'ID au render serveur (capture statique) Switch vers hx-include="#select-analyseur-synthese" (lecture LIVE), puis remplace par boutons (rechargement complet du drawer a chaque clic)
bg-violet-400 invisible (toggle, pastille) Pas dans le subset Tailwind compile du projet Switch vers bg-violet-500 (present)
peer-checked:bg-emerald-500 ne se colore pas Variant non genere par Tailwind Switch vers peer-checked:bg-blue-500 (present)
Commentaires Django multi-lignes visibles dans le HTML {# ... #} ne fonctionne QUE sur une ligne en Django (test reproduit) Switch vers {% comment %}...{% endcomment %} (1 occurrence trouvee dans synthese_en_cours_drawer.html)
Lien navbar /api/analyseurs/ bug HTMX (JS auto-save ne se re-bind pas correctement apres swap) hx-get HTMX au lieu d'un GET classique Retire les attributs HTMX → navigation classique avec full page reload
Toast info est_par_defaut decoche → ne s'affichait pas fetch().then() ne propageait pas le HX-Trigger du serveur Lecture du header HX-Trigger dans .then() + dispatchEvent(new CustomEvent(name, {detail}))

Fichiers crees / Created files

Fichier / File Description
front/templates/front/includes/confirmation_synthese.html Partial confirmation drawer (estimation, consensus, prompt, selecteur boutons)
front/templates/front/includes/synthese_en_cours_drawer.html Partial polling (spinner / erreur retry) avec filtre conditionnel anti-zombie
front/templates/front/includes/ws_synthese_terminee.html Toast WS cross-page envoye par le NotificationConsumer
front/tests/test_phase29_synthese_drawer.py 20 tests unitaires
hypostasis_extractor/migrations/0026_analyseursyntaxique_est_par_defaut.py Migration auto
docs/superpowers/specs/2026-04-29-synthese-drawer-confirmation-design.md Spec brainstorming
docs/superpowers/plans/2026-04-29-synthese-drawer-confirmation.md Plan d'implementation 14 taches

Fichiers modifies / Modified files

Fichier / File Changement / Change
hypostasis_extractor/models.py +champ est_par_defaut + override save() pour decocher les autres du meme type
hypostasis_extractor/serializers.py +est_par_defaut dans AnalyseurSyntaxiqueUpdateSerializer
hypostasis_extractor/views.py partial_update : ne setter que les champs envoyes (fix bug DRF) + toast info est_par_defaut. list affiche TOUS les analyseurs (plus de filtre is_active=True)
hypostasis_extractor/templates/.../analyseur_editor.html +option synthetiser, +toggle est_par_defaut, label « extractions et leurs commentaires », hisser analyseurId, propagation HX-Trigger via fetch.then
hypostasis_extractor/templates/.../configuration_llm.html Liste → tableau (Nom/Type/Actif/Defaut)
hypostasis_extractor/templates/.../includes/analyseur_item.html Refait en <tr> avec colonnes
front/views.py Helper _calculer_consensus extrait. Nouvelle action previsualiser_synthese. synthetiser (POST) renvoie partial drawer + HX-Trigger: ouvrirDrawer. synthese_status adapte (3 branches drawer + OOB completed + fermerDrawer)
front/tasks.py _construire_prompt_synthese(page, job, analyseur) (3e arg). Sections conditionnees aux bool. Guard dernier_job_analyse=None. synthetiser_page_task envoie au groupe utilisateur notifications_user_{pk} un signal synthese_terminee
front/consumers.py +handler synthese_terminee qui rend le toast WS
front/templates/front/includes/ws_toast.html Syntaxe corrigee hx-swap-oob="beforeend:#ws-toasts" (resout aussi le bug global de tous les toasts WS du projet)
front/templates/front/includes/dashboard_consensus.html Bouton synthese : hx-get direct vers previsualiser_synthese (suppression onclick="ouvrirModaleSynthese")
front/templates/front/includes/carte_analyseur.html +badge « Par defaut » et badge type synthetiser (etait manquant)
front/templates/front/includes/detail_analyseur_readonly.html Idem
front/static/front/js/hypostasia.js +option synthetiser au SweetAlert. +listener fermerDrawer. ouvrirPanneauDroit appelle ouvrir(false) pour ne pas ecraser le contenu pre-swap
front/static/front/js/dashboard_consensus.js Suppression de ouvrirModaleSynthese et fermerModaleSynthese (anti-pattern JS-built HTML)
front/static/front/js/drawer_vue_liste.js ouvrirDrawer(rechargerLeContenu=true) ne charge le contenu que si demande explicitement
front/management/commands/charger_fixtures_demo.py est_par_defaut=True sur les 3 analyseurs demo

Fichiers supprimes / Deleted files

  • front/templates/front/includes/synthese_en_cours.html (remplace par synthese_en_cours_drawer.html)
  • front/templates/front/includes/synthese_terminee_oob.html (remplace par HX-Location natif HTMX en fin de session)

Dependances ajoutees / New dependencies

  • markdown==3.10.2 (pyproject.toml) — parser markdown server-side pour le rendu de la synthese

WebSocket — flux complet

Le WS pre-existant NotificationConsumer (route /ws/notifications/) est connecte sur toutes les pages via <div ws-connect="/ws/notifications/"> dans base.html, avec un groupe par utilisateur (notifications_user_{user.pk}). Il reste connecte cross-page tant que le navigateur ne ferme pas l'onglet. PHASE-29 reutilise ce mecanisme :

1. Utilisateur clique "Lancer la synthèse" dans le drawer.
2. POST /lire/{pk}/synthetiser/ → cree un ExtractionJob + Celery .delay()
3. Celery (synthetiser_page_task) :
   - construit le prompt selon les bool de l'analyseur
   - appelle le LLM
   - cree une Page enfant V2
   - emet : envoyer_progression_websocket(
         f"notifications_user_{owner.pk}",
         "synthese_terminee",
         {"page_synthese_id": ..., "version_number": ..., "titre_page": ...},
     )
4. NotificationConsumer.synthese_terminee() rend ws_synthese_terminee.html et
   envoie le HTML au client via WebSocket.
5. htmx-ext-ws receptionne, applique les OOB swaps :
   - <div hx-swap-oob="beforeend:#ws-toasts">...</div> → ajoute un toast cliquable
6. Le toast contient un lien hx-get vers la V2 → clic = chargement zone-lecture.

Piege OOB important : la syntaxe courte <div id="ws-toasts" hx-swap-oob="beforeend"> ne marche PAS avec htmx-ext-ws-2.0.4. Toujours utiliser la syntaxe explicite <div hx-swap-oob="beforeend:#ws-toasts">.

Tests / Tests

  • 20 nouveaux tests unitaires (test_phase29_synthese_drawer.py)
  • 38 tests test_phase28_light adaptes au nouveau flux drawer
  • Total : 74 tests verts (phase29 + phase28_light + analyse_drawer_unifie)
  • Pas de tests E2E (projet en alpha)

Decisions de design / Design decisions

  • Approche miroir extraction plutot que generique unifie (YAGNI, djc privilegie le verbeux et lisible top-to-bottom).
  • Bool est_par_defaut par type (vs default global) — chaque type a son contexte.
  • Polling drawer + WS : le polling rafraichit en temps reel quand l'utilisateur reste sur la page ; le WS notifie cross-page. Les deux mecanismes coexistent comme dans le flux extraction. MAIS le polling est protege par un filtre conditionnel JS qui le pause si l'utilisateur a navigue ailleurs.
  • Pas de bouton Annuler explicite dans la confirmation — la croix du drawer ou Escape suffisent.
  • Auto-fermeture du drawer en fin de synthese + bascule auto sur la V2 via HX-Location natif HTMX (vs OOB complexes).
  • Ratio output 50% comme l'extraction (a affiner apres mesure reelle).
  • Selecteur d'analyseur en boutons plutot qu'en <select> : indique mieux le choix possible et permet d'afficher visuellement le defaut (etoile bleue).
  • Audit HTMX : conserver le pattern polling drawer + WS cross-page plutot que tout migrer vers WS-only. Defense en profondeur, le WS peut tomber, le polling rattrape. Cout de la refonte > benefice marginal.

Pieges documentes / Documented pitfalls

  • htmx-ext-ws-2.0.4 syntaxe OOB : la forme courte <div id="X" hx-swap-oob="beforeend"> ne marche PAS, il faut la forme explicite <div hx-swap-oob="beforeend:#X">. Bug reproduit, fix dans ws_toast.html et ws_synthese_terminee.html.
  • DRF + form-urlencoded + BooleanField(required=False) : DRF rempli validated_data avec False pour les BooleanField non envoyes, ce qui peut desactiver des champs accidentellement. Solution : partial_update ne setter que les champs explicitement dans request.data.keys().
  • Django commentaires {# #} : ne fonctionnent QUE sur une seule ligne. Multi-ligne = {% comment %}...{% endcomment %} obligatoire (sinon le commentaire apparait visible dans le HTML rendu).
  • Subset Tailwind : seules certaines variantes de couleurs/peer-checked sont compilees. Verifier avec grep dans tailwind.css avant d'utiliser une classe rare.
  • Polling HTMX et navigation : le polling continue dans le DOM masque apres swap de la zone-lecture. Solution : filtre conditionnel every Ns [expr] qui pause si conditions non remplies.

Migration

  • Migration necessaire / Migration required: Oui — 0026_analyseursyntaxique_est_par_defaut.py
  • docker exec hypostasia_web uv run python manage.py migrate

2026-03-17 — PHASE-26c : Refactoring statuts de debat (6 statuts + ownership)

Quoi / What: Refactoring du systeme de statuts de debat : passage de 4 a 6 statuts, ajout du controle d'ownership, suppression du double badge, integration de "masquer" dans le cycle deliberatif.

Pourquoi / Why: 3 problemes UX identifies : toutes les extractions demarraient en rouge (alarmant), n'importe quel user pouvait changer le statut, et "masquer" etait deconnecte du cycle deliberatif.

Changements principaux / Main changes

  1. 6 statuts : nouveau (gris), discutable (orange), discute (ambre), consensuel (vert), controverse (rouge), non_pertinent (gris pale)
  2. Ownership : seul le proprietaire du dossier peut changer statut, masquer, restaurer
  3. Non pertinent remplace le boolean masquee (synchronise via save())
  4. Double badge supprime : le _card_body.html n'affiche plus le statut en doublon
  5. Auto-promotion : commentaire sur nouveau/discutable → discute
  6. Dashboard 6 compteurs : grille 3x2, non_pertinent exclu du calcul de consensus

Fichiers modifies / Modified files

Fichier / File Changement / Change
hypostasis_extractor/models.py +2 choices, default→nouveau, save() sync masquee
hypostasis_extractor/migrations/0021_*.py AlterField + RunPython data migration
front/views.py Helper _est_proprietaire_dossier, ownership checks, est_proprietaire contexte
front/serializers.py +2 choices ChangerStatutSerializer
front/static/front/css/hypostasia.css 6 couleurs statut, discutable rouge→orange
front/static/front/js/marginalia.js +2 entrees COULEURS_STATUT
front/static/front/js/keyboard.js Check ownership avant raccourci S
front/templates/.../carte_inline.html Boutons owner-only, +discutable, +non_pertinent
front/templates/.../_card_body.html Suppression double badge statut
front/templates/.../drawer_vue_liste.html Masquer/restaurer owner-only, "Non pertinentes"
front/templates/.../dashboard_consensus.html Grille 3x2, 6 compteurs
front/templates/front/base.html data-est-proprietaire sur #zone-lecture
hypostasis_extractor/templatetags/extractor_tags.py +2 icones statut
front/tests/test_phases.py ~17 updates + 5 nouvelles classes test
front/management/commands/charger_fixtures_demo.py Redistribution 6 statuts

Migration

  • Migration necessaire / Migration required: Oui — hypostasis_extractor/migrations/0021_refactoring_statuts_debat.py
  • uv run python manage.py migrate

2026-03-16 — PHASE-26a UX : 5 ameliorations filtre multi-contributeurs

Quoi / What: 5 ameliorations UX du filtre multi-contributeurs :

  1. Scroll-to-first : le drawer scrolle en haut apres activation/desactivation d'un filtre
  2. Noms dans compteur : "2 sur 78 (marie)" au lieu de "2 sur 78"
  3. Badge entites : la pilule active affiche le nombre d'entites distinctes (pas de commentaires)
  4. Couleur HSL : chaque contributeur a une couleur deterministe (hash MD5 du username)
  5. Mode Sauf : bouton "Sauf" pour inverser le filtre (exclure au lieu d'inclure)

Pourquoi / Why: Le facilitateur utilise le filtre pour preparer ses reunions de consensus. Ces ameliorations rendent l'outil plus lisible (couleurs distinctes, noms), plus precis (entites vs commentaires), et plus flexible (mode exclure pour voir "tout sauf X").

Fichiers modifies / Modified files

Fichier / File Changement / Change
front/views.py Helper _calculer_teinte_contributeur(), enrichissement contributeurs (nombre_entites + couleur_hsl), mode exclure avec .exclude()
front/templates/front/includes/drawer_vue_liste.html Compteur avec noms + sauf, pilule-exclue/pilule-active, bouton Sauf, badge entites, commentaires mode inversé
front/static/front/js/drawer_vue_liste.js Scroll-to-first, variable modeFiltre, handler bouton Sauf, getContributeursActuels inclut pilule-exclue
front/static/front/js/marginalia.js appliquerFiltreContributeurs supporte modeFiltre pour inverser le dimming pastilles
front/static/front/css/hypostasia.css .pilule-contributeur.pilule-active HSL, .pilule-exclue hachures, .pilule-toggle-mode
front/tests/test_phases.py 8 tests : compteur noms, entites count, couleur HSL (3), exclure, compteur sauf, HX-Trigger mode

Migration

  • Migration necessaire / Migration required: Non

2026-03-16 — PHASE-26a-bis : Filtre multi-contributeurs (pilules toggle)

Quoi / What: Remplacement du <select> mono-sélection contributeur par des pilules toggle réutilisant le pattern .pilule-locuteur existant (PHASE-15). Supporte la sélection multiple : cliquer plusieurs pilules → union des commentaires. Le paramètre ?contributeur= accepte désormais une liste séparée par virgules (?contributeur=1,2,3), rétro-compatible avec le format single (?contributeur=42).

Pourquoi / Why: Le facilitateur veut comparer 2+ contributeurs ("qu'est-ce que Marie ET Thomas ont dit ?"). Les pilules toggle survivent au swap HTMX, zéro JS custom fragile, mobile-friendly, FALC.

Fichiers modifies / Modified files

Fichier / File Changement / Change
front/views.py drawer_contenu() : parsing multi-IDs virgule-séparée, user_id__in, HX-Trigger contributeurs_ids (plural). Renommage _calculer_scores_temperature_par_contributeurs(). LectureViewSet.retrieve() : parsing multi-IDs.
front/templates/front/includes/drawer_vue_liste.html Select+chip → pilules .pilule-locuteur toggle + bouton "Tous ×". Conditions contributeur_actif → contributeurs_actifs (set).
front/static/front/js/drawer_vue_liste.js getContributeursActuels() (lecture pilules actives), handler clic pilule toggle, suppression handler select/chip.
front/static/front/js/marginalia.js contributeursFiltresActuels = [], appliquerFiltreContributeurs() (array), listener contributeurs_ids.
front/static/front/css/hypostasia.css +.pilule-reset-contributeurs, suppression .chip-contributeur-actif et .btn-retirer-filtre-contributeur.
front/tests/test_phases.py 4 tests existants adaptés + 5 nouveaux tests PHASE-26a-bis (multi-filtre, HX-Trigger multi, pilules, heatmap union, rétro-compat).

2026-03-16 — PHASE-26a : Filtre contributeur sur les commentaires

Quoi / What: Filtre par contributeur dans le drawer vue liste des extractions. Quand un contributeur est selectionne, seules les extractions qu'il a commentees apparaissent, les commentaires des autres sont dimmes (opacite reduite), les pastilles de marge non concernees sont desactivees, et la heat map se recalcule pour ne compter que les commentaires de ce contributeur.

Pourquoi / Why: Le facilitateur a besoin de filtrer par contributeur pour preparer les reunions de consensus ("qu'est-ce que Michel a dit ?"). Ce filtre se combine avec la heat map pour visualiser la temperature du debat du point de vue d'un contributeur.

Fichiers modifies / Modified files

Fichier / File Changement / Change
front/views.py +helper _calculer_scores_temperature_par_contributeur(), modifier drawer_contenu() (param contributeur, liste contributeurs, HX-Trigger), modifier retrieve() (heat map par contributeur)
front/templates/front/includes/drawer_vue_liste.html +dropdown contributeur, +classe dimming commentaires
front/static/front/js/drawer_vue_liste.js +param contributeur sur chargerContenu(), event listener select, heatmap reload
front/static/front/js/marginalia.js +listener contributeurFiltreChange, filtrage pastilles, API getContributeurFiltre/resetContributeurFiltre
front/static/front/css/hypostasia.css +.commentaire-hors-filtre, +.pastille-hors-filtre
front/tests/test_phases.py +13 tests unitaires PHASE-26a (7 base + 6 UX)
front/tests/e2e/test_17_filtre_contributeur.py NOUVEAU — 6 tests E2E
front/management/commands/charger_fixtures_demo.py +24 commentaires sur pages Wikipedia (Ostrom, Alexandre, Sadin) par 4 contributeurs, dossier "Petits textes" rendu public

Ameliorations UX (post-implementation)

  1. Icone personne devant le select contributeur (differencie du select de tri)
  2. Chip/badge actif "nom x" pour retirer le filtre en un clic
  3. Compteur "N sur M" quand filtre actif (ex: "2 sur 78")
  4. Highlight du nom du contributeur filtre dans les commentaires (fond bleu + gras)
  5. Badge point bleu sur le bouton toolbar Extractions quand filtre actif

2026-03-15 — PHASE-25d UX : Ameliorations Explorer

Quoi / What: 7 ameliorations UX sur l'Explorer et le systeme d'invitation :

  1. Description optionnelle sur les dossiers (champ description 200 chars)
  2. Compteur de suivis affiche en ambre sur les cards ("3 suivis")
  3. Bouton Explorer (globe) ajoute dans la toolbar principale desktop
  4. Toasts de confirmation sur Suivre/Ne plus suivre/Inviter
  5. Selecteur tri (Plus recents / Plus suivis / Alphabetique)
  6. Preview des 3 premiers titres de pages en badges gris dans les cards
  7. Fix bug dropdown auteur duplique (Meta.ordering polluait DISTINCT)

Pourquoi / Why: Les cards etaient trop minimales (nom + date), l'Explorer pas assez decouvrable (cache dans le footer de l'arbre uniquement), et pas de feedback apres les actions Suivre/Inviter.

Fichiers modifies / Modified files

Fichier / File Changement / Change
core/models.py +champ description sur Dossier
core/migrations/0024_dossier_description.py Migration auto
front/serializers.py +champ tri dans ExplorerFiltresSerializer
front/views_explorer.py +annotate nombre_suivis, +tri (populaire/nom/recent), +preview pages, +toasts HX-Trigger, fix DISTINCT
front/views.py +toast sur action inviter
front/templates/front/includes/explorer_page.html +select tri, +listener toast SweetAlert
front/templates/front/includes/explorer_card.html +description, +compteur suivis ambre, +preview pages badges
front/templates/front/base.html +bouton globe Explorer dans toolbar

Migration

  • Migration necessaire / Migration required: Oui
  • core/migrations/0024_dossier_description.py
  • Commande : uv run python manage.py migrate

2026-03-15 — PHASE-25d : Invitation par email + Explorer + DossierSuivi

Quoi / What: Invitation par email pour dossiers et groupes (email connu = partage direct, email inconnu = invitation avec token + email). Page Explorer pour decouvrir les dossiers publics (recherche, filtre auteur, pagination). Suivi de dossiers publics (4e section "Suivis" dans l'arbre). Inscription avec token d'invitation → auto-acceptation.

Pourquoi / Why: PHASE-25c imposait de connaitre le username exact pour partager. Pas de decouverte de contenu public. Pas moyen d'inviter un non-inscrit.

Fichiers crees / Created files

Fichier / File Description
front/views_invitation.py InvitationViewSet + helpers (creer, accepter, envoyer email)
front/views_explorer.py ExplorerViewSet (list, suivre, ne_plus_suivre)
front/templates/front/includes/explorer_page.html Page Explorer complete
front/templates/front/includes/explorer_resultats.html Resultats pagines
front/templates/front/includes/explorer_card.html Card dossier individuelle
front/templates/front/invitation_erreur.html Page erreur invitation
front/templates/front/emails/invitation_dossier.txt Email invitation dossier (texte)
front/templates/front/emails/invitation_dossier.html Email invitation dossier (HTML)
front/templates/front/emails/invitation_groupe.txt Email invitation groupe (texte)
front/templates/front/emails/invitation_groupe.html Email invitation groupe (HTML)
front/tests/e2e/test_16_invitation_explorer.py 8 tests E2E
core/migrations/0023_dossiersuivi_invitation.py Migration auto

Fichiers modifies / Modified files

Fichier / File Changement / Change
core/models.py +Invitation, +DossierSuivi
hypostasia/settings.py +config email (EMAIL_BACKEND, SITE_URL, etc.)
front/serializers.py +InviterEmailSerializer, +ExplorerFiltresSerializer
front/views.py +action inviter sur DossierViewSet, _render_arbre 4 sections (+ Suivis)
front/views_auth.py Handle ?token= dans register
front/views_groupes.py +action inviter sur GroupeViewSet
front/urls.py +ExplorerViewSet, +InvitationViewSet
front/templates/front/includes/arbre_dossiers.html +section Suivis
front/templates/front/includes/_dossier_node.html +bouton Ne plus suivre
front/templates/front/includes/partage_dossier_form.html +section email + invitations en attente
front/templates/front/register.html +hidden field token
front/templates/front/base.html +lien Explorer dans footer arbre
front/tests/test_phases.py +18 tests unitaires PHASE-25d

Migration

  • Migration necessaire / Migration required: Oui
  • core/migrations/0023_dossiersuivi_invitation.py
  • Commande : uv run python manage.py migrate

2026-03-15 — PHASE-25c : Visibilite 3 niveaux + groupes + arbre restructure

Quoi / What: Systeme de visibilite a 3 niveaux (prive/partage/public) sur les dossiers. Groupes d'utilisateurs (CRUD) pour faciliter le partage. Arbre restructure en 3 sections accordeon (Mes dossiers / Partages avec moi / Dossiers publics). Anonymes limites aux dossiers publics. Controle d'acces lecture/ecriture sur LectureViewSet. Moderation : owner du dossier peut supprimer les commentaires. Auto-classement des imports dans "Mes imports". Menu contextuel avec sous-menu visibilite. OOB swaps corriges (centralises via _render_arbre).

Pourquoi / Why: Le modele de visibilite PHASE-25 etait binaire (tout ou rien). Pas de distinction prive/partage/public, pas de groupes, les anonymes voyaient tout.

Fichiers modifies / Modified files

Fichier / File Changement / Change
core/models.py +VisibiliteDossier, +GroupeUtilisateurs, visibilite sur Dossier, DossierPartage avec groupe+constraints
core/migrations/0022_*.py Migration auto
front/views.py +3 helpers acces, _render_arbre 3 sections, +changer_visibilite, +quitter, acces LectureViewSet, auto-classify imports, OOB fixes, moderation, DossierViewSet.list filtre
front/views_groupes.py Nouveau — GroupeViewSet CRUD
front/serializers.py +ChangerVisibiliteSerializer, +GroupeCreateSerializer, +GroupeAjouterMembreSerializer
front/urls.py +GroupeViewSet
front/templates/front/includes/arbre_dossiers.html Rewrite — 3 sections accordeon
front/templates/front/includes/_dossier_node.html Nouveau — partial reutilisable
front/templates/front/includes/partage_dossier_form.html +section groupes
front/static/front/js/arbre_context_menu.js +sous-menu visibilite
front/static/front/js/arbre_overlay.js +JS accordeon + bouton quitter
front/templates/front/includes/groupe_detail.html Nouveau — partial template detail groupe
front/tests/test_phases.py +23 tests PHASE-25c

Migration

  • Migration necessaire / Migration required: Oui
  • core/migrations/0022_alter_dossierpartage_unique_together_and_more.py
  • Commande : uv run python manage.py migrate

2026-03-15 — PHASE-25b : Auth extension navigateur

Quoi / What: Authentification par token API pour l'extension navigateur Chrome. L'extension envoie le token dans les headers HTTP. POST /api/pages/ exige un token valide (401 sinon). Page /auth/token/ pour generer/regenerer le token. Apres recolte, boutons dossiers pour classer la page. Dossier "A ranger" auto-cree par defaut. Dedup filtree par owner + partages. Fix URL hardcodee dans sidebar.js.

Pourquoi / Why: L'extension fonctionnait sans authentification — impossible de tracer qui envoie quoi, ni de classer les pages par utilisateur.

Fichiers modifies / Modified files

Fichier / File Changement / Change
hypostasia/settings.py +rest_framework.authtoken dans INSTALLED_APPS, +CORS_ALLOW_HEADERS
core/views.py TokenAuthentication, owner sur create, endpoints me/mes_dossiers/classer_depuis_extension, dedup filtree owner+partages
front/views_auth.py +action mon_token (GET/POST) — generation et regeneration de token
front/templates/front/mon_token.html Nouveau — page standalone token avec bouton copier/regenerer
front/templates/front/base.html Lien "Mon token API" dans dropdown menu utilisateur
extension/popup.js Token dans headers, feedback auth, boutons dossiers post-recolte
extension/popup.html Zones #authStatus et #dossiersChoix
extension/sidebar.js Fix URL hardcodee → lecture serverUrl depuis storage + token dans headers
extension/options.html Renommer "Cle API" en "Token d'authentification" + help-text
front/tests/test_phases.py +12 tests unitaires PHASE-25b
front/tests/e2e/test_15_token.py Nouveau — 3 tests E2E page token

2026-03-15 — PHASE-25 : Users et partage

Quoi / What: Authentification Django (login/register/logout), propriete des ressources (owner sur Dossier/Page), remplacement de prenom par user FK obligatoire sur CommentaireExtraction/Question/ReponseQuestion, partage binaire de dossiers (DossierPartage), protection des ecritures (lectures restent publiques).

Pourquoi / Why: L'app fonctionnait en mono-utilisateur avec identification par prenom libre. Cette phase ajoute une vraie authentification pour tracer les contributions et permettre le partage de dossiers entre utilisateurs.

Fichiers modifies / Modified files

Fichier / File Changement / Change
core/models.py +owner sur Dossier/Page, +DossierPartage, user FK sur Question/ReponseQuestion
hypostasis_extractor/models.py user FK remplace prenom sur CommentaireExtraction
core/migrations/0021_*.py Migration PHASE-25 (owner, DossierPartage, user FK)
hypostasis_extractor/migrations/0020_*.py Migration PHASE-25 (user FK commentaire)
core/admin.py Adapte pour user FK
front/views_auth.py Nouveau — AuthViewSet (login/register/logout)
front/views.py +_exiger_authentification(), protection ~28 actions POST, request.user dans create, _render_arbre filtre owner
front/serializers.py +LoginSerializer, +RegisterSerializer, +DossierPartageSerializer, -prenom sur 3 serializers
front/urls.py Enregistrer AuthViewSet
front/templates/front/login.html Nouveau — page de connexion
front/templates/front/register.html Nouveau — page d'inscription
front/templates/front/base.html Menu utilisateur dans navbar
front/templates/front/includes/fil_discussion.html Supprimer prenom, user FK, layout SMS server-side
front/templates/front/includes/vue_commentaires.html Idem
front/templates/front/includes/vue_questionnaire.html Supprimer prenom, gater formulaires
front/templates/front/includes/drawer_vue_liste.html Affichage user.username
front/templates/front/includes/arbre_dossiers.html Bouton partager
front/templates/front/includes/partage_dossier_form.html Nouveau — formulaire partage
front/management/commands/charger_fixtures_demo.py Creer users demo, assigner ownership
front/tests/test_phases.py +19 tests unitaires PHASE-25, adaptation tests existants
front/tests/e2e/base.py Helpers creer_utilisateur_demo, se_connecter
front/tests/e2e/test_13_auth.py Nouveau — 10 tests E2E auth
front/tests/e2e/__init__.py Import test_13
hypostasia/settings.py LOGIN_URL, LOGIN_REDIRECT_URL, LOGOUT_REDIRECT_URL

Audit stack-ccc

Audit complet de conformite au skill stack-ccc realise. 10 non-conformites detectees et corrigees :

  • LOCALISATION ajoutee dans toutes les docstrings (views, serializers, helpers)
  • Imports deplaces en haut de fichier (plus d'import interne dans les methodes)
  • role="alert" + aria-live="assertive" sur les zones d'erreurs (login, register)
  • aria-label sur les formulaires d'authentification et le dropdown menu
  • data-testid sur tous les elements interactifs du partage (input, boutons, lignes)
  • aria-hidden="true" sur les SVG decoratifs du partage

Tests — 712 tests verts (614 unitaires + 98 E2E)

Suite Nombre Statut
Tests unitaires PHASE-25 19 OK
Tests unitaires existants (adaptes) 595 OK
Tests E2E PHASE-25 (auth) 10 OK
Tests E2E existants (adaptes) 88 OK

2026-03-15 — PHASE-24 : Providers IA unifies

Quoi / What: Couche d'abstraction unique core/llm_providers.py pour les appels LLM directs. Ajout de 2 nouveaux providers : Ollama (local) et Anthropic (Claude). Suppression du code mort core/services.py.

Pourquoi / Why: 3 chemins d'appel LLM disperses dans le code. Cette phase les unifie en un seul point d'entree appeler_llm() et ajoute le support Ollama (gratuit, local) et Anthropic Claude (reformulation/restitution uniquement).

Fichiers modifies / Modified files

Fichier / File Changement / Change
pyproject.toml Ajout dependance anthropic>=0.40
core/models.py Provider +2 (OLLAMA, ANTHROPIC), AIModelChoices +9 modeles, champ base_url, prefix_to_provider etendu, tarifs
core/llm_providers.py Nouveau — fonction unique appeler_llm() dispatche vers 5 providers
core/migrations/0020_*.py Nouveau — migration auto (base_url + choices)
front/tasks.py Supprime _appeler_llm_reformulation(), remplace par appeler_llm()
hypostasis_extractor/services.py Ajout Ollama (model_url) et Anthropic (ValueError) dans resolve_model_params()
core/services.py Supprime — code mort (dispatch legacy)
front/tests/test_phases.py +10 tests unitaires PHASE-24
PLAN/PHASES/INDEX.md PHASE-24 cochee

Migration

  • Migration necessaire / Migration required: Oui
  • uv run python manage.py migrate — ajoute base_url sur AIModel, etend les choices

2026-03-11 — Corrections post-audit phases 1-6

  • Renommage du skill django-htmx-readable → stack-ccc (CLAUDE.md + dossier skills/) / Renamed skill django-htmx-readable → stack-ccc (CLAUDE.md + skills/ directory)
  • Ajout attributs aria-* et data-testid dans les templates / Added aria-* and data-testid attributes in templates
  • Mise a jour INDEX.md (phases 01-06 marquees completees) / Updated INDEX.md (phases 01-06 marked as completed)
  • Creation de ce CHANGELOG / Created this CHANGELOG

Fichiers modifies / Modified files:

  • CLAUDE.md
  • PLAN/PHASES/INDEX.md
  • front/templates/front/base.html
  • front/templates/front/includes/arbre_dossiers.html
  • front/templates/front/includes/panneau_analyse.html
  • front/templates/front/includes/extraction_results.html
  • front/templates/front/includes/extraction_manuelle_form.html
  • front/templates/front/includes/lecture_principale.html
  • skills/django-htmx-readable/ → skills/stack-ccc/
  • CHANGELOG.md (nouveau / new)

Migration : non / no

2026-03-11 — PHASE-06 : Modeles de donnees (statut_debat + masquee)

  • Ajout des champs statut_debat et masquee sur ExtractedEntity / Added statut_debat and masquee fields on ExtractedEntity

Fichiers modifies / Modified files:

  • hypostasis_extractor/models.py
  • hypostasis_extractor/migrations/0018_extractedentity_masquee_extractedentity_statut_debat.py

Migration : oui / yes

2026-03-11 — PHASE-05 : Extension navigateur robustesse

  • Amelioration de la robustesse de l'extension navigateur (gestion d'erreurs, retry) / Improved browser extension robustness (error handling, retry)

Fichiers modifies / Modified files:

  • core/views.py

Migration : non / no

2026-03-11 — PHASE-04 : CRUD manquants

  • Ajout des operations CRUD manquantes (renommer/supprimer dossiers, supprimer pages, deplacer pages) / Added missing CRUD operations (rename/delete folders, delete pages, move pages)

Fichiers modifies / Modified files:

  • front/views.py
  • front/templates/front/includes/arbre_dossiers.html
  • front/static/front/js/hypostasia.js

Migration : non / no

2026-03-10 — PHASE-03 : Nettoyage code extraction

  • Nettoyage et refactorisation du code d'extraction / Cleanup and refactoring of extraction code

Migration : non / no

2026-03-11 — PHASE-02 : Assets locaux (polices, CDN, collectstatic)

  • Localisation des assets : Tailwind CSS, HTMX, SweetAlert2 en fichiers statiques / Localized assets: Tailwind CSS, HTMX, SweetAlert2 as static files
  • Ajout des polices Lora (via Google Fonts, sera localise plus tard) / Added Lora fonts (via Google Fonts, to be localized later)

Fichiers modifies / Modified files:

  • front/templates/front/base.html
  • front/static/front/css/tailwind.css
  • front/static/front/css/hypostasia.css
  • front/static/front/vendor/htmx-2.0.4.min.js
  • front/static/front/vendor/sweetalert2-11.min.js

Migration : non / no

2026-03-11 — PHASE-01 : Extraction CSS/JS depuis base.html

  • Extraction du CSS inline vers hypostasia.css et du JS inline vers hypostasia.js / Extracted inline CSS to hypostasia.css and inline JS to hypostasia.js
  • Mise en place de la structure front/static/front/ / Set up front/static/front/ structure

Fichiers modifies / Modified files:

  • front/templates/front/base.html
  • front/static/front/css/hypostasia.css (nouveau / new)
  • front/static/front/js/hypostasia.js (nouveau / new)

Migration : non / no