# hichembenamara/dossier_projet architecture

> Architecture diagram of the GitHub repository hichembenamara/dossier_projet, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hichembenamara/dossier_projet
- Repository: https://github.com/hichembenamara/dossier_projet

## Overview

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: [`backend/app/main.py`](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/main.py) (FastAPI application), [`frontend/app`](https://github.com/hichembenamara/dossier_projet/tree/main/frontend/app) (Next.js app), [`backend/app/modules/auth.py`](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/auth.py) (Authentication), [`backend/app/modules/ai_features.py`](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/ai_features.py) (AI features API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Coaching frontend"]
  node_web["Next.js app"]
  node_member_ui["Member features"]
  node_admin_ui["Admin features"]
  node_super_ui["Super-admin features"]
  node_posture_ui["Posture coach<br/>[CoachPosture.tsx]"]
  node_pose_engine["Pose detection<br/>[pose-engine.ts]"]
end

subgraph group_api["API and domain"]
  node_api_entry["FastAPI application<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_security["Token security<br/>[security.py]"]
  node_member_api["Member API<br/>[me.py]"]
  node_ai_api["AI features API<br/>[ai_features.py]"]
  node_meal_service["Meal analysis<br/>[meal_analysis.py]"]
  node_recommendations["Recommendations<br/>[recommendations.py]"]
  node_profile_setup["Profile setup<br/>[profile_setup.py]"]
end

subgraph group_data["Data platform"]
  node_sql_models["Relational models<br/>[models.py]"]
  node_mariadb[("MariaDB")]
  node_mongo[("MongoDB documents<br/>[mongo.py]")]
end

subgraph group_etl["ETL pipeline"]
  node_etl_common["ETL common<br/>[etl_common.py]"]
  node_etl_jobs["Domain ETL jobs"]
end

subgraph group_admin["Administration"]
  node_admin_api["Admin API<br/>[admin.py]"]
  node_admin_services["ETL / quality services<br/>[admin_etl.py]"]
  node_super_api["Super-admin API<br/>[super_admin.py]"]
end

node_person(("Member / staff"))
node_mediapipe["MediaPipe models"]

node_person -->|"uses"| node_web
node_web -->|"calls API"| node_api_entry
node_web -.->|"presents"| node_member_ui
node_web -.->|"presents"| node_admin_ui
node_web -.->|"presents"| node_super_ui
node_member_ui -.->|"includes"| node_posture_ui
node_posture_ui -.->|"uses"| node_pose_engine
node_pose_engine -->|"loads models"| node_mediapipe
node_api_entry -->|"routes"| node_auth
node_api_entry -->|"routes"| node_member_api
node_api_entry -->|"routes"| node_ai_api
node_api_entry -->|"routes"| node_admin_api
node_api_entry -->|"routes"| node_super_api
node_auth -->|"authenticates"| node_security
node_auth -->|"sets up profile"| node_profile_setup
node_auth -->|"reads / writes"| node_mariadb
node_member_api -->|"reads / writes"| node_mariadb
node_ai_api -.->|"handles analysis"| node_meal_service
node_ai_api -.->|"generates"| node_recommendations
node_ai_api -->|"persists documents"| node_mongo
node_admin_api -.->|"uses ETL services"| node_admin_services
node_admin_api -->|"reads / writes"| node_mariadb
node_super_api -->|"manages records"| node_mariadb
node_etl_jobs -->|"uses helpers"| node_etl_common
node_etl_jobs -->|"loads data"| node_mariadb
node_sql_models -->|"maps data"| node_mariadb

click node_web "https://github.com/hichembenamara/dossier_projet/tree/main/frontend/app"
click node_member_ui "https://github.com/hichembenamara/dossier_projet/tree/main/frontend/src/features/me/pages"
click node_admin_ui "https://github.com/hichembenamara/dossier_projet/tree/main/frontend/src/features/admin/pages"
click node_super_ui "https://github.com/hichembenamara/dossier_projet/tree/main/frontend/src/features/super-admin/pages"
click node_posture_ui "https://github.com/hichembenamara/dossier_projet/blob/main/frontend/src/features/me/pages/CoachPosture.tsx"
click node_pose_engine "https://github.com/hichembenamara/dossier_projet/blob/main/frontend/src/features/coach-posture/pose-engine.ts"
click node_api_entry "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/main.py"
click node_auth "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/auth.py"
click node_security "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/core/security.py"
click node_member_api "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/me.py"
click node_ai_api "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/ai_features.py"
click node_meal_service "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/services/meal_analysis.py"
click node_recommendations "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/services/recommendations.py"
click node_profile_setup "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/services/profile_setup.py"
click node_admin_api "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/admin.py"
click node_admin_services "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/services/admin_etl.py"
click node_super_api "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/super_admin.py"
click node_sql_models "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/db/models.py"
click node_mongo "https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/db/mongo.py"
click node_etl_common "https://github.com/hichembenamara/dossier_projet/blob/main/healthai_etl/etl_common.py"
click node_etl_jobs "https://github.com/hichembenamara/dossier_projet/tree/main/healthai_etl"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_member_ui,node_admin_ui,node_super_ui,node_posture_ui,node_pose_engine toneBlue
class node_api_entry,node_auth,node_security,node_member_api,node_ai_api,node_meal_service,node_recommendations,node_profile_setup toneAmber
class node_sql_models,node_mariadb,node_mongo,node_mediapipe toneMint
class node_etl_common,node_etl_jobs toneRose
class node_admin_api,node_admin_services,node_super_api,node_person toneIndigo
```

## Components

### Coaching frontend

- [Next.js app](https://github.com/hichembenamara/dossier_projet/tree/main/frontend/app): `frontend/app`
- [Member features](https://github.com/hichembenamara/dossier_projet/tree/main/frontend/src/features/me/pages): `frontend/src/features/me/pages`
- [Admin features](https://github.com/hichembenamara/dossier_projet/tree/main/frontend/src/features/admin/pages): `frontend/src/features/admin/pages`
- [Super-admin features](https://github.com/hichembenamara/dossier_projet/tree/main/frontend/src/features/super-admin/pages): `frontend/src/features/super-admin/pages`
- [Posture coach](https://github.com/hichembenamara/dossier_projet/blob/main/frontend/src/features/me/pages/CoachPosture.tsx): `frontend/src/features/me/pages/CoachPosture.tsx`
- [Pose detection](https://github.com/hichembenamara/dossier_projet/blob/main/frontend/src/features/coach-posture/pose-engine.ts): `frontend/src/features/coach-posture/pose-engine.ts`

### API and domain

- [FastAPI application](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/auth.py): `backend/app/modules/auth.py`
- [Token security](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [Member API](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/me.py): `backend/app/modules/me.py`
- [AI features API](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/ai_features.py): `backend/app/modules/ai_features.py`
- [Meal analysis](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/services/meal_analysis.py): `backend/app/services/meal_analysis.py`
- [Recommendations](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/services/recommendations.py): `backend/app/services/recommendations.py`
- [Profile setup](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/services/profile_setup.py): `backend/app/services/profile_setup.py`

### Data platform

- [Relational models](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/db/models.py): `backend/app/db/models.py`
- **MariaDB**
- [MongoDB documents](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/db/mongo.py): `backend/app/db/mongo.py`

### ETL pipeline

- [ETL common](https://github.com/hichembenamara/dossier_projet/blob/main/healthai_etl/etl_common.py): `healthai_etl/etl_common.py`
- [Domain ETL jobs](https://github.com/hichembenamara/dossier_projet/tree/main/healthai_etl): `healthai_etl`

### Administration

- [Admin API](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/admin.py): `backend/app/modules/admin.py`
- [ETL / quality services](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/services/admin_etl.py): `backend/app/services/admin_etl.py`
- [Super-admin API](https://github.com/hichembenamara/dossier_projet/blob/main/backend/app/modules/super_admin.py): `backend/app/modules/super_admin.py`

### Other components

- **Member / staff**
- **MediaPipe models**

## Connections

- 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 (evidence: `frontend/src/features/me/pages/CoachPosture.tsx`)
- Posture coach → Pose detection: uses
- Pose detection → MediaPipe models: loads models (evidence: `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 (evidence: `backend/app/modules/auth.py`)
- Authentication → Profile setup: sets up profile (evidence: `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 (evidence: `healthai_etl/etl_gym.py`)
- Domain ETL jobs → MariaDB: loads data
- Relational models → MariaDB: maps data
