# cortezreally0/wopms architecture

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

- Interactive diagram: https://gitdiagram.com/cortezreally0/wopms
- Repository: https://github.com/cortezreally0/wopms

## Overview

This is WOPMS, a role-based work-order and project management application. Its main business flow covers client quotation requests, staff review and quotation preparation, purchase-order approval, production, QA, shipping, and delivery. The sampled staff controller confirms request review updates and notification behavior; report code confirms the later project stages. Other capabilities are represented from the file tree, so their detailed wiring is not asserted here.

Main entry points: [`app/Http/Controllers/Auth`](https://github.com/cortezreally0/wopms/tree/main/app/Http/Controllers/Auth) (Authentication and OTP), [`app/Http/Controllers/Staff/QuotationRequestReviewController.php`](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Staff/QuotationRequestReviewController.php) (Request review), [`app/Http/Controllers/Client/QuotationRequestController.php`](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Client/QuotationRequestController.php) (Client requests), [`app/Http/Controllers/Client/PurchaseOrderController.php`](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Client/PurchaseOrderController.php) (Purchase orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth["Authentication and OTP"]
  node_users[("Users and profiles<br/>[User.php]")]
  node_notifications["Notifications"]
end

subgraph group_commercial["Quotation and orders"]
  node_client_requests["Client requests"]
  node_request_reviews["Request review"]
  node_request_data[("Quotation requests")]
  node_quotation_draft["Quotation drafting"]
  node_purchase_orders["Purchase orders"]
  node_po_data[("Purchase order records<br/>[PurchaseOrder.php]")]
end

subgraph group_fulfillment["Project fulfillment"]
  node_production["Production tracking"]
  node_qa_inspection["QA inspection"]
  node_shipping["Shipping approval"]
  node_delivery_ops["Delivery updates"]
  node_projects[("Project records<br/>[Project.php]")]
end

subgraph group_oversight["Administration and insight"]
  node_reports["Operational reports"]
  node_system_admin["System administration"]
  node_activity_logs["Activity logs"]
end

node_client(("Client"))
node_staff(("Staff"))
node_admin(("Admin"))
node_qa(("QA"))
node_delivery(("Delivery staff"))
node_superadmin(("Super admin"))

node_client -->|"signs in"| node_auth
node_staff -->|"signs in"| node_auth
node_admin -->|"signs in"| node_auth
node_qa -->|"signs in"| node_auth
node_delivery -->|"signs in"| node_auth
node_superadmin -->|"signs in"| node_auth
node_auth -->|"authenticates"| node_users
node_client -->|"submits request"| node_client_requests
node_client_requests -->|"stores request"| node_request_data
node_staff -->|"reviews request"| node_request_reviews
node_request_reviews -->|"updates status"| node_request_data
node_request_reviews -->|"notifies client"| node_notifications
node_staff -->|"drafts quotation"| node_quotation_draft
node_client -->|"manages orders"| node_purchase_orders
node_purchase_orders -->|"updates order"| node_po_data
node_admin -->|"tracks production"| node_production
node_qa -->|"records inspection"| node_qa_inspection
node_admin -->|"approves shipping"| node_shipping
node_delivery -->|"updates delivery"| node_delivery_ops
node_delivery_ops -->|"marks delivered"| node_projects
node_admin -->|"views reports"| node_reports
node_superadmin -->|"manages system"| node_system_admin
node_superadmin -->|"views reports"| node_reports
node_request_reviews -.->|"logs activity"| node_activity_logs

click node_auth "https://github.com/cortezreally0/wopms/tree/main/app/Http/Controllers/Auth"
click node_users "https://github.com/cortezreally0/wopms/blob/main/app/Models/User.php"
click node_client_requests "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Client/QuotationRequestController.php"
click node_request_reviews "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Staff/QuotationRequestReviewController.php"
click node_request_data "https://github.com/cortezreally0/wopms/blob/main/app/Models/QuotationRequest.php"
click node_quotation_draft "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Staff/QuotationDraftController.php"
click node_purchase_orders "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Client/PurchaseOrderController.php"
click node_po_data "https://github.com/cortezreally0/wopms/blob/main/app/Models/PurchaseOrder.php"
click node_production "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Admin/ProductionController.php"
click node_qa_inspection "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/QA/InspectionController.php"
click node_shipping "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Admin/ShipApprovalController.php"
click node_delivery_ops "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Delivery/DeliveryCompletionController.php"
click node_projects "https://github.com/cortezreally0/wopms/blob/main/app/Models/Project.php"
click node_notifications "https://github.com/cortezreally0/wopms/blob/main/app/Services/NotificationService.php"
click node_reports "https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Admin/ReportController.php"
click node_system_admin "https://github.com/cortezreally0/wopms/tree/main/app/Http/Controllers/SuperAdmin"
click node_activity_logs "https://github.com/cortezreally0/wopms/blob/main/app/Services/ActivityLogService.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_auth,node_users,node_notifications,node_client toneBlue
class node_client_requests,node_request_reviews,node_request_data,node_quotation_draft,node_purchase_orders,node_po_data toneAmber
class node_production,node_qa_inspection,node_shipping,node_delivery_ops,node_projects toneMint
class node_reports,node_system_admin,node_activity_logs toneRose
class node_staff,node_admin,node_qa,node_delivery,node_superadmin toneIndigo
```

## Components

### Identity and access

- [Authentication and OTP](https://github.com/cortezreally0/wopms/tree/main/app/Http/Controllers/Auth): `app/Http/Controllers/Auth`
- [Users and profiles](https://github.com/cortezreally0/wopms/blob/main/app/Models/User.php): `app/Models/User.php`
- [Notifications](https://github.com/cortezreally0/wopms/blob/main/app/Services/NotificationService.php): `app/Services/NotificationService.php`

### Quotation and orders

- [Client requests](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Client/QuotationRequestController.php): `app/Http/Controllers/Client/QuotationRequestController.php`
- [Request review](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Staff/QuotationRequestReviewController.php): `app/Http/Controllers/Staff/QuotationRequestReviewController.php`
- [Quotation requests](https://github.com/cortezreally0/wopms/blob/main/app/Models/QuotationRequest.php): `app/Models/QuotationRequest.php`
- [Quotation drafting](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Staff/QuotationDraftController.php): `app/Http/Controllers/Staff/QuotationDraftController.php`
- [Purchase orders](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Client/PurchaseOrderController.php): `app/Http/Controllers/Client/PurchaseOrderController.php`
- [Purchase order records](https://github.com/cortezreally0/wopms/blob/main/app/Models/PurchaseOrder.php): `app/Models/PurchaseOrder.php`

### Project fulfillment

- [Production tracking](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Admin/ProductionController.php): `app/Http/Controllers/Admin/ProductionController.php`
- [QA inspection](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/QA/InspectionController.php): `app/Http/Controllers/QA/InspectionController.php`
- [Shipping approval](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Admin/ShipApprovalController.php): `app/Http/Controllers/Admin/ShipApprovalController.php`
- [Delivery updates](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Delivery/DeliveryCompletionController.php): `app/Http/Controllers/Delivery/DeliveryCompletionController.php`
- [Project records](https://github.com/cortezreally0/wopms/blob/main/app/Models/Project.php): `app/Models/Project.php`

### Administration and insight

- [Operational reports](https://github.com/cortezreally0/wopms/blob/main/app/Http/Controllers/Admin/ReportController.php): `app/Http/Controllers/Admin/ReportController.php`
- [System administration](https://github.com/cortezreally0/wopms/tree/main/app/Http/Controllers/SuperAdmin): `app/Http/Controllers/SuperAdmin`
- [Activity logs](https://github.com/cortezreally0/wopms/blob/main/app/Services/ActivityLogService.php): `app/Services/ActivityLogService.php`

### Other components

- **Client**
- **Staff**
- **Admin**
- **QA**
- **Delivery staff**
- **Super admin**

## Connections

- Client → Authentication and OTP: signs in
- Staff → Authentication and OTP: signs in
- Admin → Authentication and OTP: signs in
- QA → Authentication and OTP: signs in
- Delivery staff → Authentication and OTP: signs in
- Super admin → Authentication and OTP: signs in
- Authentication and OTP → Users and profiles: authenticates
- Client → Client requests: submits request
- Client requests → Quotation requests: stores request
- Staff → Request review: reviews request
- Request review → Quotation requests: updates status
- Request review → Notifications: notifies client
- Staff → Quotation drafting: drafts quotation
- Client → Purchase orders: manages orders
- Purchase orders → Purchase order records: updates order
- Admin → Production tracking: tracks production
- QA → QA inspection: records inspection
- Admin → Shipping approval: approves shipping
- Delivery staff → Delivery updates: updates delivery
- Delivery updates → Project records: marks delivered
- Admin → Operational reports: views reports
- Super admin → System administration: manages system
- Super admin → Operational reports: views reports
- Request review → Activity logs: logs activity