# evolv-projects/pep-gp-webdevproject-recipe architecture

> Architecture diagram of the GitHub repository evolv-projects/pep-gp-webdevproject-recipe, 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/evolv-projects/pep-gp-webdevproject-recipe
- Repository: https://github.com/evolv-projects/pep-gp-webdevproject-recipe

## Overview

This is a recipe-management web application: users register or log in, then browse, search, and manage recipes; admins additionally manage ingredients. The Java/Javalin backend exposes REST routes and delegates business operations to services and JDBC DAOs backed by H2. The README documents the browser workflows and API contract; source excerpts show representative controller, service, DAO, and connection behavior. Some controller and wiring details are unsampled, so unverified relationships are omitted.

Main entry points: [`src/main/java/com/revature/service/RecipeService.java`](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/RecipeService.java) (Recipe operations), [`src/main/java/com/revature/service/IngredientService.java`](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/IngredientService.java) (Ingredient operations), [`src/main/java/com/revature/controller/AuthenticationController.java`](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/controller/AuthenticationController.java) (Authentication routes), [`src/main/java/com/revature/service/ChefService.java`](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/ChefService.java) (Chef accounts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser interface"]
  node_frontend_auth["Login and registration<br/>[login-page.js]"]
  node_frontend_recipes["Recipe workspace<br/>[recipe-page.js]"]
  node_frontend_ingredients["Ingredient admin<br/>[ingredient-page.js]"]
end

subgraph group_api["REST API"]
  node_auth_api["Authentication routes"]
  node_recipe_api["Recipe routes"]
  node_ingredient_api["Ingredient routes"]
  node_admin_auth["Admin authorization"]
  node_app_setup["Route setup"]
end

subgraph group_domain["Domain services"]
  node_auth_service["Authentication and sessions"]
  node_chef_service["Chef accounts<br/>[ChefService.java]"]
  node_recipe_service["Recipe operations<br/>[RecipeService.java]"]
  node_ingredient_service["Ingredient operations"]
  node_chef_model["Chef account<br/>[Chef.java]"]
  node_recipe_model["Recipe<br/>[Recipe.java]"]
  node_ingredient_model["Ingredient<br/>[Ingredient.java]"]
  node_recipe_ingredient["Recipe ingredient"]
  node_pagination["Pagination options and results<br/>[Page.java]"]
end

subgraph group_persistence["Persistence"]
  node_chef_dao["Chef persistence<br/>[ChefDAO.java]"]
  node_recipe_dao["Recipe persistence<br/>[RecipeDAO.java]"]
  node_ingredient_dao["Ingredient persistence<br/>[IngredientDAO.java]"]
  node_h2[("H2 database")]
end

node_user(("User"))

node_user -->|"registers or logs in"| node_frontend_auth
node_user -->|"manages recipes"| node_frontend_recipes
node_user -->|"administers ingredients"| node_frontend_ingredients
node_frontend_auth -->|"sends auth requests"| node_auth_api
node_frontend_recipes -->|"calls recipe API"| node_recipe_api
node_frontend_ingredients -->|"calls ingredient API"| node_ingredient_api
node_app_setup -->|"registers routes"| node_auth_api
node_app_setup -->|"registers routes"| node_recipe_api
node_app_setup -->|"registers routes"| node_ingredient_api
node_auth_api -->|"delegates auth"| node_auth_service
node_auth_api -->|"uses accounts"| node_chef_service
node_recipe_api -->|"delegates recipes"| node_recipe_service
node_ingredient_api -->|"delegates ingredients"| node_ingredient_service
node_auth_service -->|"checks and saves chefs"| node_chef_service
node_chef_service -->|"persists accounts"| node_chef_dao
node_recipe_service -->|"persists recipes"| node_recipe_dao
node_ingredient_service -->|"persists ingredients"| node_ingredient_dao
node_chef_dao -->|"queries and writes"| node_h2
node_recipe_dao -->|"queries and writes"| node_h2
node_ingredient_dao -->|"queries and writes"| node_h2
node_chef_service -->|"manages"| node_chef_model
node_recipe_service -->|"manages"| node_recipe_model
node_ingredient_service -->|"manages"| node_ingredient_model
node_recipe_dao -->|"maps recipe data"| node_recipe_ingredient
node_recipe_service -->|"builds paged results"| node_pagination
node_ingredient_service -->|"builds paged results"| node_pagination
node_admin_auth -->|"validates sessions"| node_auth_service

click node_frontend_auth "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/resources/public/frontend/login/login-page.js"
click node_frontend_recipes "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/resources/public/frontend/recipe/recipe-page.js"
click node_frontend_ingredients "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/resources/public/frontend/ingredients/ingredient-page.js"
click node_auth_api "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/controller/AuthenticationController.java"
click node_recipe_api "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/controller/RecipeController.java"
click node_ingredient_api "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/controller/IngredientController.java"
click node_admin_auth "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/util/AdminMiddleware.java"
click node_app_setup "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/util/JavalinAppUtil.java"
click node_auth_service "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/AuthenticationService.java"
click node_chef_service "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/ChefService.java"
click node_recipe_service "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/RecipeService.java"
click node_ingredient_service "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/IngredientService.java"
click node_chef_dao "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/dao/ChefDAO.java"
click node_recipe_dao "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/dao/RecipeDAO.java"
click node_ingredient_dao "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/dao/IngredientDAO.java"
click node_h2 "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/util/ConnectionUtil.java"
click node_chef_model "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/model/Chef.java"
click node_recipe_model "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/model/Recipe.java"
click node_ingredient_model "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/model/Ingredient.java"
click node_recipe_ingredient "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/model/RecipeIngredient.java"
click node_pagination "https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/util/Page.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_frontend_auth,node_frontend_recipes,node_frontend_ingredients,node_user toneBlue
class node_auth_api,node_recipe_api,node_ingredient_api,node_admin_auth,node_app_setup toneAmber
class node_auth_service,node_chef_service,node_recipe_service,node_ingredient_service,node_chef_model,node_recipe_model,node_ingredient_model,node_recipe_ingredient,node_pagination toneMint
class node_chef_dao,node_recipe_dao,node_ingredient_dao,node_h2 toneRose
```

## Components

### Browser interface

- [Login and registration](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/resources/public/frontend/login/login-page.js): `src/main/resources/public/frontend/login/login-page.js`
- [Recipe workspace](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/resources/public/frontend/recipe/recipe-page.js): `src/main/resources/public/frontend/recipe/recipe-page.js`
- [Ingredient admin](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/resources/public/frontend/ingredients/ingredient-page.js): `src/main/resources/public/frontend/ingredients/ingredient-page.js`

### REST API

- [Authentication routes](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/controller/AuthenticationController.java): `src/main/java/com/revature/controller/AuthenticationController.java`
- [Recipe routes](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/controller/RecipeController.java): `src/main/java/com/revature/controller/RecipeController.java`
- [Ingredient routes](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/controller/IngredientController.java): `src/main/java/com/revature/controller/IngredientController.java`
- [Admin authorization](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/util/AdminMiddleware.java): `src/main/java/com/revature/util/AdminMiddleware.java`
- [Route setup](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/util/JavalinAppUtil.java): `src/main/java/com/revature/util/JavalinAppUtil.java`

### Domain services

- [Authentication and sessions](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/AuthenticationService.java): `src/main/java/com/revature/service/AuthenticationService.java`
- [Chef accounts](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/ChefService.java): `src/main/java/com/revature/service/ChefService.java`
- [Recipe operations](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/RecipeService.java): `src/main/java/com/revature/service/RecipeService.java`
- [Ingredient operations](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/service/IngredientService.java): `src/main/java/com/revature/service/IngredientService.java`
- [Chef account](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/model/Chef.java): `src/main/java/com/revature/model/Chef.java`
- [Recipe](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/model/Recipe.java): `src/main/java/com/revature/model/Recipe.java`
- [Ingredient](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/model/Ingredient.java): `src/main/java/com/revature/model/Ingredient.java`
- [Recipe ingredient](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/model/RecipeIngredient.java): `src/main/java/com/revature/model/RecipeIngredient.java`
- [Pagination options and results](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/util/Page.java): `src/main/java/com/revature/util/Page.java`

### Persistence

- [Chef persistence](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/dao/ChefDAO.java): `src/main/java/com/revature/dao/ChefDAO.java`
- [Recipe persistence](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/dao/RecipeDAO.java): `src/main/java/com/revature/dao/RecipeDAO.java`
- [Ingredient persistence](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/dao/IngredientDAO.java): `src/main/java/com/revature/dao/IngredientDAO.java`
- [H2 database](https://github.com/evolv-projects/pep-gp-webdevproject-recipe/blob/main/src/main/java/com/revature/util/ConnectionUtil.java): `src/main/java/com/revature/util/ConnectionUtil.java`

### Other components

- **User**

## Connections

- User → Login and registration: registers or logs in (evidence: `README.md`)
- User → Recipe workspace: manages recipes (evidence: `README.md`)
- User → Ingredient admin: administers ingredients (evidence: `README.md`)
- Login and registration → Authentication routes: sends auth requests (evidence: `README.md`)
- Recipe workspace → Recipe routes: calls recipe API (evidence: `README.md`)
- Ingredient admin → Ingredient routes: calls ingredient API (evidence: `README.md`)
- Route setup → Authentication routes: registers routes (evidence: `src/main/java/com/revature/util/JavalinAppUtil.java`)
- Route setup → Recipe routes: registers routes (evidence: `src/main/java/com/revature/util/JavalinAppUtil.java`)
- Route setup → Ingredient routes: registers routes (evidence: `src/main/java/com/revature/util/JavalinAppUtil.java`)
- Authentication routes → Authentication and sessions: delegates auth (evidence: `src/main/java/com/revature/controller/AuthenticationController.java`)
- Authentication routes → Chef accounts: uses accounts (evidence: `src/main/java/com/revature/controller/AuthenticationController.java`)
- Recipe routes → Recipe operations: delegates recipes (evidence: `src/main/java/com/revature/controller/RecipeController.java`)
- Ingredient routes → Ingredient operations: delegates ingredients (evidence: `src/main/java/com/revature/controller/IngredientController.java`)
- Authentication and sessions → Chef accounts: checks and saves chefs (evidence: `src/main/java/com/revature/service/AuthenticationService.java`)
- Chef accounts → Chef persistence: persists accounts (evidence: `src/main/java/com/revature/service/ChefService.java`)
- Recipe operations → Recipe persistence: persists recipes (evidence: `src/main/java/com/revature/service/RecipeService.java`)
- Ingredient operations → Ingredient persistence: persists ingredients (evidence: `src/main/java/com/revature/service/IngredientService.java`)
- Chef persistence → H2 database: queries and writes (evidence: `src/main/java/com/revature/dao/ChefDAO.java`)
- Recipe persistence → H2 database: queries and writes (evidence: `src/main/java/com/revature/dao/RecipeDAO.java`)
- Ingredient persistence → H2 database: queries and writes (evidence: `src/main/java/com/revature/dao/IngredientDAO.java`)
- Chef accounts → Chef account: manages (evidence: `src/main/java/com/revature/service/ChefService.java`)
- Recipe operations → Recipe: manages (evidence: `src/main/java/com/revature/service/RecipeService.java`)
- Ingredient operations → Ingredient: manages (evidence: `src/main/java/com/revature/service/IngredientService.java`)
- Recipe persistence → Recipe ingredient: maps recipe data (evidence: `src/main/java/com/revature/dao/RecipeDAO.java`)
- Recipe operations → Pagination options and results: builds paged results (evidence: `src/main/java/com/revature/service/RecipeService.java`)
- Ingredient operations → Pagination options and results: builds paged results (evidence: `src/main/java/com/revature/service/IngredientService.java`)
- Admin authorization → Authentication and sessions: validates sessions (evidence: `src/main/java/com/revature/util/AdminMiddleware.java`)
