# hasibul442/laboratory-management architecture

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

- Interactive diagram: https://gitdiagram.com/hasibul442/laboratory-management
- Repository: https://github.com/hasibul442/laboratory-management

## Overview

Laboratory Management System is a Laravel diagnostic-lab operations application. Staff manage patients, test categories, referrals, test reporting, billing and payments, inventory, employees, attendance, and daily activities; patients can access online and printable reports. The visible request path is Laravel route registration to feature controllers, which use Eloquent models for domain records. The README documents broad capabilities, but several controllers and their persistence details were not excerpted, so uncertain internal links are omitted.

Main entry points: [`routes/web.php`](https://github.com/hasibul442/laboratory-management/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/BillsController.php`](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/BillsController.php) (Billing), [`app/Models/TestReport.php`](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/TestReport.php) (Test report model), [`app/Models/User.php`](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/User.php) (User model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clinical["Clinical workflow"]
  node_patients["Patient records"]
  node_patientdata["Patient model<br/>[Patients.php]"]
  node_categories["Test categories"]
  node_categorydata["Category model<br/>[LabTestCat.php]"]
  node_testreports["Department test reports"]
  node_reportdata["Test report model<br/>[TestReport.php]"]
  node_reportbooth["Report generation"]
end

subgraph group_business["Lab operations"]
  node_referrals["Referral management"]
  node_employees["Employee management"]
  node_employeedata["Employee model<br/>[Employees.php]"]
  node_attendance["Attendance"]
  node_attendance_data["Attendance model<br/>[Attendances.php]"]
  node_activities["Daily activities"]
  node_inventory["Inventory tracking"]
  node_inventorydata["Inventory model<br/>[Inventories.php]"]
end

subgraph group_finance["Billing and reporting"]
  node_bills["Billing"]
  node_billdata["Bill model<br/>[Bills.php]"]
  node_payments["Payments"]
  node_accounts["Account reports"]
end

subgraph group_platform["Application platform"]
  node_routes["Web routes<br/>[web.php]"]
  node_router["Route service"]
  node_dashboard["Dashboard"]
  node_users["User and permissions<br/>[UserController.php]"]
  node_userdata["User model<br/>[User.php]"]
end

node_staff(("Staff user"))
node_patient(("Patient"))
node_database[("Relational database")]

node_router -->|"registers routes"| node_routes
node_staff -.->|"uses system"| node_routes
node_patient -.->|"views reports"| node_routes
node_routes -->|"routes requests"| node_patients
node_routes -->|"routes requests"| node_categories
node_routes -->|"routes requests"| node_testreports
node_routes -->|"routes requests"| node_reportbooth
node_routes -->|"routes requests"| node_referrals
node_routes -->|"routes requests"| node_employees
node_routes -->|"routes requests"| node_attendance
node_routes -->|"routes requests"| node_activities
node_routes -->|"routes requests"| node_inventory
node_routes -->|"routes requests"| node_bills
node_routes -->|"routes requests"| node_payments
node_routes -->|"routes requests"| node_accounts
node_routes -->|"routes requests"| node_dashboard
node_routes -->|"routes requests"| node_users
node_patients -->|"uses model"| node_patientdata
node_patients -->|"uses model"| node_userdata
node_categories -->|"uses model"| node_categorydata
node_testreports -->|"updates reports"| node_reportdata
node_testreports -->|"updates stock"| node_inventorydata
node_employees -->|"uses model"| node_employeedata
node_employees -->|"uses model"| node_userdata
node_attendance -->|"uses model"| node_attendance_data
node_inventory -->|"updates stock"| node_inventorydata
node_inventory -.->|"persists records"| node_database
node_bills -->|"uses model"| node_billdata
node_bills -->|"uses model"| node_categorydata
node_bills -->|"uses model"| node_reportdata
node_bills -.->|"persists records"| node_database
node_users -->|"updates permissions"| node_userdata
node_reportdata -->|"relates user"| node_userdata
node_reportdata -->|"relates patient"| node_patientdata
node_reportdata -->|"relates category"| node_categorydata

click node_routes "https://github.com/hasibul442/laboratory-management/blob/main/routes/web.php"
click node_router "https://github.com/hasibul442/laboratory-management/blob/main/app/Providers/RouteServiceProvider.php"
click node_patients "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/PatientsController.php"
click node_patientdata "https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Patients.php"
click node_categories "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/LabTestCatController.php"
click node_categorydata "https://github.com/hasibul442/laboratory-management/blob/main/app/Models/LabTestCat.php"
click node_testreports "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/XrayReportController.php"
click node_reportdata "https://github.com/hasibul442/laboratory-management/blob/main/app/Models/TestReport.php"
click node_reportbooth "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/ReportGenarationController.php"
click node_referrals "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/ReferralController.php"
click node_employees "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/EmployeesController.php"
click node_employeedata "https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Employees.php"
click node_attendance "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/AttendancesController.php"
click node_attendance_data "https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Attendances.php"
click node_activities "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/DaityActivitiesController.php"
click node_inventory "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/InventoriesController.php"
click node_inventorydata "https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Inventories.php"
click node_bills "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/BillsController.php"
click node_billdata "https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Bills.php"
click node_payments "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/PaymentsController.php"
click node_accounts "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/ReportGenarationController.php"
click node_dashboard "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/DashboardController.php"
click node_users "https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/UserController.php"
click node_userdata "https://github.com/hasibul442/laboratory-management/blob/main/app/Models/User.php"

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_patients,node_patientdata,node_categories,node_categorydata,node_testreports,node_reportdata,node_reportbooth,node_staff toneBlue
class node_referrals,node_employees,node_employeedata,node_attendance,node_attendance_data,node_activities,node_inventory,node_inventorydata,node_database toneAmber
class node_bills,node_billdata,node_payments,node_accounts toneMint
class node_routes,node_router,node_dashboard,node_users,node_userdata toneRose
class node_patient toneIndigo
```

## Components

### Clinical workflow

- [Patient records](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/PatientsController.php): `app/Http/Controllers/PatientsController.php`
- [Patient model](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Patients.php): `app/Models/Patients.php`
- [Test categories](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/LabTestCatController.php): `app/Http/Controllers/LabTestCatController.php`
- [Category model](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/LabTestCat.php): `app/Models/LabTestCat.php`
- [Department test reports](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/XrayReportController.php): `app/Http/Controllers/XrayReportController.php`
- [Test report model](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/TestReport.php): `app/Models/TestReport.php`
- [Report generation](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/ReportGenarationController.php): `app/Http/Controllers/ReportGenarationController.php`

### Lab operations

- [Referral management](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/ReferralController.php): `app/Http/Controllers/ReferralController.php`
- [Employee management](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/EmployeesController.php): `app/Http/Controllers/EmployeesController.php`
- [Employee model](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Employees.php): `app/Models/Employees.php`
- [Attendance](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/AttendancesController.php): `app/Http/Controllers/AttendancesController.php`
- [Attendance model](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Attendances.php): `app/Models/Attendances.php`
- [Daily activities](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/DaityActivitiesController.php): `app/Http/Controllers/DaityActivitiesController.php`
- [Inventory tracking](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/InventoriesController.php): `app/Http/Controllers/InventoriesController.php`
- [Inventory model](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Inventories.php): `app/Models/Inventories.php`

### Billing and reporting

- [Billing](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/BillsController.php): `app/Http/Controllers/BillsController.php`
- [Bill model](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/Bills.php): `app/Models/Bills.php`
- [Payments](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/PaymentsController.php): `app/Http/Controllers/PaymentsController.php`
- [Account reports](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/ReportGenarationController.php): `app/Http/Controllers/ReportGenarationController.php`

### Application platform

- [Web routes](https://github.com/hasibul442/laboratory-management/blob/main/routes/web.php): `routes/web.php`
- [Route service](https://github.com/hasibul442/laboratory-management/blob/main/app/Providers/RouteServiceProvider.php): `app/Providers/RouteServiceProvider.php`
- [Dashboard](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [User and permissions](https://github.com/hasibul442/laboratory-management/blob/main/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`
- [User model](https://github.com/hasibul442/laboratory-management/blob/main/app/Models/User.php): `app/Models/User.php`

### Other components

- **Staff user**
- **Patient**
- **Relational database**

## Connections

- Route service → Web routes: registers routes (evidence: `app/Providers/RouteServiceProvider.php`)
- Staff user → Web routes: uses system
- Patient → Web routes: views reports
- Web routes → Patient records: routes requests (evidence: `routes/web.php`)
- Web routes → Test categories: routes requests (evidence: `routes/web.php`)
- Web routes → Department test reports: routes requests (evidence: `routes/web.php`)
- Web routes → Report generation: routes requests (evidence: `routes/web.php`)
- Web routes → Referral management: routes requests (evidence: `routes/web.php`)
- Web routes → Employee management: routes requests (evidence: `routes/web.php`)
- Web routes → Attendance: routes requests (evidence: `routes/web.php`)
- Web routes → Daily activities: routes requests (evidence: `routes/web.php`)
- Web routes → Inventory tracking: routes requests (evidence: `routes/web.php`)
- Web routes → Billing: routes requests (evidence: `routes/web.php`)
- Web routes → Payments: routes requests (evidence: `routes/web.php`)
- Web routes → Account reports: routes requests (evidence: `routes/web.php`)
- Web routes → Dashboard: routes requests (evidence: `routes/web.php`)
- Web routes → User and permissions: routes requests (evidence: `routes/web.php`)
- Patient records → Patient model: uses model (evidence: `app/Http/Controllers/PatientsController.php`)
- Patient records → User model: uses model (evidence: `app/Http/Controllers/PatientsController.php`)
- Test categories → Category model: uses model (evidence: `app/Http/Controllers/LabTestCatController.php`)
- Department test reports → Test report model: updates reports (evidence: `app/Http/Controllers/XrayReportController.php`)
- Department test reports → Inventory model: updates stock (evidence: `app/Http/Controllers/XrayReportController.php`)
- Employee management → Employee model: uses model (evidence: `app/Http/Controllers/EmployeesController.php`)
- Employee management → User model: uses model (evidence: `app/Http/Controllers/EmployeesController.php`)
- Attendance → Attendance model: uses model (evidence: `app/Http/Controllers/AttendancesController.php`)
- Inventory tracking → Inventory model: updates stock (evidence: `app/Http/Controllers/InventoriesController.php`)
- Inventory tracking → Relational database: persists records
- Billing → Bill model: uses model (evidence: `app/Http/Controllers/BillsController.php`)
- Billing → Category model: uses model (evidence: `app/Http/Controllers/BillsController.php`)
- Billing → Test report model: uses model (evidence: `app/Http/Controllers/BillsController.php`)
- Billing → Relational database: persists records
- User and permissions → User model: updates permissions (evidence: `app/Http/Controllers/UserController.php`)
- Test report model → User model: relates user (evidence: `app/Models/TestReport.php`)
- Test report model → Patient model: relates patient (evidence: `app/Models/TestReport.php`)
- Test report model → Category model: relates category (evidence: `app/Models/TestReport.php`)
