Vehicle Insurance Policies & Automated Expiry Tracking

Vehicle Insurance Policy Registry#

SmartERP tracks statutory motor vehicle insurance policies across all company vehicles and leased assets using vehicle.insurance.

Policy Attributes#

classDiagram
    class VehicleInsurance {
        +Char name (Policy Number)
        +Many2one vehicle_id
        +Char insurance_company
        +Date start_date
        +Date end_date
        +Date renewal_date
        +Float premium_amount
        +Selection status
        +action_activate_insurance()
        +check_insurance_renewal()
    }

• Policy Number: Official insurance underwriter policy reference (e.g., POL/EIC/2026/0921).
• Insurance Underwriter: Recognized Ethiopian insurance companies (e.g., Ethiopian Insurance Corporation, Awash Insurance, Nyala Insurance, United Insurance).
• Policy Validity Bounds: start_date and end_date validated by constraint _check_dates() ensuring the termination date strictly succeeds the policy effective date.
• Premium Cost: Annual or semi-annual insurance fee recorded for fleet operating expenditure (OPEX) reporting.

Automated Expiry Alerts & Status Lifecycle#

To protect the organization against uncertified fleet operation, SmartERP runs an automated daily scheduler check_insurance_renewal():

stateDiagram-v2
    [*] --> Draft: Policy Entered
    Draft --> Active: action_activate_insurance()
    Active --> ExpiringSoon: 7 Days Prior to End Date (Automated Cron)
    ExpiringSoon --> Expired: Expiration Date Reached
    ExpiringSoon --> Renewed: New Premium Settled & End Date Extended
    Expired --> Renewed: Retroactive Renewal Signed
    Renewed --> Active: New Annual Term Begins

Scheduler Logic in vehicle_insurance_renewal.py#

1. 7-Day Prior Warning: If renewal_date <= today + 7 days and status == 'active', the policy automatically shifts to expiring_soon, and high-priority chatter activity notifications are assigned to the fleet administrator.
2. Hard Expiration Flag: If renewal_date <= today, the status shifts to expired, locking the vehicle's assignment in transport dispatch modules until renewal proof is uploaded.