# ssuchada/repairrequest architecture

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

- Interactive diagram: https://gitdiagram.com/ssuchada/repairrequest
- Repository: https://github.com/ssuchada/repairrequest

## Overview

This is an online dormitory repair-reporting system. Its apparent user workflow spans resident reporting, administrative review or assignment, and technician repair work, with authentication and profile management as supporting capabilities. The repository tree identifies the relevant web pages, controllers, services, repositories, and Supabase configuration, but no source excerpts were provided; therefore, inferred runtime relationships are shown as dashed and unverified rather than asserted as observed calls.

Main entry points: [`src/main/resources/templates/Technician`](https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/Technician) (Technician pages), [`src/main/java/com/example/dormitory/controller/ReporterController.java`](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/ReporterController.java) (Reporter routes), [`src/main/resources/templates/reporter`](https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/reporter) (Reporter pages), [`src/main/resources/templates/admin`](https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/admin) (Admin pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_reporter_pages["Reporter pages"]
  node_admin_pages["Admin pages"]
  node_technician_pages["Technician pages"]
  node_auth_pages["Login and registration"]
end

subgraph group_workflow["Repair workflow"]
  node_reporter_controller["Reporter routes"]
  node_admin_controller["Admin repair routes"]
  node_technician_controller["Technician routes"]
  node_work_controller["Repair work routes"]
  node_request_service["Repair request service"]
  node_assignment_service["Assignment service"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_controller["Authentication routes"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_profile_service["Reporter profiles"]
  node_supabase["Supabase authentication"]
  node_supabase_config["Supabase configuration"]
end

subgraph group_data["Domain data"]
  node_repositories[("Domain repositories")]
  node_models["Repair and user models"]
end

node_resident(("Resident"))
node_admin(("Administrator"))
node_technician(("Technician"))

node_resident -.->|"uses"| node_reporter_pages
node_reporter_pages -.->|"submits reports"| node_reporter_controller
node_reporter_controller -.->|"handles requests"| node_request_service
node_request_service -.->|"accesses records"| node_repositories
node_repositories -.->|"persists domain data"| node_models
node_admin -.->|"uses"| node_admin_pages
node_admin_pages -.->|"manages requests"| node_admin_controller
node_admin_controller -.->|"assigns repairs"| node_assignment_service
node_technician -.->|"uses"| node_technician_pages
node_technician_pages -.->|"views repair work"| node_technician_controller
node_technician_pages -.->|"updates repair work"| node_work_controller
node_auth_pages -.->|"authenticates"| node_auth_controller
node_auth_controller -.->|"delegates authentication"| node_auth_service
node_auth_service -.->|"uses authentication"| node_supabase
node_supabase_config -.->|"configures client"| node_supabase
node_reporter_controller -.->|"manages profiles"| node_profile_service

click node_reporter_pages "https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/reporter"
click node_admin_pages "https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/admin"
click node_technician_pages "https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/Technician"
click node_auth_pages "https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates"
click node_reporter_controller "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/ReporterController.java"
click node_admin_controller "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/AdminRepairRequestController.java"
click node_technician_controller "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/TechnicianController.java"
click node_work_controller "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/RepairWorkController.java"
click node_request_service "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/service/RepairRequestServiceImpl.java"
click node_assignment_service "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/service/RepairAssignmentService.java"
click node_auth_controller "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/AuthController.java"
click node_auth_service "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/service/AuthService.java"
click node_profile_service "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/service/ReporterProfileServiceImpl.java"
click node_repositories "https://github.com/ssuchada/repairrequest/tree/main/src/main/java/com/example/dormitory/repository"
click node_models "https://github.com/ssuchada/repairrequest/tree/main/src/main/java/com/example/dormitory/model"
click node_supabase_config "https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/config/SupabaseConfig.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_reporter_pages,node_admin_pages,node_technician_pages,node_auth_pages toneBlue
class node_reporter_controller,node_admin_controller,node_technician_controller,node_work_controller,node_request_service,node_assignment_service toneAmber
class node_auth_controller,node_auth_service,node_profile_service,node_supabase,node_supabase_config toneMint
class node_repositories,node_models toneRose
class node_resident,node_admin,node_technician toneIndigo
```

## Components

### Web interface

- [Reporter pages](https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/reporter): `src/main/resources/templates/reporter`
- [Admin pages](https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/admin): `src/main/resources/templates/admin`
- [Technician pages](https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates/Technician): `src/main/resources/templates/Technician`
- [Login and registration](https://github.com/ssuchada/repairrequest/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Repair workflow

- [Reporter routes](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/ReporterController.java): `src/main/java/com/example/dormitory/controller/ReporterController.java`
- [Admin repair routes](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/AdminRepairRequestController.java): `src/main/java/com/example/dormitory/controller/AdminRepairRequestController.java`
- [Technician routes](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/TechnicianController.java): `src/main/java/com/example/dormitory/controller/TechnicianController.java`
- [Repair work routes](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/RepairWorkController.java): `src/main/java/com/example/dormitory/controller/RepairWorkController.java`
- [Repair request service](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/service/RepairRequestServiceImpl.java): `src/main/java/com/example/dormitory/service/RepairRequestServiceImpl.java`
- [Assignment service](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/service/RepairAssignmentService.java): `src/main/java/com/example/dormitory/service/RepairAssignmentService.java`

### Identity and profiles

- [Authentication routes](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/controller/AuthController.java): `src/main/java/com/example/dormitory/controller/AuthController.java`
- [Authentication service](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/service/AuthService.java): `src/main/java/com/example/dormitory/service/AuthService.java`
- [Reporter profiles](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/service/ReporterProfileServiceImpl.java): `src/main/java/com/example/dormitory/service/ReporterProfileServiceImpl.java`
- **Supabase authentication**
- [Supabase configuration](https://github.com/ssuchada/repairrequest/blob/main/src/main/java/com/example/dormitory/config/SupabaseConfig.java): `src/main/java/com/example/dormitory/config/SupabaseConfig.java`

### Domain data

- [Domain repositories](https://github.com/ssuchada/repairrequest/tree/main/src/main/java/com/example/dormitory/repository): `src/main/java/com/example/dormitory/repository`
- [Repair and user models](https://github.com/ssuchada/repairrequest/tree/main/src/main/java/com/example/dormitory/model): `src/main/java/com/example/dormitory/model`

### Other components

- **Resident**
- **Administrator**
- **Technician**

## Connections

- Resident → Reporter pages: uses
- Reporter pages → Reporter routes: submits reports
- Reporter routes → Repair request service: handles requests
- Repair request service → Domain repositories: accesses records
- Domain repositories → Repair and user models: persists domain data
- Administrator → Admin pages: uses
- Admin pages → Admin repair routes: manages requests
- Admin repair routes → Assignment service: assigns repairs
- Technician → Technician pages: uses
- Technician pages → Technician routes: views repair work
- Technician pages → Repair work routes: updates repair work
- Login and registration → Authentication routes: authenticates
- Authentication routes → Authentication service: delegates authentication
- Authentication service → Supabase authentication: uses authentication
- Supabase configuration → Supabase authentication: configures client
- Reporter routes → Reporter profiles: manages profiles
