Business Pilot Manual

How to put real businesses in Hargeisa on the map, step by step.

Goal: 20 real businesses on the map, each one checked by staff. The words are kept simple. Somali and Arabic screens are still English only.

Who does what

PersonRole neededDoes
Invite senderTerratech editor or higherSends the invites
Business ownerAny Google accountFills the form
ReviewerTerratech reviewer or higherApproves or rejects
Four-eyes rule: a reviewer cannot approve a business they created themselves.

Part 1Send an invite Editor

  1. Open the web map and sign in.
  2. Open the Account menu and tap Invite a business.
    Account menu on a phone. A red ring marks the Invite a business button.
    The Account menu. Tap the ringed button.
  3. Fill in: business name, phone number, a place note (for example "near Jamhuuriya Hotel"), and the language of the message.
  4. Optional: put a pin on the shop.
  5. Tap Make invitation.
    The Invite a business form with the name, phone and place filled in. A red ring marks the Make invitation button.
    The form with made-up data. Tap the ringed button.
    The screen shows a link, a QR code and a Send on WhatsApp button. The code is shown only once. Copy the link now.
  6. Tap Send on WhatsApp. WhatsApp opens with the message ready. Press send yourself. Send one at a time.
    The invitation result. A red ring marks the Send on WhatsApp button under the invitation link.
    The result. The phone number here is made up.
  7. The invite list shows the state: Not sent Sent Opened Registered Approved Expired Cancelled
  8. A wrong invite? Tap Cancel invitation in the list.
Rules: an invite is valid for 30 days and works for one business only. 5 wrong tries block the link for 1 hour.

Part 2Add the business Owner

  1. Open the link from WhatsApp (or scan the QR code).
  2. Tap Sign in with Google.
  3. The form is already filled with the name and phone. Check it.
  4. Fill in: category, phone, WhatsApp, opening hours, short description, address note.
  5. Put the pin on the exact shop door.
  6. Add 1 to 5 photos (not required).
  7. If a warning says a similar business is near, tap This is mine or Different place.
  8. Tap Send for review. The state becomes Waiting for review. Save draft keeps it private: nobody else can see a draft.
    The owner form on a phone. A red ring marks the Send for review button.
    The owner form. The Send for review button stays at the bottom.

Later, open My businesses to see the state. If it is Rejected, the reason is shown. Fix it and submit again.

The My businesses list showing Sample Tea Shop with the state Waiting for review, marked by a red ring.
My businesses. The ringed label is the state.

Part 3Review Reviewer

  1. Sign in, open Staff, then the Businesses tab.
  2. Open a card. Check: name, category, phone, photos, pin on the map, and the list of near duplicates.
    A staff review card for Sample Tea Shop. A red ring marks the Mark as verified tick box.
    A review card. The ringed box is Mark as verified.
  3. Tap Approve. Tick Verified only if you have checked the business is real (call, visit or see the shop).
  4. Or tap Reject and choose a reason: wrong place, duplicate, not a business, bad photo, wrong phone, other. Add a note. A reason is required.
    The reject reasons: Wrong place, Duplicate, Not a business, Bad photo, Wrong phone, Other, with the reason box and the Reject and Approve buttons. A red ring marks the reason buttons.
    Quick reasons, the reason box, then Reject or Approve.
  5. Hide removes an approved business from the public map. It can be shown again.

Part 4Check it is public

  1. Open the web map. In Layers, tick Businesses. Important categories show from zoom 12, all from zoom 15.
    The Map layers panel. A red ring marks the ticked Businesses row.
    Layers. Tick Businesses.
  2. Tap a pin. The popup shows Open page, Directions, Share, Call, WhatsApp.
    The popup of Sample Tea Shop with Open page, Directions and Share. A red ring marks Open page.
    The pin popup. Tap the ringed button.
  3. Open the page /b/<short id>. It must show the name, hours and photos. The phone number is only on the page buttons, not in the page source tags.
    The public page of Sample Tea Shop with Call and WhatsApp buttons. A red ring marks them.
    The public page. The ringed buttons are Call and WhatsApp.
  4. Share the link by WhatsApp and check the preview card.

Problems

ProblemWhat to do
The invite link says not foundIt is wrong, used, expired, cancelled or blocked. Make a new invite.
The owner cannot sign inUse a Google account. Try again in a normal browser, not inside WhatsApp.
Business not on the mapIt is not approved yet, or Businesses is not ticked in Layers.
Wrong pinThe owner edits the business. The old version stays public until a reviewer approves the change.
Spam or wrong phone reportedReports are on the review screen. Hide the business, then decide.

Pilot checklist

Based on docs/BUSINESS-PILOT-GUIDE.md. Standards: WhatsApp click-to-chat (wa.me) for invites; Google sign-in (OpenID Connect).