# szemerics/ticket-manager architecture

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

- Interactive diagram: https://gitdiagram.com/szemerics/ticket-manager
- Repository: https://github.com/szemerics/ticket-manager

## Overview

##### Project type and purpose
- This is a full-stack web application (“Ticket Manager”) built for the University of Pannonia.
- Purpose: allow users to browse movies, book tickets, manage orders, seats, screenings, settings, and user roles.

##### File structure
Top-level modules:
- TicketManager.Frontend – a React/TypeScript SPA (Vite) that provides the UI.
- TicketManager – a .NET Web API project hosting REST endpoints (Controllers + Program.cs + appsettings).
- TicketManager.Services – a .NET class-library layer encapsulating business logic (MovieService, OrderService, UserService, etc.).
- TicketManager.DataContext – a .NET class-library providing Entity Framework Core context, entities, DTOs, migrations, and initdb.sql.

Architectural pattern: layered (Presentation → API → Business → Data → Database).

##### Key insights from README
- C#-based Ticket Manager.
- initdb.sql seeds base settings and users (password: almafa123).
- No third-party external dependencies beyond React, EF Core, AutoMapper, Axios, etc.

a. Components
1. Frontend (React SPA)
2. API Gateway / .NET Web API (Controllers)
3. Services Layer (TicketManager.Services)
4. Data Access Layer (TicketManager.DataContext – DbContext + Entities + Migrations)
5. Database (SQL Server / PostgreSQL etc. created by initdb.sql)
6. External/Internal shared elements: AutoMapper, configuration (appsettings.json), Authentication (JWT session).

b. Relationships & data-flow
1. User/browser ↔ Frontend UI (HTTP/HTTPS calls)
2. Frontend ↔ .NET Web API (axios configured with base URL → Controllers)
3. Controllers → Services Layer (inject IXYZService)
4. Services → DataContext (DbContext queries, CRUD operations)
5. DataContext ↔ Database
6. Database migrations and seed scripts run at startup or CI/CD.

c. Architectural patterns & principles
- Layered Architecture: clear separation of concerns (UI, API, business, data).
- Dependency Injection: Controllers depend on service abstractions; services depend on DbContext and AutoMapper.
- DTO Pattern: data transfer objects decouple entities from external contracts.
- Migrations: EF Core code-first migrations version control the schema.
- Configuration management: appsettings.json for environment-specific settings.

d. Technologies & frameworks
- Frontend: React, TypeScript, Vite, Axios
- API: .NET 7+ Web API, C# 10
- Business: .NET class library, AutoMapper
- Data: EF Core, SQL (initdb.sql)
- Auth: likely JWT or cookie based (AuthContext.tsx on frontend)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "Browser / UI"
        direction TB
        App["App.tsx"]:::ui
        Main["main.tsx"]:::ui
        MoviesPage["Movies.tsx"]:::ui
        MovieFormPage["MovieForm.tsx"]:::ui
        DashboardPage["Dashboard.tsx"]:::ui
        LoginPage["Login.tsx"]:::ui
        ForgotPasswordPage["ForgotPassword.tsx"]:::ui
        AuthContainer["AuthContainer.tsx"]:::ui
        LayoutComp["Layout/"]:::ui
        UserMenu["UserMenuDropdown.tsx"]:::ui
        AuthCtx["AuthContext.tsx"]:::ui
        APIClient["api.ts"]:::ui
        AxiosCfg["axios.config.ts"]:::ui
    end

    %% API Layer
    subgraph "API / Controllers"
        direction TB
        UserCtrl["UserController.cs"]:::api
        MovieCtrl["MovieController.cs"]:::api
        OrderCtrl["OrderController.cs"]:::api
        ScreeningCtrl["ScreeningController.cs"]:::api
        RoomCtrl["RoomController.cs"]:::api
        TicketCtrl["TicketController.cs"]:::api
        AdminCtrl["AdminController.cs"]:::api
        ProgramCS["Program.cs"]:::api
        AppSettings["appsettings.json"]:::api
        LaunchSettings["launchSettings.json"]:::api
        HTTPReq["TicketManager.http"]:::api
    end

    %% Business Layer
    subgraph "Business / Services"
        direction TB
        MovieSvc["MovieService.cs"]:::service
        OrderSvc["OrderService.cs"]:::service
        UserSvc["UserService.cs"]:::service
        RoomSvc["RoomService.cs"]:::service
        ScreeningSvc["ScreeningService.cs"]:::service
        TicketSvc["TicketService.cs"]:::service
        AdminSvc["AdminService.cs"]:::service
        AutoMap["AutoMapperProfile.cs"]:::service
    end

    %% Data Layer
    subgraph "Data / DataContext"
        direction TB
        DbContext["TicketDbContext.cs"]:::data
        EntitiesDir["Entities/"]:::data
        DtosDir["Dtos/"]:::data
        MigrationsDir["Migrations/"]:::data
        InitScript["initdb.sql"]:::data
    end

    %% Database
    Database["Relational Database"]:::db

    %% Connections
    App -->|bootstrap| Main
    Main -->|renders pages| MoviesPage & MovieFormPage & DashboardPage & LoginPage & ForgotPasswordPage
    MoviesPage -->|"GET /api/movies"| APIClient
    MovieFormPage -->|"POST /api/movies"| APIClient
    DashboardPage -->|"GET /api/dashboard"| APIClient
    LoginPage -->|"POST /api/users/login"| APIClient
    ForgotPasswordPage -->|"POST /api/users/forgot-password"| APIClient
    AuthContainer -->|provides auth| AuthCtx
    APIClient -->|uses baseURL| AxiosCfg

    %% UI to API
    APIClient -->|HTTP calls| UserCtrl & MovieCtrl & OrderCtrl & ScreeningCtrl & RoomCtrl & TicketCtrl & AdminCtrl

    %% API to Services
    UserCtrl -->|IUserService| UserSvc
    MovieCtrl -->|IMovieService| MovieSvc
    OrderCtrl -->|IOrderService| OrderSvc
    ScreeningCtrl -->|IScreeningService| ScreeningSvc
    RoomCtrl -->|IRoomService| RoomSvc
    TicketCtrl -->|ITicketService| TicketSvc
    AdminCtrl -->|IAdminService| AdminSvc

    %% Services to Data
    UserSvc & MovieSvc & OrderSvc & ScreeningSvc & RoomSvc & TicketSvc & AdminSvc -->|DbContext| DbContext
    UserSvc & MovieSvc & OrderSvc & ScreeningSvc & RoomSvc & TicketSvc & AdminSvc -->|mapping| AutoMap

    %% Data to Database
    DbContext -->|EF Core CRUD| EntitiesDir & DtosDir & MigrationsDir
    MigrationsDir -->|migrations| InitScript
    InitScript -->|seed data| Database
    EntitiesDir -->|model| Database
    DtosDir -->|DTOs| Services

    %% Configuration and Launch
    ProgramCS -->|DI setup| UserCtrl & MovieCtrl & OrderCtrl & ScreeningCtrl & RoomCtrl & TicketCtrl & AdminCtrl & DbContext
    ProgramCS -->|load| AppSettings & LaunchSettings & HTTPReq

    %% Click Events UI
    click App "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/App.tsx"
    click Main "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/main.tsx"
    click MoviesPage "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/pages/Movies.tsx"
    click MovieFormPage "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/pages/MovieForm.tsx"
    click DashboardPage "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/pages/Dashboard.tsx"
    click LoginPage "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/pages/Login.tsx"
    click ForgotPasswordPage "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/pages/ForgotPassword.tsx"
    click AuthContainer "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/components/AuthContainer.tsx"
    click LayoutComp "https://github.com/szemerics/ticket-manager/tree/main/TicketManager.Frontend/src/components/Layout"
    click UserMenu "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/components/UserMenuDropdown.tsx"
    click AuthCtx "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/context/AuthContext.tsx"
    click APIClient "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/api/api.ts"
    click AxiosCfg "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Frontend/src/api/axios.config.ts"
    click ProgramCS "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Program.cs"
    click AppSettings "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/appsettings.json"
    click LaunchSettings "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Properties/launchSettings.json"
    click HTTPReq "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/TicketManager.http"
    click UserCtrl "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Controller/UserController.cs"
    click MovieCtrl "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Controller/MovieController.cs"
    click OrderCtrl "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Controller/OrderController.cs"
    click ScreeningCtrl "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Controller/ScreeningController.cs"
    click RoomCtrl "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Controller/RoomController.cs"
    click TicketCtrl "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Controller/TicketController.cs"
    click AdminCtrl "https://github.com/szemerics/ticket-manager/blob/main/TicketManager/Controller/AdminController.cs"
    click MovieSvc "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Services/MovieService.cs"
    click OrderSvc "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Services/OrderService.cs"
    click UserSvc "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Services/UserService.cs"
    click RoomSvc "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Services/RoomService.cs"
    click ScreeningSvc "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Services/ScreeningService.cs"
    click TicketSvc "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Services/TicketService.cs"
    click AdminSvc "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Services/AdminService.cs"
    click AutoMap "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.Services/AutoMapperProfile.cs"
    click DbContext "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.DataContext/Context/TicketDbContext.cs"
    click EntitiesDir "https://github.com/szemerics/ticket-manager/tree/main/TicketManager.DataContext/Entities"
    click DtosDir "https://github.com/szemerics/ticket-manager/tree/main/TicketManager.DataContext/Dtos"
    click MigrationsDir "https://github.com/szemerics/ticket-manager/tree/main/TicketManager.DataContext/Migrations"
    click InitScript "https://github.com/szemerics/ticket-manager/blob/main/TicketManager.DataContext/Scripts/initdb.sql"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366D6,stroke-width:1px;
    classDef api fill:#D6F5D6,stroke:#28A745,stroke-width:1px;
    classDef service fill:#FFE8A1,stroke:#D27D00,stroke-width:1px;
    classDef data fill:#FFF5BA,stroke:#E5C100,stroke-width:1px;
    classDef db fill:#E0E0E0,stroke:#6A737D,stroke-width:1px;
```
