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/<id>, /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`