# SIM Lifecycle State Arrays

To track active cellular modems reliably, the database layer records hardware status properties for physical subscriber identity modules. **Asterisk 2** tracks SIM operational cycles inside `TelephonyDbContext` to automate hardware line rotation safely.

---

## SIM State Representation Matrix

The layout below illustrates how hardware port properties track active registration networks and hardware error boundaries:

```mermaid
graph TD
    %% Hardware SIM
    subgraph SimModel["SIM Profile Class"]
        SimEntity["SimProfile Entity<br/>(PK: SimId, IMSI: 40445...)"]
    end

    %% Operational States
    subgraph StateLedger["Persistent Port Variables"]
        FieldPort["PhysicalPort String<br/>(Rack Slot Map: '3-12')"]
        FieldStatus["PortStatus Indicator<br/>(Values: Idle, Busy, Failed)"]
        FieldFails["FailureCount Counter<br/>(Triggers Alert when &gt; 3)"]
    end

    %% Routing
    subgraph ActionTier["Automated System Actions"]
        ActionActive["Assign Outbound Session"]
        ActionLock["Lock Port Channel"]
        ActionAlert["Flag for Hardware Swap"]
    end

    %% Relations
    SimEntity ==>|"Maps Fields"| FieldPort
    SimEntity ==>|"Maps Fields"| FieldStatus
    SimEntity ==>|"Maps Fields"| FieldFails
    
    FieldStatus -->|"Status == Idle"| ActionActive
    FieldStatus -->|"Status == Busy"| ActionLock
    FieldFails ==>|"FailureCount &gt; 3"| ActionAlert

    %% Rich Aesthetic Theme
    classDef simToken fill:#0f172a,stroke:#38bdf8,stroke-width:2px,color:#fff,rx:6px,ry:6px;
    classDef ledgerToken fill:#1e293b,stroke:#a855f7,stroke-width:2px,color:#fff,rx:6px,ry:6px;
    classDef actToken fill:#312e81,stroke:#ec4899,stroke-width:2px,color:#fff,rx:6px,ry:6px;

    class SimModel,SimEntity simToken;
    class StateLedger,FieldPort,FieldStatus,FieldFails ledgerToken;
    class ActionTier,ActionActive,ActionLock,ActionAlert actToken;
```

---

## Schema Tracking Directives

### 1. Real-Time Hardware Handshaking
Line status variables record ongoing background service updates continuously. Changes update database rows directly to reflect active port states:
- **`Idle`**: SIM is connected to external carriers and available for immediate task assignments.
- **`Busy`**: Active audio channel call in progress. Line locked to prevent mixing signals.
- **`Failed`**: Hardware network drop detected. Port excluded from outbound routing selection pools.