DVIR Inspection Flow

flowchart TD
    subgraph Initiation["Inspection Initiation"]
        I1["Driver Requests
Magic Link (SMS)"]
        I2["Driver Scans
QR Code"]
        I3["Kiosk
Check-In"]
        I1 --> DV
        I2 --> DV
        I3 --> DV
        DV["Driver Portal
Opens"]
    end

    DV --> SA["Select Asset"]
    SA --> ST{"Select
Timing"}
    ST -->|Pre-Trip| PT["PRE_TRIP"]
    ST -->|Post-Trip| PO["POST_TRIP"]
    ST -->|Interim| IN["INTERIM"]

    PT --> TL
    PO --> TL
    IN --> TL

    subgraph Template["Inspection Template"]
        TL{"Template
Type"}
        TL -->|Full| DOT["DOT_FULL
14 Sections, 50+ Items
(49 CFR 396.11)"]
        TL -->|Quick| SIM["SIMPLIFIED
3 Sections, 13 Items"]
        TL -->|Custom| CUS["CUSTOM
Tenant Defined"]
    end

    DOT --> CK
    SIM --> CK
    CUS --> CK

    subgraph Inspection["Inspection Process"]
        CK["Check Each Item"]
        CK --> IT{"Item
Status"}
        IT -->|Pass| NX["Next Item"]
        IT -->|Fail| DF["Record Defect"]
        IT -->|N/A| NX
        NX --> CK
        DF --> SV{"Defect
Severity"}
        SV -->|Minor| MN["MINOR
Vehicle Operable"]
        SV -->|Major| MJ["MAJOR
Repair Soon"]
        SV -->|Critical| CR["CRITICAL
Out of Service"]
        MN --> NX
        MJ --> NX
        CR --> NX
    end

    CK --> FN["All Items
Checked"]
    FN --> OD["Record Odometer
/ Hours"]
    OD --> SG["Driver Signs
Digitally"]
    SG --> SF{"Safe to
Operate?"}
    SF -->|Yes| SB["Submit
Inspection"]
    SF -->|No| SB

    SB --> HD{"Has
Defects?"}

    HD -->|No| CP["COMPLETED
No Issues"]

    HD -->|Yes| DF2["Defects
Recorded"]

    subgraph AutoActions["Automated Actions"]
        DF2 --> AI{"Auto-Create
Issue?"}
        AI -->|Yes| IS["AssetIssue
Created"]
        AI -->|No| AJ

        IS --> AJ{"Auto-Create
Job?"}
        AJ -->|Yes| SC{"Severity >=
Threshold?"}
        SC -->|Yes| JB["Job Created
or Updated"]
        SC -->|No| NJ["No Job"]
        AJ -->|No| NJ

        JB --> NT["Notify
Managers"]
    end

    subgraph Resolution["Defect Resolution"]
        JB --> RP["Mechanic
Repairs"]
        RP --> MR["Mark as
REPAIRED"]
        MR --> MC["Mechanic
Certifies Fix"]
        MC --> CT["Status:
CERTIFIED"]
        CT --> CS["Inspection:
CERTIFIED_SAFE"]
    end

    subgraph Checkout["Checkout Blocking"]
        SB --> CB{"Block
Checkout?"}
        CB -->|Critical Defect| BL["Checkout
BLOCKED"]
        CB -->|No Block| OK["Checkout
Allowed"]
        BL --> ACK["Driver Must
Acknowledge"]
        ACK --> OK
    end

    %% Styling
    style Initiation fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Template fill:#ddd6fe,stroke:#8b5cf6,stroke-width:2px
    style Inspection fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    style AutoActions fill:#d1fae5,stroke:#10b981,stroke-width:2px
    style Resolution fill:#fce7f3,stroke:#ec4899,stroke-width:2px
    style Checkout fill:#fee2e2,stroke:#f43f5e,stroke-width:2px