================================================================================ meBUY ADMIN TUTORIAL — Logistics System ================================================================================ URL: http://localhost/mebuy/public/admin/logistics Access: Admin dashboard → Logistics sidebar link ================================================================================ 1. LOGISTICS DASHBOARD ================================================================================ Shows key metrics: • Total Shipments — All logistics shipments • In Transit — Currently in transit • Delivered — Completed deliveries • In China / In Transit — Shipments at Chinese warehouses or in transit • Revenue — Total revenue from logistics • China Shipments — Shipments from orders • Recent Shipments — Latest 10 shipments with quick actions ================================================================================ 2. SHIPMENTS ================================================================================ 2.1 Creating a Direct Shipment ────────────────────────────── Navigate to: Logistics > Shipments > Create New Shipment Step 1 — Sender Information: • Branch: Select origin branch (e.g., China-Guangzhou) • Sender Name, Phone, Address, City, Country Step 2 — Receiver Information: • Branch: Select destination branch (e.g., Accra-DC) • Receiver Name, Phone, Email, Address, City, Country Step 3 — Shipping Mark: • Enter a shipping mark (format: MEB-0000X0000000-GR) • This groups multiple packages together for the same customer • If the shipping mark exists, the customer is auto-linked Step 4 — Packages: • Select number of packages (1-10) • For each package, fill in: - Tracking Number — Manually entered (not auto-generated) - Shipping Method — Sea or Air - Container Rate — Select from predefined rates - Quantity — Number of units - Dollar Rate — Exchange rate (default: 15.5) - Weight (Air) — Required for Air shipping - Dimensions (Sea) — Length × Width × Height (auto-calculates CBM) - Service Type — Express / Standard / Economy - Package Description — What's in the package - COD Option — Cash on delivery (optional) Cost Calculation: • Sea: CBM = L×W×H/1,000,000 | Cost = qty × CBM × rate × dollarRate • Air: Cost = qty × weight × rate × dollarRate • All calculations happen in real-time as you type Step 5 — Submit: • Click "Save Shipment" • Each package becomes its own Shipment record • All share the same Shipping Mark 2.2 Viewing Shipments ────────────────────── Logistics > Shipments > All Shipments Filters available: • Search — Tracking number, shipping mark, sender/receiver name • Status — Filter by current status • Source — Direct / Order / Pre-Order • Shipping Method — Sea / Air Each row shows: Tracking #, Shipping Mark, Customer, Sender, Receiver, Method, Cost, Status, Source, Date 2.3 Shipment Detail ──────────────────── Click any shipment to view: • Status Timeline — Full history of status changes • Shipment Info — Tracking number, shipping mark, method, weight, CBM • Sender Info — Origin details • Receiver Info — Destination details • Items — Package items with tracking numbers • Packages — Associated packages • Warehouse Items — Storage records • Delivery Routes — Route history • Pickup — Pickup information • Invoice — Linked invoice • Payment — Payment status Actions: • Update Status — Move shipment through the logistics workflow Statuses: at_china_warehouse → china_loading → at_china_port → in_transit → heading_to_tema → at_tema_port → tema_clearance → heading_to_gh_warehouse → gh_warehouse_sorting → ready_for_pickup → out_to_branches → at_branch_warehouse → delivered → received_signed • Assign Driver — Assign a delivery driver • Generate Invoice — Create an invoice for this shipment • Create Pickup — Schedule a pickup • Edit — Modify shipment details • Delete — Remove shipment 2.4 Status Flow Explanation ──────────────────────────── The full logistics journey: CHINA LEG: at_china_warehouse → Goods arrive at China warehouse china_loading → Loaded onto container/vessel at_china_port → At Chinese port awaiting departure SEA TRANSIT: in_transit → Vessel is in transit GHANA ARRIVAL: heading_to_tema → Heading towards Tema Port at_tema_port → Arrived at Tema Port tema_clearance → Under customs clearance at Tema Port GHANA DISTRIBUTION: heading_to_gh_warehouse → Heading to Ghana warehouse gh_warehouse_sorting → Under sorting at Ghana warehouse ready_for_pickup → Ready for customer pickup out_to_branches → Out for delivery to branches at_branch_warehouse → At branch warehouse COMPLETED: delivered → Delivered to customer received_signed → Received and signed for CANCELLED: cancelled → Shipment was cancelled ================================================================================ 3. CONTAINER RATES ================================================================================ Navigate to: Logistics > Container Rates Container rates define shipping pricing for sea/air methods. 3.1 Creating a Rate ──────────────────── • Route: Select origin country → destination country • Rate Type: Sea or Air • Container Types: Select available container sizes (20ft, 40ft, etc.) and enter the rate for each • Base Rate: Default shipping rate • Per KG Rate: Additional rate per kilogram (for air) • Status: Active toggle 3.2 Managing Rates ──────────────────── • Edit — Modify rate details • Toggle Status — Activate/deactivate a rate • Delete — Remove a rate ================================================================================ 4. BRANCHES ================================================================================ Navigate to: Logistics > Branches Branches are physical locations in the logistics network. Key branches: • HQ-Tema — Head office at Tema • China-Guangzhou — China warehouse origin • Accra-DC — Accra distribution center • Kumasi-Hub — Kumasi regional hub • Takoradi-Port — Takoradi port branch Each branch has: name, code, city, country, phone, email, address, status. ================================================================================ 5. CUSTOMERS ================================================================================ Navigate to: Logistics > Customers Logistics customers are identified by their Shipping Mark. When a shipment is created with a new shipping mark, a customer record is auto-created. Features: • View all logistics customers • Search by name, phone, email, or shipping mark • Edit customer details • View customer's shipment history ================================================================================ 6. PICKUPS ================================================================================ Navigate to: Logistics > Pickups Pickups represent the collection of shipments from the warehouse for delivery. 6.1 Creating a Pickup ────────────────────── • Click "Create Pickup" • Select a shipment (only warehouse shipments without existing pickup) • Select customer and branch • Enter total amount and amount paid • Balance and payment status calculate automatically 6.2 Managing Pickups ────────────────────── • Search by pickup code or customer • Filter by status (pending/picked_up) or payment status • View pickup details ================================================================================ 7. REPORTS ================================================================================ The logistics dashboard provides: • Revenue tracking • Shipment volume by status • China vs direct shipment breakdown • Recent activity log