# Courier Management System — Enterprise 3PL, WMS & Logistics Suite

> Courier Management System is an enterprise-grade courier, parcel delivery, 3PL warehousing (WMS), and supply chain logistics platform featuring real-time GPS tracking, linehaul cargo sacking, driver companion mobile apps (ePOD), automated B2B merchant COD settlements, and a native 17-tool Model Context Protocol (MCP) AI agent gateway.

## Core Capabilities & Architecture
- **7 Specialized Portals:** Super Admin (`/admin/`), Branch Agent (`/agent/`), 3PL Warehouse Manager (`/manager/`), B2B Merchant (`/merchant/`), Retail Customer (`/customer/`), Mobile Delivery Driver & Picker App (`api/v1/driver/`), and Public Tracking Portal (`/track`).
- **Deterministic Parcel Lifecycle:** Pending -> Picked Up -> At Origin Hub -> Consolidated into Cargo Sack (`SCK-...`) -> Dispatched on Vehicle Manifest -> At Destination Hub -> Out for Delivery -> Delivered (with ePOD signature, photo & GPS geostamp) -> COD Settled.
- **Enterprise 3PL Warehouse Management System (WMS):** Multi-warehouse spatial grid (`Warehouse -> Zone -> Aisle -> Shelf -> Bin`), SKU batch/expiry stock control, inbound Purchase Orders, outbound Sales Orders, FIFO/FEFO wave picking, kitting packs, and RMA returns.
- **E-Commerce & Omnichannel Integrations:** Official WooCommerce HPOS sync plugin, HMAC-verified Shopify order webhooks, and 5-channel notifications (WhatsApp Cloud API, SMS, SMTP Email, Web Push, In-App).

## Public Pages
- [Home](https://cheetah.creatsify.tech/): Main landing page, parcel booking portal, volumetric rate calculator, and enterprise logistics overview
- [Track Shipment](https://cheetah.creatsify.tech/track): Real-time live shipment tracking timeline, transit checkpoints, and electronic proof of delivery
- [Services](https://cheetah.creatsify.tech/services): Domestic express courier, linehaul freight forwarding, cold chain, 3PL fulfillment, and warehousing services
- [About Us](https://cheetah.creatsify.tech/about): Corporate architecture, leadership, fleet infrastructure, and nationwide hub network
- [Blog & Logistics Insights](https://cheetah.creatsify.tech/blog): Technical articles, 3PL warehousing guides, COD remittance strategies, and AI logistics insights
- [Contact Support](https://cheetah.creatsify.tech/contact): Branch locations, 24/7 helpline, and B2B merchant onboarding inquiries
- [Privacy Policy](https://cheetah.creatsify.tech/privacy-policy): Customer data protection and privacy practices
- [Terms & Conditions](https://cheetah.creatsify.tech/terms-and-conditions): Service agreements, liability limits, and shipping terms
- [Data Deletion](https://cheetah.creatsify.tech/data-deletion): User account and data deletion request instructions

## Published Logistics & Technical Articles
- [Green Logistics: Fleet Decarbonization](https://cheetah.creatsify.tech/blog/green-logistics-fleet-decarbonization): [Sustainability & Green Fleet] Discover actionable strategies for sustainable logistics: EV 2-wheeler fleets, micro-hubs, compostable packaging, and carbon footprint tracking.
- [Cold-Chain Logistics Best Practices](https://cheetah.creatsify.tech/blog/cold-chain-logistics-best-practices): [Cold-Chain & Specialized] Essential best practices for temperature-controlled logistics, IoT environmental telemetry, unbroken cold chain verification, and regulatory compliance.
- [WhatsApp & SMS Alerts for Couriers](https://cheetah.creatsify.tech/blog/whatsapp-sms-alerts-courier): [Technology & AI] Explore how automated WhatsApp Cloud API notifications, multi-gateway SMS failover, and live dispatch updates reduce failed delivery attempts by 35%.
- [WMS Guide: Zone Putaway & Wave Picking](https://cheetah.creatsify.tech/blog/wms-zone-putaway-wave-picking): [Warehouse & Fulfillment] A comprehensive guide to high-throughput warehouse architecture, spatial hierarchy, wave picking workflows, and barcode-validated inventory control.
- [Mastering E-Commerce COD Remittance](https://cheetah.creatsify.tech/blog/mastering-ecommerce-cod-remittance): [E-Commerce & Retail] Learn how automated digital wallet ledgers, rapid settlement cycles, and OTP verification solve cash flow bottlenecks and reduce RTO rates for COD merchants.
- [AI Dispatching in Last-Mile Delivery](https://cheetah.creatsify.tech/blog/ai-dispatching-last-mile-delivery): [Logistics & Supply Chain] Discover how AI routing algorithms, real-time telematics, and spatial optimization are revolutionizing last-mile courier logistics and slashing delivery costs.

## Model Context Protocol (MCP) & AI Agent Gateway
Courier Management System includes a native JSON-RPC 2.0 Model Context Protocol (MCP v2024-11-05) server enabling authorized AI agents (Claude Desktop, Cursor, Windsurf, Google Antigravity, GitHub Copilot, OpenAI Agents) to orchestrate live logistics and 3PL operations:
- **HTTP / SSE Endpoint:** `https://cheetah.creatsify.tech/api/v1/mcp/index.php`
- **CLI Stdio & Remote HTTPS Bridge:** `php bin/mcp-server.php --url=https://cheetah.creatsify.tech/api/v1/mcp/index.php --key=cht_mcp_...`
- **Authentication:** Pass `Authorization: Bearer cht_mcp_...` or `X-MCP-API-Key: cht_mcp_...` (keys managed in `/admin/mcp_settings.php` or `/merchant/api_settings.php`)
- **17 Built-In AI Tools (4 Enterprise Domains):**
  - **Logistics & Parcels (6):** `track_parcel`, `book_parcel`, `update_parcel_status`, `calculate_shipping_rate`, `list_parcels`, `get_thermal_label_url`
  - **Blog CMS & SEO (7):** `create_blog_post`, `update_blog_post`, `delete_blog_post`, `list_blog_posts`, `get_blog_post`, `manage_blog_category`, `manage_blog_tag`
  - **Executive Analytics & COD Ledger (2):** `get_executive_summary`, `get_cod_settlement_overview`
  - **3PL Warehouse Management — WMS (2):** `wms_check_stock`, `wms_lookup_bin`

## Machine-Readable Discovery
- [XML Sitemap](https://cheetah.creatsify.tech/sitemap.xml): Complete XML sitemap of public pages, articles, categories, and tags
- [Robots Policy](https://cheetah.creatsify.tech/robots.txt): Crawler directives for search engines and AI agents
- [API Health Probe](https://cheetah.creatsify.tech/api/health): Real-time JSON system status endpoint

## Disallowed Paths
AI crawlers and automated agents MUST NOT crawl or scrape private, administrative, or mutation endpoints without an authorized API or MCP token:
- /admin/
- /super-admin/
- /agent/
- /manager/
- /merchant/
- /customer/
- /api/
- /includes/
- /assets/
- /uploads/
- /vendor/
- /webhooks/
- /login
- /register
- /forgot_password
- /reset_password
- /settings
- /profile