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:
49
CLAUDE.md
Normal file
49
CLAUDE.md
Normal 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) |
|
||||
Reference in New Issue
Block a user