chore : import initial du dossier de travail (PRD, guides, recommandations doc2sveltekit)

Inclut SPECS_SVELTE.md : conventions Svelte 5/SvelteKit pour veille-ia, consolidées depuis doc2sveltekit-transition (playbook, charte OKI, best practices).
2026-08-01 09:18:27 -04:00
commit dc6bf1bbde
21 changed files with 5302 additions and 0 deletions
@@ -0,0 +1,56 @@
+# Pousser un projet sur Gitea (labola.o-k-i.net)
+
+Mémo rédigé le 2026-07-19 après la mise en ligne de `gwada-sirius`.
+À relire avant de pousser un autre projet sur `https://labola.o-k-i.net/cyber-mawonaj`.
+
+## Prérequis déjà en place (setup unique, fait)
+
+- **Instance Gitea** : `https://labola.o-k-i.net`, namespace `cyber-mawonaj`.
+- **Clé SSH dédiée** : `~/.ssh/id_ed25519_gitea` (sans passphrase), enregistrée dans
+  Gitea → Paramètres → Clés SSH (`https://labola.o-k-i.net/user/settings/keys`).
+- **Entrée dans `~/.ssh/config`** pour utiliser cette clé automatiquement :
+
+  ```
+  Host labola.o-k-i.net
+      IdentityFile ~/.ssh/id_ed25519_gitea
+      IdentitiesOnly yes
+  ```
+
+- ⚠️ `id_rsa` (et les autres clés du compte) ont une passphrase et **ne fonctionnent
+  pas** en non-interactif (pas d'agent SSH). Toujours utiliser `id_ed25519_gitea`.
+- Test de connexion : `ssh -T git@labola.o-k-i.net` doit répondre
+  `Hi there, cyber-mawonaj! ...`
+
+## Procédure pour un nouveau projet
+
+1. **Créer le dépôt vide sur Gitea** (interface web) :
+   - Aller sur `https://labola.o-k-i.net/repo/create`
+   - Propriétaire : `cyber-mawonaj` ; nom : celui du projet
+   - ⚠️ **Décocher « Initialiser le dépôt »** (pas de README/licence/.gitignore),
+     sinon le premier push est refusé (historiques différents).
+2. **Côté local**, dans le dossier du projet :
+   - Vérifier l'état : `git status` (commits présents, copie propre).
+   - Vérifier que `.gitignore` exclut `node_modules/`, les builds (`_site/`, `dist/`…), `.env`.
+3. **Ajouter le remote** (garder `origin` si un remote GitHub existe déjà) :
+
+   ```bash
+   git remote add gitea git@labola.o-k-i.net:cyber-mawonaj/<nom-du-projet>.git
+   ```
+
+4. **Pousser** (demander confirmation à l'utilisateur avant) :
+
+   ```bash
+   git push -u gitea main   # ou master, vérifier avec `git branch --show-current`
+   ```
+
+5. **Vérifier** : `git ls-remote gitea main` doit afficher le même hash que `git rev-parse main`.
+
+## Effets de bord à connaître
+
+- Après `git push -u gitea main`, la branche suit `gitea/main` : un simple `git push`
+  ira vers Gitea. Pour GitHub : `git push origin main` explicite.
+- Si la clé SSH est refusée (`Permission denied (publickey)`) : vérifier que la clé
+  est bien enregistrée dans Gitea et que l'entrée `Host labola.o-k-i.net` existe dans
+  `~/.ssh/config`.
+- Alternative à l'interface web pour créer le dépôt : l'API Gitea avec un token
+  (`POST /api/v1/orgs/cyber-mawonaj/repos`), non utilisée ici.