gitea-dashboard/docs/project/descriptif.md

Descriptif — gitea-dashboard

Contexte

Supervision de l'instance Gitea personnelle (192.168.0.106:3000). Pas de vue d'ensemble disponible sans naviguer repo par repo dans l'interface web.

Objectifs

• Afficher en une commande l'etat de tous les repos Gitea
• Visualiser les issues ouvertes, dernieres releases et milestones
• Fournir un output terminal lisible et structure

Perimetre

Inclus

• Connexion API Gitea avec authentification token
• Liste de tous les repos de l'utilisateur
• Nombre d'issues ouvertes par repo
• Derniere release par repo (tag + date)
• Etat des milestones (nom, progression open/closed)
• Formatage rich (tableaux, couleurs)

Exclus

• Interface web ou GUI
• Mode watch / rafraichissement automatique
• Filtrage par owner/organisation
• Modification de donnees (lecture seule)
• Notifications ou alertes

Utilisateurs cibles

Administrateur unique de l'instance Gitea. Usage terminal.

Contraintes

• Python 3.x
• Dependances : requests, rich
• API Gitea REST v1
• Token en variable d'environnement (GITEA_TOKEN)
• Instance locale : http://192.168.0.106:3000

References

• API Gitea : https://gitea.io/en-us/ (documentation Swagger disponible sur l'instance)
• Rich : https://rich.readthedocs.io/