Documentation publique

Comprendre la plateforme sans ouvrir l’exploitation complète.

Cette documentation publique sert de couche de compréhension. Elle explique l’architecture, les projets visibles, l’usage de l’IA, la posture de sécurité et la logique d’organisation d’Incandia. Les procédures détaillées, runbooks exhaustifs et notes d’intervention restent du côté privé.

Navigation rapide

Lecture synthétique organisée par domaines plutôt qu’en simple liste brute de fichiers.

Démarrer

Les documents à lire en premier pour comprendre rapidement le périmètre et la structure de la plateforme.

Vue d’ensemble du VPS

Structure globale, organisation des dossiers, responsabilités et points d’entrée principaux.

README

Résumé général, liens utiles et lecture d’ensemble du projet VPS.

Projects

Inventaire synthétique des projets et outils visibles sur la plateforme.

Architecture

Comprendre le proxy, les stacks, les services et l’organisation du système.

Architecture

Vue globale du schéma, de l’exposition web et des flux principaux.

Services

Rôle des services existants et place de chaque brique dans l’écosystème.

Stacks

Organisation des stacks Docker par responsabilité métier.

Proxy

Routes Caddy, exposition des sous-domaines et logique de façade.

Services visibles

Documentation ciblée sur les briques principales exposées ou structurantes.

Docmost

Service de documentation privée et base de connaissance.

Navidrome

Service musique et pipeline associé.

SFTPGo

Service de transfert, dépôt et accès fichiers.

Uptime Kuma

Monitoring public et preuve de fonctionnement.

IA & automatisation

Le rôle de l’IA dans la plateforme: recherche, accélération et support à l’exploitation.

AI Workspace

Socle de travail pour la recherche locale, les vues ops et l’aide à l’intervention.

RAG

Indexation locale, recherche documentaire et logique du moteur de contexte.

Sécurité & méthode

La doc publique montre la posture générale. Le détail opérationnel reste privé.

Sécurité

Principes de sécurisation, séparation des accès et réduction de l’exposition brute.

ENV

Vue d’ensemble des variables et fichiers d’environnement, sans entrer dans les secrets.

Conventions de code

Normalisation, organisation du code et lisibilité des projets.

Ce qui reste privé

La documentation publique n’a pas vocation à devenir un manuel d’exploitation complet.

Runbooks détaillés

Procédures complètes de maintenance, dépannage et exploitation quotidienne.

Inventaire sensible

Détails plus fins sur les chemins, dépendances internes et panneaux privés.

Historique interne

REX, décisions d’implémentation et notes de travail conservées côté privé.