bruno
d94817bac5
- ROADMAP: v1.3.0 déplacé dans Completed, item checkboxes [x] - WORKLOAD: réécrit pour refléter v1.3.0 + plan v1.4.0 - README: version 1.3.0, features à jour, tests 34/34
90 lines
2.5 KiB
Markdown
90 lines
2.5 KiB
Markdown
# FlowDeck
|
||
|
||
Clone de l'interface **Notion** intégré nativement à **Gitea** — Databases, Pages, Kanban, Table, multi-vues.
|
||
|
||
> **v1.3.0** — Database Concept (collections, pages, vues, GiteaBoardCompat)
|
||
|
||
## Quick Start
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
# Éditer .env avec votre token Gitea
|
||
docker compose up -d
|
||
# → http://localhost:8080
|
||
```
|
||
|
||
## Features
|
||
|
||
### Database Concept (v1.3.0)
|
||
- **Collections**: databases indépendantes de Gitea, schéma JSON, icon, description
|
||
- **Pages**: propriétés JSON, position, parent_id (sub-items ready), lien Gitea optionnel
|
||
- **Vues**: configurables (type, filters, sorts, visible_properties)
|
||
- **GiteaBoardCompat**: adaptateur boards Gitea legacy → Collections
|
||
- **API REST**: CRUD complet collections + pages (12 endpoints)
|
||
|
||
### UI Notion-Style (v1.1–v1.2)
|
||
- **Sidebar gauche** avec sections hiérarchiques (Recents, Private, Library, Trash)
|
||
- **Topbar** avec breadcrumbs (workspace > projet > page)
|
||
- **Dark mode** Notion: `#191919` fond, `#222222` sidebar, `#333333` actif
|
||
- **Éditeur de blocs** Notion-style: slash menu (/), navigation clavier, placeholders
|
||
- **Drag & drop** pages dans la sidebar (SortableJS)
|
||
|
||
### Vues Multiples (v0.5–v0.8)
|
||
- **Kanban board**: colonnes avec sous-groupes, drag & drop cartes
|
||
- **Table view**: colonnes triables, groupes rétractables
|
||
- **Status overview**: Donut chart SVG avec segments, compteurs
|
||
- **Team Load**: Barres empilées par membre
|
||
- **Detailed board**: cartes avec propriétés visibles
|
||
|
||
### Filtres & Tri (v0.7)
|
||
- **Filtres cumulables** (logique AND) avec pastilles
|
||
- **Tri multi-critères** hiérarchique
|
||
- **Filtre par statut**: checkboxes multiples
|
||
|
||
### Intégration Gitea
|
||
- **Issues Gitea → cartes** Notion-style
|
||
- Sync labels, milestones, assignees, due dates
|
||
- OAuth2 Gitea, CSRF, rate limiting
|
||
- Webhooks pour sync temps réel
|
||
|
||
## Stack
|
||
|
||
| Couche | Techno |
|
||
|--------|--------|
|
||
| Frontend | Jinja2 + HTMX + Alpine.js + SortableJS + CSS 31KB |
|
||
| Backend | Python 3.12 + FastAPI + httpx |
|
||
| BDD | SQLite (WAL mode) — `/data/flowdeck.db` |
|
||
| Déploiement | Docker (python:3.12-slim), docker-compose |
|
||
|
||
## Configuration
|
||
|
||
```env
|
||
GITEA_URL=https://git.dracodev.net
|
||
GITEA_TOKEN=votre_token
|
||
APP_PORT=8080
|
||
DATABASE_URL=sqlite:////data/flowdeck.db
|
||
```
|
||
|
||
## Roadmap
|
||
|
||
Voir [ROADMAP.md](ROADMAP.md) — v1.4.0 Propriétés Avancées → v2.0.0 Multi-Users.
|
||
|
||
## Développement
|
||
|
||
```bash
|
||
python3 -m venv venv
|
||
source venv/bin/activate
|
||
pip install -r requirements.txt
|
||
uvicorn app.main:app --reload --port 8080
|
||
```
|
||
|
||
## Tests
|
||
|
||
```bash
|
||
python3 -m pytest tests/ -v # 34/34 passent
|
||
```
|
||
|
||
## Licence
|
||
|
||
MIT
|