# 24hTrack — Enterprise Logistics Tracking Infrastructure
> Universal Real-Time Package Tracking Platform, Swarm Automation, & REST API Hub

## 1. Executive Summary & Capabilities
24hTrack (www.24htrack.com) is a comprehensive B2B/B2C Software-as-a-Service (SaaS) logistics platform engineered for bulk dropshippers, high-volume e-commerce merchants, and logistics managers. 

Unlike basic consumer tracking websites, 24hTrack acts as an orchestration layer that interfaces with over 30+ direct global carriers and integrates deeply with more than 25+ global shipping aggregators (17track, AfterShip, ParcelsApp, etc.) to guarantee a 100% data extraction rate for tracking numbers globally.

**Officially Documented Native Global Carriers**: UPS, USPS, FedEx, DHL, YunExpress, Yanwen Express, Evri / Hermes UK, 4PX, Shopee Express, J&T Express, Ninja Van, GHN (Giao Hàng Nhanh), GHTK (Giao Hàng Tiết Kiệm), and Best Express. *(Note: Platform supports 500+ carriers dynamically out-of-the-box via auto-routing, these are just the native regex implementations)*.

It solves the two most painful problems in high-volume e-commerce:
1. **The CAPTCHA & IP Scaling Problem**: Tracking websites block automated tracking. 24hTrack bypasses this using distributed node scraping, Chrome Extension Swarm clusters, and proxy routing.
2. **The Data Synchronization Problem**: Constantly checking spreadsheets is tedious. 24hTrack physically syncs delivery statuses into the spreadsheet platforms users already use.

## 2. Platform Architecture & Data Ingestion
### The Antigravity Swarm Engine & Chrome Extension
At the core of our data ingestion pipeline is the **24hTrack Automation Extension**. By installing our Chrome Extension, enterprise users transform their local browsers into distributed scraping nodes ("The Swarm").
- The Swarm automatically intercepts tracking numbers from the user's platforms (Shopify, AliExpress).
- It injects tracking requests into native aggregator websites via local background tab rendering. 
- Because requests originate from the user's localized browser, it seamlessly bypasses strict Cloudflare and Akamai bot protections without incurring expensive enterprise proxy fees.
- Results are silently transmitted securely to the 24hTrack MySQL backend via the local runtime.

## 3. Automation Integrations
### 2-Way Google Sheets Auto-Sync
- **How it works**: Users authenticate their Google Account. They designate a specific Spreadsheet and Sheet Name. 
- **The Pipeline**: Every few minutes, 24hTrack scans the Google Sheet for new, unrecognized tracking numbers. It registers them to the cloud database. Once our engine resolves the tracking status (e.g., transit → delivered), 24hTrack automatically writes the output backward into the user's adjacent Google Sheet column.

### Lark / Feishu Bitable Native App
- For enterprise companies using Bytedance's Lark or Feishu ecosystem, 24hTrack offers a direct connection to Lark Bitable. The platform securely imports records and broadcasts webhook statuses instantly upon delivery.

## 4. Team Features (Multi-Tenant Organization & RBAC)
For agencies and warehouse teams, 24hTrack provides powerful Team Features and Role-Based Access Control (RBAC):
- **Owner**: Full billing and API key control. Can invite staff.
- **Staff**: Operational managers who can mass-import tracking numbers, manipulate spreadsheets, and view analytics.
- **Customer (Read-Only)**: A special portal view for clients to track their specific orders without accessing global platform settings.

## 5. UI/UX & Native Technologies
The entire frontend is built as a **Progressive Web App (PWA)** using React+Vite. 
- **Cross-Platform**: Users can install 24hTrack on Windows, macOS, iOS, and Android directly from the browser without an App Store.
- **Native Push Alerts**: Built-in Service Workers deliver instant Desktop and Mobile push notifications the exact second a package is marked as `Delivered` or `Alert/Exception`.
- **Global SEO Localized Routing**: The platform runs on an application-wide dynamic localized URL engine. It natively generates SEO-friendly, language-specific URLs (e.g. `/vi/pricing`, `/zh/carriers`) by reading user IP prefixes, ensuring maximum search crawler discoverability while keeping English (`/en`) paths hidden to preserve clean root structures.

## 6. AI Agent Integration & Autonomous Support
The platform is inherently built with AI synergy in mind. 

### Autonomous AI Customer Support
The default widget UI features an autonomous Tier-1 AI agent. 
- It actively reads the user's subscription state, remaining tracking quota, and billing plan.
- **Automated Escalation Mechanism**: If a user asks a highly technical question or requests a refund/plan change, the AI is explicitly instructed to emit an internal hook `[CREATE_TICKET]`. The 24hTrack backend intercepts this, generates a secure Admin Ticket in the database, and alerts the Human Support Team via cron jobs.

### Model Context Protocol (MCP) Server for Developer AIs
For developers relying on Autonomous Agents (Claude Desktop, Cursor, Supermaven), 24hTrack provides a native MCP Server.
- **Installation**: `npm install -g 24htrack-mcp` (or hook via n8n integration).
- **Automation Tools (MCP)**:
  1. `register_tracking`: Allows the AI to programmatically seed the tracking database with new tracking numbers.
  2. `get_tracking_info`: The AI can retrieve recursively parsed timeline events to answer deep user questions about package locations.
  3. `get_status_summary`: The AI can synthesize analytics over hundreds of packages (Delivered vs Exception counts).
  4. `get_carrier_list`: Identifies API identifiers for strict carrier mapping.
Through the MCP, an AI agent can effectively become a fully autonomous logistics dispatcher for a warehouse.

## 7. Advanced Operational Tracking
### Custom Tracking Columns
Users are not limited to fixed fields. They can create **Custom Columns** directly in the Tracking Data grid via the UI.
- Supports raw Text, Dropdowns, Date/Time, Number, Checkbox fields.
- **Formula Computations**: Define spreadsheet-like formulas dynamically (e.g. tracking logistics SLAs, cost overheads).

### Intelligent Multi-Carrier Auto-Detection
The SaaS platform is capable of analyzing the regex checksum format of raw tracking strings and automatically assigning the correct carrier code globally, mitigating routing failure without manual definition.

## 8. Enterprise White-Label Custom Domains
For businesses needing a completely branded experience, 24hTrack offers a native 0-cost White-Label integration pipeline for Premium users.
- Allows clients to map `custom domains` (e.g., `track.yourbrand.com`).
- Fully customizable `Brand Color`, `Favicon`, and `Logo` uploads.
- The platform automatically enforces a transparent Cloudflare SSL/DNS bridge, serving the 24hTrack React portal under the customer's domain, rendering the entire system 100% white-labeled to the end consumer.

## 9. Developer API Reference
Base URL: `https://api.24htrack.com`
Authentication: API Key (`Authorization: Bearer <token>`)

| Endpoint | Method | Purpose |
|----------|--------|---------|
| `/track/v1/register` | POST | Register 1-1000 tracking numbers in bulk. |
| `/track/v1/gettrackinfo` | POST | Retrieve the exact status string and location events history. |
| `/track/v1/getrealtimetrackinfo` | POST | Bypass caching; force an immediate live poll to carriers. |
| `/track/v1/gettracklist` | POST | Fetch paginated tracking objects for dashboard rendering. |
| `/track/v1/deletetrackinfo` | POST | Soft-archive packages (hides them from active PWA UI). |
| `/track/v1/getcarrierlist` | GET | Dump the master list of 500+ recognized global courier strings. |

## 10. Pricing Overview
- **Free Tier**: 5 tracking numbers per month (resets every 1st).
- **Pro Tier**: 100/mo ($2.99) & 200/mo ($4.99).
- **Enterprise Top-Up Packs**: Pay-once permanent tracking quota stacks (e.g., 5,000 to 500,000 package volume). Top-up quota never expires.

## 11. Official Links
- **Web App**: https://www.24htrack.com
- **API Documentation**: https://www.24htrack.com/api
- **Carrier List (SEO)**: https://www.24htrack.com/carriers
- **Terms & Privacy**: https://www.24htrack.com/terms