Set-OPS-Public/README.md

# Set-OPS — moteur d'écosystèmes numériques souverains

Set-OPS construit et exploite un **écosystème numérique souverain** sur une grappe
**Proxmox**, à partir d'un **plan déclaratif** : DNS, AC interne, identité (LDAP + SSO),
courriel, bases de données, observabilité, forge, applications web. Logiciel libre
exclusivement ; ni Docker, ni Podman.

- **Moteur** (ce dépôt) : rôles Ansible, playbooks, scripts de dérivation, preuves.
- **Écosystème** : un dépôt par locataire (`OPS-<nom>`) — son plan, son inventaire
  généré, sa voûte. Un dépôt par site d'hébergement (`SITE-<nom>`) — son underlay, sa
  frontière.
- **Plan → inventaire → déploiement** : on édite le plan, le moteur génère l'inventaire et
  l'ordre de déploiement, Ansible applique. L'inventaire ne s'édite jamais à la main.
- **Sans IA** : la doc, `make` et le GUI suffisent à l'exploiter.

## Démarrage rapide

Prérequis : une grappe Proxmox et un jeton d'API, un poste Linux avec Python 3, Ansible,
`make` et `git`, une paire de clés SSH.

```bash
git clone <url-de-Set-OPS> Set-OPS && cd Set-OPS

# 1. Un écosystème, depuis le modèle public, et la clé de sa voûte
make instance-creer NOM=OPS-MonOrg MODELE=socle
ln -s ../OPS-MonOrg instance
install -m 600 /dev/null ~/.config/setops-vault-ops-monorg   # la phrase de passe, une ligne
#    renseigner domaine_interne, nomenclature, domaines, placement : docs/setup.md §3

# 2. Proxmox et le gabarit Debian 13 (une fois par grappe)
make config
make preparer-modele && make verifier-modele && make nettoyer-modele CONFIRMER=true

# 3. Inventaire, VM, déploiement
make instancier && make instancier-appliquer FORCE=1
make creer-vm HOTE=infra-dns-01
make deployer HOTE=infra-dns-01

# 4. Vérifier
make verifier
```

Chaque étape, ses fichiers et ses pièges : [`docs/setup.md`](docs/setup.md).

## Documentation

| Document | Contenu |
|---|---|
| [`docs/README.md`](docs/README.md) | l'index : par situation, par lecteur |
| [`docs/architecture.md`](docs/architecture.md) | composants, flux de données, réseau, sécurité |
| [`docs/setup.md`](docs/setup.md) | installation et configuration |
| [`docs/usage.md`](docs/usage.md) | conventions, variables, toutes les commandes |
| [`wiki/Home.md`](wiki/Home.md) | le métier, pas à pas |
| [`AGENTS.md`](AGENTS.md) | les règles d'autorité du dépôt |

## Licence

Copyright (C) 2026 Daniel Allaire — Chezlepro / Alliance Boréale. Logiciel libre sous
**GNU Affero General Public License v3** ou ultérieure : voir [`LICENSE`](LICENSE). Pourquoi
l'AGPLv3, et le modèle libre + services : [`docs/projet/positionnement.md`](docs/projet/positionnement.md) §6.