**Motivations:** - Single canonical documentation tree under docs/; reduce drift between README copies. **Evolutions:** - Add docs/repo/ with operational guides (cron, systemd, projects, logs, docv, ia_dev, services, scripts, extension). - Replace scattered README.md files with pointers to docs/repo/*.md. - Refresh docs/README.md index and cross-links across docs/, .cursor rules/agents. - Bump ia_dev submodule to matching doc pointer commits.
1.4 KiB
1.4 KiB
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
- Pile services : services.md
- Proposition d’architecture (fichier dans le service) :
services/local-office/docs/architecture-proposal.md
Exécution locale
- Environnement Python :
python3 -m venv .venv;pip install -r requirements.txt - Variables : copier
.env.example→.env, définir au minimumAPI_KEYS - Lancer :
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000 - 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).