# t0m5krt/thesis architecture

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

- Interactive diagram: https://gitdiagram.com/t0m5krt/thesis
- Repository: https://github.com/t0m5krt/thesis

## Overview

This is a PHP repair-and-maintenance management system with separate requester, admin, employee, and super-admin areas. The primary workflow is a requester submitting a service request, followed by admin review and assignment; the repository also exposes request history, work orders, equipment, inventory, employee, and account-management areas. Evidence is limited to the README and sampled/indexed files, so unsampled feature links are not inferred. The README mentions importing test.sql, but that file is not in the provided tree.

Main entry points: [`admin/serviceRequest_Admin.php`](https://github.com/t0m5krt/thesis/blob/master/admin/serviceRequest_Admin.php) (Request Review), [`users/serviceRequest.php`](https://github.com/t0m5krt/thesis/blob/master/users/serviceRequest.php) (Request Form Page), [`admin/view_assign_work_order.php`](https://github.com/t0m5krt/thesis/blob/master/admin/view_assign_work_order.php) (Work Order Detail), [`admin/workOrder_Admin.php`](https://github.com/t0m5krt/thesis/blob/master/admin/workOrder_Admin.php) (Work Orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request["Requester Portal"]
  node_request_page["Request Form Page<br/>[serviceRequest.php]"]
  node_request_submit["Request Submission<br/>[request_form.php]"]
  node_request_history["Request History<br/>[history.php]"]
end

subgraph group_operations["Admin Operations"]
  node_request_admin["Request Review"]
  node_close_request["Close Request<br/>[close_request.php]"]
  node_work_order["Work Order Detail"]
  node_work_order_admin["Work Orders"]
  node_admin_assets["Asset Administration"]
end

subgraph group_staff["Employee Portal"]
  node_employee_dashboard["Employee Dashboard<br/>[dashboard.php]"]
  node_employee_requests["Employee Requests"]
end

subgraph group_accounts["Account Administration"]
  node_account_create["Create Account<br/>[create.php]"]
  node_account_records["Account Records<br/>[view.php]"]
  node_account_crud["Account Maintenance"]
end

node_requester(("Requester"))
node_service_db[("Service Request Store")]
node_admin(("Admin"))
node_employee(("Employee"))
node_super_admin(("Super Admin"))
node_account_db[("Account Store")]

node_requester -.->|"opens"| node_request_page
node_request_page -->|"posts form"| node_request_submit
node_requester -.->|"views"| node_request_history
node_admin -.->|"reviews"| node_request_admin
node_request_admin -->|"queries requests"| node_service_db
node_request_admin -->|"sends close"| node_close_request
node_admin -.->|"manages"| node_work_order_admin
node_work_order_admin -.->|"opens detail"| node_work_order
node_work_order -->|"reads request"| node_service_db
node_admin -.->|"manages assets"| node_admin_assets
node_employee -.->|"opens"| node_employee_dashboard
node_employee_dashboard -->|"counts requests"| node_service_db
node_employee -.->|"opens"| node_employee_requests
node_super_admin -.->|"creates account"| node_account_create
node_account_create -->|"checks and inserts"| node_account_db
node_super_admin -.->|"views accounts"| node_account_records
node_super_admin -.->|"maintains accounts"| node_account_crud

click node_request_page "https://github.com/t0m5krt/thesis/blob/master/users/serviceRequest.php"
click node_request_submit "https://github.com/t0m5krt/thesis/blob/master/users/request_form.php"
click node_request_history "https://github.com/t0m5krt/thesis/blob/master/users/history.php"
click node_request_admin "https://github.com/t0m5krt/thesis/blob/master/admin/serviceRequest_Admin.php"
click node_close_request "https://github.com/t0m5krt/thesis/blob/master/admin/close_request.php"
click node_work_order "https://github.com/t0m5krt/thesis/blob/master/admin/view_assign_work_order.php"
click node_work_order_admin "https://github.com/t0m5krt/thesis/blob/master/admin/workOrder_Admin.php"
click node_admin_assets "https://github.com/t0m5krt/thesis/tree/master/admin"
click node_employee_dashboard "https://github.com/t0m5krt/thesis/blob/master/employee/dashboard.php"
click node_employee_requests "https://github.com/t0m5krt/thesis/blob/master/employee/service_request.php"
click node_account_create "https://github.com/t0m5krt/thesis/blob/master/super_admin/create.php"
click node_account_records "https://github.com/t0m5krt/thesis/blob/master/super_admin/view.php"
click node_account_crud "https://github.com/t0m5krt/thesis/tree/master/super_admin"

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_request_page,node_request_submit,node_request_history toneBlue
class node_request_admin,node_close_request,node_work_order,node_work_order_admin,node_admin_assets,node_service_db,node_account_db toneAmber
class node_employee_dashboard,node_employee_requests,node_requester toneMint
class node_account_create,node_account_records,node_account_crud toneRose
class node_admin,node_employee,node_super_admin toneIndigo
```

## Components

### Requester Portal

- [Request Form Page](https://github.com/t0m5krt/thesis/blob/master/users/serviceRequest.php): `users/serviceRequest.php`
- [Request Submission](https://github.com/t0m5krt/thesis/blob/master/users/request_form.php): `users/request_form.php`
- [Request History](https://github.com/t0m5krt/thesis/blob/master/users/history.php): `users/history.php`

### Admin Operations

- [Request Review](https://github.com/t0m5krt/thesis/blob/master/admin/serviceRequest_Admin.php): `admin/serviceRequest_Admin.php`
- [Close Request](https://github.com/t0m5krt/thesis/blob/master/admin/close_request.php): `admin/close_request.php`
- [Work Order Detail](https://github.com/t0m5krt/thesis/blob/master/admin/view_assign_work_order.php): `admin/view_assign_work_order.php`
- [Work Orders](https://github.com/t0m5krt/thesis/blob/master/admin/workOrder_Admin.php): `admin/workOrder_Admin.php`
- [Asset Administration](https://github.com/t0m5krt/thesis/tree/master/admin): `admin`

### Employee Portal

- [Employee Dashboard](https://github.com/t0m5krt/thesis/blob/master/employee/dashboard.php): `employee/dashboard.php`
- [Employee Requests](https://github.com/t0m5krt/thesis/blob/master/employee/service_request.php): `employee/service_request.php`

### Account Administration

- [Create Account](https://github.com/t0m5krt/thesis/blob/master/super_admin/create.php): `super_admin/create.php`
- [Account Records](https://github.com/t0m5krt/thesis/blob/master/super_admin/view.php): `super_admin/view.php`
- [Account Maintenance](https://github.com/t0m5krt/thesis/tree/master/super_admin): `super_admin`

### Other components

- **Requester**
- **Service Request Store**
- **Admin**
- **Employee**
- **Super Admin**
- **Account Store**

## Connections

- Requester → Request Form Page: opens
- Request Form Page → Request Submission: posts form (evidence: `users/serviceRequest.php`)
- Requester → Request History: views
- Admin → Request Review: reviews
- Request Review → Service Request Store: queries requests (evidence: `admin/serviceRequest_Admin.php`)
- Request Review → Close Request: sends close (evidence: `admin/serviceRequest_Admin.php`)
- Admin → Work Orders: manages
- Work Orders → Work Order Detail: opens detail
- Work Order Detail → Service Request Store: reads request (evidence: `admin/view_assign_work_order.php`)
- Admin → Asset Administration: manages assets
- Employee → Employee Dashboard: opens
- Employee Dashboard → Service Request Store: counts requests (evidence: `employee/dashboard.php`)
- Employee → Employee Requests: opens
- Super Admin → Create Account: creates account
- Create Account → Account Store: checks and inserts (evidence: `super_admin/create.php`)
- Super Admin → Account Records: views accounts
- Super Admin → Account Maintenance: maintains accounts
