CLAUDE.md

CLAUDE.md — MarkitDown Local WebApp

Setup

• Dépendances: pip install -r requirements.txt
• Lancement: python app.py (ou start.bat / start.sh)
• Accès: http://localhost:5000
• Python: 3.9+ requis

Architecture

markitdown-app/
├── app.py          ← Serveur Flask + routes API
├── converter.py    ← Wrapper MarkItDown (logique de conversion)
├── history.py      ← Gestion historique (fichier JSON)
├── static/
│   ├── style.css   ← Styles monochrome + accent violet
│   └── script.js   ← Logique frontend (upload, preview, copy)
└── templates/
    └── index.html  ← Page unique SPA-like

Conventions

• Python: snake_case (fichiers, fonctions, variables)
• JS: camelCase (variables, fonctions)
• CSS: kebab-case (classes, IDs)
• Routes Flask: /upload, /history, /download/, /clear-history
• Gestion erreurs: try/except dans converter.py → messages inline dans l'UI
• Pas de framework JS — vanilla HTML/CSS/JS uniquement
• Pas de base de données — persistance fichier JSON local

Commandes

• pip install -r requirements.txt — Installer les dépendances
• python app.py — Lancer le serveur

Maintenance

• Dette technique suivie dans .claude/DEBT.md
• Évolution notée dans .claude/CHANGELOG.md