# abeerscode/university-automation-system architecture

> Architecture diagram of the GitHub repository abeerscode/university-automation-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abeerscode/university-automation-system
- Repository: https://github.com/abeerscode/university-automation-system

## Overview

This is a University Automation System: an ASP.NET MVC application backed by business facades, data access and a relational model, with a separate API host. The visible user workflow covers authentication, permission-checked administration and notice drafting/approval, with results persisted through repositories and EF Core. The tree also shows admission, academic, student, finance and other administrative domains; their detailed service flows were not sampled, so they are represented as domain capabilities without guessed call chains. Connections for unsampled subsystems are omitted.

Main entry points: [`src/Presentation/UA.Web.UI/Program.cs`](https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Program.cs) (MVC web app), [`src/Library/UA.Entities`](https://github.com/abeerscode/university-automation-system/tree/main/src/Library/UA.Entities) (University domain model), [`src/Library/UA.DataAccess/Data/UniversityDbContext.cs`](https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.DataAccess/Data/UniversityDbContext.cs) (EF data context), [`src/Presentation/UA.Web.UI/Areas/Administration/Controllers`](https://github.com/abeerscode/university-automation-system/tree/main/src/Presentation/UA.Web.UI/Areas/Administration/Controllers) (Administration UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Web experience"]
  node_web["MVC web app<br/>[Program.cs]"]
  node_account["Account flows"]
  node_admin["Administration UI<br/>[Controllers]"]
  node_notice_ui["Notice UI"]
  node_authorization["Permission checks"]
end

subgraph group_business["Business services"]
  node_auth["Authentication service<br/>[AuthFacade.cs]"]
  node_access["User access service"]
  node_notices["Notice service<br/>[NoticeFacade.cs]"]
  node_rules["Academic rules"]
  node_audit["Manual audit"]
  node_business_domains["Other business services<br/>[Administration]"]
end

subgraph group_data["Persistence and domain"]
  node_repositories["Data repositories<br/>[Implementation]"]
  node_notice_repo["Notice repository"]
  node_dbcontext["EF data context"]
  node_domain["University domain model<br/>[UA.Entities]"]
  node_database[("University database")]
  node_admissions["Admissions<br/>[Application.cs]"]
  node_students["Student records<br/>[Student.cs]"]
  node_enrollment["Course enrollment<br/>[Enrollment.cs]"]
end

subgraph group_runtime["Background and integrations"]
  node_api["API host<br/>[Program.cs]"]
  node_dispatch["Notification dispatch"]
  node_email["SMTP email<br/>[SmtpEmailSender.cs]"]
  node_files["Local file storage"]
end

node_user(("University user"))

node_user -->|"submits requests"| node_web
node_web -->|"routes requests"| node_account
node_web -->|"routes requests"| node_admin
node_web -->|"routes requests"| node_notice_ui
node_account -->|"calls"| node_auth
node_admin -->|"calls"| node_rules
node_admin -->|"calls"| node_access
node_notice_ui -->|"calls"| node_notices
node_authorization -->|"checks access"| node_access
node_notices -->|"checks permissions"| node_access
node_notices -->|"reads and writes"| node_notice_repo
node_notice_repo -->|"queries"| node_dbcontext
node_repositories -->|"uses context"| node_dbcontext
node_dbcontext -->|"maps entities"| node_domain
node_dbcontext -.->|"persists data"| node_database
node_auth -->|"sends messages"| node_email
node_api -->|"registers worker"| node_dispatch
node_dispatch -->|"requests dispatch"| node_business_domains
node_domain -->|"includes admission records"| node_admissions
node_domain -->|"includes student records"| node_students
node_domain -->|"includes enrollment records"| node_enrollment

click node_web "https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Program.cs"
click node_account "https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Controllers/AccountController.cs"
click node_admin "https://github.com/abeerscode/university-automation-system/tree/main/src/Presentation/UA.Web.UI/Areas/Administration/Controllers"
click node_notice_ui "https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Areas/Website/Controllers/NoticesController.cs"
click node_authorization "https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Infrastructure/Authorization/PermissionHandler.cs"
click node_auth "https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Implementation/Administration/AuthFacade.cs"
click node_access "https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Interface/Administration/IUserAccessFacade.cs"
click node_notices "https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Implementation/Website/NoticeFacade.cs"
click node_rules "https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Implementation/Administration/AcademicRulesFacade.cs"
click node_audit "https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Implementation/Administration/ManualAuditService.cs"
click node_business_domains "https://github.com/abeerscode/university-automation-system/tree/main/src/Business/UA.Facade/Implementation/Administration"
click node_api "https://github.com/abeerscode/university-automation-system/blob/main/src/API/UA.API/Program.cs"
click node_dispatch "https://github.com/abeerscode/university-automation-system/blob/main/src/API/UA.API/Workers/NotificationDispatchWorker.cs"
click node_email "https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Integration/Messaging/SmtpEmailSender.cs"
click node_files "https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Integration/Storage/LocalFileStorage.cs"
click node_repositories "https://github.com/abeerscode/university-automation-system/tree/main/src/Library/UA.DataAccess/Implementation"
click node_notice_repo "https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.DataAccess/Implementation/Website/NoticeRepository.cs"
click node_dbcontext "https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.DataAccess/Data/UniversityDbContext.cs"
click node_domain "https://github.com/abeerscode/university-automation-system/tree/main/src/Library/UA.Entities"
click node_admissions "https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Entities/Application.cs"
click node_students "https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Entities/Student.cs"
click node_enrollment "https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Entities/Enrollment.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_web,node_account,node_admin,node_notice_ui,node_authorization,node_user toneBlue
class node_auth,node_access,node_notices,node_rules,node_audit,node_business_domains toneAmber
class node_repositories,node_notice_repo,node_dbcontext,node_domain,node_database,node_admissions,node_students,node_enrollment toneMint
class node_api,node_dispatch,node_email,node_files toneRose
```

## Components

### Web experience

- [MVC web app](https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Program.cs): `src/Presentation/UA.Web.UI/Program.cs`
- [Account flows](https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Controllers/AccountController.cs): `src/Presentation/UA.Web.UI/Controllers/AccountController.cs`
- [Administration UI](https://github.com/abeerscode/university-automation-system/tree/main/src/Presentation/UA.Web.UI/Areas/Administration/Controllers): `src/Presentation/UA.Web.UI/Areas/Administration/Controllers`
- [Notice UI](https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Areas/Website/Controllers/NoticesController.cs): `src/Presentation/UA.Web.UI/Areas/Website/Controllers/NoticesController.cs`
- [Permission checks](https://github.com/abeerscode/university-automation-system/blob/main/src/Presentation/UA.Web.UI/Infrastructure/Authorization/PermissionHandler.cs): `src/Presentation/UA.Web.UI/Infrastructure/Authorization/PermissionHandler.cs`

### Business services

- [Authentication service](https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Implementation/Administration/AuthFacade.cs): `src/Business/UA.Facade/Implementation/Administration/AuthFacade.cs`
- [User access service](https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Interface/Administration/IUserAccessFacade.cs): `src/Business/UA.Facade/Interface/Administration/IUserAccessFacade.cs`
- [Notice service](https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Implementation/Website/NoticeFacade.cs): `src/Business/UA.Facade/Implementation/Website/NoticeFacade.cs`
- [Academic rules](https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Implementation/Administration/AcademicRulesFacade.cs): `src/Business/UA.Facade/Implementation/Administration/AcademicRulesFacade.cs`
- [Manual audit](https://github.com/abeerscode/university-automation-system/blob/main/src/Business/UA.Facade/Implementation/Administration/ManualAuditService.cs): `src/Business/UA.Facade/Implementation/Administration/ManualAuditService.cs`
- [Other business services](https://github.com/abeerscode/university-automation-system/tree/main/src/Business/UA.Facade/Implementation/Administration): `src/Business/UA.Facade/Implementation/Administration`

### Persistence and domain

- [Data repositories](https://github.com/abeerscode/university-automation-system/tree/main/src/Library/UA.DataAccess/Implementation): `src/Library/UA.DataAccess/Implementation`
- [Notice repository](https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.DataAccess/Implementation/Website/NoticeRepository.cs): `src/Library/UA.DataAccess/Implementation/Website/NoticeRepository.cs`
- [EF data context](https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.DataAccess/Data/UniversityDbContext.cs): `src/Library/UA.DataAccess/Data/UniversityDbContext.cs`
- [University domain model](https://github.com/abeerscode/university-automation-system/tree/main/src/Library/UA.Entities): `src/Library/UA.Entities`
- **University database**
- [Admissions](https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Entities/Application.cs): `src/Library/UA.Entities/Application.cs`
- [Student records](https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Entities/Student.cs): `src/Library/UA.Entities/Student.cs`
- [Course enrollment](https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Entities/Enrollment.cs): `src/Library/UA.Entities/Enrollment.cs`

### Background and integrations

- [API host](https://github.com/abeerscode/university-automation-system/blob/main/src/API/UA.API/Program.cs): `src/API/UA.API/Program.cs`
- [Notification dispatch](https://github.com/abeerscode/university-automation-system/blob/main/src/API/UA.API/Workers/NotificationDispatchWorker.cs): `src/API/UA.API/Workers/NotificationDispatchWorker.cs`
- [SMTP email](https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Integration/Messaging/SmtpEmailSender.cs): `src/Library/UA.Integration/Messaging/SmtpEmailSender.cs`
- [Local file storage](https://github.com/abeerscode/university-automation-system/blob/main/src/Library/UA.Integration/Storage/LocalFileStorage.cs): `src/Library/UA.Integration/Storage/LocalFileStorage.cs`

### Other components

- **University user**

## Connections

- University user → MVC web app: submits requests (evidence: `src/Presentation/UA.Web.UI/Program.cs`)
- MVC web app → Account flows: routes requests (evidence: `src/Presentation/UA.Web.UI/Program.cs`)
- MVC web app → Administration UI: routes requests (evidence: `src/Presentation/UA.Web.UI/Program.cs`)
- MVC web app → Notice UI: routes requests (evidence: `src/Presentation/UA.Web.UI/Program.cs`)
- Account flows → Authentication service: calls (evidence: `src/Presentation/UA.Web.UI/Controllers/AccountController.cs`)
- Administration UI → Academic rules: calls (evidence: `src/Presentation/UA.Web.UI/Areas/Administration/Controllers/GradeScalesController.cs`)
- Administration UI → User access service: calls (evidence: `src/Presentation/UA.Web.UI/Areas/Administration/Controllers/UsersController.cs`)
- Notice UI → Notice service: calls (evidence: `src/Presentation/UA.Web.UI/Areas/Website/Controllers/NoticesController.cs`)
- Permission checks → User access service: checks access (evidence: `src/Presentation/UA.Web.UI/Infrastructure/Authorization/PermissionHandler.cs`)
- Notice service → User access service: checks permissions (evidence: `src/Business/UA.Facade/Implementation/Website/NoticeFacade.cs`)
- Notice service → Notice repository: reads and writes (evidence: `src/Business/UA.Facade/Implementation/Website/NoticeFacade.cs`)
- Notice repository → EF data context: queries (evidence: `src/Library/UA.DataAccess/Implementation/Website/NoticeRepository.cs`)
- Data repositories → EF data context: uses context (evidence: `src/Library/UA.DataAccess/Implementation/Common/Repository.cs`)
- EF data context → University domain model: maps entities (evidence: `src/Library/UA.DataAccess/Data/UniversityDbContext.cs`)
- EF data context → University database: persists data
- Authentication service → SMTP email: sends messages (evidence: `src/Business/UA.Facade/Implementation/Administration/AuthFacade.cs`)
- API host → Notification dispatch: registers worker (evidence: `src/API/UA.API/Program.cs`)
- Notification dispatch → Other business services: requests dispatch (evidence: `src/API/UA.API/Workers/NotificationDispatchWorker.cs`)
- University domain model → Admissions: includes admission records (evidence: `src/Library/UA.DataAccess/Data/UniversityDbContext.cs`)
- University domain model → Student records: includes student records (evidence: `src/Library/UA.DataAccess/Data/UniversityDbContext.cs`)
- University domain model → Course enrollment: includes enrollment records (evidence: `src/Library/UA.DataAccess/Data/UniversityDbContext.cs`)
