# jamalishaq/uims architecture

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

- Interactive diagram: https://gitdiagram.com/jamalishaq/uims
- Repository: https://github.com/jamalishaq/uims

## Overview

This repository is a university-management application: a React role-based portal backed by a FastAPI service organized into bounded academic contexts. A representative workflow runs from an applicant submitting an application, through screening and an offer, to acceptance, payment clearance, and matriculation as a student. Other implemented branches cover academic structure and sessions, course registration, grades and records, and billing. The composition root wires context adapters and event handlers. The README describes additional product areas, but the supplied tree does not show implementations for many of them; edges reflect only documented or excerpted relationships.

Main entry points: [`backend/src/main.py`](https://github.com/jamalishaq/uims/blob/main/backend/src/main.py) (Application wiring), [`backend/src/admissions/application`](https://github.com/jamalishaq/uims/tree/main/backend/src/admissions/application) (Application lifecycle), [`backend/src/faculty_department/domain`](https://github.com/jamalishaq/uims/tree/main/backend/src/faculty_department/domain) (Structure and calendar), [`backend/src/billing/application`](https://github.com/jamalishaq/uims/tree/main/backend/src/billing/application) (Accounts and fees)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["User portal"]
  node_portal_app["Role-based portal<br/>[App.jsx]"]
  node_portal_api["API client<br/>[api.js]"]
end

subgraph group_runtime["API runtime"]
  node_api["HTTP API<br/>[http_api.py]"]
  node_composition["Application wiring<br/>[main.py]"]
  node_security["Authentication and authorization<br/>[security.py]"]
  node_event_bus["Domain event bus<br/>[event_bus.py]"]
  node_database[("PostgreSQL repositories<br/>[persistence.py]")]
end

subgraph group_lifecycle["Student lifecycle"]
  node_admissions_http["Admissions routes<br/>[router.py]"]
  node_admissions_usecases["Application lifecycle"]
  node_admissions_domain["Admissions rules"]
  node_student_profile["Student profile"]
end

subgraph group_academics["Academic operations"]
  node_faculty_http["Academic structure routes<br/>[router.py]"]
  node_faculty_domain["Structure and calendar"]
  node_course_catalog["Course catalog"]
  node_enrollment["Course registration"]
  node_academic_records["Grades and transcripts"]
end

subgraph group_platform["Identity and finance"]
  node_billing["Accounts and fees"]
  node_billing_routes["Billing routes<br/>[router.py]"]
  node_identity["Identity services"]
end

node_users(("University users"))

node_users -->|"use portal"| node_portal_app
node_portal_app -.->|"request data"| node_portal_api
node_portal_api -->|"call REST API"| node_api
node_api -->|"mount routes"| node_composition
node_composition -->|"configure security"| node_security
node_composition -->|"wire context"| node_admissions_http
node_composition -->|"wire context"| node_faculty_http
node_composition -->|"wire context"| node_billing_routes
node_admissions_http -->|"invoke use cases"| node_admissions_usecases
node_admissions_usecases -.->|"apply rules"| node_admissions_domain
node_admissions_usecases -->|"matriculate applicant"| node_student_profile
node_faculty_http -->|"manage structure"| node_faculty_domain
node_faculty_domain -->|"publish session event"| node_event_bus
node_event_bus -->|"deliver session event"| node_billing
node_billing_routes -->|"invoke use cases"| node_billing
node_billing -.->|"persist account state"| node_database
node_composition -->|"wire context"| node_course_catalog
node_composition -->|"wire context"| node_enrollment
node_composition -->|"wire context"| node_academic_records
node_composition -->|"wire context"| node_identity
node_faculty_domain -->|"submit grades"| node_academic_records

click node_portal_app "https://github.com/jamalishaq/uims/blob/main/frontend/src/App.jsx"
click node_portal_api "https://github.com/jamalishaq/uims/blob/main/frontend/src/lib/api.js"
click node_api "https://github.com/jamalishaq/uims/blob/main/backend/src/http_api.py"
click node_composition "https://github.com/jamalishaq/uims/blob/main/backend/src/main.py"
click node_security "https://github.com/jamalishaq/uims/blob/main/backend/src/security.py"
click node_admissions_http "https://github.com/jamalishaq/uims/blob/main/backend/src/admissions/adapters/inbound/http/router.py"
click node_admissions_usecases "https://github.com/jamalishaq/uims/tree/main/backend/src/admissions/application"
click node_admissions_domain "https://github.com/jamalishaq/uims/tree/main/backend/src/admissions/domain"
click node_student_profile "https://github.com/jamalishaq/uims/tree/main/backend/src/student_profile/application"
click node_billing "https://github.com/jamalishaq/uims/tree/main/backend/src/billing/application"
click node_billing_routes "https://github.com/jamalishaq/uims/blob/main/backend/src/billing/adapters/inbound/http/router.py"
click node_identity "https://github.com/jamalishaq/uims/tree/main/backend/src/identity/application"
click node_faculty_http "https://github.com/jamalishaq/uims/blob/main/backend/src/faculty_department/adapters/inbound/http/router.py"
click node_faculty_domain "https://github.com/jamalishaq/uims/tree/main/backend/src/faculty_department/domain"
click node_course_catalog "https://github.com/jamalishaq/uims/tree/main/backend/src/course_catalog/application"
click node_enrollment "https://github.com/jamalishaq/uims/tree/main/backend/src/enrollment/application"
click node_academic_records "https://github.com/jamalishaq/uims/tree/main/backend/src/academic_records/application"
click node_event_bus "https://github.com/jamalishaq/uims/blob/main/backend/src/event_bus.py"
click node_database "https://github.com/jamalishaq/uims/blob/main/backend/src/persistence.py"

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_portal_app,node_portal_api,node_users toneBlue
class node_api,node_composition,node_security,node_event_bus,node_database toneAmber
class node_admissions_http,node_admissions_usecases,node_admissions_domain,node_student_profile toneMint
class node_faculty_http,node_faculty_domain,node_course_catalog,node_enrollment,node_academic_records toneRose
class node_billing,node_billing_routes,node_identity toneIndigo
```

## Components

### User portal

- [Role-based portal](https://github.com/jamalishaq/uims/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/jamalishaq/uims/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`

### API runtime

- [HTTP API](https://github.com/jamalishaq/uims/blob/main/backend/src/http_api.py): `backend/src/http_api.py`
- [Application wiring](https://github.com/jamalishaq/uims/blob/main/backend/src/main.py): `backend/src/main.py`
- [Authentication and authorization](https://github.com/jamalishaq/uims/blob/main/backend/src/security.py): `backend/src/security.py`
- [Domain event bus](https://github.com/jamalishaq/uims/blob/main/backend/src/event_bus.py): `backend/src/event_bus.py`
- [PostgreSQL repositories](https://github.com/jamalishaq/uims/blob/main/backend/src/persistence.py): `backend/src/persistence.py`

### Student lifecycle

- [Admissions routes](https://github.com/jamalishaq/uims/blob/main/backend/src/admissions/adapters/inbound/http/router.py): `backend/src/admissions/adapters/inbound/http/router.py`
- [Application lifecycle](https://github.com/jamalishaq/uims/tree/main/backend/src/admissions/application): `backend/src/admissions/application`
- [Admissions rules](https://github.com/jamalishaq/uims/tree/main/backend/src/admissions/domain): `backend/src/admissions/domain`
- [Student profile](https://github.com/jamalishaq/uims/tree/main/backend/src/student_profile/application): `backend/src/student_profile/application`

### Academic operations

- [Academic structure routes](https://github.com/jamalishaq/uims/blob/main/backend/src/faculty_department/adapters/inbound/http/router.py): `backend/src/faculty_department/adapters/inbound/http/router.py`
- [Structure and calendar](https://github.com/jamalishaq/uims/tree/main/backend/src/faculty_department/domain): `backend/src/faculty_department/domain`
- [Course catalog](https://github.com/jamalishaq/uims/tree/main/backend/src/course_catalog/application): `backend/src/course_catalog/application`
- [Course registration](https://github.com/jamalishaq/uims/tree/main/backend/src/enrollment/application): `backend/src/enrollment/application`
- [Grades and transcripts](https://github.com/jamalishaq/uims/tree/main/backend/src/academic_records/application): `backend/src/academic_records/application`

### Identity and finance

- [Accounts and fees](https://github.com/jamalishaq/uims/tree/main/backend/src/billing/application): `backend/src/billing/application`
- [Billing routes](https://github.com/jamalishaq/uims/blob/main/backend/src/billing/adapters/inbound/http/router.py): `backend/src/billing/adapters/inbound/http/router.py`
- [Identity services](https://github.com/jamalishaq/uims/tree/main/backend/src/identity/application): `backend/src/identity/application`

### Other components

- **University users**

## Connections

- University users → Role-based portal: use portal (evidence: `README.md`)
- Role-based portal → API client: request data
- API client → HTTP API: call REST API (evidence: `README.md`)
- HTTP API → Application wiring: mount routes (evidence: `backend/src/main.py`)
- Application wiring → Authentication and authorization: configure security (evidence: `backend/src/main.py`)
- Application wiring → Admissions routes: wire context (evidence: `backend/src/main.py`)
- Application wiring → Academic structure routes: wire context (evidence: `backend/src/main.py`)
- Application wiring → Billing routes: wire context (evidence: `backend/src/main.py`)
- Admissions routes → Application lifecycle: invoke use cases (evidence: `backend/src/admissions/adapters/inbound/http/router.py`)
- Application lifecycle → Admissions rules: apply rules (evidence: `backend/src/admissions/application/accept_offer.py`)
- Application lifecycle → Student profile: matriculate applicant
- Academic structure routes → Structure and calendar: manage structure (evidence: `backend/src/faculty_department/adapters/inbound/http/router.py`)
- Structure and calendar → Domain event bus: publish session event
- Domain event bus → Accounts and fees: deliver session event
- Billing routes → Accounts and fees: invoke use cases (evidence: `backend/src/billing/adapters/inbound/http/router.py`)
- Accounts and fees → PostgreSQL repositories: persist account state
- Application wiring → Course catalog: wire context (evidence: `backend/src/main.py`)
- Application wiring → Course registration: wire context (evidence: `backend/src/main.py`)
- Application wiring → Grades and transcripts: wire context (evidence: `backend/src/main.py`)
- Application wiring → Identity services: wire context (evidence: `backend/src/main.py`)
- Structure and calendar → Grades and transcripts: submit grades
