# pirnavadmin/cms_btech architecture

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

- Interactive diagram: https://gitdiagram.com/pirnavadmin/cms_btech
- Repository: https://github.com/pirnavadmin/cms_btech

## Overview

This repository is a campus-management product: a React staff-facing application and an ASP.NET API covering academic administration, student and faculty operations, fees, exams, and access governance. The evident user workflow enters through the frontend application; backend controllers expose domain capabilities, while shared services, authorization scope, and database contexts provide internal layers. The README is empty, and many domain controllers were not sampled, so their detailed call paths and frontend-to-API wiring are not asserted. Grouped directory nodes preserve major capabilities visible in the tree.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/pirnavadmin/cms_btech/blob/main/Frontend/src/App.jsx) (Staff UI), [`Backend/Program.cs`](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Program.cs) (API host), [`Backend/Services/AuthService.cs`](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Services/AuthService.cs) (Authentication), [`Backend/Services/CollegeDataScope.cs`](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Services/CollegeDataScope.cs) (College scope)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Staff application"]
  node_staff["Staff UI<br/>[App.jsx]"]
end

subgraph group_identity["Identity and governance"]
  node_host["API host<br/>[Program.cs]"]
  node_auth["Authentication<br/>[AuthService.cs]"]
  node_user_access["Account access"]
  node_permissions["Module permissions"]
  node_college_scope["College scope"]
  node_roles["Roles governance<br/>[RolesController.cs]"]
end

subgraph group_academics["Academic operations"]
  node_academics_api["Academic setup"]
  node_student_api["Student lifecycle"]
  node_faculty_api["Faculty operations"]
  node_teaching_api["Teaching and exams"]
end

subgraph group_campus["Campus services"]
  node_persistence[("EF data context")]
  node_finance_api["Fees and finance"]
  node_documents["Document management"]
  node_events["Events"]
  node_library["Library services"]
end

node_actor(("Staff user"))

node_actor -.->|"uses"| node_staff
node_host -->|"configures"| node_persistence
node_auth -->|"checks access"| node_user_access
node_college_scope -->|"reads scope"| node_permissions
node_staff -.->|"API calls"| node_host

click node_staff "https://github.com/pirnavadmin/cms_btech/blob/main/Frontend/src/App.jsx"
click node_host "https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Program.cs"
click node_auth "https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Services/AuthService.cs"
click node_user_access "https://github.com/pirnavadmin/cms_btech/blob/main/Backend/UserAccess/UserAccessService.cs"
click node_permissions "https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Middleware/ModulePermissionMiddleware.cs"
click node_college_scope "https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Services/CollegeDataScope.cs"
click node_roles "https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Controllers/RolesController.cs"
click node_persistence "https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Data/ApplicationDbContext.cs"
click node_academics_api "https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1"
click node_student_api "https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1"
click node_faculty_api "https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1/FacultyManagement"
click node_teaching_api "https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1"
click node_finance_api "https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1"
click node_documents "https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1/DocumentManagement"
click node_events "https://github.com/pirnavadmin/cms_btech/tree/main/Backend/EventManagement"
click node_library "https://github.com/pirnavadmin/cms_btech/tree/main/Backend/LibraryManagement"

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_staff,node_actor toneBlue
class node_host,node_auth,node_user_access,node_permissions,node_college_scope,node_roles toneAmber
class node_academics_api,node_student_api,node_faculty_api,node_teaching_api toneMint
class node_persistence,node_finance_api,node_documents,node_events,node_library toneRose
```

## Components

### Staff application

- [Staff UI](https://github.com/pirnavadmin/cms_btech/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`

### Identity and governance

- [API host](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Program.cs): `Backend/Program.cs`
- [Authentication](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Services/AuthService.cs): `Backend/Services/AuthService.cs`
- [Account access](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/UserAccess/UserAccessService.cs): `Backend/UserAccess/UserAccessService.cs`
- [Module permissions](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Middleware/ModulePermissionMiddleware.cs): `Backend/Middleware/ModulePermissionMiddleware.cs`
- [College scope](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Services/CollegeDataScope.cs): `Backend/Services/CollegeDataScope.cs`
- [Roles governance](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Controllers/RolesController.cs): `Backend/Controllers/RolesController.cs`

### Academic operations

- [Academic setup](https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1): `Backend/Controllers/V1`
- [Student lifecycle](https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1): `Backend/Controllers/V1`
- [Faculty operations](https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1/FacultyManagement): `Backend/Controllers/V1/FacultyManagement`
- [Teaching and exams](https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1): `Backend/Controllers/V1`

### Campus services

- [EF data context](https://github.com/pirnavadmin/cms_btech/blob/main/Backend/Data/ApplicationDbContext.cs): `Backend/Data/ApplicationDbContext.cs`
- [Fees and finance](https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1): `Backend/Controllers/V1`
- [Document management](https://github.com/pirnavadmin/cms_btech/tree/main/Backend/Controllers/V1/DocumentManagement): `Backend/Controllers/V1/DocumentManagement`
- [Events](https://github.com/pirnavadmin/cms_btech/tree/main/Backend/EventManagement): `Backend/EventManagement`
- [Library services](https://github.com/pirnavadmin/cms_btech/tree/main/Backend/LibraryManagement): `Backend/LibraryManagement`

### Other components

- **Staff user**

## Connections

- Staff user → Staff UI: uses
- API host → EF data context: configures (evidence: `Backend/Program.cs`)
- Authentication → Account access: checks access (evidence: `Backend/Services/AuthService.cs`)
- College scope → Module permissions: reads scope (evidence: `Backend/Services/CollegeDataScope.cs`)
- Staff UI → API host: API calls
