How hichembenamara/dossier_projet works
HealthAI Coaching is a health-coaching platform with user, admin, and super-admin experiences, a FastAPI backend, polyglot persistence, and a Python ETL pipeline. The main user flow runs from the frontend through the API to profile, activity, nutrition, and coaching capabilities; AI meal analysis and recommendations persist documents separately. Admins oversee catalogs, ETL, and data quality, while super-admins manage organizations and monitoring. The README documents the product branches and storage roles; unsampled implementation details are represented only where those relationships are documented.
Main entry points: main.py FastAPI application · app Next.js app · auth.py Authentication · ai_features.py AI features API
Components 24
Coaching frontend
- Next.js app
frontend/app - Member features
frontend/src/features/me/pages - Admin features
frontend/src/features/admin/pages - Super-admin features
frontend/src/features/super-admin/pages - Posture coach
frontend/src/features/me/pages/CoachPosture.tsx - Pose detection
frontend/src/features/coach-posture/pose-engine.ts
API and domain
- FastAPI application
backend/app/main.py - Authentication
backend/app/modules/auth.py - Token security
backend/app/core/security.py - Member API
backend/app/modules/me.py - AI features API
backend/app/modules/ai_features.py - Meal analysis
backend/app/services/meal_analysis.py - Recommendations
backend/app/services/recommendations.py - Profile setup
backend/app/services/profile_setup.py
Data platform
- Relational models
backend/app/db/models.py - MariaDB
- MongoDB documents
backend/app/db/mongo.py
ETL pipeline
- ETL common
healthai_etl/etl_common.py - Domain ETL jobs
healthai_etl
Administration
- Admin API
backend/app/modules/admin.py - ETL / quality services
backend/app/services/admin_etl.py - Super-admin API
backend/app/modules/super_admin.py
Other components
- Member / staff
- MediaPipe models
Connections 26
- Member / staff → Next.js app: uses
- Next.js app → FastAPI application: calls API
- Next.js app → Member features: presents
- Next.js app → Admin features: presents
- Next.js app → Super-admin features: presents
- Member features → Posture coach: includes
frontend/src/features/me/pages/CoachPosture.tsx - Posture coach → Pose detection: uses
- Pose detection → MediaPipe models: loads models
frontend/src/features/coach-posture/pose-engine.ts - FastAPI application → Authentication: routes
- FastAPI application → Member API: routes
- FastAPI application → AI features API: routes
- FastAPI application → Admin API: routes
- FastAPI application → Super-admin API: routes
- Authentication → Token security: authenticates
backend/app/modules/auth.py - Authentication → Profile setup: sets up profile
backend/app/modules/auth.py - Authentication → MariaDB: reads / writes
- Member API → MariaDB: reads / writes
- AI features API → Meal analysis: handles analysis
- AI features API → Recommendations: generates
- AI features API → MongoDB documents: persists documents
- Admin API → ETL / quality services: uses ETL services
- Admin API → MariaDB: reads / writes
- Super-admin API → MariaDB: manages records
- Domain ETL jobs → ETL common: uses helpers
healthai_etl/etl_gym.py - Domain ETL jobs → MariaDB: loads data
- Relational models → MariaDB: maps data