La Vida Luca App

Plateforme collaborative pour l'entraide et les échanges locaux, axée sur le jardinage, la permaculture et la vie durable.

🏗️ Architecture

Frontend: Next.js 15 + React 19 + TypeScript
Backend: FastAPI + Python 3.12
Base de données: PostgreSQL avec AsyncPG
Authentification: JWT
IA: OpenAI Integration pour conseils personnalisés
Déploiement: Render (fullstack)
Monitoring: Sentry + Prometheus metrics

🚀 Lancement Local

Prérequis

Node.js 20+
Python 3.12+
PostgreSQL 15+
Git

Installation rapide

# 1. Cloner le repository
git clone https://github.com/vidaluca77-cloud/LaVidaLuca-App.git
cd LaVidaLuca-App

# 2. Configuration environnement
cp .env.example .env
cp apps/backend/.env.example apps/backend/.env
cp apps/web/.env.local.example apps/web/.env.local

# 3. Installer les dépendances
npm run setup

# 4. Configurer la base de données
createdb lavidaluca_dev
cd apps/backend
python -m alembic upgrade head

# 5. Lancer l'application complète
npm run dev:full

Lancement séparé

Backend (port 8000)

cd apps/backend
pip install -r requirements.txt
cp .env.example .env
# Configurer DATABASE_URL dans .env
uvicorn app_simple:app --reload --host 0.0.0.0 --port 8000

Frontend (port 3000)

cd apps/web
npm install
cp .env.local.example .env.local
# Configurer NEXT_PUBLIC_API_URL dans .env.local
npm run dev

📡 API Endpoints

Endpoints principaux

GET / - Informations de l'API
POST /api/v1/guide - Assistant IA pour conseils jardinage/permaculture
GET /docs - Documentation Swagger

Authentification

POST /api/v1/auth/register - Inscription utilisateur
POST /api/v1/auth/login - Connexion
POST /api/v1/auth/refresh - Renouvellement token

Guide IA

POST /api/v1/guide - Conseils personnalisés IA
GET /api/v1/guide/health - Statut service guide

Utilisateurs

GET /api/v1/users/me - Profil utilisateur
PUT /api/v1/users/me - Mise à jour profil

Activités

GET /api/v1/activities - Liste des activités
POST /api/v1/activities - Créer une activité
GET /api/v1/activities/{id} - Détails activité

Contacts & Suggestions

POST /api/v1/contacts - Formulaire de contact
POST /api/v1/suggestions - Proposer une amélioration

🧪 Tests

Backend

cd apps/backend
pytest tests/ -v
pytest tests/ --cov=. --cov-report=html  # Avec couverture

Frontend

cd apps/web
npm run test
npm run test:coverage

Test de l'API Guide

Visitez http://localhost:3000/test-ia pour tester l'endpoint /guide avec une interface utilisateur.

🚀 Déploiement Automatique

Le déploiement est automatisé via GitHub Actions :

Configuration des secrets

Dans les settings GitHub du repository, configurer :

Backend (Render)

RENDER_DEPLOY_HOOK_BACKEND : URL de déploiement Render backend

Frontend (Render)

RENDER_DEPLOY_HOOK_FRONTEND : URL de déploiement Render frontend

Processus de déploiement

Push sur main déclenche automatiquement :
- Tests backend avec PostgreSQL
- Build frontend
- Tests d'intégration
- Déploiement backend sur Render
- Déploiement frontend sur Render
Pull Requests exécutent les tests CI sans déploiement

🔧 Configuration Environnement

Variables Backend (.env)

ENVIRONMENT=development|production
DATABASE_URL=postgresql+asyncpg://user:pass@host:port/db
JWT_SECRET_KEY=your-secret-key
OPENAI_API_KEY=your-openai-key
CORS_ORIGINS=http://localhost:3000,https://yourdomain.com

Variables Frontend (.env.local)

NEXT_PUBLIC_API_URL=http://localhost:8000/api/v1
NEXT_PUBLIC_APP_NAME=La Vida Luca
SENTRY_DSN=your-sentry-dsn

📁 Structure du Projet

LaVidaLuca-App/
├── .github/workflows/     # GitHub Actions CI/CD
├── apps/
│   ├── backend/          # API FastAPI
│   │   ├── routes/       # Endpoints API
│   │   ├── tests/        # Tests backend
│   │   ├── models/       # Modèles SQLAlchemy
│   │   └── main.py       # Application principale
│   └── web/              # Frontend Next.js
│       ├── app/          # Pages et composants
│       ├── public/       # Assets statiques
│       └── src/          # Code source
├── .env.example          # Configuration globale
└── package.json          # Scripts npm globaux

🤝 Contribution

Fork le projet
Créer une branche (git checkout -b feature/AmazingFeature)
Commit (git commit -m 'Add AmazingFeature')
Push (git push origin feature/AmazingFeature)
Ouvrir une Pull Request

Standards de code

Backend: Black (formatage) + isort + flake8
Frontend: ESLint + Prettier + TypeScript strict
Tests: Coverage minimum 80%
Commits: Convention Conventional Commits

📄 License

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

📞 Support

Issues GitHub: github.com/vidaluca77-cloud/LaVidaLuca-App/issues
Email: support@lavidaluca.fr
Documentation: Disponible à /docs en mode développement

Développé avec ❤️ pour promouvoir l'entraide locale et la vie durable. Frontend --> Backend[FastAPI Backend] Backend --> Database[(PostgreSQL)] Backend --> OpenAI[OpenAI API] Frontend --> Sentry[Sentry Monitoring] Backend --> Sentry

subgraph "Déploiement"
    Frontend --> Render[Render Frontend]
    Backend --> RenderAPI[Render Backend]
end

subgraph "Fonctionnalités"
    Backend --> Activities[Catalogue d'activités]
    Backend --> IA[Suggestions IA]
    Backend --> Contact[Contact & Rejoindre]
    Backend --> Auth[Authentification JWT]
end


## Installation

### Prérequis
- Node.js 18.x ou supérieur
- Python 3.11+
- PostgreSQL 12+
- npm ou yarn
- Git

### 1. Cloner le repository
```bash
git clone https://github.com/vidaluca77-cloud/LaVidaLuca-App.git
cd LaVidaLuca-App

2. Installation complète

# Installation frontend et backend
npm run setup

# Ou installation séparée:
npm install                    # Frontend
npm run backend:install       # Backend

3. Configuration Backend

cd apps/backend
cp .env.example .env
# Éditer .env avec vos valeurs

4. Configuration Base de données

# Créer la base de données
createdb lavidaluca_dev

# Appliquer les migrations
npm run backend:migrate

# (Optionnel) Peupler avec des données d'exemple
cd apps/backend && python seed.py

5. Configuration Frontend

Créer un fichier .env.local à la racine avec les variables suivantes :

# Backend API
NEXT_PUBLIC_API_URL=http://localhost:8000

# Backend API
NEXT_PUBLIC_API_URL=http://localhost:8000

# Sentry (monitoring - requis pour la surveillance des erreurs)
NEXT_PUBLIC_SENTRY_DSN=votre_dsn_sentry

# Sentry Backend (pour le monitoring backend)
SENTRY_DSN=votre_dsn_sentry_backend

# Contact
NEXT_PUBLIC_CONTACT_EMAIL=contact@lavidaluca.fr
NEXT_PUBLIC_CONTACT_PHONE=+33123456789

6. Lancement en développement

# Frontend seul
npm run dev

# Backend seul  
npm run backend:dev

# Frontend + Backend simultanément
npm run dev:full

L'application sera accessible sur :

Frontend: http://localhost:3000
Backend API: http://localhost:8000
Documentation API: http://localhost:8000/docs
Monitoring Dashboard: http://localhost:3000/monitoring (développement uniquement)
Métriques Prometheus: http://localhost:8000/metrics

Scripts disponibles

Frontend

Script	Description
`npm run dev`	Lance le serveur de développement frontend
`npm run build`	Compile l'application pour la production
`npm run start`	Lance l'application compilée
`npm run lint`	Vérifie la qualité du code
`npm run type-check`	Vérifie les types TypeScript
`npm test`	Lance les tests frontend

Backend

Script	Description
`npm run backend:dev`	Lance le serveur de développement backend
`npm run backend:install`	Installe les dépendances Python
`npm run backend:test`	Lance les tests backend
`npm run backend:migrate`	Applique les migrations de base de données
`npm run backend:migration`	Crée une nouvelle migration

Full-stack

Script	Description
`npm run setup`	Installation complète (frontend + backend)
`npm run dev:full`	Lance frontend et backend simultanément

Structure du projet

├── apps/
│   ├── backend/            # API FastAPI
│   │   ├── main.py         # Point d'entrée de l'API
│   │   ├── config.py       # Configuration
│   │   ├── database.py     # Connexion base de données
│   │   ├── auth/           # Authentification JWT
│   │   ├── models/         # Modèles SQLAlchemy
│   │   ├── schemas/        # Schémas Pydantic
│   │   ├── routes/         # Points de terminaison API
│   │   ├── services/       # Logique métier
│   │   ├── migrations/     # Migrations Alembic
│   │   └── tests/          # Tests backend
│   └── web/                # Application frontend Next.js
├── public/                 # Fichiers statiques
│   ├── icons/             # Icônes PWA
│   └── manifest.webmanifest
├── src/
│   ├── app/               # App Router Next.js 13+
│   │   ├── api/           # Routes API (legacy)
│   │   ├── catalogue/     # Page catalogue d'activités
│   │   ├── contact/       # Page contact
│   │   ├── rejoindre/     # Page rejoindre
│   │   ├── layout.tsx     # Layout principal
│   │   └── page.tsx       # Page d'accueil
│   ├── components/        # Composants réutilisables
│   ├── lib/              # Utilitaires et configurations
│   ├── monitoring/       # Outils de monitoring
│   └── types/            # Types TypeScript
├── monitoring/            # Configuration monitoring backend
├── docs/                 # Documentation additionnelle
└── tests/                # Tests frontend

Déploiement

Production sur Render

Connexion du repository
- Connecter le repository GitHub à Render
- Sélectionner la branche main pour les déploiements automatiques
Configuration des variables d'environnement Dans le dashboard Render, ajouter toutes les variables d'environnement nécessaires

Déploiement

# Déploiement automatique via Git
git push origin main

Optimisations de production

Compression : Gzip automatique
Images : Optimisation via Next.js
Fonts : Optimisation automatique des Google Fonts
Bundle : Tree-shaking et minification
PWA : Manifest et service worker

Monitoring et Observabilité

Sentry (Monitoring d'erreurs)

Capture automatique des erreurs frontend
Monitoring des performances
Alertes en temps réel
Session Replay pour le debugging

Métriques personnalisées

Temps de chargement des pages
Interactions utilisateur
Erreurs API
Performances des suggestions IA

Logs structurés

// Exemple d'utilisation
import { logger } from '@/lib/logger';

logger.info('Action utilisateur', {
  action: 'view_activity',
  activityId: 'abc123',
  userId: 'user456'
});

API et Intégrations

Routes API principales

GET /api/activities - Liste des activités
POST /api/contact - Envoi de messages de contact
GET /api/suggestions - Suggestions IA personnalisées

Intégrations externes

Supabase : Base de données et authentification
OpenAI : Génération de suggestions personnalisées
Sentry : Monitoring et alertes

Tests

Exécution des tests

# Tests unitaires
npm test

# Tests avec coverage
npm run test:coverage

# Tests en mode watch
npm run test:watch

Types de tests

Unitaires : Composants et fonctions utilitaires
Intégration : Flux utilisateur complets
E2E : Tests de bout en bout avec Playwright

Contribution

Workflow de développement

Fork du repository
Branche : git checkout -b feature/ma-fonctionnalite
Développement avec tests
Commit : git commit -m 'feat: ajouter ma fonctionnalité'
Push : git push origin feature/ma-fonctionnalite
Pull Request avec description détaillée

Standards de code

ESLint : Configuration stricte Next.js
TypeScript : Typage strict activé
Prettier : Formatage automatique
Conventional Commits : Messages de commit standardisés

Review checklist

Tests passent (npm test)
Build réussit (npm run build)
Lint sans erreur (npm run lint)
Types corrects (npm run type-check)
Documentation mise à jour
Changements testés manuellement

Sécurité

Bonnes pratiques

Variables d'environnement pour les secrets
Validation des inputs côté client et serveur
CSP (Content Security Policy) configuré
HTTPS obligatoire en production

Authentification

JWT tokens via Supabase
Refresh tokens automatiques
Logout sécurisé

Monitoring et Observabilité

Surveillance des erreurs

Sentry : Capture et suivi des erreurs frontend et backend
Error Boundaries : Gestion des erreurs React avec fallback UI
Filtrage intelligent : Les erreurs sensibles sont automatiquement filtrées
Contexte utilisateur : Tracking des actions utilisateur pour debugging

Métriques de performance

Web Vitals : FCP, LCP, FID, CLS en temps réel
API Performance : Latence, taux de succès/échec des appels API
Métriques système : CPU, mémoire, connexions base de données
Métriques métier : Actions utilisateur, utilisation des fonctionnalités

Dashboard de monitoring

Interface temps réel : /monitoring (développement uniquement)
Statut de santé : Aperçu global de l'état de l'application
Alertes : Système d'alertes configurables pour les problèmes critiques
Export des données : Téléchargement des métriques au format JSON

Logging structuré

Frontend : JSON structuré avec contexte utilisateur
Backend : Logs contextuels avec request ID unique
Activités utilisateur : Tracking des interactions pour analytics
API calls : Log complet des requêtes/réponses avec durée

Configuration monitoring

# Frontend (.env.local)
NEXT_PUBLIC_SENTRY_DSN=your_sentry_dsn

# Backend (.env)
SENTRY_DSN=your_sentry_backend_dsn

Endpoints de monitoring

Health check : GET /health
Métriques Prometheus : GET /metrics
Dashboard monitoring : http://localhost:3000/monitoring

Performance

Optimisations

Code splitting automatique par Next.js
Lazy loading des composants
Image optimization avec next/image
Font optimization avec next/font

Métriques cibles

FCP < 1.5s (First Contentful Paint)
LCP < 2.5s (Largest Contentful Paint)
CLS < 0.1 (Cumulative Layout Shift)
FID < 100ms (First Input Delay)

Support et Contact

Documentation

API Docs : /docs (à venir avec backend)
Storybook : Composants UI (à venir)
Wiki : Documentation étendue

Contact technique

Email : tech@lavidaluca.fr
Issues : GitHub Issues pour les bugs
Discussions : GitHub Discussions pour les questions

Roadmap

À venir

La Vida Luca - Plateforme collaborative pour la formation des jeunes en MFR et le développement d'une agriculture nouvelle.

Dernière mise à jour : 2024

Name		Name	Last commit message	Last commit date
Latest commit History 202 Commits
.github/workflows		.github/workflows
apps		apps
scripts		scripts
.env.example		.env.example
.gitignore		.gitignore
DEPLOYMENT_CHECKLIST.md		DEPLOYMENT_CHECKLIST.md
DEVELOPMENT_ACCELERATION.md		DEVELOPMENT_ACCELERATION.md
IMPLEMENTATION_SUMMARY.md		IMPLEMENTATION_SUMMARY.md
LICENSE		LICENSE
README.md		README.md
STRUCTURE.md		STRUCTURE.md
package-lock.json		package-lock.json
package.json		package.json
render.yaml		render.yaml

Folders and files

Latest commit

History

Repository files navigation

La Vida Luca App

🏗️ Architecture

🚀 Lancement Local

Prérequis

Installation rapide

Lancement séparé

Backend (port 8000)

Frontend (port 3000)

📡 API Endpoints

Endpoints principaux

Authentification

Guide IA

Utilisateurs

Activités

Contacts & Suggestions

🧪 Tests

Backend

Frontend

Test de l'API Guide

🚀 Déploiement Automatique

Configuration des secrets

Backend (Render)

Frontend (Render)

Processus de déploiement

🔧 Configuration Environnement

Variables Backend (.env)

Variables Frontend (.env.local)

📁 Structure du Projet

🤝 Contribution

Standards de code

📄 License

📞 Support

2. Installation complète

3. Configuration Backend

4. Configuration Base de données

5. Configuration Frontend

6. Lancement en développement

Scripts disponibles

Frontend

Backend

Full-stack

Structure du projet

Déploiement

Production sur Render

Optimisations de production

Monitoring et Observabilité

Sentry (Monitoring d'erreurs)

Métriques personnalisées

Logs structurés

API et Intégrations

Routes API principales

Intégrations externes

Tests

Exécution des tests

Types de tests

Contribution

Workflow de développement

Standards de code

Review checklist

Sécurité

Bonnes pratiques

Authentification

Monitoring et Observabilité

Surveillance des erreurs

Métriques de performance

Dashboard de monitoring

Logging structuré

Configuration monitoring

Endpoints de monitoring

Performance

Optimisations

Métriques cibles

Support et Contact

Documentation

Contact technique

Roadmap

Packages