Installation Lifecycle
======================

State Machine
-------------

.. mermaid::

   stateDiagram-v2
       [*] --> planned
       planned --> material_pending : Material check initiated
       material_pending --> material_ready : Materials allocated
       material_ready --> confirmed : Customer confirms
       confirmed --> in_progress : Team on site
       in_progress --> completed : Charger installed + demo
       completed --> report_submitted : Report uploaded
       report_submitted --> closed : Central Ops closes

       planned --> rescheduled : Date changed
       confirmed --> rescheduled : Emergency
       rescheduled --> planned : New date set

       planned --> cancelled
       material_pending --> cancelled
       material_ready --> cancelled

       closed --> [*]
       cancelled --> [*]

Installation Day Sequence
-------------------------

.. mermaid::

   sequenceDiagram
       participant CentralOps as Central Ops
       participant FieldTeam as Field Team
       participant Customer
       participant Procurement

       CentralOps->>Procurement: Check Material Availability
       alt Material Available
           Procurement->>FieldTeam: Allocate Material
       else Material Unavailable
           Procurement->>FieldTeam: Procure Locally
           FieldTeam->>CentralOps: Share Vendor QR Details
           Note over CentralOps: Finance processes payment
       end

       CentralOps->>FieldTeam: Assign Installation
       CentralOps->>Customer: Pre-Installation Confirmation

       FieldTeam->>Customer: Installation Day Confirmation Call

       alt Team Available
           FieldTeam->>Customer: Install Charger + Demo
           FieldTeam->>CentralOps: Submit Installation Report
       else Team Unavailable (Emergency)
           FieldTeam--xCentralOps: Installation Team Unavailable
           CentralOps->>Customer: Inform Delay
           CentralOps->>CentralOps: Search Backup Installer
           alt Backup Available
               CentralOps->>FieldTeam: Emergency Install Assignment
               FieldTeam->>Customer: Execute Installation
               FieldTeam->>CentralOps: Submit Report
           else No Backup
               CentralOps->>Customer: Priority Reschedule
           end
       end