# kelvinlai2912/toogoodtogo architecture

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

## Overview

TooGoodToGo is a canteen meal-package application: employees manage packages and students browse and reserve them. The MVC application exposes the user-facing workflow, while a separate WebAPI offers package access through REST and GraphQL. PackageService applies reservation and package rules before persistence through repositories and Entity Framework. Registration and account handling form a separate capability. The source index supports the main service, repository, controller, and API connections; unsampled service and controller details are represented conservatively.

Main entry points: [`Core.DomainServices/Services/PackageService.cs`](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.DomainServices/Services/PackageService.cs) (Package rules), [`Core.Domain/Entities/Package.cs`](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Package.cs) (Package model), [`Infrastructure/Data/ApplicationDbContext.cs`](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Infrastructure/Data/ApplicationDbContext.cs) (Application database), [`Core.Domain/Enumerations`](https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.Domain/Enumerations) (Domain enumerations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_mvc_package["Package workflows"]
  node_mvc_account["Account management"]
  node_web_host["MVC host<br/>[Program.cs]"]
end

subgraph group_api["API"]
  node_api_package["REST packages"]
  node_api_account["API accounts"]
  node_graphql["GraphQL query"]
  node_api_host["API host<br/>[Program.cs]"]
end

subgraph group_domain["Domain and services"]
  node_package_service["Package rules<br/>[PackageService.cs]"]
  node_other_services["Other domain services<br/>[Services]"]
  node_service_contracts["Service contracts<br/>[IServices]"]
  node_repository_contracts["Repository contracts<br/>[IRepositories]"]
  node_package_model["Package model<br/>[Package.cs]"]
  node_student_model["Student model<br/>[Student.cs]"]
  node_employee_model["Employee model<br/>[Employee.cs]"]
  node_canteen_model["Canteen model<br/>[Canteen.cs]"]
  node_product_model["Product model<br/>[Product.cs]"]
  node_enum_models["Domain enumerations<br/>[Enumerations]"]
end

subgraph group_data["Persistence"]
  node_repositories["Entity repositories"]
  node_application_db[("Application database")]
  node_security_db[("Security database")]
end

node_student(("Student"))
node_employee(("Employee"))

node_student -.->|"uses"| node_mvc_package
node_employee -.->|"uses"| node_mvc_package
node_mvc_package -->|"calls"| node_package_service
node_mvc_account -->|"calls"| node_other_services
node_api_package -->|"calls"| node_package_service
node_graphql -->|"queries"| node_package_service
node_package_service -->|"uses package contract"| node_repository_contracts
node_package_service -->|"uses student contract"| node_service_contracts
node_other_services -.->|"uses"| node_repository_contracts
node_repositories -->|"queries and updates"| node_application_db
node_package_service -->|"updates package"| node_package_model
node_package_service -->|"checks reservation"| node_student_model
node_package_model -->|"reservation reference"| node_student_model
node_package_model -->|"contains products"| node_product_model
node_package_model -->|"canteen field"| node_canteen_model
node_package_model -->|"uses package and canteen types"| node_enum_models
node_student_model -->|"uses city type"| node_enum_models
node_employee_model -->|"uses canteen type"| node_enum_models
node_canteen_model -->|"uses city and location types"| node_enum_models
node_application_db -->|"stores entities"| node_package_model
node_web_host -->|"registers"| node_repositories
node_api_host -->|"registers"| node_repositories
node_web_host -->|"configures"| node_application_db
node_api_host -->|"configures"| node_application_db
node_web_host -->|"configures"| node_security_db
node_api_host -->|"configures"| node_security_db

click node_mvc_package "https://github.com/kelvinlai2912/toogoodtogo/blob/main/TooGoodToGo/Controllers/PackageController.cs"
click node_mvc_account "https://github.com/kelvinlai2912/toogoodtogo/blob/main/TooGoodToGo/Controllers/AccountController.cs"
click node_web_host "https://github.com/kelvinlai2912/toogoodtogo/blob/main/TooGoodToGo/Program.cs"
click node_api_package "https://github.com/kelvinlai2912/toogoodtogo/blob/main/WebAPI/Controllers/PackageController.cs"
click node_api_account "https://github.com/kelvinlai2912/toogoodtogo/blob/main/WebAPI/Controllers/AccountController.cs"
click node_graphql "https://github.com/kelvinlai2912/toogoodtogo/blob/main/WebAPI/GraphQL/GetPackagesQuery.cs"
click node_api_host "https://github.com/kelvinlai2912/toogoodtogo/blob/main/WebAPI/Program.cs"
click node_package_service "https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.DomainServices/Services/PackageService.cs"
click node_other_services "https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.DomainServices/Services"
click node_service_contracts "https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.DomainServices/IServices"
click node_repository_contracts "https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.DomainServices/IRepositories"
click node_package_model "https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Package.cs"
click node_student_model "https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Student.cs"
click node_employee_model "https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Employee.cs"
click node_canteen_model "https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Canteen.cs"
click node_product_model "https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Product.cs"
click node_enum_models "https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.Domain/Enumerations"
click node_repositories "https://github.com/kelvinlai2912/toogoodtogo/tree/main/Infrastructure/Repositories"
click node_application_db "https://github.com/kelvinlai2912/toogoodtogo/blob/main/Infrastructure/Data/ApplicationDbContext.cs"
click node_security_db "https://github.com/kelvinlai2912/toogoodtogo/blob/main/Infrastructure/Data/SecurityDbContext.cs"

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_mvc_package,node_mvc_account,node_web_host toneBlue
class node_api_package,node_api_account,node_graphql,node_api_host toneAmber
class node_package_service,node_other_services,node_service_contracts,node_repository_contracts,node_package_model,node_student_model,node_employee_model,node_canteen_model,node_product_model,node_enum_models toneMint
class node_repositories,node_application_db,node_security_db toneRose
class node_student,node_employee toneIndigo
```

## Components

### Web application

- [Package workflows](https://github.com/kelvinlai2912/toogoodtogo/blob/main/TooGoodToGo/Controllers/PackageController.cs): `TooGoodToGo/Controllers/PackageController.cs`
- [Account management](https://github.com/kelvinlai2912/toogoodtogo/blob/main/TooGoodToGo/Controllers/AccountController.cs): `TooGoodToGo/Controllers/AccountController.cs`
- [MVC host](https://github.com/kelvinlai2912/toogoodtogo/blob/main/TooGoodToGo/Program.cs): `TooGoodToGo/Program.cs`

### API

- [REST packages](https://github.com/kelvinlai2912/toogoodtogo/blob/main/WebAPI/Controllers/PackageController.cs): `WebAPI/Controllers/PackageController.cs`
- [API accounts](https://github.com/kelvinlai2912/toogoodtogo/blob/main/WebAPI/Controllers/AccountController.cs): `WebAPI/Controllers/AccountController.cs`
- [GraphQL query](https://github.com/kelvinlai2912/toogoodtogo/blob/main/WebAPI/GraphQL/GetPackagesQuery.cs): `WebAPI/GraphQL/GetPackagesQuery.cs`
- [API host](https://github.com/kelvinlai2912/toogoodtogo/blob/main/WebAPI/Program.cs): `WebAPI/Program.cs`

### Domain and services

- [Package rules](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.DomainServices/Services/PackageService.cs): `Core.DomainServices/Services/PackageService.cs`
- [Other domain services](https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.DomainServices/Services): `Core.DomainServices/Services`
- [Service contracts](https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.DomainServices/IServices): `Core.DomainServices/IServices`
- [Repository contracts](https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.DomainServices/IRepositories): `Core.DomainServices/IRepositories`
- [Package model](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Package.cs): `Core.Domain/Entities/Package.cs`
- [Student model](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Student.cs): `Core.Domain/Entities/Student.cs`
- [Employee model](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Employee.cs): `Core.Domain/Entities/Employee.cs`
- [Canteen model](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Canteen.cs): `Core.Domain/Entities/Canteen.cs`
- [Product model](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Core.Domain/Entities/Product.cs): `Core.Domain/Entities/Product.cs`
- [Domain enumerations](https://github.com/kelvinlai2912/toogoodtogo/tree/main/Core.Domain/Enumerations): `Core.Domain/Enumerations`

### Persistence

- [Entity repositories](https://github.com/kelvinlai2912/toogoodtogo/tree/main/Infrastructure/Repositories): `Infrastructure/Repositories`
- [Application database](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Infrastructure/Data/ApplicationDbContext.cs): `Infrastructure/Data/ApplicationDbContext.cs`
- [Security database](https://github.com/kelvinlai2912/toogoodtogo/blob/main/Infrastructure/Data/SecurityDbContext.cs): `Infrastructure/Data/SecurityDbContext.cs`

### Other components

- **Student**
- **Employee**

## Connections

- Student → Package workflows: uses
- Employee → Package workflows: uses
- Package workflows → Package rules: calls (evidence: `TooGoodToGo/Controllers/PackageController.cs`)
- Account management → Other domain services: calls (evidence: `TooGoodToGo/Controllers/AccountController.cs`)
- REST packages → Package rules: calls (evidence: `WebAPI/Controllers/PackageController.cs`)
- GraphQL query → Package rules: queries (evidence: `WebAPI/GraphQL/GetPackagesQuery.cs`)
- Package rules → Repository contracts: uses package contract (evidence: `Core.DomainServices/Services/PackageService.cs`)
- Package rules → Service contracts: uses student contract (evidence: `Core.DomainServices/Services/PackageService.cs`)
- Other domain services → Repository contracts: uses (evidence: `Core.DomainServices/Services/PackageService.cs`)
- Entity repositories → Application database: queries and updates (evidence: `Infrastructure/Repositories/PackageRepository.cs`)
- Package rules → Package model: updates package (evidence: `Core.DomainServices/Services/PackageService.cs`)
- Package rules → Student model: checks reservation (evidence: `Core.DomainServices/Services/PackageService.cs`)
- Package model → Student model: reservation reference (evidence: `Core.Domain/Entities/Package.cs`)
- Package model → Product model: contains products (evidence: `Core.Domain/Entities/Package.cs`)
- Package model → Canteen model: canteen field (evidence: `Core.Domain/Entities/Package.cs`)
- Package model → Domain enumerations: uses package and canteen types (evidence: `Core.Domain/Entities/Package.cs`)
- Student model → Domain enumerations: uses city type (evidence: `Core.Domain/Entities/Student.cs`)
- Employee model → Domain enumerations: uses canteen type (evidence: `Core.Domain/Entities/Employee.cs`)
- Canteen model → Domain enumerations: uses city and location types (evidence: `Core.Domain/Entities/Canteen.cs`)
- Application database → Package model: stores entities (evidence: `Infrastructure/Data/ApplicationDbContext.cs`)
- MVC host → Entity repositories: registers (evidence: `TooGoodToGo/Program.cs`)
- API host → Entity repositories: registers (evidence: `WebAPI/Program.cs`)
- MVC host → Application database: configures (evidence: `TooGoodToGo/Program.cs`)
- API host → Application database: configures (evidence: `WebAPI/Program.cs`)
- MVC host → Security database: configures (evidence: `TooGoodToGo/Program.cs`)
- API host → Security database: configures (evidence: `WebAPI/Program.cs`)
