Eric / documentation

# Documentation gitrust

> Documentation officielle de **gitrust**, une forge Git self-hosted écrite en Rust et conforme ANSSI PA-074. La plateforme offre un hébergement de dépôts Git avec protocoles HTTP et SSH natifs, revue de code par pull requests, système d'issues, CI/CD intégrée via Dagger, génération SBOM, authentification à deux facteurs, et gestion fine des permissions par équipes.

Cette documentation est structurée selon la méthodologie [Diátaxis](https://diataxis.fr) (tutorials / how-to / reference / explanation) et couvre quatre audiences distinctes : utilisateurs finaux, administrateurs système, contributeurs au code, et ingénieurs qui intègrent l'API.

## Manuel utilisateur

- [Manuel utilisateur](https://demo.gitrust.eu/docs/fr/user_manual/index.html): vue d'ensemble pour les développeurs qui utilisent gitrust au quotidien
- [Premier pas](https://demo.gitrust.eu/docs/fr/user_manual/tutorials/01-premier-pas.html): inscription, activation 2FA, création d'un dépôt
- [Cloner et pousser](https://demo.gitrust.eu/docs/fr/user_manual/tutorials/02-cloner-pousser.html): SSH keys, clone, premier push
- [Collaborer](https://demo.gitrust.eu/docs/fr/user_manual/tutorials/03-collaborer.html): équipes, issues, pull requests
- [Automatiser avec la CI](https://demo.gitrust.eu/docs/fr/user_manual/tutorials/04-automatiser-ci.html): premier .gitrust-ci.yml
- [API REST v1](https://demo.gitrust.eu/docs/fr/user_manual/reference/api-rest-v1.html): auth, pagination, codes erreur
- [Modèle de permissions](https://demo.gitrust.eu/docs/fr/user_manual/reference/modele-permissions.html): matrice des 4 rôles

## Manuel d'administration

- [Manuel d'administration](https://demo.gitrust.eu/docs/fr/administration_manual/index.html): vue d'ensemble ops/self-hosting
- [Installation Docker](https://demo.gitrust.eu/docs/fr/administration_manual/tutorials/01-installation-docker.html): stack docker-compose complète
- [Installation systemd](https://demo.gitrust.eu/docs/fr/administration_manual/tutorials/02-installation-systemd.html): binaire natif + unit durci
- [Mise en production TLS](https://demo.gitrust.eu/docs/fr/administration_manual/tutorials/04-mise-en-production-192-168.html): reverse-proxy Let's Encrypt
- [Variables d'environnement](https://demo.gitrust.eu/docs/fr/administration_manual/reference/variables-environnement.html): référence exhaustive du .env
- [Schéma de la base de données](https://demo.gitrust.eu/docs/fr/administration_manual/reference/schema-base-de-donnees.html): ERD + tables
- [Conformité ANSSI PA-074](https://demo.gitrust.eu/docs/fr/administration_manual/reference/conformite-anssi-pa074.html): checklist par exigence
- [Sauvegarder et restaurer](https://demo.gitrust.eu/docs/fr/administration_manual/how-to/sauvegarder-restaurer.html): pg_dump + repos + SSH keys
- [Durcir avec Fail2ban](https://demo.gitrust.eu/docs/fr/administration_manual/how-to/durcir-avec-fail2ban.html): jails SSH/HTTP
- [Dependency-Track + SBOM](https://demo.gitrust.eu/docs/fr/administration_manual/how-to/integrer-dependency-track.html): intégration CI

## Manuel développeur

- [Manuel développeur](https://demo.gitrust.eu/docs/fr/developer_manual/index.html): vue d'ensemble contributeurs + API clients
- [Démarrage contributeur](https://demo.gitrust.eu/docs/fr/developer_manual/tutorials/01-getting-started.html): cloner, builder, lancer
- [Première contribution](https://demo.gitrust.eu/docs/fr/developer_manual/tutorials/02-premiere-contribution.html): TDD, QA, PR
- [Worker async (capstone)](https://demo.gitrust.eu/docs/fr/developer_manual/tutorials/03-creer-un-worker-async.html): patron complet
- [Architecture par crates](https://demo.gitrust.eu/docs/fr/developer_manual/reference/architecture-crates.html): les 6 crates
- [Schéma de la base de données](https://demo.gitrust.eu/docs/fr/developer_manual/reference/schema-base-donnees.html): ERD orienté dev
- [Règles QA ANSSI](https://demo.gitrust.eu/docs/fr/developer_manual/reference/regles-qa-anssi.html): gates, lints, checklist
- [API REST v1](https://demo.gitrust.eu/docs/fr/developer_manual/reference/api-rest-v1.html): référence API complète
- [Ajouter une route web](https://demo.gitrust.eu/docs/fr/developer_manual/how-to/ajouter-route-web.html): patron axum handler
- [Ajouter un service métier](https://demo.gitrust.eu/docs/fr/developer_manual/how-to/ajouter-service-metier.html): structure + tests
- [Ajouter une migration DB](https://demo.gitrust.eu/docs/fr/developer_manual/how-to/ajouter-migration-db.html): SeaORM, up/down

## Templates copiables

- [Catalogue des templates](https://demo.gitrust.eu/docs/fr/template/index.html): configs, docker-compose, nginx, systemd, CI, clients API

## Autres ressources

- [Site principal](https://gitrust.eu/): présentation commerciale de la plateforme
- [Licence CC BY 4.0](https://creativecommons.org/licenses/by/4.0/): licence de la documentation