4NK
f482b0e2b8
- Add services-functional-scope.md with consumption matrix and CLI tools - Cross-link from services, API index, architecture, platform-target, ecosystem, docv-ai, overview
31 lines
2.8 KiB
Markdown
31 lines
2.8 KiB
Markdown
# Référence API — services `smart_ide`
|
||
|
||
Documentation des **API HTTP** exposées par les services sous [`services/`](../../services/). Chaque service écoute en principe sur **`127.0.0.1`** ; ports et variables d’environnement sont rappelés par fiche.
|
||
|
||
**Périmètre fonctionnel et consommation** (IDE, automation, backends produit) : [services-functional-scope.md](../services-functional-scope.md).
|
||
|
||
| Service | Auth | Port défaut | Fiche |
|
||
|---------|------|-------------|--------|
|
||
| **repos-devtools-server** | `Authorization: Bearer` | `37140` | [repos-devtools-server.md](./repos-devtools-server.md) |
|
||
| **langextract-api** | Bearer optionnel | `37141` | [langextract-api.md](./langextract-api.md) |
|
||
| **claw-harness-api** (proxy) | Bearer | `37142` | [claw-harness-proxy.md](./claw-harness-proxy.md) |
|
||
| **agent-regex-search-api** | Bearer (sauf `/health`) | `37143` | [agent-regex-search-api.md](./agent-regex-search-api.md) |
|
||
| **local-office** | `X-API-Key` | `8000` (exemple run) | [local-office.md](./local-office.md) |
|
||
| **ia-dev-gateway** | Bearer | `37144` (spécification) | [ia-dev-gateway.md](./ia-dev-gateway.md) |
|
||
| **smart_ide-orchestrator** | Bearer (spécification) | `37145` (spécification) | [orchestrator.md](./orchestrator.md) |
|
||
| **anythingllm-devtools** | Bearer | `37146` | [anythingllm-devtools-api.md](./anythingllm-devtools-api.md) |
|
||
| **smart-ide-tools-bridge** | Bearer (sauf `/health`) | `37147` | [smart-ide-tools-bridge-api.md](./smart-ide-tools-bridge-api.md) |
|
||
| **docv** (externe) | selon dépôt Enso | selon déploiement | [docv.md](./docv.md) |
|
||
|
||
**OpenAPI** : FastAPI expose une spec interactive pour **langextract-api** (`/docs`) et **local-office** (`/docs`) une fois le service démarré.
|
||
|
||
**Amont claw-code** : le binaire / serveur HTTP réel est hors de ce dépôt ; seul le **proxy** documenté ici fait partie du monorepo.
|
||
|
||
**docv** : serveur HTTP et OpenAPI dans le dépôt **docv** ; smart_ide ne les duplique pas — voir [docv.md](./docv.md).
|
||
|
||
**Implémentation minimale** : **ia-dev-gateway** et **smart_ide-orchestrator** ont un serveur Node/TS dans le monorepo (`npm run build` dans chaque dossier). Le branchement runner `ia_dev` et le proxy HTTP complet de l’orchestrateur restent à étendre.
|
||
|
||
**Données sur environnements déployés** : les services qui lisent des fichiers ou index (ex. **agent-regex-search-api** sous `REGEX_SEARCH_ROOT`, **langextract-api**, usages futurs côté orchestrateur) doivent pouvoir consommer un **répertoire local alimenté par SSH** depuis test / pprod / prod ; la déclaration des alias et chemins distants est dans `projects/<id>/conf.json` → **`smart_ide.remote_data_access`** — [features/remote-deployed-data-ssh.md](../features/remote-deployed-data-ssh.md).
|
||
|
||
Voir aussi : [services.md](../services.md), [system-architecture.md](../system-architecture.md), README de chaque dossier sous `services/`.
|