# ADR-001 — Mise en place d’un serveur personnel

- **Statut** : En réflexion
- **Date** : 2026-05-16
- **Décideur** : Philippe A.
- **Contexte** : Infrastructure personnelle / PKM / IA / automatisation

---

# Contexte

Les usages numériques personnels et professionnels reposent aujourd’hui sur de nombreux services distribués :

- stockage cloud,
- outils collaboratifs,
- mails,
- PKM,
- IA génératives,
- automatisations,
- outils de développement,
- workflows documentaires.

Cette fragmentation limite :

- la centralisation des connaissances,
- l’automatisation continue,
- la souveraineté des données,
- la capitalisation long terme,
- l’exécution persistante des traitements.

Certaines limitations actuelles ont été identifiées :

- impossibilité de lancer ou poursuivre des tâches lorsque le poste principal est éteint ;
- dépendance des automatisations à la disponibilité de la machine utilisateur ;
- difficulté à exécuter des workflows continus ou longue durée ;
- absence de point central pour l’orchestration des outils et agents IA.

---

# Décision

Mettre en place un serveur personnel hébergé sur un VPS OVH, servant d'abord de socle minimal, sécurisé et maintenable pour :

- l’hébergement des services personnels ;
- l’automatisation des workflows ;
- la centralisation documentaire ;
- l’exécution continue des traitements ;
- l’exécution contrôlée d’agents de code ;
- la capitalisation des connaissances.

Le choix d'un VPS OVH est retenu pour éviter les contraintes d'un hébergement à domicile :

- disponibilité dépendante de la box Internet ;
- gestion de l'électricité et du matériel ;
- exposition réseau résidentielle ;
- maintenance physique ;
- accès distant moins stable.

Le serveur devra pouvoir devenir progressivement une base de :

- PKM augmenté ;
- infrastructure IA personnelle (PAI) ;
- orchestration documentaire ;
- mémoire numérique persistante.

Cette évolution reste conditionnée à la validation préalable du socle : accès, sécurité, sauvegardes, supervision et restauration.

---

# Non-objectifs initiaux

Les éléments suivants sont explicitement hors périmètre de la première mise en place :

- hébergement à domicile ;
- haute disponibilité ou cluster ;
- IA locale lourde nécessitant GPU ou ressources dédiées ;
- migration complète du PKM dès la phase 1 ;
- exposition publique large des services ;
- accès distant dépendant de VS Code Server / `code tunnel` ;
- agents IA autonomes avec droits système étendus.

---

# Objectifs

## Centralisation

Créer un point unique pour :

- documents,
- notes,
- sauvegardes,
- workflows,
- outils,
- connaissances,
- automatisations.

---

## Souveraineté numérique

Conserver la maîtrise :

- des données,
- des accès,
- des sauvegardes,
- des traitements IA,
- de l’hébergement.

---

## Exécution continue

Permettre :

- l’exécution de tâches en continu ;
- les traitements planifiés ;
- les workflows persistants ;
- les agents IA encadrés ;
- la reprise automatique des traitements.

---

## Infrastructure IA personnelle

Héberger progressivement :

- bases vectorielles,
- moteurs RAG,
- serveurs MCP,
- pipelines documentaires,
- agents IA,
- workflows automatisés.

---

## Capitalisation de la connaissance

Structurer durablement :

- ADR,
- documentation,
- comptes-rendus,
- tickets,
- playbooks,
- veille,
- décisions techniques.

---

# Conséquences attendues

## Positives

- centralisation des services ;
- meilleure maîtrise des données ;
- automatisation avancée ;
- exécution continue indépendante du poste utilisateur ;
- création d’une mémoire numérique durable ;
- socle technique pour les expérimentations IA.

---

## Négatives / contraintes

- maintenance supplémentaire ;
- supervision nécessaire ;
- gestion de la sécurité ;
- sauvegardes obligatoires ;
- augmentation progressive de la complexité ;
- responsabilité d’exploitation.

---

# Périmètre technique envisagé

## Infrastructure

- VPS OVH
- Ubuntu Server 24.04 LTS (sans interface graphique)
- Docker / Docker Compose
- Devcontainers (environnements de développement isolés)
- SSH durci — accès distant de référence pour administration et agents de code
- Reverse proxy : Traefik (Let's Encrypt natif, auto-découverte Docker)
- Restriction d'accès par IP fixe (UFW + middleware IPAllowList Traefik)

VS Code Server / `code tunnel` est volontairement exclu du périmètre initial. Il pourra être réévalué comme outil de confort pour l'édition distante, mais ne doit pas devenir une dépendance structurante de l'administration du serveur ni de l'exécution des agents.

---

## Données

- PostgreSQL
- stockage documentaire
- indexation full-text
- base vectorielle

---

## Environnements de développement

- Devcontainers Docker (un par projet / agent)
- Accès SSH / Remote SSH pour ouvrir et piloter les environnements distants
- Isolation par namespace ou Docker Compose par projet
- Volumes persistants pour l'état des projets

---

## IA / Automatisation

- moteurs RAG
- agents IA
- MCP servers
- workflows automatisés
- synchronisation documentaire

---

# Évolution envisagée

## Phase 1

- infrastructure de base ;
- sauvegardes ;
- hébergement applicatif ;
- centralisation documentaire.

## Phase 2

- PKM augmenté ;
- automatisation ;
- indexation documentaire ;
- recherche avancée.

## Phase 3

- infrastructure IA personnelle ;
- mémoire augmentée ;
- agents spécialisés ;
- orchestration avancée.
