# phu0312/veggiepal_be architecture

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

- Interactive diagram: https://gitdiagram.com/phu0312/veggiepal_be
- Repository: https://github.com/phu0312/veggiepal_be

## Overview

VeggiePal is a Java microservice backend for vegan community and nutrition features. The documented user path is client → API Gateway → identity, nutrition, or blog APIs; those services own separate data stores. Sampled code also exposes AI meal-plan, prompt-preview, diary-snapshot, payment, and restaurant-search behavior. The README describes several of these as not yet implemented, so they are shown as repository capabilities rather than confirmed live routes. Cross-service edges follow explicit README statements or sampled calls; unsampled wiring is omitted.

Main entry points: [`api-gateway/src/main/java/com/veggiepal/gateway/ApiGatewayApplication.java`](https://github.com/phu0312/veggiepal_be/blob/dev/api-gateway/src/main/java/com/veggiepal/gateway/ApiGatewayApplication.java) (API Gateway), [`nutrition-service/src/main/java/com/veggiepal/nutrition/controller/HealthRecordController.java`](https://github.com/phu0312/veggiepal_be/blob/dev/nutrition-service/src/main/java/com/veggiepal/nutrition/controller/HealthRecordController.java) (Health and allergies), [`blog-service/src/main/java/com/veggiepal/blog/service/BlogService.java`](https://github.com/phu0312/veggiepal_be/blob/dev/blog-service/src/main/java/com/veggiepal/blog/service/BlogService.java) (Blogs and comments), [`identity-service/src/main/java/com/veggiepal/controller/UserController.java`](https://github.com/phu0312/veggiepal_be/blob/dev/identity-service/src/main/java/com/veggiepal/controller/UserController.java) (Accounts and profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["API entry"]
  node_gateway["API Gateway"]
end

subgraph group_identity["Identity"]
  node_identity_api["Accounts and profiles"]
  node_identity_store[("Identity data<br/>[User.java]")]
end

subgraph group_nutrition["Nutrition"]
  node_nutrition_api["Health and allergies"]
  node_nutrition_store[("Nutrition data")]
  node_diary["Food and activity diary<br/>[DiaryService.java]"]
end

subgraph group_community["Community"]
  node_blog["Blogs and comments<br/>[BlogService.java]"]
  node_moderation["Content moderation"]
  node_blog_store[("Blog data<br/>[Blog.java]")]
end

subgraph group_ai["AI features"]
  node_ai_chat["AI chat<br/>[ChatService.java]"]
  node_mealplan["Meal planning"]
  node_prompt_preview["Prompt preview"]
  node_groq["Groq client<br/>[GroqClient.java]"]
end

subgraph group_commerce["Other domains"]
  node_payment["Payments and plans"]
  node_restaurant["Restaurant search"]
  node_recipes["Recipes and ingredients<br/>[RecipeService.java]"]
end

node_clients(("Web / mobile clients"))
node_groq_service["Groq API"]
node_payos["PayOS"]
node_cloudinary["Cloudinary storage"]

node_clients -->|"send requests"| node_gateway
node_gateway -->|"routes to"| node_identity_api
node_gateway -->|"routes to"| node_nutrition_api
node_gateway -->|"routes to"| node_blog
node_identity_api -->|"owns data"| node_identity_store
node_nutrition_api -->|"owns data"| node_nutrition_store
node_nutrition_api -.->|"offers diary"| node_diary
node_blog -->|"owns data"| node_blog_store
node_moderation -.->|"moderates content"| node_blog
node_prompt_preview -->|"requests preview"| node_groq
node_prompt_preview -->|"reads active prompt"| node_mealplan
node_groq -->|"calls completion API"| node_groq_service
node_diary -->|"fetches plan snapshot"| node_mealplan
node_mealplan -->|"fetches health data"| node_nutrition_api
node_payment -->|"creates payment link"| node_payos
node_identity_api -->|"stores avatars"| node_cloudinary
node_blog -->|"stores thumbnails"| node_cloudinary

click node_gateway "https://github.com/phu0312/veggiepal_be/blob/dev/api-gateway/src/main/java/com/veggiepal/gateway/ApiGatewayApplication.java"
click node_identity_api "https://github.com/phu0312/veggiepal_be/blob/dev/identity-service/src/main/java/com/veggiepal/controller/UserController.java"
click node_identity_store "https://github.com/phu0312/veggiepal_be/blob/dev/identity-service/src/main/java/com/veggiepal/entity/User.java"
click node_nutrition_api "https://github.com/phu0312/veggiepal_be/blob/dev/nutrition-service/src/main/java/com/veggiepal/nutrition/controller/HealthRecordController.java"
click node_nutrition_store "https://github.com/phu0312/veggiepal_be/blob/dev/nutrition-service/src/main/java/com/veggiepal/nutrition/service/HealthRecordService.java"
click node_diary "https://github.com/phu0312/veggiepal_be/blob/dev/nutrition-service/src/main/java/com/veggiepal/nutrition/diary/DiaryService.java"
click node_blog "https://github.com/phu0312/veggiepal_be/blob/dev/blog-service/src/main/java/com/veggiepal/blog/service/BlogService.java"
click node_moderation "https://github.com/phu0312/veggiepal_be/blob/dev/blog-service/src/main/java/com/veggiepal/blog/moderation/AiContentModerationService.java"
click node_blog_store "https://github.com/phu0312/veggiepal_be/blob/dev/blog-service/src/main/java/com/veggiepal/blog/entity/Blog.java"
click node_ai_chat "https://github.com/phu0312/veggiepal_be/blob/dev/ai-service/src/main/java/com/veggiepal/ai/chat/ChatService.java"
click node_mealplan "https://github.com/phu0312/veggiepal_be/blob/dev/ai-service/src/main/java/com/veggiepal/ai/mealplan/MealPlanService.java"
click node_prompt_preview "https://github.com/phu0312/veggiepal_be/blob/dev/ai-service/src/main/java/com/veggiepal/ai/prompt/PromptPreviewService.java"
click node_groq "https://github.com/phu0312/veggiepal_be/blob/dev/ai-service/src/main/java/com/veggiepal/ai/groq/GroqClient.java"
click node_payment "https://github.com/phu0312/veggiepal_be/blob/dev/payment-service/src/main/java/com/veggiepal/payment/service/PaymentService.java"
click node_restaurant "https://github.com/phu0312/veggiepal_be/blob/dev/location-service/src/main/java/com/veggiepal/location/service/RestaurantService.java"
click node_recipes "https://github.com/phu0312/veggiepal_be/blob/dev/recipe-service/src/main/java/com/veggiepal/recipe/service/RecipeService.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_gateway,node_clients toneBlue
class node_identity_api,node_identity_store,node_cloudinary toneAmber
class node_nutrition_api,node_nutrition_store,node_diary,node_groq_service toneMint
class node_blog,node_moderation,node_blog_store toneRose
class node_ai_chat,node_mealplan,node_prompt_preview,node_groq,node_payos toneIndigo
class node_payment,node_restaurant,node_recipes toneTeal
```

## Components

### API entry

- [API Gateway](https://github.com/phu0312/veggiepal_be/blob/dev/api-gateway/src/main/java/com/veggiepal/gateway/ApiGatewayApplication.java): `api-gateway/src/main/java/com/veggiepal/gateway/ApiGatewayApplication.java`

### Identity

- [Accounts and profiles](https://github.com/phu0312/veggiepal_be/blob/dev/identity-service/src/main/java/com/veggiepal/controller/UserController.java): `identity-service/src/main/java/com/veggiepal/controller/UserController.java`
- [Identity data](https://github.com/phu0312/veggiepal_be/blob/dev/identity-service/src/main/java/com/veggiepal/entity/User.java): `identity-service/src/main/java/com/veggiepal/entity/User.java`

### Nutrition

- [Health and allergies](https://github.com/phu0312/veggiepal_be/blob/dev/nutrition-service/src/main/java/com/veggiepal/nutrition/controller/HealthRecordController.java): `nutrition-service/src/main/java/com/veggiepal/nutrition/controller/HealthRecordController.java`
- [Nutrition data](https://github.com/phu0312/veggiepal_be/blob/dev/nutrition-service/src/main/java/com/veggiepal/nutrition/service/HealthRecordService.java): `nutrition-service/src/main/java/com/veggiepal/nutrition/service/HealthRecordService.java`
- [Food and activity diary](https://github.com/phu0312/veggiepal_be/blob/dev/nutrition-service/src/main/java/com/veggiepal/nutrition/diary/DiaryService.java): `nutrition-service/src/main/java/com/veggiepal/nutrition/diary/DiaryService.java`

### Community

- [Blogs and comments](https://github.com/phu0312/veggiepal_be/blob/dev/blog-service/src/main/java/com/veggiepal/blog/service/BlogService.java): `blog-service/src/main/java/com/veggiepal/blog/service/BlogService.java`
- [Content moderation](https://github.com/phu0312/veggiepal_be/blob/dev/blog-service/src/main/java/com/veggiepal/blog/moderation/AiContentModerationService.java): `blog-service/src/main/java/com/veggiepal/blog/moderation/AiContentModerationService.java`
- [Blog data](https://github.com/phu0312/veggiepal_be/blob/dev/blog-service/src/main/java/com/veggiepal/blog/entity/Blog.java): `blog-service/src/main/java/com/veggiepal/blog/entity/Blog.java`

### AI features

- [AI chat](https://github.com/phu0312/veggiepal_be/blob/dev/ai-service/src/main/java/com/veggiepal/ai/chat/ChatService.java): `ai-service/src/main/java/com/veggiepal/ai/chat/ChatService.java`
- [Meal planning](https://github.com/phu0312/veggiepal_be/blob/dev/ai-service/src/main/java/com/veggiepal/ai/mealplan/MealPlanService.java): `ai-service/src/main/java/com/veggiepal/ai/mealplan/MealPlanService.java`
- [Prompt preview](https://github.com/phu0312/veggiepal_be/blob/dev/ai-service/src/main/java/com/veggiepal/ai/prompt/PromptPreviewService.java): `ai-service/src/main/java/com/veggiepal/ai/prompt/PromptPreviewService.java`
- [Groq client](https://github.com/phu0312/veggiepal_be/blob/dev/ai-service/src/main/java/com/veggiepal/ai/groq/GroqClient.java): `ai-service/src/main/java/com/veggiepal/ai/groq/GroqClient.java`

### Other domains

- [Payments and plans](https://github.com/phu0312/veggiepal_be/blob/dev/payment-service/src/main/java/com/veggiepal/payment/service/PaymentService.java): `payment-service/src/main/java/com/veggiepal/payment/service/PaymentService.java`
- [Restaurant search](https://github.com/phu0312/veggiepal_be/blob/dev/location-service/src/main/java/com/veggiepal/location/service/RestaurantService.java): `location-service/src/main/java/com/veggiepal/location/service/RestaurantService.java`
- [Recipes and ingredients](https://github.com/phu0312/veggiepal_be/blob/dev/recipe-service/src/main/java/com/veggiepal/recipe/service/RecipeService.java): `recipe-service/src/main/java/com/veggiepal/recipe/service/RecipeService.java`

### Other components

- **Web / mobile clients**
- **Groq API**
- **PayOS**
- **Cloudinary storage**

## Connections

- Web / mobile clients → API Gateway: send requests
- API Gateway → Accounts and profiles: routes to
- API Gateway → Health and allergies: routes to
- API Gateway → Blogs and comments: routes to
- Accounts and profiles → Identity data: owns data
- Health and allergies → Nutrition data: owns data
- Health and allergies → Food and activity diary: offers diary
- Blogs and comments → Blog data: owns data
- Content moderation → Blogs and comments: moderates content
- Prompt preview → Groq client: requests preview (evidence: `ai-service/src/main/java/com/veggiepal/ai/prompt/PromptPreviewService.java`)
- Prompt preview → Meal planning: reads active prompt (evidence: `ai-service/src/main/java/com/veggiepal/ai/prompt/PromptPreviewService.java`)
- Groq client → Groq API: calls completion API (evidence: `ai-service/src/main/java/com/veggiepal/ai/groq/GroqClient.java`)
- Food and activity diary → Meal planning: fetches plan snapshot (evidence: `nutrition-service/src/main/java/com/veggiepal/nutrition/diary/DiaryService.java`)
- Meal planning → Health and allergies: fetches health data (evidence: `ai-service/src/main/java/com/veggiepal/ai/mealplan/MealPlanService.java`)
- Payments and plans → PayOS: creates payment link (evidence: `payment-service/src/main/java/com/veggiepal/payment/service/PaymentService.java`)
- Accounts and profiles → Cloudinary storage: stores avatars
- Blogs and comments → Cloudinary storage: stores thumbnails
