# 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