# jacksonhoran/structureflow architecture

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

- Interactive diagram: https://gitdiagram.com/jacksonhoran/structureflow
- Repository: https://github.com/jacksonhoran/structureflow

## Overview

This is a multi-organization facilities-maintenance application: signed-in users manage locations, recurring maintenance plans, and work orders, then review operational reports. The main flow is authenticated workspace access into those domain modules; maintenance plans calculate due dates and can create scheduled work orders. The graph also shows the domain relationships and reporting branch. The README is empty, and several UI, route, and controller implementations are unsampled; their links are omitted or marked unverified rather than inferred as confirmed calls.

Main entry points: [`app-modules/work-orders/src/Models/WorkOrder.php`](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Models/WorkOrder.php) (Work-order records), [`app-modules/maintenance/src/Models/MaintenanceSchedule.php`](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Models/MaintenanceSchedule.php) (Plan recurrence and generation), [`app-modules/locations/src/Models/Location.php`](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/locations/src/Models/Location.php) (Location records), [`app/Models/Organization.php`](https://github.com/jacksonhoran/structureflow/blob/main/app/Models/Organization.php) (Organization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and workspace"]
  node_user["User<br/>[User.php]"]
  node_organization["Organization<br/>[Organization.php]"]
  node_login["Authentication"]
  node_org_guard["Organization guard"]
  node_base_controller["Base controller<br/>[Controller.php]"]
end

subgraph group_operations["Facilities operations"]
  node_locations["Location management"]
  node_location_model["Location records<br/>[Location.php]"]
  node_work_orders["Work-order management"]
  node_work_order_model["Work-order records<br/>[WorkOrder.php]"]
  node_status_controller["Status changes"]
  node_comments["Work-order comments"]
  node_work_order_status["Work-order statuses"]
  node_work_order_priority["Work-order priorities"]
end

subgraph group_maintenance["Preventive maintenance"]
  node_maintenance_controller["Maintenance plans"]
  node_maintenance_model["Plan recurrence and generation"]
  node_maintenance_frequency["Maintenance frequency"]
  node_scheduled_generation["Scheduled generation command"]
end

subgraph group_insights["Reports and overview"]
  node_reports["Reports and exports"]
  node_dashboard["Dashboard"]
end

node_database[("Application database<br/>[database.php]")]
node_actor(("User"))
node_workos["WorkOS"]

node_actor -.->|"authenticates"| node_login
node_login -->|"delegates authentication"| node_workos
node_login -->|"syncs account"| node_user
node_user -->|"selects workspace"| node_organization
node_org_guard -->|"checks membership"| node_organization
node_base_controller -->|"resolves current workspace"| node_organization
node_locations -->|"manages locations"| node_location_model
node_work_orders -->|"opens and lists"| node_work_order_model
node_work_orders -->|"uses status options"| node_work_order_status
node_work_orders -->|"filters by priority"| node_work_order_priority
node_status_controller -->|"changes status"| node_work_order_model
node_status_controller -->|"validates status"| node_work_order_status
node_comments -->|"adds comments"| node_work_order_model
node_maintenance_controller -->|"reads and manages plans"| node_maintenance_model
node_maintenance_controller -->|"reads generated work"| node_work_order_model
node_maintenance_controller -->|"uses priority options"| node_work_order_priority
node_maintenance_model -->|"calculates recurrence"| node_maintenance_frequency
node_maintenance_model -->|"creates scheduled orders"| node_work_order_model
node_scheduled_generation -.->|"generates due orders"| node_maintenance_model
node_reports -->|"queries work orders"| node_work_order_model
node_reports -->|"groups by location"| node_location_model
node_dashboard -->|"loads work orders"| node_work_order_model
node_location_model -->|"belongs to"| node_organization
node_location_model -->|"relates to orders"| node_work_order_model
node_location_model -->|"relates to plans"| node_maintenance_model
node_work_order_model -->|"belongs to"| node_organization
node_work_order_model -->|"references location"| node_location_model
node_work_order_model -->|"may reference plan"| node_maintenance_model
node_work_order_model -.->|"persists records"| node_database
node_maintenance_model -.->|"persists plans"| node_database

click node_user "https://github.com/jacksonhoran/structureflow/blob/main/app/Models/User.php"
click node_organization "https://github.com/jacksonhoran/structureflow/blob/main/app/Models/Organization.php"
click node_login "https://github.com/jacksonhoran/structureflow/blob/main/app/Http/Controllers/Auth/LoginController.php"
click node_org_guard "https://github.com/jacksonhoran/structureflow/blob/main/app/Http/Middleware/EnsureUserHasOrganization.php"
click node_base_controller "https://github.com/jacksonhoran/structureflow/blob/main/app/Http/Controllers/Controller.php"
click node_locations "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/locations/src/Http/Controllers/LocationController.php"
click node_location_model "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/locations/src/Models/Location.php"
click node_work_orders "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Http/Controllers/WorkOrderController.php"
click node_work_order_model "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Models/WorkOrder.php"
click node_status_controller "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Http/Controllers/WorkOrderStatusController.php"
click node_comments "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Http/Controllers/WorkOrderCommentController.php"
click node_work_order_status "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Enums/WorkOrderStatus.php"
click node_work_order_priority "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Enums/WorkOrderPriority.php"
click node_maintenance_controller "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Http/Controllers/MaintenanceScheduleController.php"
click node_maintenance_model "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Models/MaintenanceSchedule.php"
click node_maintenance_frequency "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Enums/MaintenanceFrequency.php"
click node_scheduled_generation "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Console/Commands/GenerateMaintenanceWorkOrders.php"
click node_reports "https://github.com/jacksonhoran/structureflow/blob/main/app-modules/reports/src/Http/Controllers/ReportController.php"
click node_dashboard "https://github.com/jacksonhoran/structureflow/blob/main/app/Http/Controllers/DashboardController.php"
click node_database "https://github.com/jacksonhoran/structureflow/blob/main/config/database.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_user,node_organization,node_login,node_org_guard,node_base_controller,node_actor toneBlue
class node_locations,node_location_model,node_work_orders,node_work_order_model,node_status_controller,node_comments,node_work_order_status,node_work_order_priority,node_database toneAmber
class node_maintenance_controller,node_maintenance_model,node_maintenance_frequency,node_scheduled_generation toneMint
class node_reports,node_dashboard toneRose
class node_workos toneIndigo
```

## Components

### Access and workspace

- [User](https://github.com/jacksonhoran/structureflow/blob/main/app/Models/User.php): `app/Models/User.php`
- [Organization](https://github.com/jacksonhoran/structureflow/blob/main/app/Models/Organization.php): `app/Models/Organization.php`
- [Authentication](https://github.com/jacksonhoran/structureflow/blob/main/app/Http/Controllers/Auth/LoginController.php): `app/Http/Controllers/Auth/LoginController.php`
- [Organization guard](https://github.com/jacksonhoran/structureflow/blob/main/app/Http/Middleware/EnsureUserHasOrganization.php): `app/Http/Middleware/EnsureUserHasOrganization.php`
- [Base controller](https://github.com/jacksonhoran/structureflow/blob/main/app/Http/Controllers/Controller.php): `app/Http/Controllers/Controller.php`

### Facilities operations

- [Location management](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/locations/src/Http/Controllers/LocationController.php): `app-modules/locations/src/Http/Controllers/LocationController.php`
- [Location records](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/locations/src/Models/Location.php): `app-modules/locations/src/Models/Location.php`
- [Work-order management](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Http/Controllers/WorkOrderController.php): `app-modules/work-orders/src/Http/Controllers/WorkOrderController.php`
- [Work-order records](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Models/WorkOrder.php): `app-modules/work-orders/src/Models/WorkOrder.php`
- [Status changes](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Http/Controllers/WorkOrderStatusController.php): `app-modules/work-orders/src/Http/Controllers/WorkOrderStatusController.php`
- [Work-order comments](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Http/Controllers/WorkOrderCommentController.php): `app-modules/work-orders/src/Http/Controllers/WorkOrderCommentController.php`
- [Work-order statuses](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Enums/WorkOrderStatus.php): `app-modules/work-orders/src/Enums/WorkOrderStatus.php`
- [Work-order priorities](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/work-orders/src/Enums/WorkOrderPriority.php): `app-modules/work-orders/src/Enums/WorkOrderPriority.php`

### Preventive maintenance

- [Maintenance plans](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Http/Controllers/MaintenanceScheduleController.php): `app-modules/maintenance/src/Http/Controllers/MaintenanceScheduleController.php`
- [Plan recurrence and generation](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Models/MaintenanceSchedule.php): `app-modules/maintenance/src/Models/MaintenanceSchedule.php`
- [Maintenance frequency](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Enums/MaintenanceFrequency.php): `app-modules/maintenance/src/Enums/MaintenanceFrequency.php`
- [Scheduled generation command](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/maintenance/src/Console/Commands/GenerateMaintenanceWorkOrders.php): `app-modules/maintenance/src/Console/Commands/GenerateMaintenanceWorkOrders.php`

### Reports and overview

- [Reports and exports](https://github.com/jacksonhoran/structureflow/blob/main/app-modules/reports/src/Http/Controllers/ReportController.php): `app-modules/reports/src/Http/Controllers/ReportController.php`
- [Dashboard](https://github.com/jacksonhoran/structureflow/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`

### Other components

- [Application database](https://github.com/jacksonhoran/structureflow/blob/main/config/database.php): `config/database.php`
- **User**
- **WorkOS**

## Connections

- User → Authentication: authenticates
- Authentication → WorkOS: delegates authentication (evidence: `app/Http/Controllers/Auth/LoginController.php`)
- Authentication → User: syncs account (evidence: `app/Http/Controllers/Auth/LoginController.php`)
- User → Organization: selects workspace (evidence: `app/Models/User.php`)
- Organization guard → Organization: checks membership (evidence: `app/Http/Middleware/EnsureUserHasOrganization.php`)
- Base controller → Organization: resolves current workspace (evidence: `app/Http/Controllers/Controller.php`)
- Location management → Location records: manages locations (evidence: `app-modules/locations/src/Http/Controllers/LocationController.php`)
- Work-order management → Work-order records: opens and lists (evidence: `app-modules/work-orders/src/Http/Controllers/WorkOrderController.php`)
- Work-order management → Work-order statuses: uses status options (evidence: `app-modules/work-orders/src/Http/Controllers/WorkOrderController.php`)
- Work-order management → Work-order priorities: filters by priority (evidence: `app-modules/work-orders/src/Http/Controllers/WorkOrderController.php`)
- Status changes → Work-order records: changes status (evidence: `app-modules/work-orders/src/Http/Controllers/WorkOrderStatusController.php`)
- Status changes → Work-order statuses: validates status (evidence: `app-modules/work-orders/src/Http/Controllers/WorkOrderStatusController.php`)
- Work-order comments → Work-order records: adds comments (evidence: `app-modules/work-orders/src/Http/Controllers/WorkOrderCommentController.php`)
- Maintenance plans → Plan recurrence and generation: reads and manages plans (evidence: `app-modules/maintenance/src/Http/Controllers/MaintenanceScheduleController.php`)
- Maintenance plans → Work-order records: reads generated work (evidence: `app-modules/maintenance/src/Http/Controllers/MaintenanceScheduleController.php`)
- Maintenance plans → Work-order priorities: uses priority options (evidence: `app-modules/maintenance/src/Http/Controllers/MaintenanceScheduleController.php`)
- Plan recurrence and generation → Maintenance frequency: calculates recurrence (evidence: `app-modules/maintenance/src/Models/MaintenanceSchedule.php`)
- Plan recurrence and generation → Work-order records: creates scheduled orders (evidence: `app-modules/maintenance/src/Models/MaintenanceSchedule.php`)
- Scheduled generation command → Plan recurrence and generation: generates due orders
- Reports and exports → Work-order records: queries work orders (evidence: `app-modules/reports/src/Http/Controllers/ReportController.php`)
- Reports and exports → Location records: groups by location (evidence: `app-modules/reports/src/Http/Controllers/ReportController.php`)
- Dashboard → Work-order records: loads work orders (evidence: `app/Http/Controllers/DashboardController.php`)
- Location records → Organization: belongs to (evidence: `app-modules/locations/src/Models/Location.php`)
- Location records → Work-order records: relates to orders (evidence: `app-modules/locations/src/Models/Location.php`)
- Location records → Plan recurrence and generation: relates to plans (evidence: `app-modules/locations/src/Models/Location.php`)
- Work-order records → Organization: belongs to (evidence: `app-modules/work-orders/src/Models/WorkOrder.php`)
- Work-order records → Location records: references location (evidence: `app-modules/work-orders/src/Models/WorkOrder.php`)
- Work-order records → Plan recurrence and generation: may reference plan (evidence: `app-modules/work-orders/src/Models/WorkOrder.php`)
- Work-order records → Application database: persists records
- Plan recurrence and generation → Application database: persists plans
