# amirhabiby/itas_registration_tracking_system architecture

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

- Interactive diagram: https://gitdiagram.com/amirhabiby/itas_registration_tracking_system
- Repository: https://github.com/amirhabiby/itas_registration_tracking_system

## Overview

RTTS is a modular-monolith registration and training system with role-based portals. Its documented representative journey runs from requesting training, through delegator approval and institute delivery, to assessment and trained status; delegators can then assign trained representatives as agents. The graph also preserves identity, online assessments, public/staff training access, and administration. Source excerpts show selected service calls and frontend routing; other domain links are limited to README statements, and unsampled subsystem internals are represented by their existing directories.

Main entry points: [`frontend/src/routes/AppRoutes.tsx`](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/frontend/src/routes/AppRoutes.tsx) (Role routing), [`backend/src/main/java/com/aronalvarenga/rtts/modules/delegator/application/DelegatorService.java`](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/delegator/application/DelegatorService.java) (Delegator decisions), [`backend/src/main/java/com/aronalvarenga/rtts/modules/representatives/application/RepresentativeService.java`](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/representatives/application/RepresentativeService.java) (Representative status), [`frontend/src/pages/institute`](https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/institute) (Institute portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Role Portals"]
  node_routes["Role routing<br/>[AppRoutes.tsx]"]
  node_repportal["Representative portal"]
  node_delegatorportal["Delegator portal"]
  node_instituteportal["Institute portal"]
  node_publicstaff["Public and staff training"]
end

subgraph group_identity["Identity and Access"]
  node_auth["Authentication services<br/>[AuthService.java]"]
  node_accounts[("User accounts<br/>[UserAccount.java]")]
end

subgraph group_lifecycle["Training Lifecycle"]
  node_requests["Training requests"]
  node_delegation["Delegator decisions"]
  node_trainings[("Training delivery<br/>[Training.java]")]
  node_enrollments["Enrollment and scores"]
  node_representatives["Representative status"]
end

subgraph group_assessment["Assessment"]
  node_onlineassessment["Online assessments"]
  node_grading["Assessment grading"]
end

subgraph group_operations["Administration and Support"]
  node_admin["System administration"]
  node_dashboards["Role dashboards"]
  node_media["Profile media"]
  node_notifications["Email notifications<br/>[EmailService.java]"]
end

node_people(("Portal users"))

node_people -->|"use portals"| node_routes
node_routes -->|"routes to"| node_repportal
node_routes -->|"routes to"| node_delegatorportal
node_routes -->|"routes to"| node_instituteportal
node_routes -->|"routes to"| node_publicstaff
node_auth -->|"reads accounts"| node_accounts
node_people -->|"request training"| node_requests
node_requests -->|"submit for decision"| node_delegation
node_delegation -->|"approve training"| node_trainings
node_trainings -->|"deliver to trainees"| node_enrollments
node_enrollments -->|"marks trained"| node_representatives
node_people -.->|"take assessments"| node_onlineassessment
node_instituteportal -->|"submit scores"| node_grading
node_grading -.->|"updates status"| node_representatives
node_representatives -->|"eligible as agent"| node_delegation
node_people -.->|"administer system"| node_admin
node_people -.->|"view dashboards"| node_dashboards
node_media -.->|"stores profile URL"| node_accounts

click node_routes "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/frontend/src/routes/AppRoutes.tsx"
click node_repportal "https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/representative"
click node_delegatorportal "https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/delegator"
click node_instituteportal "https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/institute"
click node_publicstaff "https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/public"
click node_auth "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/identity/application/AuthService.java"
click node_accounts "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/identity/domain/UserAccount.java"
click node_requests "https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/backend/src/main/java/com/aronalvarenga/rtts/modules/requests"
click node_delegation "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/delegator/application/DelegatorService.java"
click node_trainings "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/trainings/domain/Training.java"
click node_enrollments "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/enrollments/application/EnrollmentService.java"
click node_representatives "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/representatives/application/RepresentativeService.java"
click node_onlineassessment "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/assessment/application/OnlineAssessmentService.java"
click node_grading "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/assessment/application/AssessmentGradingService.java"
click node_admin "https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/backend/src/main/java/com/aronalvarenga/rtts/modules/user"
click node_dashboards "https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/backend/src/main/java/com/aronalvarenga/rtts/modules/dashboard"
click node_media "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/media/CloudinaryService.java"
click node_notifications "https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/notifications/EmailService.java"

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_routes,node_repportal,node_delegatorportal,node_instituteportal,node_publicstaff,node_people toneBlue
class node_auth,node_accounts toneAmber
class node_requests,node_delegation,node_trainings,node_enrollments,node_representatives toneMint
class node_onlineassessment,node_grading toneRose
class node_admin,node_dashboards,node_media,node_notifications toneIndigo
```

## Components

### Role Portals

- [Role routing](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/frontend/src/routes/AppRoutes.tsx): `frontend/src/routes/AppRoutes.tsx`
- [Representative portal](https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/representative): `frontend/src/pages/representative`
- [Delegator portal](https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/delegator): `frontend/src/pages/delegator`
- [Institute portal](https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/institute): `frontend/src/pages/institute`
- [Public and staff training](https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/frontend/src/pages/public): `frontend/src/pages/public`

### Identity and Access

- [Authentication services](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/identity/application/AuthService.java): `backend/src/main/java/com/aronalvarenga/rtts/identity/application/AuthService.java`
- [User accounts](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/identity/domain/UserAccount.java): `backend/src/main/java/com/aronalvarenga/rtts/identity/domain/UserAccount.java`

### Training Lifecycle

- [Training requests](https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/backend/src/main/java/com/aronalvarenga/rtts/modules/requests): `backend/src/main/java/com/aronalvarenga/rtts/modules/requests`
- [Delegator decisions](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/delegator/application/DelegatorService.java): `backend/src/main/java/com/aronalvarenga/rtts/modules/delegator/application/DelegatorService.java`
- [Training delivery](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/trainings/domain/Training.java): `backend/src/main/java/com/aronalvarenga/rtts/modules/trainings/domain/Training.java`
- [Enrollment and scores](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/enrollments/application/EnrollmentService.java): `backend/src/main/java/com/aronalvarenga/rtts/modules/enrollments/application/EnrollmentService.java`
- [Representative status](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/representatives/application/RepresentativeService.java): `backend/src/main/java/com/aronalvarenga/rtts/modules/representatives/application/RepresentativeService.java`

### Assessment

- [Online assessments](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/assessment/application/OnlineAssessmentService.java): `backend/src/main/java/com/aronalvarenga/rtts/modules/assessment/application/OnlineAssessmentService.java`
- [Assessment grading](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/modules/assessment/application/AssessmentGradingService.java): `backend/src/main/java/com/aronalvarenga/rtts/modules/assessment/application/AssessmentGradingService.java`

### Administration and Support

- [System administration](https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/backend/src/main/java/com/aronalvarenga/rtts/modules/user): `backend/src/main/java/com/aronalvarenga/rtts/modules/user`
- [Role dashboards](https://github.com/amirhabiby/itas_registration_tracking_system/tree/main/backend/src/main/java/com/aronalvarenga/rtts/modules/dashboard): `backend/src/main/java/com/aronalvarenga/rtts/modules/dashboard`
- [Profile media](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/media/CloudinaryService.java): `backend/src/main/java/com/aronalvarenga/rtts/media/CloudinaryService.java`
- [Email notifications](https://github.com/amirhabiby/itas_registration_tracking_system/blob/main/backend/src/main/java/com/aronalvarenga/rtts/notifications/EmailService.java): `backend/src/main/java/com/aronalvarenga/rtts/notifications/EmailService.java`

### Other components

- **Portal users**

## Connections

- Portal users → Role routing: use portals (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Role routing → Representative portal: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Role routing → Delegator portal: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Role routing → Institute portal: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Role routing → Public and staff training: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Authentication services → User accounts: reads accounts (evidence: `backend/src/main/java/com/aronalvarenga/rtts/identity/application/AuthService.java`)
- Portal users → Training requests: request training (evidence: `README.md`)
- Training requests → Delegator decisions: submit for decision (evidence: `README.md`)
- Delegator decisions → Training delivery: approve training (evidence: `README.md`)
- Training delivery → Enrollment and scores: deliver to trainees (evidence: `README.md`)
- Enrollment and scores → Representative status: marks trained (evidence: `backend/src/main/java/com/aronalvarenga/rtts/modules/enrollments/application/EnrollmentService.java`)
- Portal users → Online assessments: take assessments
- Institute portal → Assessment grading: submit scores (evidence: `README.md`)
- Assessment grading → Representative status: updates status
- Representative status → Delegator decisions: eligible as agent (evidence: `README.md`)
- Portal users → System administration: administer system
- Portal users → Role dashboards: view dashboards
- Profile media → User accounts: stores profile URL
