# l1nehalt/meely-deely architecture

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

- Interactive diagram: https://gitdiagram.com/l1nehalt/meely-deely
- Repository: https://github.com/l1nehalt/meely-deely

## Overview

MeelyDeely is a food and grocery delivery application with a Vue frontend and an ASP.NET Core API. Its central customer workflow is browsing a restaurant or grocery catalog, managing a cart, and placing and tracking an order; the backend calculates order totals and persists orders. The product also includes authentication, addresses, promotions and markdowns, courier order handling, support, and administration. The source index supports several backend call relationships; where frontend-to-API routing or unsampled controller wiring is not shown, connections are omitted or marked unverified.

Main entry points: [`frontend/src/services`](https://github.com/l1nehalt/meely-deely/tree/main/frontend/src/services) (Frontend API services), [`backend/MeelyDeely.Application/Services/UserService.cs`](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Application/Services/UserService.cs) (User service), [`backend/MeelyDeely.Application/Services/OrderService.cs`](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Application/Services/OrderService.cs) (Order service), [`frontend/src/App.vue`](https://github.com/l1nehalt/meely-deely/blob/main/frontend/src/App.vue) (Vue application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Customer and staff web app"]
  node_webapp["Vue application<br/>[App.vue]"]
  node_webviews["Catalog and checkout views"]
  node_webservices["Frontend API services"]
end

subgraph group_api["HTTP API"]
  node_authapi["Authentication API<br/>[AuthController.cs]"]
  node_catalogapi["Catalog APIs<br/>[Controllers]"]
  node_ordersapi["Orders API"]
  node_otherapi["Other product APIs<br/>[Controllers]"]
end

subgraph group_application["Application services"]
  node_userservice["User service<br/>[UserService.cs]"]
  node_cartservice["Cart service<br/>[CartService.cs]"]
  node_orderservice["Order service<br/>[OrderService.cs]"]
  node_otherservices["Other application services<br/>[Services]"]
end

subgraph group_domain["Domain model"]
  node_domainentities["Commerce and user entities<br/>[Entities]"]
  node_repositorycontracts["Repository contracts<br/>[Abstractions]"]
  node_unitofwork["Unit of work<br/>[IUnitOfWork.cs]"]
end

subgraph group_persistence["Persistence and integrations"]
  node_database[("Application database")]
  node_orderrepo["Order repository<br/>[OrderRepository.cs]"]
  node_addresslookup["DaData address lookup"]
end

node_customer(("Customer"))
node_addressprovider{{"DaData"}}

node_customer -.->|"uses"| node_webapp
node_webapp -.->|"presents"| node_webviews
node_webviews -.->|"requests data"| node_webservices
node_webservices -.->|"calls HTTP API"| node_ordersapi
node_webservices -.->|"calls HTTP API"| node_authapi
node_authapi -->|"delegates to"| node_userservice
node_catalogapi -.->|"delegates to"| node_otherservices
node_ordersapi -->|"delegates to"| node_orderservice
node_otherapi -.->|"delegates to"| node_otherservices
node_userservice -->|"uses"| node_repositorycontracts
node_userservice -->|"uses"| node_domainentities
node_cartservice -->|"uses"| node_unitofwork
node_orderservice -->|"uses"| node_unitofwork
node_orderservice -->|"creates and reads"| node_domainentities
node_orderrepo -->|"queries"| node_database
node_addresslookup -.->|"looks up addresses"| node_addressprovider

click node_webapp "https://github.com/l1nehalt/meely-deely/blob/main/frontend/src/App.vue"
click node_webviews "https://github.com/l1nehalt/meely-deely/tree/main/frontend/src/views"
click node_webservices "https://github.com/l1nehalt/meely-deely/tree/main/frontend/src/services"
click node_authapi "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.API/Controllers/AuthController.cs"
click node_catalogapi "https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.API/Controllers"
click node_ordersapi "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.API/Controllers/OrdersController.cs"
click node_otherapi "https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.API/Controllers"
click node_userservice "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Application/Services/UserService.cs"
click node_cartservice "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Application/Services/CartService.cs"
click node_orderservice "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Application/Services/OrderService.cs"
click node_otherservices "https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.Application/Services"
click node_domainentities "https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.Domain/Entities"
click node_repositorycontracts "https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.Domain/Abstractions"
click node_unitofwork "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Domain/Abstractions/IUnitOfWork.cs"
click node_database "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Infrastructure/Data/MeelyDeelyDbContext.cs"
click node_orderrepo "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Infrastructure/Repositories/OrderRepository.cs"
click node_addresslookup "https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Infrastructure/Services/DadataAddressService.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_webapp,node_webviews,node_webservices toneBlue
class node_authapi,node_catalogapi,node_ordersapi,node_otherapi toneAmber
class node_userservice,node_cartservice,node_orderservice,node_otherservices toneMint
class node_domainentities,node_repositorycontracts,node_unitofwork toneRose
class node_database,node_orderrepo,node_addresslookup,node_customer,node_addressprovider toneIndigo
```

## Components

### Customer and staff web app

- [Vue application](https://github.com/l1nehalt/meely-deely/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Catalog and checkout views](https://github.com/l1nehalt/meely-deely/tree/main/frontend/src/views): `frontend/src/views`
- [Frontend API services](https://github.com/l1nehalt/meely-deely/tree/main/frontend/src/services): `frontend/src/services`

### HTTP API

- [Authentication API](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.API/Controllers/AuthController.cs): `backend/MeelyDeely.API/Controllers/AuthController.cs`
- [Catalog APIs](https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.API/Controllers): `backend/MeelyDeely.API/Controllers`
- [Orders API](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.API/Controllers/OrdersController.cs): `backend/MeelyDeely.API/Controllers/OrdersController.cs`
- [Other product APIs](https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.API/Controllers): `backend/MeelyDeely.API/Controllers`

### Application services

- [User service](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Application/Services/UserService.cs): `backend/MeelyDeely.Application/Services/UserService.cs`
- [Cart service](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Application/Services/CartService.cs): `backend/MeelyDeely.Application/Services/CartService.cs`
- [Order service](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Application/Services/OrderService.cs): `backend/MeelyDeely.Application/Services/OrderService.cs`
- [Other application services](https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.Application/Services): `backend/MeelyDeely.Application/Services`

### Domain model

- [Commerce and user entities](https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.Domain/Entities): `backend/MeelyDeely.Domain/Entities`
- [Repository contracts](https://github.com/l1nehalt/meely-deely/tree/main/backend/MeelyDeely.Domain/Abstractions): `backend/MeelyDeely.Domain/Abstractions`
- [Unit of work](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Domain/Abstractions/IUnitOfWork.cs): `backend/MeelyDeely.Domain/Abstractions/IUnitOfWork.cs`

### Persistence and integrations

- [Application database](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Infrastructure/Data/MeelyDeelyDbContext.cs): `backend/MeelyDeely.Infrastructure/Data/MeelyDeelyDbContext.cs`
- [Order repository](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Infrastructure/Repositories/OrderRepository.cs): `backend/MeelyDeely.Infrastructure/Repositories/OrderRepository.cs`
- [DaData address lookup](https://github.com/l1nehalt/meely-deely/blob/main/backend/MeelyDeely.Infrastructure/Services/DadataAddressService.cs): `backend/MeelyDeely.Infrastructure/Services/DadataAddressService.cs`

### Other components

- **Customer**
- **DaData**

## Connections

- Customer → Vue application: uses
- Vue application → Catalog and checkout views: presents
- Catalog and checkout views → Frontend API services: requests data
- Frontend API services → Orders API: calls HTTP API
- Frontend API services → Authentication API: calls HTTP API
- Authentication API → User service: delegates to (evidence: `backend/MeelyDeely.API/Controllers/AuthController.cs`)
- Catalog APIs → Other application services: delegates to
- Orders API → Order service: delegates to (evidence: `backend/MeelyDeely.API/Controllers/OrdersController.cs`)
- Other product APIs → Other application services: delegates to
- User service → Repository contracts: uses (evidence: `backend/MeelyDeely.Application/Services/UserService.cs`)
- User service → Commerce and user entities: uses (evidence: `backend/MeelyDeely.Application/Services/UserService.cs`)
- Cart service → Unit of work: uses (evidence: `backend/MeelyDeely.Application/Services/CartService.cs`)
- Order service → Unit of work: uses (evidence: `backend/MeelyDeely.Application/Services/OrderService.cs`)
- Order service → Commerce and user entities: creates and reads (evidence: `backend/MeelyDeely.Application/Services/OrderService.cs`)
- Order repository → Application database: queries (evidence: `backend/MeelyDeely.Infrastructure/Repositories/OrderRepository.cs`)
- DaData address lookup → DaData: looks up addresses
