Create documentation for project architecture, deployment, and usage

Add DAT, DEX, GITEA_TUTO, and WIKI markdown files to the docs directory, and update agent_assets_metadata.toml to include these new documents. Replit-Commit-Author: Agent Replit-Commit-Session-Id: 923ae0e3-a363-4db8-b04a-e8baca2a1330 Replit-Commit-Checkpoint-Type: full_checkpoint Replit-Commit-Event-Id: 4bb1a658-d577-451e-965c-fa15e2c21ca9 Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/8af7d2ec-2cc3-4ece-8af3-9f071488d072/923ae0e3-a363-4db8-b04a-e8baca2a1330/RusmVRz Replit-Helium-Checkpoint-Created: true
2026-04-04 06:56:49 +00:00
parent e2a0b6401d
commit 213a67e612
5 changed files with 727 additions and 0 deletions
@@ -0,0 +1,156 @@
+# Récupérer le projet sur Gitea
+
+Ce tutoriel explique comment pousser le code de **La Voix du Peuple** depuis Replit vers votre instance Gitea, et comment vous synchroniser ensuite à votre rythme.
+
+---
+
+## Prérequis
+
+- Une instance Gitea accessible (ex. `https://git.mondomaine.fr`)
+- Un compte avec les droits de création de dépôt
+- Git installé localement (si vous travaillez aussi depuis votre poste)
+
+---
+
+## Étape 1 — Créer le dépôt sur Gitea
+
+1. Connectez-vous à votre Gitea
+2. Cliquez sur **+ New Repository**
+3. Nom suggéré : `voix-du-peuple`
+4. Laissez-le **vide** (pas de README, pas de .gitignore)
+5. Notez l'URL du dépôt — elle ressemble à :
+   - SSH : `git@git.mondomaine.fr:vous/voix-du-peuple.git`
+   - HTTPS : `https://git.mondomaine.fr/vous/voix-du-peuple.git`
+
+---
+
+## Étape 2 — Ajouter Gitea comme remote depuis Replit
+
+Dans le shell Replit (onglet **Shell**) :
+
+```bash
+# Vérifier les remotes actuels
+git remote -v
+
+# Ajouter votre Gitea comme remote (choisissez SSH ou HTTPS)
+git remote add gitea git@git.mondomaine.fr:vous/voix-du-peuple.git
+# ou en HTTPS :
+git remote add gitea https://git.mondomaine.fr/vous/voix-du-peuple.git
+
+# Vérifier
+git remote -v
+```
+
+---
+
+## Étape 3 — Configurer l'authentification
+
+### Option A — SSH (recommandé)
+
+Générez une clé SSH dans le shell Replit si vous n'en avez pas :
+
+```bash
+ssh-keygen -t ed25519 -C "replit-voix-du-peuple"
+cat ~/.ssh/id_ed25519.pub
+```
+
+Copiez la clé publique affichée et ajoutez-la dans Gitea :
+**Paramètres → Clés SSH → Ajouter une clé**
+
+Testez la connexion :
+
+```bash
+ssh -T git@git.mondomaine.fr
+```
+
+### Option B — HTTPS avec token
+
+Dans Gitea : **Paramètres → Applications → Générer un token**
+
+Utilisez l'URL avec token :
+
+```bash
+git remote set-url gitea https://VOTRE_TOKEN@git.mondomaine.fr/vous/voix-du-peuple.git
+```
+
+---
+
+## Étape 4 — Pousser le code
+
+```bash
+# Premier push (établit le tracking)
+git push -u gitea main
+
+# Pour les push suivants
+git push gitea main
+```
+
+---
+
+## Étape 5 — Récupérer les mises à jour depuis Replit
+
+Chaque fois que vous voulez synchroniser votre Gitea avec l'état actuel du projet Replit :
+
+```bash
+# Depuis le shell Replit
+git push gitea main
+```
+
+Si vous avez également modifié des fichiers directement sur Gitea :
+
+```bash
+git pull gitea main --rebase
+git push gitea main
+```
+
+---
+
+## Étape 6 — Cloner depuis Gitea sur votre serveur de production
+
+Sur votre serveur RockyLinux / Debian :
+
+```bash
+git clone git@git.mondomaine.fr:vous/voix-du-peuple.git
+cd voix-du-peuple
+
+# Copier et adapter les variables d'environnement
+cp .env.example .env
+nano .env   # Renseignez DATABASE_URL, MISTRAL_API_KEY, SESSION_SECRET
+
+# Suivre ensuite le guide DEPLOIEMENT.md
+```
+
+---
+
+## Résumé des commandes utiles
+
+```bash
+# Voir l'état du dépôt
+git status
+git log --oneline -10
+
+# Synchroniser vers Gitea
+git push gitea main
+
+# Récupérer depuis Gitea
+git pull gitea main
+
+# Voir les remotes configurés
+git remote -v
+```
+
+---
+
+## Structure des branches
+
+| Branche | Usage |
+|---------|-------|
+| `main` | Code de production, stable |
+| `replit-agent` | Branche de travail de l'agent Replit (interne) |
+
+> Il est conseillé de ne travailler que sur `main` et de ne jamais pousser `replit-agent` vers votre Gitea.
+
+```bash
+# Pousser uniquement main
+git push gitea main
+```