# andresade16/capstoneproject architecture

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

- Interactive diagram: https://gitdiagram.com/andresade16/capstoneproject
- Repository: https://github.com/andresade16/capstoneproject

## Overview

This is a Spring-based food-planning backend: users manage ingredient definitions, recipes, pantry stock and shopping lists. A key workflow converts a recipe’s ingredients into shopping-list items, then lets purchased items become pantry stock. The graph preserves those domain stages plus account/authentication and image/email integrations. Evidence is limited to the README (empty), the SOURCE INDEX and the excerpts shown; uncertain wiring is omitted rather than inferred.

Main entry points: [`src/main/java/andreasaderi/capstone/services/RecipeService.java`](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/RecipeService.java) (Recipe Management), [`src/main/java/andreasaderi/capstone/controllers/RecipeController.java`](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/controllers/RecipeController.java) (Recipe API), [`src/main/java/andreasaderi/capstone/services/UserService.java`](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/UserService.java) (User Management), [`src/main/java/andreasaderi/capstone/repositories`](https://github.com/andresade16/capstoneproject/tree/main/src/main/java/andreasaderi/capstone/repositories) (Data Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_recipe_api["Recipe API"]
  node_shopping_api["Shopping APIs"]
  node_user_api["User API"]
end

subgraph group_accounts["Accounts &amp; Security"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_user_service["User Management<br/>[UserService.java]"]
  node_security["JWT Security"]
end

subgraph group_food["Food Planning"]
  node_recipe_service["Recipe Management<br/>[RecipeService.java]"]
  node_ingredients["Ingredient Catalog"]
  node_pantry["Pantry Stock"]
  node_shopping["Shopping Lists"]
  node_shopping_items["List Items"]
  node_recipe_ingredients["Recipe Ingredients"]
end

subgraph group_persistence["Persistence"]
  node_entities["Domain Records"]
  node_repositories["Data Repositories"]
end

subgraph group_integrations["External Services"]
  node_cloudinary["Cloudinary"]
  node_email["Email Provider"]
end

node_user(("User"))
node_database[("Relational Database")]

node_user -->|"requests recipes"| node_recipe_api
node_user -->|"manages lists"| node_shopping_api
node_user -->|"manages account"| node_user_api
node_recipe_api -->|"delegates to"| node_recipe_service
node_recipe_api -->|"delegates to"| node_recipe_ingredients
node_recipe_api -->|"delegates to"| node_shopping
node_recipe_api -->|"delegates to"| node_pantry
node_shopping_api -->|"delegates to"| node_shopping_items
node_shopping_api -->|"delegates to"| node_shopping
node_user_api -->|"delegates to"| node_auth
node_user_api -->|"delegates to"| node_user_service
node_auth -->|"uses account service"| node_user_service
node_recipe_service -->|"creates list items"| node_shopping_items
node_recipe_service -->|"checks and updates"| node_pantry
node_recipe_service -->|"uploads images"| node_cloudinary
node_pantry -->|"resolves ingredient"| node_ingredients
node_ingredients -->|"finds affected recipes"| node_recipe_service
node_user_service -->|"sends email"| node_email
node_user_service -->|"uploads images"| node_cloudinary
node_auth -->|"uses JWT tools"| node_security
node_recipe_service -->|"queries recipes"| node_repositories
node_pantry -->|"queries pantry"| node_repositories
node_ingredients -->|"queries catalog"| node_repositories
node_user_service -->|"queries users"| node_repositories
node_repositories -.->|"persists records"| node_entities
node_entities -.->|"stored in"| node_database

click node_recipe_api "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/controllers/RecipeController.java"
click node_shopping_api "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/controllers/ShoppingListItemController.java"
click node_user_api "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/controllers/UserController.java"
click node_auth "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/AuthService.java"
click node_user_service "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/UserService.java"
click node_security "https://github.com/andresade16/capstoneproject/tree/main/src/main/java/andreasaderi/capstone/security"
click node_recipe_service "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/RecipeService.java"
click node_ingredients "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/IngredientDefinitionService.java"
click node_pantry "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/PantryItemService.java"
click node_shopping "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/ShoppingListService.java"
click node_shopping_items "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/ShoppingListItemService.java"
click node_recipe_ingredients "https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/RecipeIngredientService.java"
click node_entities "https://github.com/andresade16/capstoneproject/tree/main/src/main/java/andreasaderi/capstone/entities"
click node_repositories "https://github.com/andresade16/capstoneproject/tree/main/src/main/java/andreasaderi/capstone/repositories"

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_recipe_api,node_shopping_api,node_user_api,node_user toneBlue
class node_auth,node_user_service,node_security,node_database toneAmber
class node_recipe_service,node_ingredients,node_pantry,node_shopping,node_shopping_items,node_recipe_ingredients toneMint
class node_entities,node_repositories toneRose
class node_cloudinary,node_email toneIndigo
```

## Components

### HTTP API

- [Recipe API](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/controllers/RecipeController.java): `src/main/java/andreasaderi/capstone/controllers/RecipeController.java`
- [Shopping APIs](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/controllers/ShoppingListItemController.java): `src/main/java/andreasaderi/capstone/controllers/ShoppingListItemController.java`
- [User API](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/controllers/UserController.java): `src/main/java/andreasaderi/capstone/controllers/UserController.java`

### Accounts & Security

- [Authentication](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/AuthService.java): `src/main/java/andreasaderi/capstone/services/AuthService.java`
- [User Management](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/UserService.java): `src/main/java/andreasaderi/capstone/services/UserService.java`
- [JWT Security](https://github.com/andresade16/capstoneproject/tree/main/src/main/java/andreasaderi/capstone/security): `src/main/java/andreasaderi/capstone/security`

### Food Planning

- [Recipe Management](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/RecipeService.java): `src/main/java/andreasaderi/capstone/services/RecipeService.java`
- [Ingredient Catalog](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/IngredientDefinitionService.java): `src/main/java/andreasaderi/capstone/services/IngredientDefinitionService.java`
- [Pantry Stock](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/PantryItemService.java): `src/main/java/andreasaderi/capstone/services/PantryItemService.java`
- [Shopping Lists](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/ShoppingListService.java): `src/main/java/andreasaderi/capstone/services/ShoppingListService.java`
- [List Items](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/ShoppingListItemService.java): `src/main/java/andreasaderi/capstone/services/ShoppingListItemService.java`
- [Recipe Ingredients](https://github.com/andresade16/capstoneproject/blob/main/src/main/java/andreasaderi/capstone/services/RecipeIngredientService.java): `src/main/java/andreasaderi/capstone/services/RecipeIngredientService.java`

### Persistence

- [Domain Records](https://github.com/andresade16/capstoneproject/tree/main/src/main/java/andreasaderi/capstone/entities): `src/main/java/andreasaderi/capstone/entities`
- [Data Repositories](https://github.com/andresade16/capstoneproject/tree/main/src/main/java/andreasaderi/capstone/repositories): `src/main/java/andreasaderi/capstone/repositories`

### External Services

- **Cloudinary**
- **Email Provider**

### Other components

- **User**
- **Relational Database**

## Connections

- User → Recipe API: requests recipes (evidence: `src/main/java/andreasaderi/capstone/controllers/RecipeController.java`)
- User → Shopping APIs: manages lists (evidence: `src/main/java/andreasaderi/capstone/controllers/ShoppingListItemController.java`)
- User → User API: manages account (evidence: `src/main/java/andreasaderi/capstone/controllers/UserController.java`)
- Recipe API → Recipe Management: delegates to (evidence: `src/main/java/andreasaderi/capstone/controllers/RecipeController.java`)
- Recipe API → Recipe Ingredients: delegates to (evidence: `src/main/java/andreasaderi/capstone/controllers/RecipeController.java`)
- Recipe API → Shopping Lists: delegates to (evidence: `src/main/java/andreasaderi/capstone/controllers/RecipeController.java`)
- Recipe API → Pantry Stock: delegates to (evidence: `src/main/java/andreasaderi/capstone/controllers/RecipeController.java`)
- Shopping APIs → List Items: delegates to (evidence: `src/main/java/andreasaderi/capstone/controllers/ShoppingListItemController.java`)
- Shopping APIs → Shopping Lists: delegates to (evidence: `src/main/java/andreasaderi/capstone/controllers/ShoppingListItemController.java`)
- User API → Authentication: delegates to (evidence: `src/main/java/andreasaderi/capstone/controllers/UserController.java`)
- User API → User Management: delegates to (evidence: `src/main/java/andreasaderi/capstone/controllers/UserController.java`)
- Authentication → User Management: uses account service (evidence: `src/main/java/andreasaderi/capstone/services/AuthService.java`)
- Recipe Management → List Items: creates list items (evidence: `src/main/java/andreasaderi/capstone/services/RecipeService.java`)
- Recipe Management → Pantry Stock: checks and updates (evidence: `src/main/java/andreasaderi/capstone/services/RecipeService.java`)
- Recipe Management → Cloudinary: uploads images (evidence: `src/main/java/andreasaderi/capstone/services/RecipeService.java`)
- Pantry Stock → Ingredient Catalog: resolves ingredient (evidence: `src/main/java/andreasaderi/capstone/services/PantryItemService.java`)
- Ingredient Catalog → Recipe Management: finds affected recipes (evidence: `src/main/java/andreasaderi/capstone/services/IngredientDefinitionService.java`)
- User Management → Email Provider: sends email (evidence: `src/main/java/andreasaderi/capstone/services/UserService.java`)
- User Management → Cloudinary: uploads images (evidence: `src/main/java/andreasaderi/capstone/services/UserService.java`)
- Authentication → JWT Security: uses JWT tools (evidence: `src/main/java/andreasaderi/capstone/services/AuthService.java`)
- Recipe Management → Data Repositories: queries recipes (evidence: `src/main/java/andreasaderi/capstone/services/RecipeService.java`)
- Pantry Stock → Data Repositories: queries pantry (evidence: `src/main/java/andreasaderi/capstone/services/PantryItemService.java`)
- Ingredient Catalog → Data Repositories: queries catalog (evidence: `src/main/java/andreasaderi/capstone/services/IngredientDefinitionService.java`)
- User Management → Data Repositories: queries users (evidence: `src/main/java/andreasaderi/capstone/services/UserService.java`)
- Data Repositories → Domain Records: persists records (evidence: `src/main/java/andreasaderi/capstone/repositories/PantryItemRepository.java`)
- Domain Records → Relational Database: stored in
