Logistics & Courier

ParcelNet

A full-stack courier platform that runs an entire parcel delivery network end to end: merchants book pickups, riders collect and deliver, branches and warehouses route packages between cities, and customers track their parcel live on a map. Six user roles across six separate portals, plus a native Android rider app.

Visit the live site

Loading live preview…

Live preview of parcelnet.kwingsmedia.com

Overview

ParcelNet is a complete production-style courier management product rather than a demo. It covers six user roles across six separate web portals, a native Android rider application, real-time GPS tracking, OTP-verified custody handovers and a deployed multi-domain server setup.

A parcel moves through a strictly validated state machine defined once in the backend and mirrored on the frontend, so both stay in sync. Illegal transitions are rejected at the API level — a shipment can only be cancelled before dispatch, and only an out-for-delivery parcel can be marked as a failed delivery.

What it does

Six portals, one platform

An admin console with full network control and a live map, branch portals scoped to the logged-in staff member, a warehouse WMS with bin-level storage, a merchant portal, the rider app and a public tracking page.

Automatic routing

When a parcel is created the system finds the nearest active branch to the receiver and chooses direct delivery if it falls inside that branch coverage radius, or a multi-leg via-warehouse route if not.

Merchant storefronts

Merchants run a hosted e-commerce storefront whose orders automatically become real, tracked parcels in the network.

Public live tracking

Customers follow their parcel on a live map with no login required, seeing status, branch names and a timeline.

Engineering highlights

OTP-verified custody transfers

Every change of hands is confirmed, not just clicked. Delivery is verified by an OTP emailed to the receiver; rider-to-branch handover uses a code branch staff generate on their own screen. The "just mark it received" bypass was deliberately removed.

GPS proof at every step

Pickup, handover and delivery each capture device coordinates and store them permanently against the event, so any parcel physical history can be audited on a map.

Security-conscious by default

Public tracking never exposes phone numbers, COD amounts, notes, staff GPS or rider identity. OTP failures return generic errors to prevent enumeration, and temp-password accounts are forced through a password change.

Zero paid third-party services

Address picking, geocoding and maps run on OpenStreetMap and Nominatim; distance routing happens inside PostgreSQL using the cube and earthdistance extensions.

More projects

Multi-Tenant SaaS