All. Done API v1.3.0

Backend API REST moderne pour la gestion collaborative de projets avec authentification JWT, stockage de fichiers, recherche full-text et suggestions IA.

📚 Documentation

Pour les utilisateurs

• Guide de démarrage rapide - Commencez ici !
• Documentation API - README principal
• SDK TypeScript - Utiliser le SDK dans votre projet
• Exemples SDK - Exemples de code exécutables

Pour les développeurs

• Spécification Backend - Spécification complète de l’API
• Système de rôles - ACL et permissions
• Guide de déploiement - Déploiement en production
• File Versioning - Gestion du versioning de fichiers
• Production Readiness - État de production readiness

Guides techniques

• Configuration OpenAPI & SDK - Comment fonctionne la génération du SDK
• Scripts de génération - Utilisation des scripts
• Résumé du commit - Historique des modifications

🚀 Fonctionnalités

Gestion de projets

• Workspaces - Organisation multi-projets
• Projects - Gestion de projets avec codes uniques
• WBS (Work Breakdown Structure) - Décomposition hiérarchique
• Tasks - Gestion de tâches avec états, priorités, estimations
• Subtasks - Sous-tâches avec progression

Collaboration

• Teams - Équipes avec rôles personnalisés
• ACL (Access Control) - Contrôle d’accès granulaire
• File Management - Upload, versioning, liens vers entités
• WebSocket - Édition collaborative temps réel

Intelligence Artificielle (Mistral AI)

• 🤖 Task Breakdown - Décomposition automatique de work packages
• 💡 Task Suggestions - Suggestions d’amélioration
• 📊 Estimations - Estimation d’effort par IA
• 🗂️ WBS Generation - Génération de WBS pour nouveaux projets

Recherche & Navigation

• Full-Text Search (FTS5) - Recherche avancée multi-entités
• Advanced Filtering - Filtres sur assignees, states, dates, types
• Pagination - Cursor-based pagination pour performance
• Sorting - Tri multi-critères (priority, wbs_index, dates)

🎯 Quick Start

Installation

git clone https://github.com/wolf75222/alldoneserver
cd alldoneserver
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

Configuration

cp .env.example .env
# Éditer .env avec JWT_SECRET, MISTRAL_API_KEY, etc.

Lancer l’API

# Initialiser la base de données
python -c "from app.db.engine import init_db; init_db()"

# Démarrer le serveur
uvicorn app.main:app --reload --host 0.0.0.0 --port 8080

API disponible: http://localhost:8080 Documentation interactive: http://localhost:8080/docs

Utiliser le SDK TypeScript

import { OpenAPI, AuthService, TasksService } from './sdk';

// Configuration
OpenAPI.BASE = 'http://localhost:8080';

// Login
const { access } = await AuthService.login({
  email: 'user@example.com',
  password: 'password123'
});

OpenAPI.TOKEN = access;

// Créer une tâche
const task = await TasksService.createTask({
  project_id: 'project_id',
  wbs_id: 'wbs_id',
  title: 'Ma tâche',
  state: 'todo'
});

Voir documentation complète du SDK.

📦 SDK Client

Le SDK TypeScript est pré-généré et prêt à l’emploi dans le dossier sdk/.

Services disponibles:

• AuthService - Authentification
• WorkspacesService - Gestion des workspaces
• ProjectsService - Gestion des projets
• TasksService - Gestion des tâches
• WbsService - Work Breakdown Structure
• FilesService - Gestion de fichiers
• TeamsService - Gestion d’équipes
• AiService - Suggestions IA (Mistral)
• Et 5 autres services…

Régénération:

npm run generate

🧪 Tests

# Lancer tous les tests
pytest

# Avec coverage
pytest --cov=app --cov-report=html

Résultats: 137/137 tests passing (100%) ✨

📊 Architecture

API REST (FastAPI)
├── JWT Authentication
├── SQLite + FTS5
├── ACL (Workspace + Project)
├── WebSocket (Collaborative editing)
├── Mistral AI Integration
└── TypeScript SDK (auto-generated)

🔗 Liens utiles

• GitHub Repository: wolf75222/alldoneserver
• API Documentation: http://localhost:8080/docs
• OpenAPI Schema: http://localhost:8080/openapi.json
• Issues: GitHub Issues

📄 License

MIT License - voir LICENSE

🙋 Support

• Email: romaindespoul@gmail.com
• Issues: GitHub Issues

---

Version: 1.3.0 | Python: 3.11+ | FastAPI: 0.115 Développé avec ❤️ et ☕ par l’équipe All. Done