# zenisek-gd/minsu-inventory-system-laravel-react architecture

> Architecture diagram of the GitHub repository zenisek-gd/minsu-inventory-system-laravel-react, 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/zenisek-gd/minsu-inventory-system-laravel-react
- Repository: https://github.com/zenisek-gd/minsu-inventory-system-laravel-react

## Overview

This is a university asset and supplies management system: staff use web and mobile interfaces to manage inventory, borrowing, memorandum receipts (MRs), procurement, locations, scanning, and reporting. The web app routes users to role-protected workflows; API routes dispatch requests to backend controllers, which operate on domain models and stock/location services. The README is empty, so capabilities are inferred from the file tree and sampled source; several frontend-to-API and backend persistence links are therefore shown as unverified rather than asserted.

Main entry points: [`backend/routes/api.php`](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/routes/api.php) (API dispatch), [`frontend/src/App.jsx`](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/App.jsx) (Web routes and access), [`backend/app/Models`](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/tree/main/backend/app/Models) (Asset and workflow records), [`backend/app/Http/Controllers/Api/V1/ItemController.php`](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/ItemController.php) (Inventory API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Web routes and access<br/>[App.jsx]"]
  node_inventory["Inventory management<br/>[ItemsInventory.jsx]"]
  node_borrowing["Borrowing workflow<br/>[Borrows.jsx]"]
  node_receipts["Memorandum receipts"]
  node_receipt_detail["Receipt details"]
  node_dashboard["Dashboard and reports<br/>[Dashboard.jsx]"]
  node_scanner["QR scanning<br/>[QRScanner.jsx]"]
end

subgraph group_api["API workflows"]
  node_api_routes["API dispatch<br/>[api.php]"]
  node_item_api["Inventory API<br/>[ItemController.php]"]
  node_borrow_api["Borrow API"]
  node_receipt_api["Receipt API"]
  node_procurement_api["Purchase requests"]
  node_locations_api["Location administration"]
  node_reports_api["Reports"]
end

subgraph group_domain["Asset domain"]
  node_domain_models[("Asset and workflow records")]
  node_stock_service["Stock ledger service<br/>[StockService.php]"]
  node_location_service["Location rules"]
end

subgraph group_mobile["Mobile scanning"]
  node_mobile_app["Mobile scanner app<br/>[App.js]"]
end

node_user(("Staff and administrators"))

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_inventory
node_webapp -->|"routes to"| node_borrowing
node_webapp -->|"routes to"| node_receipts
node_webapp -->|"routes to"| node_receipt_detail
node_webapp -.->|"routes to"| node_dashboard
node_webapp -.->|"routes to"| node_scanner
node_user -.->|"uses"| node_mobile_app
node_inventory -.->|"requests data"| node_item_api
node_borrowing -.->|"requests data"| node_borrow_api
node_receipts -.->|"requests data"| node_receipt_api
node_receipt_detail -.->|"requests data"| node_receipt_api
node_dashboard -.->|"requests data"| node_reports_api
node_scanner -.->|"submits scans"| node_api_routes
node_mobile_app -.->|"submits scans"| node_api_routes
node_api_routes -->|"dispatches to"| node_item_api
node_api_routes -->|"dispatches to"| node_borrow_api
node_api_routes -->|"dispatches to"| node_receipt_api
node_api_routes -->|"dispatches to"| node_procurement_api
node_api_routes -->|"dispatches to"| node_locations_api
node_api_routes -->|"dispatches to"| node_reports_api
node_item_api -->|"uses"| node_stock_service
node_borrow_api -->|"uses"| node_stock_service
node_locations_api -->|"validates locations"| node_location_service
node_item_api -->|"reads and writes"| node_domain_models
node_borrow_api -->|"reads and writes"| node_domain_models
node_receipt_api -->|"reads and writes"| node_domain_models
node_procurement_api -->|"reads and writes"| node_domain_models
node_reports_api -->|"queries records"| node_domain_models
node_stock_service -->|"updates ledger and items"| node_domain_models

click node_webapp "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/App.jsx"
click node_inventory "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/ItemsInventory.jsx"
click node_borrowing "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/Borrows.jsx"
click node_receipts "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/MemorandumReceipts.jsx"
click node_receipt_detail "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/MemorandumReceiptDetail.jsx"
click node_dashboard "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/Dashboard.jsx"
click node_scanner "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/QRScanner.jsx"
click node_mobile_app "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/mobile/App.js"
click node_api_routes "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/routes/api.php"
click node_item_api "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/ItemController.php"
click node_borrow_api "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/BorrowController.php"
click node_receipt_api "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/MemorandumReceiptController.php"
click node_procurement_api "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/PurchaseRequestController.php"
click node_locations_api "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/OfficeController.php"
click node_reports_api "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/ReportsController.php"
click node_domain_models "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/tree/main/backend/app/Models"
click node_stock_service "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Services/StockService.php"
click node_location_service "https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Services/LocationService.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_webapp,node_inventory,node_borrowing,node_receipts,node_receipt_detail,node_dashboard,node_scanner toneBlue
class node_api_routes,node_item_api,node_borrow_api,node_receipt_api,node_procurement_api,node_locations_api,node_reports_api toneAmber
class node_domain_models,node_stock_service,node_location_service toneMint
class node_mobile_app toneRose
class node_user toneIndigo
```

## Components

### Web application

- [Web routes and access](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Inventory management](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/ItemsInventory.jsx): `frontend/src/pages/ItemsInventory.jsx`
- [Borrowing workflow](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/Borrows.jsx): `frontend/src/pages/Borrows.jsx`
- [Memorandum receipts](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/MemorandumReceipts.jsx): `frontend/src/pages/MemorandumReceipts.jsx`
- [Receipt details](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/MemorandumReceiptDetail.jsx): `frontend/src/pages/MemorandumReceiptDetail.jsx`
- [Dashboard and reports](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [QR scanning](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/frontend/src/pages/QRScanner.jsx): `frontend/src/pages/QRScanner.jsx`

### API workflows

- [API dispatch](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/routes/api.php): `backend/routes/api.php`
- [Inventory API](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/ItemController.php): `backend/app/Http/Controllers/Api/V1/ItemController.php`
- [Borrow API](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/BorrowController.php): `backend/app/Http/Controllers/Api/V1/BorrowController.php`
- [Receipt API](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/MemorandumReceiptController.php): `backend/app/Http/Controllers/Api/V1/MemorandumReceiptController.php`
- [Purchase requests](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/Api/V1/PurchaseRequestController.php): `backend/app/Http/Controllers/Api/V1/PurchaseRequestController.php`
- [Location administration](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/OfficeController.php): `backend/app/Http/Controllers/OfficeController.php`
- [Reports](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Http/Controllers/ReportsController.php): `backend/app/Http/Controllers/ReportsController.php`

### Asset domain

- [Asset and workflow records](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/tree/main/backend/app/Models): `backend/app/Models`
- [Stock ledger service](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Services/StockService.php): `backend/app/Services/StockService.php`
- [Location rules](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/backend/app/Services/LocationService.php): `backend/app/Services/LocationService.php`

### Mobile scanning

- [Mobile scanner app](https://github.com/zenisek-gd/minsu-inventory-system-laravel-react/blob/main/mobile/App.js): `mobile/App.js`

### Other components

- **Staff and administrators**

## Connections

- Staff and administrators → Web routes and access: uses
- Web routes and access → Inventory management: routes to (evidence: `frontend/src/App.jsx`)
- Web routes and access → Borrowing workflow: routes to (evidence: `frontend/src/App.jsx`)
- Web routes and access → Memorandum receipts: routes to (evidence: `frontend/src/App.jsx`)
- Web routes and access → Receipt details: routes to (evidence: `frontend/src/App.jsx`)
- Web routes and access → Dashboard and reports: routes to (evidence: `frontend/src/App.jsx`)
- Web routes and access → QR scanning: routes to (evidence: `frontend/src/App.jsx`)
- Staff and administrators → Mobile scanner app: uses
- Inventory management → Inventory API: requests data
- Borrowing workflow → Borrow API: requests data
- Memorandum receipts → Receipt API: requests data
- Receipt details → Receipt API: requests data
- Dashboard and reports → Reports: requests data
- QR scanning → API dispatch: submits scans
- Mobile scanner app → API dispatch: submits scans
- API dispatch → Inventory API: dispatches to (evidence: `backend/routes/api.php`)
- API dispatch → Borrow API: dispatches to (evidence: `backend/routes/api.php`)
- API dispatch → Receipt API: dispatches to (evidence: `backend/routes/api.php`)
- API dispatch → Purchase requests: dispatches to (evidence: `backend/routes/api.php`)
- API dispatch → Location administration: dispatches to (evidence: `backend/routes/api.php`)
- API dispatch → Reports: dispatches to (evidence: `backend/routes/api.php`)
- Inventory API → Stock ledger service: uses (evidence: `backend/app/Http/Controllers/Api/V1/ItemController.php`)
- Borrow API → Stock ledger service: uses (evidence: `backend/app/Http/Controllers/Api/V1/BorrowController.php`)
- Location administration → Location rules: validates locations (evidence: `backend/app/Http/Controllers/OfficeController.php`)
- Inventory API → Asset and workflow records: reads and writes (evidence: `backend/app/Http/Controllers/Api/V1/ItemController.php`)
- Borrow API → Asset and workflow records: reads and writes (evidence: `backend/app/Http/Controllers/Api/V1/BorrowController.php`)
- Receipt API → Asset and workflow records: reads and writes (evidence: `backend/app/Http/Controllers/Api/V1/MemorandumReceiptController.php`)
- Purchase requests → Asset and workflow records: reads and writes (evidence: `backend/app/Http/Controllers/Api/V1/PurchaseRequestController.php`)
- Reports → Asset and workflow records: queries records (evidence: `backend/app/Http/Controllers/ReportsController.php`)
- Stock ledger service → Asset and workflow records: updates ledger and items (evidence: `backend/app/Services/StockService.php`)
