# iwrite3/storemymeal architecture

> Architecture diagram of the GitHub repository iwrite3/storemymeal, 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/iwrite3/storemymeal
- Repository: https://github.com/iwrite3/storemymeal

## Overview

StoreMyMeal appears to be a Spring web application for meal-related nutrition facts and analysis. Its likely user workflow begins at the web or facts controller, passes through nutrition services, and may use a repository or DeepSeek integration; the tree also shows a server-rendered page and rate-limit configuration. No README or source excerpts were provided, so these relationships are unverified and shown as dashed. The DTOs and service names indicate the domain stages, but their exact behavior is unknown.

Main entry points: [`src/main/java/com/example/storemymeal/service/NutritionService.java`](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/service/NutritionService.java) (Nutrition service), [`src/main/java/com/example/storemymeal/service/DeepSeekService.java`](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/service/DeepSeekService.java) (DeepSeek service), [`src/main/java/com/example/storemymeal/controller/FactController.java`](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/controller/FactController.java) (Fact controller), [`src/main/java/com/example/storemymeal/controller/WebController.java`](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/controller/WebController.java) (Web controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_web_controller["Web controller<br/>[WebController.java]"]
  node_fact_controller["Fact controller"]
  node_meal_page["Meal page<br/>[index.html]"]
  node_api_response["API response<br/>[ApiResponse.java]"]
end

subgraph group_nutrition["Nutrition domain"]
  node_nutrition_service["Nutrition service"]
  node_meal_analysis["Meal analysis"]
  node_nutrition_fact["Nutrition fact<br/>[NutritionFact.java]"]
end

subgraph group_integration["Persistence and AI"]
  node_fact_repository["Fact repository"]
  node_fact_store[("Fact store")]
  node_deepseek_service["DeepSeek service"]
  node_deepseek_api["DeepSeek API"]
  node_deepseek_request["DeepSeek request"]
  node_deepseek_response["DeepSeek response"]
end

subgraph group_runtime["Application runtime"]
  node_application["Application entry"]
  node_app_config["App configuration<br/>[AppConfig.java]"]
  node_web_config["Web configuration<br/>[WebConfig.java]"]
  node_rate_limit["Rate limit"]
  node_test_runner["Test runner<br/>[TestRunner.java]"]
end

node_user(("User"))

node_user -.->|"opens page"| node_web_controller
node_user -.->|"requests facts"| node_fact_controller
node_web_controller -.->|"renders"| node_meal_page
node_fact_controller -.->|"requests nutrition"| node_nutrition_service
node_nutrition_service -.->|"accesses facts"| node_fact_repository
node_fact_repository -.->|"reads and writes"| node_fact_store
node_nutrition_service -.->|"requests analysis"| node_deepseek_service
node_deepseek_service -.->|"sends request"| node_deepseek_api
node_fact_controller -.->|"returns response"| node_api_response
node_nutrition_service -.->|"produces analysis"| node_meal_analysis
node_nutrition_service -.->|"uses facts"| node_nutrition_fact
node_deepseek_service -.->|"uses request"| node_deepseek_request
node_deepseek_service -.->|"parses response"| node_deepseek_response
node_application -.->|"loads configuration"| node_app_config
node_web_config -.->|"registers interceptor"| node_rate_limit

click node_web_controller "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/controller/WebController.java"
click node_fact_controller "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/controller/FactController.java"
click node_meal_page "https://github.com/iwrite3/storemymeal/blob/main/src/main/resources/templates/index.html"
click node_api_response "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/ApiResponse.java"
click node_nutrition_service "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/service/NutritionService.java"
click node_meal_analysis "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/MealAnalysisResponse.java"
click node_nutrition_fact "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/NutritionFact.java"
click node_fact_repository "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/repository/NutritionFactRepository.java"
click node_deepseek_service "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/service/DeepSeekService.java"
click node_deepseek_request "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/DeepSeekRequest.java"
click node_deepseek_response "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/DeepSeekResponse.java"
click node_application "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/StoremymealApplication.java"
click node_app_config "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/config/AppConfig.java"
click node_web_config "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/config/WebConfig.java"
click node_rate_limit "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/config/RateLimitInterceptor.java"
click node_test_runner "https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/service/TestRunner.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_web_controller,node_fact_controller,node_meal_page,node_api_response,node_user toneBlue
class node_nutrition_service,node_meal_analysis,node_nutrition_fact toneAmber
class node_fact_repository,node_fact_store,node_deepseek_service,node_deepseek_api,node_deepseek_request,node_deepseek_response toneMint
class node_application,node_app_config,node_web_config,node_rate_limit,node_test_runner toneRose
```

## Components

### Web interface

- [Web controller](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/controller/WebController.java): `src/main/java/com/example/storemymeal/controller/WebController.java`
- [Fact controller](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/controller/FactController.java): `src/main/java/com/example/storemymeal/controller/FactController.java`
- [Meal page](https://github.com/iwrite3/storemymeal/blob/main/src/main/resources/templates/index.html): `src/main/resources/templates/index.html`
- [API response](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/ApiResponse.java): `src/main/java/com/example/storemymeal/model/ApiResponse.java`

### Nutrition domain

- [Nutrition service](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/service/NutritionService.java): `src/main/java/com/example/storemymeal/service/NutritionService.java`
- [Meal analysis](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/MealAnalysisResponse.java): `src/main/java/com/example/storemymeal/model/MealAnalysisResponse.java`
- [Nutrition fact](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/NutritionFact.java): `src/main/java/com/example/storemymeal/model/NutritionFact.java`

### Persistence and AI

- [Fact repository](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/repository/NutritionFactRepository.java): `src/main/java/com/example/storemymeal/repository/NutritionFactRepository.java`
- **Fact store**
- [DeepSeek service](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/service/DeepSeekService.java): `src/main/java/com/example/storemymeal/service/DeepSeekService.java`
- **DeepSeek API**
- [DeepSeek request](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/DeepSeekRequest.java): `src/main/java/com/example/storemymeal/model/DeepSeekRequest.java`
- [DeepSeek response](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/model/DeepSeekResponse.java): `src/main/java/com/example/storemymeal/model/DeepSeekResponse.java`

### Application runtime

- [Application entry](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/StoremymealApplication.java): `src/main/java/com/example/storemymeal/StoremymealApplication.java`
- [App configuration](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/config/AppConfig.java): `src/main/java/com/example/storemymeal/config/AppConfig.java`
- [Web configuration](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/config/WebConfig.java): `src/main/java/com/example/storemymeal/config/WebConfig.java`
- [Rate limit](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/config/RateLimitInterceptor.java): `src/main/java/com/example/storemymeal/config/RateLimitInterceptor.java`
- [Test runner](https://github.com/iwrite3/storemymeal/blob/main/src/main/java/com/example/storemymeal/service/TestRunner.java): `src/main/java/com/example/storemymeal/service/TestRunner.java`

### Other components

- **User**

## Connections

- User → Web controller: opens page
- User → Fact controller: requests facts
- Web controller → Meal page: renders
- Fact controller → Nutrition service: requests nutrition
- Nutrition service → Fact repository: accesses facts
- Fact repository → Fact store: reads and writes
- Nutrition service → DeepSeek service: requests analysis
- DeepSeek service → DeepSeek API: sends request
- Fact controller → API response: returns response
- Nutrition service → Meal analysis: produces analysis
- Nutrition service → Nutrition fact: uses facts
- DeepSeek service → DeepSeek request: uses request
- DeepSeek service → DeepSeek response: parses response
- Application entry → App configuration: loads configuration
- Web configuration → Rate limit: registers interceptor
