# HornDeliver

> HornDeliver is the on-demand delivery, errands and digital commerce platform
> for the Horn of Africa. One super-app unifies parcel pickup & delivery,
> in-app marketplace ordering, real-time tracking, dual wallets (debit + credit),
> in-app chat, subscriptions, advertising, merchant storefronts, courier
> earnings and an admin control center — as a mobile-first, offline-capable
> Progressive Web App.

HornDeliver is built and operated by Horn Digital Innovation. It serves four
user types — Customers, Drivers (couriers), Merchants (Providers) and Admins —
through a single installable PWA that works on low-end Android devices and
unreliable networks, with full offline mode powered by LocalStorage queues and
a service worker cache.

The platform's public marketing surface is at `https://HornDeliver.app/` and
explains the value proposition for senders, couriers and merchants. All
authenticated product modules live behind a hash route (`#/app/*`,
`#/admin/*`, `#/merchant/*`) and are not crawlable.

## Core modules (10)

1. **Dashboard** — role-aware home screen with quick actions, KPIs and the
   day's task queue.
2. **Order** — split into *Pickup & Delivery* (send anything from point A to
   point B with photo proof) and *in-app Order & Delivery* (browse merchant
   stores, place an order, have a courier deliver it).
3. **Tracking** — live map with courier ETA, status timeline and proof-of-
   delivery media.
4. **Wallets** — a *Debit wallet* (topped-up balance used to pay for orders)
   and a *Credit wallet* (courier/merchant earnings, withdrawable to Mobile
   Money).
5. **Message** — in-app chat between customer, courier and merchant with
   order context.
6. **Subscription** — premium plans for merchants and power users (lower
   commission, priority dispatch, advanced analytics).
7. **Advertising** — merchant-promoted listings and in-app ad slots managed
   by Admins.
8. **Profile** — verified identity, KYC/trust records, ratings, languages
   and devices.
9. **Settings** — notifications, security (2FA, sessions), privacy & data
   protection, language and appearance.
10. **Help & Supports** — in-app support, live chat, dispute center and
    knowledge base.

## User roles

- **Customer** — places orders, tracks deliveries, manages debit wallet.
- **Driver (Courier)** — accepts dispatches, completes pickups/deliveries,
  earns into the credit wallet, withdraws to Mobile Money.
- **Merchant (Provider)** — runs a digital storefront, fulfils in-app
  orders, runs advertising campaigns, subscribes to premium plans.
- **Admin** — verifies users, moderates disputes, manages services,
  commission rules, fraud flags, ads, stores and platform analytics.

## Languages

English, Amharic (አማርኛ), Arabic (العربية), Oromo (Afaan Oromoo), Somali
(Soomaali), Tigrinya (ትግርኛ), Afar (Qafar).

## Coverage

Ethiopia, Djibouti, Eritrea, Somalia and Somaliland — with Mobile Money
integration (Telebirr, CBE Birr, M-Pesa, Evol, Sahay, E-Dahab).

## Optional

- `/legal/terms` — Terms of Service
- `/legal/privacy` — Privacy Policy
- `/legal/data-protection` — Data Protection (GDPR-style)
- `/legal/support` — Support center
- `/manifest.json` — PWA manifest
- `/sitemap.xml` — XML sitemap
- `/robots.txt` — crawler policy