# zuyd-hogeschool/vlammend-varken-app architecture

> Architecture diagram of the GitHub repository zuyd-hogeschool/vlammend-varken-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zuyd-hogeschool/vlammend-varken-app
- Repository: https://github.com/zuyd-hogeschool/vlammend-varken-app

## Overview

##### Project Type and Purpose
- This is a full-stack ASP.NET Core solution for “Het Vlammend Varken,” a sustainable barbecue restaurant web app.
- It consists of:
- A Razor-Pages-based frontend (Vlammend_Varken project) for guest, waiter, and chef roles
- A C# Web API (Vlammend_Varken.API project) exposing REST endpoints
- A Core library (Vlammend_Varken.Core) containing domain models, EF Core DbContext, migrations, and business/data logic
- A MySQL database for persistent storage

##### File Structure Analysis
- Top-level solution (Vlammend_Varken.sln) references three projects:
- Vlammend_Varken (Razor Pages UI + Identity)
- Vlammend_Varken.API (Controllers for menu, orders, weather forecasts)
- Vlammend_Varken.Core (Models, Data/AppDbConnection, EF Core migrations)
- Config files (.json) handle environment settings, connection strings, Identity setup.
- wwwroot holds Bootstrap and jQuery for styling/validation.

##### README Insights
- Confirms roles (guest, ober, kok) and features: reservations, orders, payments, dynamic menus, stock overview.
- Tech stack: C#/.NET, MySQL, Razor UI, Bootstrap, jQuery, ASP.NET Identity.

##### Main Components & Interactions
a. Components:
1. Client Browser (Guest/Ober/Kok)
2. Razor Pages UI (Vlammend_Varken)
3. Web API (Vlammend_Varken.API)
4. Core Library (Vlammend_Varken.Core)
– AppDbConnection (EF Core DbContext)
– Domain Models & Migrations
5. MySQL Database
6. External Identity Service (ASP.NET Identity)
b. Relationships:
– Browser ↔ Razor UI via HTTPS
– Razor UI ↔ Web API (for AJAX or server-side calls to REST endpoints)
– Web API & Razor UI both reference Core library
– Core library → MySQL (via EF Core)
– Razor UI ↔ Identity (login/logout user management)
c. Architectural Patterns:
– Layered architecture: Presentation → API → Domain/Data → Database
– Separation of concerns: UI (Razor + Identity) vs. API vs. Business logic (Core)
– EF Core Code-First migrations for schema management
d. Key Technologies:
– ASP.NET Core Razor Pages
– ASP.NET Core Web API
– EF Core (AppDbConnection, migrations)
– MySQL
– ASP.NET Identity
– Bootstrap & jQuery

##### Detailing Essentials
- Flow for a typical use-case:
1. Guest logs in (Browser → Identity → Razor UI)
2. Browser requests menu (Razor UI → API → Core → DB → Core → API → Razor UI → Browser)
3. Guest places an order (Browser → Razor UI → API → Core → DB)
- Migration process (Core → Migrations → MySQL) to ensure DB schema versioning.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Browser["Client Browser\n(Guest/Ober/Kok)"]:::frontend
        UI["Vlammend_Varken\n(Razor Pages + Identity)"]:::frontend
        Identity["ASP.NET Identity Service"]:::infra
        UI -->|"Authenticate user"| Identity
        Browser -->|"HTTPS"| UI
    end

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        API["Vlammend_Varken.API\n(REST Controllers)"]:::backend
        API -->|"calls Core methods"| CoreLib
        UI -->|"REST calls\nFetch menu, Submit order"| API
    end

    %% Core Layer
    subgraph "Core Layer"
        direction TB
        CoreLib["Vlammend_Varken.Core\n(Models, DbContext, Migrations)"]:::core
        DbContext["AppDbConnection\n(EF Core DbContext)"]:::core
        Models["Domain Models"]:::core
        Migrations["EF Core Migrations"]:::core
        CoreLib --> DbContext
        CoreLib --> Models
        CoreLib --> Migrations
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        MySQL["MySQL Database"]:::infra
        CoreLib -->|"SQL Queries via EF Core"| MySQL
        Migrations -->|"Run migrations"| MySQL
    end

    %% Click Events for Frontend
    click UI "https://github.com/zuyd-hogeschool/vlammend-varken-app/tree/main/Vlammend_Varken/"
    click UI "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken/Program.cs"
    click UI "https://github.com/zuyd-hogeschool/vlammend-varken-app/tree/main/Vlammend_Varken/Pages/"
    click UI "https://github.com/zuyd-hogeschool/vlammend-varken-app/tree/main/Vlammend_Varken/Areas/Identity/Pages/"
    click UI "https://github.com/zuyd-hogeschool/vlammend-varken-app/tree/main/Vlammend_Varken/wwwroot/"
    click UI "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken/appsettings.json"
    click UI "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken/appsettings.Development.json"

    %% Click Events for API
    click API "https://github.com/zuyd-hogeschool/vlammend-varken-app/tree/main/Vlammend_Varken.API/"
    click API "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.API/Program.cs"
    click API "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.API/Controllers/MenuCategoryController.cs"
    click API "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.API/Controllers/MenuItemController.cs"
    click API "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.API/Controllers/WeatherForecastController.cs"
    click API "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.API/appsettings.json"
    click API "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.API/appsettings.Development.json"

    %% Click Events for Core
    click CoreLib "https://github.com/zuyd-hogeschool/vlammend-varken-app/tree/main/Vlammend_Varken.Core/"
    click CoreLib "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.Core/Vlammend_Varken.Core.csproj"
    click DbContext "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.Core/Data/AppDbConnection.cs"
    click Models "https://github.com/zuyd-hogeschool/vlammend-varken-app/tree/main/Vlammend_Varken.Core/Models/"
    click Migrations "https://github.com/zuyd-hogeschool/vlammend-varken-app/tree/main/Vlammend_Varken.Core/Migrations/"

    %% Click Event for Solution
    click Solution "https://github.com/zuyd-hogeschool/vlammend-varken-app/blob/main/Vlammend_Varken.sln"

    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085;
    classDef backend fill:#d4edda,stroke:#155724,color:#155724;
    classDef core fill:#fff3cd,stroke:#856404,color:#856404;
    classDef infra fill:#e2e3e5,stroke:#6c757d,color:#6c757d;
```
