Nicolas Cantu
ac96434351
**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.
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/.
Documentation du dépôt (repo/)
Vue d’ensemble et index complet : repo/README.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/extension-anythingllm-workspaces.md | Extension VS Code / Cursor |
Les fichiers README.md sous services/*/, cron/, projects/, etc. ne font que renvoyer vers ces pages.
Architecture et déploiement
| Document | Contenu |
|---|---|
| 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 sous services/ |
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 |
| 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 extension AnythingLLM → Lapce |
| 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 |