Live platform and first steps

The platform is live on helsen-med.com. This page lists every public address, says plainly what works today and what does not yet, and walks the operator through the first day. It ends with short quick-starts for buyers, sellers, drivers and dispatchers.

Live addresses

What works today, and what does not yet

First-day checklist for the operator

1. Sign in as the administrator. There is one super-admin account; its credentials are held by the team, never on this site. With the admin console not deployed, sign in through the Swagger UI: call POST /api/v1/auth/login, then use Authorize with the returned access token.
2. Turn on two-factor authentication for that account. Administrators must pass a second factor: until one is set up, every call other than signing in, signing out and enrolling is refused with auth.MFA_REQUIRED. Call POST /api/v1/auth/mfa/enroll, add the returned key to an authenticator app, confirm with POST /api/v1/auth/mfa/confirm and a current code. From then on, sign-in takes the password and a code (the mfaToken field of the login call).
3. Give each imported seller an owner account. Until a seller has an owner, its orders cannot be accepted. There is no screen or endpoint yet that attaches an owner to an existing seller (staff invitations create staff, not owners, and are emailed), so this is an open item for the team to settle before those products take real orders.
4. Correct the sellers' details and stock. The legal names and the warehouse address are placeholders. Warehouses and stock levels can be edited through the inventory endpoints; a seller's legal name has no edit endpoint after application, so that correction also needs the team. Set the real stock per variant — the opening figure of 25 is not a count.
5. Configure email. Set the email driver to SMTP with the provider's settings in the server environment and restart the API and worker (the runbook is in infra/deploy/README.md). Queued notifications then go out; codes in that backlog will long have expired, so users should ask for a fresh one. SMS and push follow the same pattern when accounts exist.
6. Review tax and shipping. Confirm Qatar 0% tax-inclusive, and the Standard and Express prices. The delivery windows (2–4 working days, next working day) were taken from the development defaults and have not been confirmed as a business decision — confirm them.
7. Check delivery zones and staff. Drivers are only assigned stops inside their delivery zones, so at least one zone must cover Qatar. Create a dispatcher account (grant the DISPATCHER role) and approve at least one test driver with a zone and a cash limit — see Delivery & drivers.
8. Install the APKs on test phones. Install the buyer, seller and driver APKs from the team (Android asks to allow installing apps from that source). Sign in with a password: SMS codes are not sent yet.
9. Place a test cash-on-delivery order and walk it end to end, on a product whose seller has an owner:
   • Buyer: sign in, add to cart, choose a Qatar address and a shipping method, pay cash on delivery.
   • Seller: accept the order group, pack it and mark it ready for pickup (seller web).
   • Dispatch: check the delivery task was created and assigned; assign by hand if needed (delivery web).
   • Driver: accept, pick up, go in transit, request the delivery code, enter the code the buyer reads from their in-app notifications, record the cash, complete.
   • Confirm the order shows as delivered to the buyer, and that the driver's cash appears for settlement.

Quick-starts

Buyer

1. Open helsen-med.com (or the buyer app) and choose Arabic or English.
2. Browse or search, pick a variant, add to cart. A guest cart is kept and merged when you sign in.
3. Create an account with email and password (choose Sign in with a password instead on the sign-in page) — email codes are not sent yet.
4. Check out: choose a delivery address in Qatar, a shipping method per seller, and cash on delivery.
5. Follow the order from your account. When the driver arrives, read them the delivery code from your notifications.

Seller

1. Sign in at seller.helsen-med.com or in the seller app.
2. Set up two-factor sign-in with an authenticator app — it is required before you can add a bank account.
3. Watch the order queue and accept new orders before their deadline; then pack and mark ready for pickup.
4. Keep stock and prices right. Details: Seller guide.

Driver and dispatcher

1. Driver: install the driver APK and sign in with email and password. Once approved you see your tasks and route; for each drop, request the delivery code, enter the code the recipient reads out, record cash on COD orders, and complete.
2. Dispatcher: sign in at delivery.helsen-med.com with a dispatcher account. Watch unassigned tasks, assign or rebuild routes when needed, manage shifts and record drivers' cash hand-ins.

When something does not behave as expected, see Troubleshooting & FAQ.