timetrack-pro/docs/GITEA_GUIDE.md

Guide Gitea pour Claude

Credentials

Toujours lire en premier:

C:\Users\alexi\Documents\projects\ProjectTracker\.env

Contient:

• GITEA_URL - URL du serveur Gitea
• GITEA_TOKEN - Token d'authentification API

Creer un nouveau repo

1. Creer le repo sur Gitea via API

curl -X POST "https://git.etheryale.com/api/v1/user/repos" \
  -H "Authorization: token <GITEA_TOKEN>" \
  -H "Content-Type: application/json" \
  -d "{\"name\": \"<nom-repo>\", \"description\": \"<description>\", \"private\": false}"

Reponse: JSON avec clone_url et html_url

2. Initialiser git localement

cd "<chemin-projet>"
git init

3. Creer .gitignore adapte au projet

Exemple pour projet Access/VBA:

# Access lock files
*.laccdb
*.ldb

# Backups
.vba_backups/
*.bak

# Windows
Thumbs.db
Desktop.ini
nul
con
prn
aux

# Temp
*.tmp
~$*

4. Ajouter les fichiers

Important: Ne pas utiliser git add . si fichier nul existe (erreur Windows).

Ajouter fichiers specifiquement:

git add .gitignore README.md <autres-fichiers>
git add <dossiers>/
git status

5. Premier commit

git commit -m "$(cat <<'EOF'
Initial commit - <Nom Projet>

<Description des fichiers>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
EOF
)"

6. Configurer remote et push

git branch -M main
git remote add origin https://git.etheryale.com/StillHammer/<nom-repo>.git
git push -u origin main

---

Operations courantes

Commit et push

git add <fichiers>
git commit -m "Description du changement"
git push

Voir le status

git status
git log --oneline -5

Creer une branche

git checkout -b feature/ma-fonctionnalite
git push -u origin feature/ma-fonctionnalite

---

API Gitea - Endpoints utiles

Base URL: https://git.etheryale.com/api/v1

Action	Methode	Endpoint
Lister mes repos	GET	/user/repos
Creer repo	POST	/user/repos
Info repo	GET	/repos/StillHammer/<repo>
Supprimer repo	DELETE	/repos/StillHammer/<repo>
Lister branches	GET	/repos/StillHammer/<repo>/branches
Lister issues	GET	/repos/StillHammer/<repo>/issues
Creer issue	POST	/repos/StillHammer/<repo>/issues

Exemple: Lister mes repos

curl -H "Authorization: token <GITEA_TOKEN>" \
  "https://git.etheryale.com/api/v1/user/repos" | jq '.[].name'

---

Troubleshooting

Erreur "nul" ou fichier reserve Windows

Ajouter au .gitignore:

nul
con
prn
aux

Et ajouter fichiers specifiquement au lieu de git add .

Erreur proxy/connexion

Le fichier .env mentionne:

Use wget instead of curl for API calls due to proxy compatibility

Si curl echoue, essayer wget:

wget --header="Authorization: token <TOKEN>" \
  --header="Content-Type: application/json" \
  --post-data='{"name":"repo"}' \
  -qO- "https://git.etheryale.com/api/v1/user/repos"

Authentification git push

Si demande credentials, utiliser:

• Username: StillHammer
• Password: <GITEA_TOKEN>

Ou configurer credential helper:

git config credential.helper store

---

Template .gitignore par type de projet

Python

__pycache__/
*.pyc
*.pyo
.venv/
venv/
*.egg-info/
dist/
build/

Node.js

node_modules/
npm-debug.log
.env
dist/

Access/VBA

*.laccdb
*.ldb
.vba_backups/
~$*

---

Auteur: Claude Date: 2025-12-30