# Courier Management System — Express Last-Mile Courier & Parcel Delivery Suite

> Courier Management System is a modern, fast, and secure last-mile courier and parcel delivery management system with real-time GPS tracking, barcode scanning, driver companion mobile apps (ePOD), automated B2B merchant COD settlements, and a native 15-tool Model Context Protocol (MCP) AI agent gateway.

## Core Capabilities & Architecture
- **6 Specialized Portals:** Super Admin (`/admin/`), Branch Agent (`/agent/`), B2B Merchant (`/merchant/`), Retail Customer (`/customer/`), Mobile Delivery Rider App (`api/v1/driver/`), and Public Tracking Portal (`/track`).
- **Streamlined Last-Mile 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.
- **E-Commerce & Omnichannel Integrations:** Official WooCommerce HPOS sync plugin, HMAC-verified Shopify order webhooks, thermal AWB label printing, and 5-channel notifications (WhatsApp Cloud API, SMS, SMTP Email, Web Push, In-App).

## Public Pages
- [Home](https://cheetah-lite.creatsify.tech/): Main landing page, parcel booking portal, volumetric rate calculator, and service highlights
- [Track Shipment](https://cheetah-lite.creatsify.tech/track): Real-time live shipment tracking timeline and electronic proof of delivery
- [Services](https://cheetah-lite.creatsify.tech/services): Domestic courier, same-day express parcel delivery, cargo transit, and door-to-door shipping services
- [About Us](https://cheetah-lite.creatsify.tech/about): Corporate history, leadership, fleet infrastructure, and branch network
- [Blog & Courier Insights](https://cheetah-lite.creatsify.tech/blog): Last-mile delivery strategies, e-commerce COD tips, and logistics industry updates
- [Contact Support](https://cheetah-lite.creatsify.tech/contact): Branch locations, helpline, and customer inquiries
- [Privacy Policy](https://cheetah-lite.creatsify.tech/privacy-policy): Customer data protection and privacy practices
- [Terms & Conditions](https://cheetah-lite.creatsify.tech/terms-and-conditions): Service agreements, liability limits, and shipping terms
- [Data Deletion](https://cheetah-lite.creatsify.tech/data-deletion): User account and data deletion request instructions

## Model Context Protocol (MCP) & AI Agent Gateway
Courier Management System provides a native JSON-RPC 2.0 Model Context Protocol (MCP v2024-11-05) server for authorized AI agents (Claude Desktop, Cursor, Windsurf, Google Antigravity, GitHub Copilot, OpenAI Agents):
- **HTTP / SSE Endpoint:** `https://cheetah-lite.creatsify.tech/api/v1/mcp/index.php`
- **CLI Stdio & Remote HTTPS Bridge:** `php bin/mcp-server.php --url=https://cheetah-lite.creatsify.tech/api/v1/mcp/index.php --key=cht_mcp_...`
- **Authentication:** Pass `Authorization: Bearer cht_mcp_...` or `X-MCP-API-Key: cht_mcp_...` (manage keys in `/admin/mcp_settings.php` or `/merchant/api_settings.php`)
- **15 Built-In Tools (3 Express Lite 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`

## Machine-Readable Discovery
- [XML Sitemap](https://cheetah-lite.creatsify.tech/sitemap.xml): Complete XML sitemap of public pages, articles, categories, and tags
- [Robots Policy](https://cheetah-lite.creatsify.tech/robots.txt): Crawler directives for search engines and AI agents
- [API Health Probe](https://cheetah-lite.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/
- /agent/
- /merchant/
- /customer/
- /api/
- /includes/
- /assets/
- /uploads/
- /vendor/
- /webhooks/
- /login
- /register
- /forgot_password
- /reset_password
- /settings
- /profile