# FellaHost Company Limited
**Project Developers & Software Engineering Specialists**  
**Document Reference:** Section 24 Deliverables for Software Development Team  
**System Designation:** Integrated Clearing, Forwarding & Logistics System (ICFLS)  
**Corporate Entity:** FellaHost Company Limited  
**TIN NO:** 189-723-717 | **B.L.No:** 20000105272  
**Headquarters:** P.O. Box 80079, Dar es Salaam, Tanzania  
**Support Desk:** support@fellahost.co.tz | **Web:** www.fellahost.co.tz  
**System Deployment Host:** `logistics.domain.co.tz` | `api.domain.co.tz`  
**Publication Date:** September 2026 | **Version:** 1.0 (Production Master Engineering Pack)  

---
# 5. Workflow & Deterministic State-Machine Definitions

## Executive Overview
The ICFLS operational engine uses deterministic finite state machines (FSM) to govern the lifecycle of Consignments, Customs Entries, and Haulage Trips. Transitions require strict cryptographic authorization, telemetry verification, and prerequisite validation.

---

## 5.1 Consignment Job Finite State Machine

```mermaid
stateDiagram-v2
    [*] --> DRAFT : Booking Placed
    DRAFT --> DOCS_PENDING : Commercial Invoice & BL Attached
    DOCS_PENDING --> CUSTOMS_PROCESSING : Documents Verified
    CUSTOMS_PROCESSING --> CLEARED : TANCIS Release Order Issued
    CLEARED --> DISPATCHED : Haulage Trip Assigned
    DISPATCHED --> IN_TRANSIT : Border Departure Logged
    IN_TRANSIT --> DELIVERED : Consignee Signs POD
    DELIVERED --> INVOICED : Finance Billing Reconciled
    INVOICED --> CLOSED : Zero Escrow & Invoice Settled
    CLOSED --> [*]
```

### 5.1.1 Job State Transition Rules
- **T1 (`DRAFT` -> `DOCS_PENDING`)**: Requires minimum mandatory attachments: Master BL, Commercial Invoice, Packing List.
- **T2 (`CUSTOMS_PROCESSING` -> `CLEARED`)**: Guarded by electronic receipt of TRA TANCIS Release Notice (`release_order_issued`).
- **T3 (`DELIVERED` -> `INVOICED`)**: Requires verified electronic Proof of Delivery (POD) image upload.

---

## 5.2 Cross-Border Fleet Trip State Machine

```mermaid
stateDiagram-v2
    [*] --> ASSIGNED
    ASSIGNED --> LOADING : Gate In at Port / CFS
    LOADING --> DEPARTED : Exit Pass Signed
    DEPARTED --> AT_BORDER : Geofence Trigger at Tunduma/Rusumo
    AT_BORDER --> BORDER_CLEARED : Transit Customs Release
    BORDER_CLEARED --> DESTINATION_ARRIVED : Destination Geofence Trigger
    DESTINATION_ARRIVED --> OFFLOADED : Consignee Unloading Complete
    OFFLOADED --> POD_CONFIRMED : Mobile Electronic Signature Uploaded
    POD_CONFIRMED --> [*]
```

---

### Regulatory Notice
> **We're Top leading Company Registering under Commercial & Technical ICT Services TIN NO: 189-723-717**  
> *FellaHost Company Limited — Project Developers & Engineering Specialists.*  
> *Confidential & Proprietary Enterprise Asset — All Rights Reserved.*