# yrbre/fs-shipment_system architecture

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

- Interactive diagram: https://gitdiagram.com/yrbre/fs-shipment_system
- Repository: https://github.com/yrbre/fs-shipment_system

## Overview

This is a Laravel shipment-management application, not the Laravel framework described by its boilerplate README. Users manage shipments and their item details, consult shipment history and tracking, maintain reference data, and view dashboard summaries; authentication and role permissions govern access. The sampled code confirms the shipment controller’s service usage, item CRUD service calls, and dashboard queries. Other subsystems are represented from the file tree, but their internal wiring is not inferred where source was not sampled.

Main entry points: [`routes/web.php`](https://github.com/yrbre/fs-shipment_system/blob/main/routes/web.php) (Web routes), [`config/database.php`](https://github.com/yrbre/fs-shipment_system/blob/main/config/database.php) (Application database), [`app/Http/Controllers/ShipmentController.php`](https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/ShipmentController.php) (Shipment workflow), [`app/Repositories/Eloquent`](https://github.com/yrbre/fs-shipment_system/tree/main/app/Repositories/Eloquent) (Eloquent repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shipment["Shipment operations"]
  node_shipments["Shipment workflow"]
  node_shipment_service["Shipment service"]
  node_tracking["Tracking"]
  node_verification["IMC verification"]
  node_verification_controller["IMC endpoints"]
  node_shipment_views["Shipment screens<br/>[index.blade.php]"]
end

subgraph group_reference["Reference data"]
  node_master_items["Item management<br/>[ItemController.php]"]
  node_item_service["Item service<br/>[ItemService.php]"]
  node_master_data["Other master data"]
  node_master_services["Master-data services"]
end

subgraph group_access["Access and overview"]
  node_dashboard["Dashboard"]
  node_auth["Authentication"]
  node_permissions["Role permissions<br/>[Role.php]"]
  node_exports["Data exports"]
end

subgraph group_persistence["Persistence"]
  node_shipment_models["Shipment records<br/>[Shipment.php]"]
  node_master_models["Reference records<br/>[Item.php]"]
  node_repositories["Eloquent repositories"]
  node_database[("Application database<br/>[database.php]")]
end

node_user(("User"))
node_web["Web routes<br/>[web.php]"]
node_shipment_pages["Shipment pages"]
node_master_pages["Master-data pages"]
node_dashboard_page["Dashboard page"]
node_auth_pages["Login and registration"]

node_user -->|"requests"| node_web
node_web -->|"routes requests"| node_shipments
node_shipments -->|"calls"| node_shipment_service
node_shipments -->|"renders"| node_shipment_views
node_user -->|"uses"| node_shipment_pages
node_web -->|"routes requests"| node_master_items
node_master_items -->|"calls"| node_item_service
node_master_items -->|"renders"| node_master_pages
node_user -->|"uses"| node_master_pages
node_web -->|"routes requests"| node_dashboard
node_dashboard -->|"queries"| node_database
node_dashboard -->|"renders"| node_dashboard_page
node_user -->|"uses"| node_auth_pages
node_web -->|"routes requests"| node_auth
node_auth -->|"creates user"| node_database
node_shipments -->|"creates supplier"| node_database
node_shipment_service --> node_repositories
node_repositories --> node_database
node_item_service --> node_repositories
node_master_services --> node_repositories
node_master_data --> node_master_services
node_web -->|"routes requests"| node_tracking
node_web -->|"routes requests"| node_verification_controller
node_verification_controller --> node_verification
node_web -->|"routes requests"| node_exports
node_web -->|"routes requests"| node_permissions
node_shipment_models --> node_database
node_master_models --> node_database

click node_web "https://github.com/yrbre/fs-shipment_system/blob/main/routes/web.php"
click node_shipments "https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/ShipmentController.php"
click node_shipment_service "https://github.com/yrbre/fs-shipment_system/blob/main/app/Services/ShipmentService.php"
click node_tracking "https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/TrackingController.php"
click node_verification "https://github.com/yrbre/fs-shipment_system/blob/main/app/Services/ImcVerifService.php"
click node_verification_controller "https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/ImcVerifController.php"
click node_shipment_views "https://github.com/yrbre/fs-shipment_system/blob/main/resources/views/pages/shipment/index.blade.php"
click node_master_items "https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/Master/ItemController.php"
click node_item_service "https://github.com/yrbre/fs-shipment_system/blob/main/app/Services/MasterData/ItemService.php"
click node_master_data "https://github.com/yrbre/fs-shipment_system/tree/main/app/Http/Controllers/Master"
click node_master_services "https://github.com/yrbre/fs-shipment_system/tree/main/app/Services/MasterData"
click node_dashboard "https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/DashboardController.php"
click node_auth "https://github.com/yrbre/fs-shipment_system/tree/main/app/Http/Controllers/Auth"
click node_permissions "https://github.com/yrbre/fs-shipment_system/blob/main/app/Models/Role.php"
click node_exports "https://github.com/yrbre/fs-shipment_system/tree/main/app/Exports"
click node_shipment_models "https://github.com/yrbre/fs-shipment_system/blob/main/app/Models/Shipment.php"
click node_master_models "https://github.com/yrbre/fs-shipment_system/blob/main/app/Models/Item.php"
click node_repositories "https://github.com/yrbre/fs-shipment_system/tree/main/app/Repositories/Eloquent"
click node_database "https://github.com/yrbre/fs-shipment_system/blob/main/config/database.php"
click node_shipment_pages "https://github.com/yrbre/fs-shipment_system/tree/main/resources/views/pages/shipment"
click node_master_pages "https://github.com/yrbre/fs-shipment_system/tree/main/resources/views/master"
click node_dashboard_page "https://github.com/yrbre/fs-shipment_system/blob/main/resources/views/dashboard.blade.php"
click node_auth_pages "https://github.com/yrbre/fs-shipment_system/tree/main/resources/views/auth"

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_shipments,node_shipment_service,node_tracking,node_verification,node_verification_controller,node_shipment_views,node_user toneBlue
class node_master_items,node_item_service,node_master_data,node_master_services toneAmber
class node_dashboard,node_auth,node_permissions,node_exports,node_web toneMint
class node_shipment_models,node_master_models,node_repositories,node_database toneRose
class node_shipment_pages,node_master_pages,node_dashboard_page,node_auth_pages toneTeal
```

## Components

### Shipment operations

- [Shipment workflow](https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/ShipmentController.php): `app/Http/Controllers/ShipmentController.php`
- [Shipment service](https://github.com/yrbre/fs-shipment_system/blob/main/app/Services/ShipmentService.php): `app/Services/ShipmentService.php`
- [Tracking](https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/TrackingController.php): `app/Http/Controllers/TrackingController.php`
- [IMC verification](https://github.com/yrbre/fs-shipment_system/blob/main/app/Services/ImcVerifService.php): `app/Services/ImcVerifService.php`
- [IMC endpoints](https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/ImcVerifController.php): `app/Http/Controllers/ImcVerifController.php`
- [Shipment screens](https://github.com/yrbre/fs-shipment_system/blob/main/resources/views/pages/shipment/index.blade.php): `resources/views/pages/shipment/index.blade.php`

### Reference data

- [Item management](https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/Master/ItemController.php): `app/Http/Controllers/Master/ItemController.php`
- [Item service](https://github.com/yrbre/fs-shipment_system/blob/main/app/Services/MasterData/ItemService.php): `app/Services/MasterData/ItemService.php`
- [Other master data](https://github.com/yrbre/fs-shipment_system/tree/main/app/Http/Controllers/Master): `app/Http/Controllers/Master`
- [Master-data services](https://github.com/yrbre/fs-shipment_system/tree/main/app/Services/MasterData): `app/Services/MasterData`

### Access and overview

- [Dashboard](https://github.com/yrbre/fs-shipment_system/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Authentication](https://github.com/yrbre/fs-shipment_system/tree/main/app/Http/Controllers/Auth): `app/Http/Controllers/Auth`
- [Role permissions](https://github.com/yrbre/fs-shipment_system/blob/main/app/Models/Role.php): `app/Models/Role.php`
- [Data exports](https://github.com/yrbre/fs-shipment_system/tree/main/app/Exports): `app/Exports`

### Persistence

- [Shipment records](https://github.com/yrbre/fs-shipment_system/blob/main/app/Models/Shipment.php): `app/Models/Shipment.php`
- [Reference records](https://github.com/yrbre/fs-shipment_system/blob/main/app/Models/Item.php): `app/Models/Item.php`
- [Eloquent repositories](https://github.com/yrbre/fs-shipment_system/tree/main/app/Repositories/Eloquent): `app/Repositories/Eloquent`
- [Application database](https://github.com/yrbre/fs-shipment_system/blob/main/config/database.php): `config/database.php`

### Other components

- **User**
- [Web routes](https://github.com/yrbre/fs-shipment_system/blob/main/routes/web.php): `routes/web.php`
- [Shipment pages](https://github.com/yrbre/fs-shipment_system/tree/main/resources/views/pages/shipment): `resources/views/pages/shipment`
- [Master-data pages](https://github.com/yrbre/fs-shipment_system/tree/main/resources/views/master): `resources/views/master`
- [Dashboard page](https://github.com/yrbre/fs-shipment_system/blob/main/resources/views/dashboard.blade.php): `resources/views/dashboard.blade.php`
- [Login and registration](https://github.com/yrbre/fs-shipment_system/tree/main/resources/views/auth): `resources/views/auth`

## Connections

- User → Web routes: requests
- Web routes → Shipment workflow: routes requests
- Shipment workflow → Shipment service: calls
- Shipment workflow → Shipment screens: renders
- User → Shipment pages: uses
- Web routes → Item management: routes requests
- Item management → Item service: calls
- Item management → Master-data pages: renders
- User → Master-data pages: uses
- Web routes → Dashboard: routes requests
- Dashboard → Application database: queries
- Dashboard → Dashboard page: renders
- User → Login and registration: uses
- Web routes → Authentication: routes requests
- Authentication → Application database: creates user
- Shipment workflow → Application database: creates supplier
- Shipment service → Eloquent repositories
- Eloquent repositories → Application database
- Item service → Eloquent repositories
- Master-data services → Eloquent repositories
- Other master data → Master-data services
- Web routes → Tracking: routes requests
- Web routes → IMC endpoints: routes requests
- IMC endpoints → IMC verification
- Web routes → Data exports: routes requests
- Web routes → Role permissions: routes requests
- Shipment records → Application database
- Reference records → Application database