A fullstack digital library platform dedicated to Burkina Faso
# Digital Library BF
## Table des matières
- Vision du projet
- Stack technique
- Architecture
- Documentation
- Installation
- Démarrage rapide
- Équipe
- Contribution
---
## Vision du projet
Digital Library BF est une plateforme de bibliothèque numérique fullstack dédiée au Burkina Faso. Elle permet la gestion, la distribution et le téléchargement de ressources documentaires (livres, PDF) à travers une application web et une application mobile.
### Objectifs Fonctionnels
- Les administrateurs peuvent uploader et gérer les livres disponibles sur la plateforme.
- Les utilisateurs peuvent s'inscrire, se connecter, rechercher et télécharger des livres.
- Un système de contrôle d'accès basé sur les rôles (RBAC) sécurise les actions sensibles.
- Chaque téléchargement est tracé à des fins de statistiques et de suivi.
## Stack technique
Le projet utilise les technologies suivantes, choisies pour leur rapidité de mise en œuvre :
- **Backend** : Node.js (Express.js) avec TypeScript
- **Frontend Web** : Next.js avec TypeScript et shadcn/ui
- **Mobile** : Flutter
- **Base de données, Stockage & Auth** : Supabase (PostgreSQL, Supabase Storage, Supabase Auth)
- **Déploiement** : Vercel (Frontend) et Railway/Render (Backend)
## Architecture
Le projet est organisé sous forme de **monorepo** contenant les applications et l'API :
```
digital-library-bf/
├── backend/ # API Express.js + Supabase (TypeScript)
├── frontend/ # Application web Next.js (TypeScript + shadcn/ui)
├── mobile/ # Application mobile Flutter
└── docs/ # Documentation du projet
```
Les différentes parties du système communiquent via une API REST documentée (Swagger/OpenAPI). La base de données de production se trouve sur Supabase, qui gère également directement l'authentification et le stockage des fichiers.
## Documentation
La documentation détaillée du projet se trouve dans le dossier `docs/` :
- Aperçu du projet (Project Overview)
- Spécifications des Exig …