# bechir-karmeni/entreprise-web-developement architecture

> Architecture diagram of the GitHub repository bechir-karmeni/entreprise-web-developement, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bechir-karmeni/entreprise-web-developement
- Repository: https://github.com/bechir-karmeni/entreprise-web-developement

## Overview

Daily Tracker is a personalized nutrition-planning web app. Users sign in, track food and nutrition, plan meals, explore recipes, and manage shopping; analytics and progress views support ongoing tracking. The documented backend pattern is controller → service → repository → PostgreSQL. The README names major capabilities, but most feature implementations were not sampled, so those branches are represented at subsystem level and their unverified links are dashed.

Main entry points: [`backend/src/main/java/com/dailytracker/nutrition/repository`](https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/repository) (Data repositories), [`backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java`](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java) (Auth workflows), [`backend/src/main/java/com/dailytracker/nutrition/service`](https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/service) (Business services), [`backend/src/main/java/com/dailytracker/nutrition/service/FoodLogService.java`](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/FoodLogService.java) (Food logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web app"]
  node_app["React app routes<br/>[App.tsx]"]
  node_auth_context["Auth session<br/>[AuthContext.tsx]"]
  node_auth_api["Auth API<br/>[authApi.ts]"]
  node_food_page["Food tracking"]
  node_today_page["Today view<br/>[TodayPage.tsx]"]
  node_analytics_page["Analytics<br/>[AnalyticsPage.tsx]"]
  node_shopping_page["Shopping list"]
end

subgraph group_identity["Identity and security"]
  node_auth_controller["Auth endpoints"]
  node_auth_service["Auth workflows<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_user_entity["User account<br/>[User.java]"]
end

subgraph group_nutrition["Nutrition tracking"]
  node_food_controller["Food endpoints"]
  node_food_log["Food logging"]
  node_food_entity["Food records<br/>[Food.java]"]
  node_nutrition_domain["Targets and nutrition"]
end

subgraph group_planning["Planning and recipes"]
  node_planning_services["Meal and recipe planning"]
  node_online_recipes["Online recipes"]
  node_recommendations["Recommendations"]
end

subgraph group_platform["Backend and integrations"]
  node_backend_controllers["Feature endpoints"]
  node_backend_services["Business services"]
  node_repositories["Data repositories"]
  node_postgres[("PostgreSQL")]
  node_mealdb["MealDB client<br/>[MealDbClient.java]"]
  node_mealdb_service["MealDB service"]
end

node_user(("User"))

node_user -.->|"uses"| node_app
node_app -->|"routes with"| node_auth_context
node_auth_context -.->|"authenticates via"| node_auth_api
node_user -.->|"tracks food"| node_food_page
node_user -.->|"reviews today"| node_today_page
node_user -.->|"reviews progress"| node_analytics_page
node_user -.->|"manages shopping"| node_shopping_page
node_auth_api -.->|"calls"| node_auth_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -.->|"issues tokens"| node_jwt
node_auth_service -->|"manages account"| node_user_entity
node_food_controller -->|"delegates to"| node_backend_services
node_food_page -.->|"requests food data"| node_food_controller
node_food_log -->|"scales serving nutrients"| node_food_entity
node_food_log -->|"reads and writes"| node_repositories
node_planning_services -.->|"persists plans"| node_repositories
node_online_recipes -->|"fetches recipes"| node_mealdb
node_recommendations -->|"searches recipes"| node_mealdb
node_backend_controllers -->|"delegates to"| node_backend_services
node_backend_services -->|"uses"| node_repositories
node_repositories -->|"stores data"| node_postgres

click node_app "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/App.tsx"
click node_auth_context "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/auth/AuthContext.tsx"
click node_auth_api "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/api/authApi.ts"
click node_food_page "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/pages/FoodTrackingPage.tsx"
click node_today_page "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/pages/TodayPage.tsx"
click node_analytics_page "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/pages/AnalyticsPage.tsx"
click node_shopping_page "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/pages/ShoppingListPage.tsx"
click node_auth_controller "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/controller/AuthController.java"
click node_auth_service "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java"
click node_jwt "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/security/JwtService.java"
click node_user_entity "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/entity/User.java"
click node_food_controller "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/controller/FoodController.java"
click node_food_log "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/FoodLogService.java"
click node_food_entity "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/entity/Food.java"
click node_nutrition_domain "https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/nutrition"
click node_planning_services "https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/service"
click node_online_recipes "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/OnlineRecipeService.java"
click node_recommendations "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/RecommendationService.java"
click node_backend_controllers "https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/controller"
click node_backend_services "https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/service"
click node_repositories "https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/repository"
click node_mealdb "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/external/MealDbClient.java"
click node_mealdb_service "https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/OnlineRecipeService.java"

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_app,node_auth_context,node_auth_api,node_food_page,node_today_page,node_analytics_page,node_shopping_page,node_user toneBlue
class node_auth_controller,node_auth_service,node_jwt,node_user_entity toneAmber
class node_food_controller,node_food_log,node_food_entity,node_nutrition_domain toneMint
class node_planning_services,node_online_recipes,node_recommendations toneRose
class node_backend_controllers,node_backend_services,node_repositories,node_postgres,node_mealdb,node_mealdb_service toneIndigo
```

## Components

### Web app

- [React app routes](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth session](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/auth/AuthContext.tsx): `frontend/src/auth/AuthContext.tsx`
- [Auth API](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/api/authApi.ts): `frontend/src/api/authApi.ts`
- [Food tracking](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/pages/FoodTrackingPage.tsx): `frontend/src/pages/FoodTrackingPage.tsx`
- [Today view](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/pages/TodayPage.tsx): `frontend/src/pages/TodayPage.tsx`
- [Analytics](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/pages/AnalyticsPage.tsx): `frontend/src/pages/AnalyticsPage.tsx`
- [Shopping list](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/frontend/src/pages/ShoppingListPage.tsx): `frontend/src/pages/ShoppingListPage.tsx`

### Identity and security

- [Auth endpoints](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/controller/AuthController.java): `backend/src/main/java/com/dailytracker/nutrition/controller/AuthController.java`
- [Auth workflows](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java): `backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java`
- [JWT service](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/security/JwtService.java): `backend/src/main/java/com/dailytracker/nutrition/security/JwtService.java`
- [User account](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/entity/User.java): `backend/src/main/java/com/dailytracker/nutrition/entity/User.java`

### Nutrition tracking

- [Food endpoints](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/controller/FoodController.java): `backend/src/main/java/com/dailytracker/nutrition/controller/FoodController.java`
- [Food logging](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/FoodLogService.java): `backend/src/main/java/com/dailytracker/nutrition/service/FoodLogService.java`
- [Food records](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/entity/Food.java): `backend/src/main/java/com/dailytracker/nutrition/entity/Food.java`
- [Targets and nutrition](https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/nutrition): `backend/src/main/java/com/dailytracker/nutrition/nutrition`

### Planning and recipes

- [Meal and recipe planning](https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/service): `backend/src/main/java/com/dailytracker/nutrition/service`
- [Online recipes](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/OnlineRecipeService.java): `backend/src/main/java/com/dailytracker/nutrition/service/OnlineRecipeService.java`
- [Recommendations](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/RecommendationService.java): `backend/src/main/java/com/dailytracker/nutrition/service/RecommendationService.java`

### Backend and integrations

- [Feature endpoints](https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/controller): `backend/src/main/java/com/dailytracker/nutrition/controller`
- [Business services](https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/service): `backend/src/main/java/com/dailytracker/nutrition/service`
- [Data repositories](https://github.com/bechir-karmeni/entreprise-web-developement/tree/main/backend/src/main/java/com/dailytracker/nutrition/repository): `backend/src/main/java/com/dailytracker/nutrition/repository`
- **PostgreSQL**
- [MealDB client](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/external/MealDbClient.java): `backend/src/main/java/com/dailytracker/nutrition/external/MealDbClient.java`
- [MealDB service](https://github.com/bechir-karmeni/entreprise-web-developement/blob/main/backend/src/main/java/com/dailytracker/nutrition/service/OnlineRecipeService.java): `backend/src/main/java/com/dailytracker/nutrition/service/OnlineRecipeService.java`

### Other components

- **User**

## Connections

- User → React app routes: uses
- React app routes → Auth session: routes with (evidence: `frontend/src/App.tsx`)
- Auth session → Auth API: authenticates via (evidence: `frontend/src/auth/AuthContext.tsx`)
- User → Food tracking: tracks food
- User → Today view: reviews today
- User → Analytics: reviews progress
- User → Shopping list: manages shopping
- Auth API → Auth endpoints: calls
- Auth endpoints → Auth workflows: delegates to (evidence: `backend/src/main/java/com/dailytracker/nutrition/controller/AuthController.java`)
- Auth workflows → JWT service: issues tokens (evidence: `backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java`)
- Auth workflows → User account: manages account (evidence: `backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java`)
- Food endpoints → Business services: delegates to (evidence: `backend/src/main/java/com/dailytracker/nutrition/controller/FoodController.java`)
- Food tracking → Food endpoints: requests food data
- Food logging → Food records: scales serving nutrients (evidence: `backend/src/main/java/com/dailytracker/nutrition/service/FoodLogService.java`)
- Food logging → Data repositories: reads and writes (evidence: `backend/src/main/java/com/dailytracker/nutrition/service/FoodLogService.java`)
- Meal and recipe planning → Data repositories: persists plans (evidence: `backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java`)
- Online recipes → MealDB client: fetches recipes (evidence: `backend/src/main/java/com/dailytracker/nutrition/service/OnlineRecipeService.java`)
- Recommendations → MealDB client: searches recipes (evidence: `backend/src/main/java/com/dailytracker/nutrition/service/RecommendationService.java`)
- Feature endpoints → Business services: delegates to (evidence: `backend/src/main/java/com/dailytracker/nutrition/controller/FoodController.java`)
- Business services → Data repositories: uses (evidence: `backend/src/main/java/com/dailytracker/nutrition/service/AuthService.java`)
- Data repositories → PostgreSQL: stores data
