# kaleez17/tms architecture

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

- Interactive diagram: https://gitdiagram.com/kaleez17/tms
- Repository: https://github.com/kaleez17/tms

## Overview

TMS is an Angular application for managing students, courses, transactions, tests, access permissions, and activity reports. Users enter through routed, guarded screens; they sign in or work with a domain screen, which calls frontend services that communicate with the configured HTTP API. The graph preserves the documented question-bank and test workflows alongside the sampled administration and reporting paths. Backend implementation was not present in the supplied tree, so the API is shown as an external service; links for unsampled feature implementations are limited to documented routing.

Main entry points: [`frontend/src/app/app.routes.ts`](https://github.com/kaleez17/tms/blob/main/frontend/src/app/app.routes.ts) (Route configuration), [`frontend/src/app/services/config-master.service.ts`](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/config-master.service.ts) (Configuration API client), [`frontend/src/app/services/student-detail.service.ts`](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/student-detail.service.ts) (Student API client), [`frontend/src/app/services/auth.service.ts`](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/auth.service.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_router["Route configuration<br/>[app.routes.ts]"]
  node_shell["Application shell<br/>[app.component.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_role["Role permissions"]
end

subgraph group_records["Administration and records"]
  node_configui["Configuration screens"]
  node_courseui["Course screens"]
  node_studentui["Student screens"]
  node_transactionui["Transaction screens"]
  node_userui["User maintenance"]
end

subgraph group_learning["Tests and activity"]
  node_questionui["Question bank<br/>[question-bank.ts]"]
  node_testsetup["Test setup"]
  node_testexec["Test execution"]
  node_myactivity["My activity"]
end

subgraph group_reporting["Reports and data services"]
  node_reports["Reports and dashboard"]
  node_reportservice["Report API client<br/>[report.service.ts]"]
  node_configservice["Configuration API client"]
  node_studentservice["Student API client"]
  node_crud["Cached CRUD layer"]
  node_environment["API configuration<br/>[environment.ts]"]
end

node_user(("User"))
node_api{{"Backend API"}}

node_user -->|"opens screens"| node_router
node_router -->|"hosts routes"| node_shell
node_router -->|"guards access"| node_auth
node_router -->|"routes to"| node_configui
node_router -->|"routes to"| node_courseui
node_router -->|"routes to"| node_studentui
node_router -->|"routes to"| node_transactionui
node_router -->|"routes to"| node_userui
node_router -->|"routes to"| node_questionui
node_router -->|"routes to"| node_testsetup
node_router -->|"routes to"| node_testexec
node_router -->|"routes to"| node_myactivity
node_router -->|"routes to"| node_reports
node_shell -->|"uses"| node_auth
node_shell -->|"refreshes permissions"| node_role
node_auth -->|"loads screens"| node_role
node_configui -.->|"calls"| node_configservice
node_courseui -.->|"loads and saves"| node_api
node_studentui -->|"calls"| node_studentservice
node_transactionui -.->|"loads and saves"| node_api
node_userui -.->|"loads and saves"| node_api
node_questionui -.->|"uses question API"| node_api
node_testsetup -.->|"manages tests"| node_api
node_testexec -.->|"runs tests"| node_api
node_myactivity -->|"loads records"| node_studentservice
node_myactivity -->|"loads activity"| node_reportservice
node_reports -->|"requests reports"| node_reportservice
node_reports -->|"loads filters"| node_configservice
node_configservice -->|"extends"| node_crud
node_studentservice -->|"extends"| node_crud
node_reportservice -->|"requests data and exports"| node_api
node_configservice -->|"requests configuration"| node_api
node_studentservice -->|"requests student data"| node_api
node_reportservice -->|"reads API URL"| node_environment
node_configservice -->|"reads API URL"| node_environment
node_studentservice -->|"reads API URL"| node_environment
node_auth -->|"authenticates"| node_api

click node_router "https://github.com/kaleez17/tms/blob/main/frontend/src/app/app.routes.ts"
click node_shell "https://github.com/kaleez17/tms/blob/main/frontend/src/app/app.component.ts"
click node_auth "https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/auth.service.ts"
click node_role "https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/role-access.service.ts"
click node_configui "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/config-master-form/config-master-form.component.ts"
click node_courseui "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/course-detail-form/course-detail-form.component.ts"
click node_studentui "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/student-detail-form/student-detail-form.component.ts"
click node_transactionui "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/transaction-detail-form/transaction-detail-form.component.ts"
click node_userui "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/user-master-form/user-master-form.component.ts"
click node_questionui "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/question-bank/question-bank.ts"
click node_testsetup "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/test-setup/test-setup.component.ts"
click node_testexec "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/test-execution/test-execution.component.ts"
click node_myactivity "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/student-my-activity-form/student-my-activity-form.component.ts"
click node_reports "https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/report-daily-activity/report-daily-activity.component.ts"
click node_reportservice "https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/report.service.ts"
click node_configservice "https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/config-master.service.ts"
click node_studentservice "https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/student-detail.service.ts"
click node_crud "https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/cached-crud.service.ts"
click node_environment "https://github.com/kaleez17/tms/blob/main/frontend/src/environments/environment.ts"

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_router,node_shell,node_auth,node_role,node_user toneBlue
class node_configui,node_courseui,node_studentui,node_transactionui,node_userui toneAmber
class node_questionui,node_testsetup,node_testexec,node_myactivity,node_api toneMint
class node_reports,node_reportservice,node_configservice,node_studentservice,node_crud,node_environment toneRose
```

## Components

### Access and navigation

- [Route configuration](https://github.com/kaleez17/tms/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Application shell](https://github.com/kaleez17/tms/blob/main/frontend/src/app/app.component.ts): `frontend/src/app/app.component.ts`
- [Authentication](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/auth.service.ts): `frontend/src/app/services/auth.service.ts`
- [Role permissions](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/role-access.service.ts): `frontend/src/app/services/role-access.service.ts`

### Administration and records

- [Configuration screens](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/config-master-form/config-master-form.component.ts): `frontend/src/app/components/config-master-form/config-master-form.component.ts`
- [Course screens](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/course-detail-form/course-detail-form.component.ts): `frontend/src/app/components/course-detail-form/course-detail-form.component.ts`
- [Student screens](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/student-detail-form/student-detail-form.component.ts): `frontend/src/app/components/student-detail-form/student-detail-form.component.ts`
- [Transaction screens](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/transaction-detail-form/transaction-detail-form.component.ts): `frontend/src/app/components/transaction-detail-form/transaction-detail-form.component.ts`
- [User maintenance](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/user-master-form/user-master-form.component.ts): `frontend/src/app/components/user-master-form/user-master-form.component.ts`

### Tests and activity

- [Question bank](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/question-bank/question-bank.ts): `frontend/src/app/components/question-bank/question-bank.ts`
- [Test setup](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/test-setup/test-setup.component.ts): `frontend/src/app/components/test-setup/test-setup.component.ts`
- [Test execution](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/test-execution/test-execution.component.ts): `frontend/src/app/components/test-execution/test-execution.component.ts`
- [My activity](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/student-my-activity-form/student-my-activity-form.component.ts): `frontend/src/app/components/student-my-activity-form/student-my-activity-form.component.ts`

### Reports and data services

- [Reports and dashboard](https://github.com/kaleez17/tms/blob/main/frontend/src/app/components/report-daily-activity/report-daily-activity.component.ts): `frontend/src/app/components/report-daily-activity/report-daily-activity.component.ts`
- [Report API client](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/report.service.ts): `frontend/src/app/services/report.service.ts`
- [Configuration API client](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/config-master.service.ts): `frontend/src/app/services/config-master.service.ts`
- [Student API client](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/student-detail.service.ts): `frontend/src/app/services/student-detail.service.ts`
- [Cached CRUD layer](https://github.com/kaleez17/tms/blob/main/frontend/src/app/services/cached-crud.service.ts): `frontend/src/app/services/cached-crud.service.ts`
- [API configuration](https://github.com/kaleez17/tms/blob/main/frontend/src/environments/environment.ts): `frontend/src/environments/environment.ts`

### Other components

- **User**
- **Backend API**

## Connections

- User → Route configuration: opens screens (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Application shell: hosts routes (evidence: `frontend/src/app/app.component.ts`)
- Route configuration → Authentication: guards access (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Configuration screens: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Course screens: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Student screens: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Transaction screens: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → User maintenance: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Question bank: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Test setup: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Test execution: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → My activity: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route configuration → Reports and dashboard: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Application shell → Authentication: uses (evidence: `frontend/src/app/app.component.ts`)
- Application shell → Role permissions: refreshes permissions (evidence: `frontend/src/app/app.component.ts`)
- Authentication → Role permissions: loads screens (evidence: `frontend/src/app/services/auth.service.ts`)
- Configuration screens → Configuration API client: calls
- Course screens → Backend API: loads and saves
- Student screens → Student API client: calls (evidence: `frontend/src/app/components/student-detail-form/student-detail-form.component.ts`)
- Transaction screens → Backend API: loads and saves
- User maintenance → Backend API: loads and saves
- Question bank → Backend API: uses question API
- Test setup → Backend API: manages tests
- Test execution → Backend API: runs tests
- My activity → Student API client: loads records (evidence: `frontend/src/app/components/student-my-activity-form/student-my-activity-form.component.ts`)
- My activity → Report API client: loads activity (evidence: `frontend/src/app/components/student-my-activity-form/student-my-activity-form.component.ts`)
- Reports and dashboard → Report API client: requests reports (evidence: `frontend/src/app/components/report-daily-activity/report-daily-activity.component.ts`)
- Reports and dashboard → Configuration API client: loads filters (evidence: `frontend/src/app/components/report-daily-activity/report-daily-activity.component.ts`)
- Configuration API client → Cached CRUD layer: extends (evidence: `frontend/src/app/services/config-master.service.ts`)
- Student API client → Cached CRUD layer: extends (evidence: `frontend/src/app/services/student-detail.service.ts`)
- Report API client → Backend API: requests data and exports (evidence: `frontend/src/app/services/report.service.ts`)
- Configuration API client → Backend API: requests configuration (evidence: `frontend/src/app/services/config-master.service.ts`)
- Student API client → Backend API: requests student data (evidence: `frontend/src/app/services/student-detail.service.ts`)
- Report API client → API configuration: reads API URL (evidence: `frontend/src/app/services/report.service.ts`)
- Configuration API client → API configuration: reads API URL (evidence: `frontend/src/app/services/config-master.service.ts`)
- Student API client → API configuration: reads API URL (evidence: `frontend/src/app/services/student-detail.service.ts`)
- Authentication → Backend API: authenticates (evidence: `frontend/src/app/services/auth.service.ts`)
