smart_ide/docs/README.md

Documentation technique — smart_ide

Index principal. Les fonctionnalités détaillées sont dans features/. La documentation opérationnelle regroupée (anciens README.md à la racine et sous cron/, projects/, services/, etc.) est dans repo/.

Configuration locale agrégée

Fichier	Rôle
config/services.local.env.example	Ports, jetons, SMART_IDE_MONOREPO_ROOT — copier vers config/services.local.env
config/README.md	Rôle du répertoire config/
packages/smart-ide-upstreams/README.md	Clés d’amont HTTP partagées (@4nk/smart-ide-upstreams) pour l’API globale et le SSO

Documentation du dépôt (repo/)

Vue d’ensemble et index complet : repo/README.md. Règles/agents IDE : repo/smartide-config-directory.md.

Document	Contenu
repo/smart-ide-overview.md	Vision produit, stack, liens architecture
repo/projects-directory.md	projects/<id>/conf.json, clones, active-project.json
repo/cron-git-pull.md	Pull planifié, cron/config.env, systemd user
repo/systemd-units.md	Ollama, AnythingLLM, timer git-pull
repo/logs-directory.md	Fichiers journaux locaux sous logs/
repo/docv-services-directory.md	Répertoire services/docv/, contrat intégration
repo/docv-enso-docs-mirror.md	Miroir services/docv/enso-docs/
repo/ia-dev-smart-ide-integration.md	Module ia_dev dans smart_ide
repo/ia-dev-repository-overview.md	Dépôt ia_dev : agents, deploy
repo/ia-dev-project-conf-schema.md	Schéma conf.json, résolution projet
repo/ia-dev-deploy-lib.md	ia_dev/deploy/lib/
repo/ia-dev-shared-lib.md	ia_dev/lib/project_config.sh
repo/service-*.md	Exploitation de chaque micro-service (voir index repo/README)
repo/script-anythingllm-pull-sync.md	Hook post-merge → AnythingLLM
repo/service-anythingllm-devtools.md	Service HTTP AnythingLLM + devtools
repo/service-carbonyl.md	Carbonyl (navigateur terminal), prévisualisation test
repo/service-pageindex.md	PageIndex (index vectorless, définition sémantique documents)
repo/service-smart-ide-tools-bridge.md	Pont HTTP IDE + sous-modules CLI
repo/service-smart-ide-global-api.md	API HTTP interne : proxy vers micro-services (jetons techniques)
repo/service-smart-ide-sso-gateway.md	Passerelle OIDC utilisateur → API globale → micro-services
repo/service-chandra.md	Chandra OCR (PDF / images structurés)
repo/extension-anythingllm-workspaces.md	Extension AnythingLLM IDE (supprimée ; voir anythingllm-devtools)

Les fichiers README.md sous services/*/, cron/, projects/, etc. ne font que renvoyer vers ces pages.

Architecture et déploiement

Document	Contenu
services-functional-scope.md	Périmètre fonctionnel des services, rôle IDE vs backends applicatifs
platform-target.md	Vision plateforme en ligne, 3 envs, machine IA unique vs SSH, SSO, navigateur optionnel
implementation-rollout.md	Déroulé du plan plateforme : doc + code minimal, suites
system-architecture.md	Couches, monorepo, cartographie des dossiers, gateway, OpenShell, micro-services
ecosystem-architecture-and-sync.md	smart_ide, projets développés, API IA, Ollama / AnythingLLM / Git ; automation et synchro
core-ide.md	Socle applicatif Lapce : core_ide/, clone amont, build
deployment-target.md	Client Linux + SSH, variante machine IA unique, serveur socle IA et repos
infrastructure.md	SSH, accès hôte, renvois vers les scripts
services.md	Ollama, AnythingLLM, Local Office, micro-services HTTP ; renvoie vers la vue fonctionnelle détaillée

Référence API des services (API/)

Document	Contenu
API/README.md	Index : auth, ports, liens vers chaque service
API/repos-devtools-server.md	Clone / liste / load de dépôts Git
API/langextract-api.md	Extraction structurée (LangExtract)
API/claw-harness-proxy.md	Proxy HTTP vers serveur claw-code
API/agent-regex-search-api.md	Recherche regex fichiers (ripgrep)
API/local-office.md	Documents Office (upload, commandes docx)
API/ia-dev-gateway.md	Gateway ia_dev — agents, runs, SSE (spécification)
API/orchestrator.md	Orchestrateur intentions — routage (spécification)

Workspaces et IDE

Document	Contenu
anythingllm-workspaces.md	Un workspace AnythingLLM par projet, synchronisation
features/carbonyl-terminal-browser.md	Carbonyl, URL test dans conf.json
features/pageindex-semantic-documents.md	PageIndex, arbre sémantique PDF / Markdown
features/chandra-ocr-documents.md	Chandra OCR, mise en page
ux-navigation-model.md	Intentions, recherche, mode expert

Intégration dépôts

Document	Contenu
ia_dev-module.md	Module ia_dev dans le dépôt, agents ; confs dans projects/<id>/
ia_dev-project-smart_ide.md	Projet Cursor / conf smart_ide
repo/logs-directory.md	Journaux : pull planifié, ia_dev
repo/ia-dev-smart-ide-integration.md	Contrat intégration services/ia_dev/

Données déployées et SSH

Document	Contenu
features/remote-deployed-data-ssh.md	Données hors Git sur test/pprod/prod ; SSH ; bloc smart_ide dans conf.json ; active-project.json

Fonctionnalités (features/)

Document	Contenu
features/local-office.md	Local Office — API REST Office dans services/local-office/
features/langextract-api.md	API locale LangExtract
features/claw-harness-api.md	Harnais claw-code, proxy
features/agent-regex-search-api.md	Recherche regex code (ripgrep)
features/anythingllm-pull-sync-after-pull.md	Synchro AnythingLLM après pull
features/initial-rag-sync-4nkaiignore.md	RAG initial et .4nkaiignore
features/ia-dev-service.md	Service ia-dev-gateway, fork ia_dev, migration
features/orchestrator-api.md	Contrat HTTP orchestrateur (Ollama, ALLM, services)
features/lapce-porting-roadmap.md	Phases portage surface AnythingLLM → Lapce (service HTTP + UI)
features/sso-docv-enso.md	OIDC front ↔ docv (Enso)
features/docv-ai-integration.md	Backend docv : API IA smart_ide, clones ../projects/, AnythingLLM
features/docv-service-integration.md	docv gestion documentaire, ../projects/<id>/data, DOCV_PROJECTS_ROOT, multi-hôte
features/browser-automation-criteria.md	Critères service navigateur optionnel