# it-core2025/education-huc-api architecture

> Architecture diagram of the GitHub repository it-core2025/education-huc-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/it-core2025/education-huc-api
- Repository: https://github.com/it-core2025/education-huc-api

## Overview

This is a bilingual education-centre website and administration system: visitors browse courses and submit registrations, while staff manage content, enrolments, tracking, finance, and users. The React app routes public and protected dashboard pages and calls the ASP.NET API; the API persists domain records through EF Core, with uploads and Identity authentication. The README documents further content and admin capabilities not all sampled in source. Edges use README statements or shown references; unsampled implementation details are represented by directory-level nodes where appropriate.

Main entry points: [`learnigCon-Front/src/utils/api.js`](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/utils/api.js) (API client), [`learnigCon-Front/src/App.jsx`](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/App.jsx) (Route application), [`backend/Data/ApplicationDbContext.cs`](https://github.com/it-core2025/education-huc-api/blob/main/backend/Data/ApplicationDbContext.cs) (EF data context), [`backend/API/RegistrationsApiController.cs`](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/RegistrationsApiController.cs) (Registration API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public Website"]
  node_app["Route application<br/>[App.jsx]"]
  node_catalog["Course browsing<br/>[CoursesPage.jsx]"]
  node_enroll["Course registration"]
  node_trackingui["Course tracking<br/>[MyCourses.jsx]"]
  node_newsui["News browsing<br/>[NewsPage.jsx]"]
  node_publiccontent["Public content pages"]
  node_apiutil["API client<br/>[api.js]"]
end

subgraph group_admin["Administration"]
  node_dashroute["Protected dashboards<br/>[App.jsx]"]
  node_regdash["Registration management"]
  node_coursedash["Course management"]
  node_financedash["Finance dashboards"]
  node_contentdash["Content administration"]
  node_userdash["Users and roles<br/>[UsersPage.jsx]"]
  node_auditdash["Audit log viewer"]
end

subgraph group_api["Backend API"]
  node_authapi["Authentication API<br/>[AuthController.cs]"]
  node_registrationapi["Registration API"]
  node_trackingapi["Tracking API"]
  node_courseapi["Course API"]
  node_newsapi["News API<br/>[NewsController.cs]"]
  node_contentapi["Content APIs"]
  node_discountapi["Discount API"]
  node_moneyapi["Finance API"]
  node_staffapi["Staff API<br/>[StaffApi.cs]"]
  node_usersapi["User administration API<br/>[UsersController.cs]"]
  node_auditmw["Write audit middleware"]
end

subgraph group_data["Persistence and Identity"]
  node_dbcontext["EF data context"]
  node_sql[("SQL Server database")]
  node_domain["Domain entities"]
  node_identity["ASP.NET Identity"]
  node_uploads[("Uploaded files")]
end

node_visitor(("Visitor"))
node_staff(("Staff user"))

node_visitor -->|"browses"| node_app
node_staff -->|"uses dashboards"| node_app
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_enroll
node_app -->|"routes to"| node_trackingui
node_app -->|"routes to"| node_newsui
node_app -->|"routes to"| node_publiccontent
node_app -->|"routes to"| node_dashroute
node_dashroute -->|"renders"| node_regdash
node_dashroute -->|"renders"| node_coursedash
node_dashroute -->|"renders"| node_financedash
node_dashroute -->|"routes to"| node_contentdash
node_dashroute -->|"routes to"| node_userdash
node_dashroute -->|"routes to"| node_auditdash
node_enroll -->|"calls API"| node_apiutil
node_regdash -->|"calls API"| node_apiutil
node_catalog -.->|"calls API"| node_apiutil
node_trackingui -.->|"calls API"| node_apiutil
node_apiutil -->|"HTTP requests"| node_registrationapi
node_apiutil -->|"HTTP requests"| node_trackingapi
node_apiutil -->|"HTTP requests"| node_courseapi
node_apiutil -->|"HTTP requests"| node_newsapi
node_apiutil -->|"HTTP requests"| node_contentapi
node_apiutil -->|"HTTP requests"| node_discountapi
node_apiutil -->|"HTTP requests"| node_moneyapi
node_apiutil -->|"HTTP requests"| node_staffapi
node_apiutil -->|"HTTP requests"| node_usersapi
node_apiutil -->|"HTTP requests"| node_authapi
node_registrationapi -->|"queries and saves"| node_dbcontext
node_trackingapi -->|"queries and saves"| node_dbcontext
node_discountapi -->|"queries and saves"| node_dbcontext
node_moneyapi -->|"queries and saves"| node_dbcontext
node_staffapi -->|"queries and saves"| node_dbcontext
node_usersapi -->|"uses identity"| node_authapi
node_dbcontext -->|"maps entities"| node_domain
node_dbcontext -->|"persists"| node_sql
node_authapi -->|"authenticates"| node_identity
node_registrationapi -->|"stores files"| node_uploads
node_auditmw -->|"writes audit entries"| node_dbcontext
node_auditmw -->|"observes API writes"| node_registrationapi
node_auditmw -->|"records audit log"| node_domain
node_coursedash -.->|"calls API"| node_apiutil
node_financedash -.->|"calls API"| node_apiutil
node_contentdash -.->|"calls API"| node_apiutil
node_userdash -.->|"calls API"| node_apiutil
node_auditdash -.->|"calls API"| node_apiutil

click node_app "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/App.jsx"
click node_catalog "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/pages/coursesPage/CoursesPage.jsx"
click node_enroll "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/pages/courseRegistration/CourseRegistration.jsx"
click node_trackingui "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/pages/myCourses/MyCourses.jsx"
click node_newsui "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/pages/newsPage/NewsPage.jsx"
click node_publiccontent "https://github.com/it-core2025/education-huc-api/tree/main/learnigCon-Front/src/pages"
click node_apiutil "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/utils/api.js"
click node_dashroute "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/App.jsx"
click node_regdash "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/dashPages/registrationsDashboard/RegistrationsDashboard.jsx"
click node_coursedash "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/dashPages/coursesDashboard/CoursesDashboard.jsx"
click node_financedash "https://github.com/it-core2025/education-huc-api/tree/main/learnigCon-Front/src/dashPages/financialDashboard"
click node_contentdash "https://github.com/it-core2025/education-huc-api/tree/main/learnigCon-Front/src/dashPages"
click node_userdash "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/dashPages/users/UsersPage.jsx"
click node_auditdash "https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/dashPages/staffAuditLogs/StaffAuditLogsPage.jsx"
click node_authapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/AuthController.cs"
click node_registrationapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/RegistrationsApiController.cs"
click node_trackingapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/TrackingCodeApiController.cs"
click node_courseapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/CoursesApiController.cs"
click node_newsapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/NewsController.cs"
click node_contentapi "https://github.com/it-core2025/education-huc-api/tree/main/backend/API"
click node_discountapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/DiscountsApiController.cs"
click node_moneyapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/MoneyAPIpageController.cs"
click node_staffapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/StaffApi.cs"
click node_usersapi "https://github.com/it-core2025/education-huc-api/blob/main/backend/API/UsersController.cs"
click node_auditmw "https://github.com/it-core2025/education-huc-api/blob/main/backend/Middleware/StaffAuditLogMiddleware.cs"
click node_dbcontext "https://github.com/it-core2025/education-huc-api/blob/main/backend/Data/ApplicationDbContext.cs"
click node_domain "https://github.com/it-core2025/education-huc-api/tree/main/backend/Models"
click node_uploads "https://github.com/it-core2025/education-huc-api/tree/main/backend/wwwroot"

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_app,node_catalog,node_enroll,node_trackingui,node_newsui,node_publiccontent,node_apiutil,node_staff toneBlue
class node_dashroute,node_regdash,node_coursedash,node_financedash,node_contentdash,node_userdash,node_auditdash toneAmber
class node_authapi,node_registrationapi,node_trackingapi,node_courseapi,node_newsapi,node_contentapi,node_discountapi,node_moneyapi,node_staffapi,node_usersapi,node_auditmw toneMint
class node_dbcontext,node_sql,node_domain,node_identity,node_uploads toneRose
class node_visitor toneIndigo
```

## Components

### Public Website

- [Route application](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/App.jsx): `learnigCon-Front/src/App.jsx`
- [Course browsing](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/pages/coursesPage/CoursesPage.jsx): `learnigCon-Front/src/pages/coursesPage/CoursesPage.jsx`
- [Course registration](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/pages/courseRegistration/CourseRegistration.jsx): `learnigCon-Front/src/pages/courseRegistration/CourseRegistration.jsx`
- [Course tracking](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/pages/myCourses/MyCourses.jsx): `learnigCon-Front/src/pages/myCourses/MyCourses.jsx`
- [News browsing](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/pages/newsPage/NewsPage.jsx): `learnigCon-Front/src/pages/newsPage/NewsPage.jsx`
- [Public content pages](https://github.com/it-core2025/education-huc-api/tree/main/learnigCon-Front/src/pages): `learnigCon-Front/src/pages`
- [API client](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/utils/api.js): `learnigCon-Front/src/utils/api.js`

### Administration

- [Protected dashboards](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/App.jsx): `learnigCon-Front/src/App.jsx`
- [Registration management](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/dashPages/registrationsDashboard/RegistrationsDashboard.jsx): `learnigCon-Front/src/dashPages/registrationsDashboard/RegistrationsDashboard.jsx`
- [Course management](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/dashPages/coursesDashboard/CoursesDashboard.jsx): `learnigCon-Front/src/dashPages/coursesDashboard/CoursesDashboard.jsx`
- [Finance dashboards](https://github.com/it-core2025/education-huc-api/tree/main/learnigCon-Front/src/dashPages/financialDashboard): `learnigCon-Front/src/dashPages/financialDashboard`
- [Content administration](https://github.com/it-core2025/education-huc-api/tree/main/learnigCon-Front/src/dashPages): `learnigCon-Front/src/dashPages`
- [Users and roles](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/dashPages/users/UsersPage.jsx): `learnigCon-Front/src/dashPages/users/UsersPage.jsx`
- [Audit log viewer](https://github.com/it-core2025/education-huc-api/blob/main/learnigCon-Front/src/dashPages/staffAuditLogs/StaffAuditLogsPage.jsx): `learnigCon-Front/src/dashPages/staffAuditLogs/StaffAuditLogsPage.jsx`

### Backend API

- [Authentication API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/AuthController.cs): `backend/API/AuthController.cs`
- [Registration API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/RegistrationsApiController.cs): `backend/API/RegistrationsApiController.cs`
- [Tracking API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/TrackingCodeApiController.cs): `backend/API/TrackingCodeApiController.cs`
- [Course API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/CoursesApiController.cs): `backend/API/CoursesApiController.cs`
- [News API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/NewsController.cs): `backend/API/NewsController.cs`
- [Content APIs](https://github.com/it-core2025/education-huc-api/tree/main/backend/API): `backend/API`
- [Discount API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/DiscountsApiController.cs): `backend/API/DiscountsApiController.cs`
- [Finance API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/MoneyAPIpageController.cs): `backend/API/MoneyAPIpageController.cs`
- [Staff API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/StaffApi.cs): `backend/API/StaffApi.cs`
- [User administration API](https://github.com/it-core2025/education-huc-api/blob/main/backend/API/UsersController.cs): `backend/API/UsersController.cs`
- [Write audit middleware](https://github.com/it-core2025/education-huc-api/blob/main/backend/Middleware/StaffAuditLogMiddleware.cs): `backend/Middleware/StaffAuditLogMiddleware.cs`

### Persistence and Identity

- [EF data context](https://github.com/it-core2025/education-huc-api/blob/main/backend/Data/ApplicationDbContext.cs): `backend/Data/ApplicationDbContext.cs`
- **SQL Server database**
- [Domain entities](https://github.com/it-core2025/education-huc-api/tree/main/backend/Models): `backend/Models`
- **ASP.NET Identity**
- [Uploaded files](https://github.com/it-core2025/education-huc-api/tree/main/backend/wwwroot): `backend/wwwroot`

### Other components

- **Visitor**
- **Staff user**

## Connections

- Visitor → Route application: browses
- Staff user → Route application: uses dashboards
- Route application → Course browsing: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Route application → Course registration: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Route application → Course tracking: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Route application → News browsing: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Route application → Public content pages: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Route application → Protected dashboards: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Protected dashboards → Registration management: renders (evidence: `learnigCon-Front/src/App.jsx`)
- Protected dashboards → Course management: renders (evidence: `learnigCon-Front/src/App.jsx`)
- Protected dashboards → Finance dashboards: renders (evidence: `learnigCon-Front/src/App.jsx`)
- Protected dashboards → Content administration: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Protected dashboards → Users and roles: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Protected dashboards → Audit log viewer: routes to (evidence: `learnigCon-Front/src/App.jsx`)
- Course registration → API client: calls API (evidence: `learnigCon-Front/src/pages/courseRegistration/CourseRegistration.jsx`)
- Registration management → API client: calls API (evidence: `learnigCon-Front/src/dashPages/registrationsDashboard/RegistrationsDashboard.jsx`)
- Course browsing → API client: calls API
- Course tracking → API client: calls API
- API client → Registration API: HTTP requests
- API client → Tracking API: HTTP requests
- API client → Course API: HTTP requests
- API client → News API: HTTP requests
- API client → Content APIs: HTTP requests
- API client → Discount API: HTTP requests
- API client → Finance API: HTTP requests
- API client → Staff API: HTTP requests
- API client → User administration API: HTTP requests
- API client → Authentication API: HTTP requests
- Registration API → EF data context: queries and saves (evidence: `backend/API/RegistrationsApiController.cs`)
- Tracking API → EF data context: queries and saves (evidence: `backend/API/TrackingCodeApiController.cs`)
- Discount API → EF data context: queries and saves (evidence: `backend/API/DiscountsApiController.cs`)
- Finance API → EF data context: queries and saves (evidence: `backend/API/MoneyAPIpageController.cs`)
- Staff API → EF data context: queries and saves (evidence: `backend/API/StaffApi.cs`)
- User administration API → Authentication API: uses identity (evidence: `backend/API/UsersController.cs`)
- EF data context → Domain entities: maps entities (evidence: `backend/Data/ApplicationDbContext.cs`)
- EF data context → SQL Server database: persists
- Authentication API → ASP.NET Identity: authenticates
- Registration API → Uploaded files: stores files (evidence: `backend/API/RegistrationsApiController.cs`)
- Write audit middleware → EF data context: writes audit entries (evidence: `backend/Middleware/StaffAuditLogMiddleware.cs`)
- Write audit middleware → Registration API: observes API writes
- Write audit middleware → Domain entities: records audit log (evidence: `backend/Middleware/StaffAuditLogMiddleware.cs`)
- Course management → API client: calls API
- Finance dashboards → API client: calls API (evidence: `learnigCon-Front/src/dashPages/financialDashboard/StudentDetailsPage.jsx`)
- Content administration → API client: calls API (evidence: `learnigCon-Front/src/dashPages/registrationsDashboard/RegistrationsDashboard.jsx`)
- Users and roles → API client: calls API
- Audit log viewer → API client: calls API
