Files
kanbante/README.md
T
bruno 3732b5cb45 feat: Kanbante v0.1.0 — Kanban Git-integrated PM tool
- Dashboard with all Gitea projects (active/archived)
- Kanban board per project (Backlog → À faire → En cours → Révision → Terminé)
- Drag & drop issues between columns (SortableJS)
- Project notes panel
- Gitea API integration (read issues, repos)
- SQLite local state for board positions
- Dark theme design system
- Docker-ready (Dockerfile + docker-compose.yml)
- FastAPI + Jinja2 + HTMX + Alpine.js stack
2026-07-07 23:24:15 -04:00

71 lines
1.9 KiB
Markdown

# Kanbante
**Kanban project manager integrated with Gitea** — lightweight, self-hosted, dark theme.
## Features
- 📋 **Dashboard** — tous tes projets Gitea en un coup d'œil (actifs / archivés)
- 🗂️ **Kanban Board** — colonnes Backlog → À faire → En cours → Révision → Terminé
- 🎯 **Drag & Drop** — glisse les issues entre colonnes
- 🔗 **Gitea Sync** — les issues Gitea deviennent des cartes Kanban
- 📝 **Notes** — bloc-notes par projet
- 🌙 **Dark theme** — conçu pour les longues sessions
- 🐳 **Docker** — un seul conteneur, déploiement en 30 secondes
## Quick Start
```bash
# 1. Installer les dépendances
cd kanbante
pip install -e .
# 2. Configurer les variables d'environnement
export GITEA_URL=https://git.dracodev.net
export GITEA_TOKEN=ton_token_gitea
# 3. Lancer
uvicorn app.main:app --reload --port 8080
```
Ouvrir http://localhost:8080
## Docker
```bash
echo "GITEA_TOKEN=ton_token" > .env
docker compose up -d
```
## Architecture
```
kanbante/
├── app/
│ ├── main.py # FastAPI app (routes + API)
│ ├── gitea_client.py # Client API Gitea
│ ├── models.py # SQLite (état du board local)
│ └── templates/ # Jinja2 (dashboard.html, board.html)
├── static/
│ ├── css/style.css # Design system dark theme
│ └── js/board.js # Drag & drop (SortableJS)
├── Dockerfile
├── docker-compose.yml
└── README.md
```
## API
| Méthode | Route | Description |
|---------|-------|-------------|
| GET | `/` | Dashboard tous les projets |
| GET | `/board/{owner}/{repo}` | Kanban board |
| POST | `/api/move` | Déplacer une issue |
| POST | `/api/notes` | Sauvegarder des notes |
| GET | `/api/stats` | Statistiques JSON |
| GET | `/api/projects` | Projets JSON |
| GET | `/api/health` | Health check |
## Licence
MIT