andd-baay

Andd Baay

Plateforme web de gestion agricole collaborative — fermes, projets, semis, tâches, messagerie temps réel et prévisions de rendement.

Conçue pour les exploitations sahéliennes : multi-rôles (propriétaire, manager, technicien, ouvrier), workflows agronomiques, communication d'équipe instantanée, et prédictions de rendement basées sur des règles métier.

---

Démarrage rapide

Prérequis

• Python 3.12 (version fixée dans .python-version — utilisez pyenv ou installez Python 3.12 directement)
• (Optionnel) Redis si vous voulez tester le layer channels-redis en production
• (Optionnel) Docker + docker-compose

Installation locale

# 1. Cloner le dépôt
git clone https://github.com/<votre-compte>/andd-baay.git
cd Andd_baay

# 2. Créer un environnement virtuel
python -m venv env
# Windows :   .\env\Scripts\activate
# Linux/Mac : source env/bin/activate

# 3. Installer les dépendances
pip install -r requirements.txt

# Pour contribuer (tests + debug toolbar) :
pip install -r requirements-dev.txt

# 4. Variables d'environnement
cp .env.example .env
# Éditez .env : fournissez au minimum DJANGO_SECRET_KEY=une-valeur-secrete

# 5. Migrations
python manage.py migrate

# 6. Créer un utilisateur admin (pour se connecter immédiatement)
python manage.py createsuperuser
# Exemple : Email → [email protected] / Mot de passe → changeme123
# Vous pourrez vous connecter sur http://localhost:8000/admin/ avec ces identifiants.

# 7. Lancer le serveur
python manage.py runserver

Vérifier que tout fonctionne

Après runserver, ouvrez http://localhost:8000. Vous devez voir la page de connexion Andd Baay. Connectez-vous avec le compte créé à l'étape 6.

Pour valider la configuration Django :

python manage.py check

Avec Docker

docker compose up --build

---

Variables d'environnement

Variable	Description	Défaut
DJANGO_SECRET_KEY	Clé secrète Django (obligatoire)	—
DEBUG	Mode debug Django	False
ALLOWED_HOSTS	Hôtes autorisés (séparés par virgule)	localhost
DATABASE_URL	URL PostgreSQL en production	SQLite local
REDIS_URL	Si défini, active channels-redis pour les WebSockets	(vide)
GOOGLE_CLIENT_ID	OAuth Google (login social)	(vide)
GOOGLE_CLIENT_SECRET	OAuth Google	(vide)
GEMINI_API_KEY	Chatbot + analyse photo maladies des plantes	(vide)
OPENWEATHER_API_KEY	Météo des fermes	(vide)
EMAIL_HOST / EMAIL_*	Configuration SMTP (console en dev si vide)	console

Cf. .env.example pour la liste exhaustive et les instructions d'obtention.

---

Stack technique

Couche	Technologies
Backend HTTP	Django 5, Django REST Framework, django-allauth (email + Google OAuth)
Temps réel (WebSocket)	Django Channels + Daphne, InMemoryChannelLayer (dev) / channels-redis (prod)
Base de données	SQLite (dev) — PostgreSQL (prod, recommandé)
Frontend	Django Templates, Bootstrap 5, JavaScript vanilla, PWA (manifest + service worker)
IA / prévisions	Scikit-learn (modele_rendement.pkl) + règles métier (baay/services.py)
Mobile	Flutter (../andd_baay_mobile) — voir Application mobile
Déploiement	Docker / docker-compose, Render, Vercel, Railway

---

Architecture du dépôt