How jamalishaq/uims works
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: main.py Application wiring · admissions/application Application lifecycle · domain Structure and calendar · billing/application Accounts and fees
Components 20
User portal
- Role-based portal
frontend/src/App.jsx - API client
frontend/src/lib/api.js
API runtime
- HTTP API
backend/src/http_api.py - Application wiring
backend/src/main.py - Authentication and authorization
backend/src/security.py - Domain event bus
backend/src/event_bus.py - PostgreSQL repositories
backend/src/persistence.py
Student lifecycle
- Admissions routes
backend/src/admissions/adapters/inbound/http/router.py - Application lifecycle
backend/src/admissions/application - Admissions rules
backend/src/admissions/domain - Student profile
backend/src/student_profile/application
Academic operations
- Academic structure routes
backend/src/faculty_department/adapters/inbound/http/router.py - Structure and calendar
backend/src/faculty_department/domain - Course catalog
backend/src/course_catalog/application - Course registration
backend/src/enrollment/application - Grades and transcripts
backend/src/academic_records/application
Identity and finance
- Accounts and fees
backend/src/billing/application - Billing routes
backend/src/billing/adapters/inbound/http/router.py - Identity services
backend/src/identity/application
Other components
- University users
Connections 21
- University users → Role-based portal: use portal
README.md - Role-based portal → API client: request data
- API client → HTTP API: call REST API
README.md - HTTP API → Application wiring: mount routes
backend/src/main.py - Application wiring → Authentication and authorization: configure security
backend/src/main.py - Application wiring → Admissions routes: wire context
backend/src/main.py - Application wiring → Academic structure routes: wire context
backend/src/main.py - Application wiring → Billing routes: wire context
backend/src/main.py - Admissions routes → Application lifecycle: invoke use cases
backend/src/admissions/adapters/inbound/http/router.py - Application lifecycle → Admissions rules: apply rules
backend/src/admissions/application/accept_offer.py - Application lifecycle → Student profile: matriculate applicant
- Academic structure routes → Structure and calendar: manage structure
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
backend/src/billing/adapters/inbound/http/router.py - Accounts and fees → PostgreSQL repositories: persist account state
- Application wiring → Course catalog: wire context
backend/src/main.py - Application wiring → Course registration: wire context
backend/src/main.py - Application wiring → Grades and transcripts: wire context
backend/src/main.py - Application wiring → Identity services: wire context
backend/src/main.py - Structure and calendar → Grades and transcripts: submit grades