# Local Office (`services/local-office/`)

Service HTTP pour charger et modifier des documents Office (docx, xlsx, pptx) sur la machine locale. Intégration monorepo : code sous **`services/local-office/`** (historique fusionné depuis le dépôt **local_office**).

## Documentation métier et architecture

- Fonctionnalités smart_ide : [features/local-office.md](../features/local-office.md)
- Pile services : [services.md](../services.md)
- Proposition d’architecture (fichier dans le service) : [`services/local-office/docs/architecture-proposal.md`](../../services/local-office/docs/architecture-proposal.md)

## Exécution locale

1. Environnement Python : `python3 -m venv .venv` ; `pip install -r requirements.txt`
2. Variables : copier `.env.example` → `.env`, définir au minimum **`API_KEYS`**
3. Lancer : `uvicorn app.main:app --reload --host 0.0.0.0 --port 8000`
4. Swagger : `http://localhost:8000/docs`

## API (résumé)

- **POST /documents** — upload multipart, en-tête **`X-API-Key`**
- **GET /documents** — liste
- **GET /documents/{id}** — métadonnées
- **GET /documents/{id}/file** — téléchargement
- **POST /documents/{id}/commands** — commandes docx (`replaceText`, `insertParagraph`, …)
- **DELETE /documents/{id}**

Toutes les routes exigent **`X-API-Key`** ; limitation de débit par clé.

## Référence OpenAPI

Répertoire du service : `services/local-office/` (fichiers OpenAPI s’il y en a).