chore: init project structure

Discovery synthesis, docs tree, Python src layout, CLAUDE.md, pyproject.toml.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
sylvain
2026-03-10 18:21:33 +01:00
parent 11e5def11c
commit 4e72ddc32f
14 changed files with 324 additions and 1 deletions

49
CLAUDE.md Normal file
View File

@@ -0,0 +1,49 @@
# gitea-dashboard
Dashboard CLI Python affichant l'etat des repos Gitea (issues, releases, milestones).
## Stack
- **Langage** : Python 3.x
- **Dependances** : requests, rich
- **API** : Gitea REST v1
- **Instance** : http://192.168.0.106:3000
## Principes
1. **Lecture seule** — le dashboard ne modifie jamais de donnees Gitea
2. **Configuration externalisee** — token et URL en variables d'environnement, jamais dans le code
3. **Separation des responsabilites** — client API / formatage / point d'entree distincts
4. **Gestion gracieuse** — un repo sans release ou milestone ne casse pas l'affichage
## Points d'attention
- Ne jamais committer de token ou secret
- Gerer la pagination API Gitea (reponses potentiellement tronquees)
- Tester avec des repos sans release et sans milestone
- L'API Gitea peut varier selon la version — tester sur l'instance reelle
## Commandes
```bash
# Installation
pip install -e .
# Execution
gitea-dashboard
# ou
python -m gitea_dashboard
# Tests
pytest
# Lint
ruff check src/ tests/
```
## Variables d'environnement
| Variable | Description | Defaut |
|----------|-------------|--------|
| `GITEA_URL` | URL de l'instance Gitea | http://192.168.0.106:3000 |
| `GITEA_TOKEN` | Token API Gitea | (requis) |