Complete TSD coverage
All 5 modules. Every requirement. Itemised.
Everything below is in scope. Nothing is a roadmap item or separate charge.
AAmbassador Mobile Application12 items
✓8-step compliance check flow — sequential, step-level validation, no skip permitted
✓Rider search by ID linked to HungerStation WMS — name, 3PL, vehicle type, last check. Not found: FTR flag.
✓Live photo enforcement: camera-only, EXIF 60-second window, Laplacian blur, MD5 dedup, anti-screenshot
✓GPS captured at photo shutter AND at submit — both stored. >200m discrepancy auto-flags for Crystal.
✓KSA GPS bounding box (lat 16.0–32.5, lon 36.0–56.5) — out-of-range flags check and notifies Team Leader
✓Impossible movement detection — two checks >5km apart within 3 minutes auto-flagged
✓AES-256 offline storage — 200 checks capacity, auto-sync on reconnect, timestamps immutable
✓Daily check counter X/60, progress bar (red→amber→green), push notification at 50 checks
✓Arabic RTL UI — full mobile app. Boolanga provides all Arabic translations.
✓Ambassador mobile dashboard: counter, KPI score and tier, pending coaching tasks, last 10 checks
✓AI visual scoring Steps 04/05/06 — uniform, branding, safety gear from single proof photoAI
✓Phase 2 city config — Mecca, Medina, Eastern Province, Abha, Al Ahsa, QP — config only, no re-engineering
BIncident & Emergency Response10 items
✓RiderCare bidirectional integration (8001111717) — webhook + API, real-time event-driven
✓Live dispatch map — all ambassadors as GPS pins, 30-second refresh, names and availability visible
✓One-tap dispatch — push to ambassador instantly. 60-second accept/decline window, auto-reoffer.
✓15-minute on-scene SLA timer visible on agent screen from dispatch time
✓L1 (serious injury/fatality): 911 required, RiderCare mandatory, HSS Asst Manager + Ops Director same day
✓L2 (minor accident/breakdown): on-scene ≤15 min, Najm 920002020 if needed, report within 24 hours
✓L3 (non-cooperation/violation): photo/video documentation, coaching call, Team Leader notified
✓L1/L2 incident report: rider condition, 2+ photos, GPS auto-captured, Najm reference, 24h deadline
✓Push escalation to Team Leader and HSS within 5 seconds for L1/L2 incidents
✓FMS API integration — real-time GPS feed for dispatch map, 30-second refresh
CField Intelligence & Reporting6 items
✓Voice of the Rider: morale 1–5, satisfaction 1–5, top challenge dropdown + free text — min 1/week enforced
✓Vendor-Side Issues: vendor, issue type, severity Low/Medium/High, mandatory photo — auto-push on High
✓Street & Field Reporting: TL-activated, road closure Y/N, congestion 1–5, reroute + map pin
✓Daily Operational Log: mandatory end-of-shift, auto-filled check count, incident/coaching/FTR fields
✓All 4 forms count toward ambassador monthly Report Quality KPI score
✓Non-submission within 30 min of shift end: flag to Team Leader + reduces valid submission count
DKPI Scoring & Incentive Engine13 items
✓Automated 4-pillar monthly KPI calculator — zero manual intervention
✓Checks Completed (50 pts): (actual ÷ 1,560) × 50 — proportional, capped at 50
✓Report Quality (20 pts): ≥95% = 20 pts; each 1% below 95% = −2 pts; below 85% = 0
✓Proactive Escalations (15 pts): 2+ HSS-validated = 15; 1 = 8; 0 = 0
✓Violation Detection (15 pts): 5+ = 15; 3–4 = 10; 1–2 = 5; 0 = 0
✓Deductions: SAR 4/missed check (auto); SAR 15/Crystal-confirmed invalid — never on flag alone
✓Vehicle incident: 30% base + 50% incentive/month, spread max 3 months — HR + Fleet confirmation required
✓Minimum payout SAR 0 — deductions cannot result in negative payout
✓Incentive brackets: Platinum SAR 1,200 / Gold SAR 900 / Silver SAR 650 / Bronze SAR 400 — auto-assigned
✓TL composite: 60% team avg + 25% eligibility + 15% weekly reports on time — TL read-only
✓HSS Management Dashboard: cross-city aggregate, city comparison, FTR map, payout projection, alerts
✓Data export to Excel (.xlsx) + Google Sheets API v4 — Admin and HSS Asst Manager only
✓HSS Asst Manager manual override with immutable audit log entry per override
ECompliance Audit — Crystal Team10 items
✓Crystal validation queue: sorted oldest first, per row shows ambassador, city, rider ID, timestamp, GPS, photo, flags
✓Actions: Approve / Reject (reason mandatory) / Flag — batch approve/reject available
✓SAR 15 only after Crystal manual confirmation — never automatically on flag alone
✓48-hour SLA: all submitted checks reviewed within 48 hours
✓Auto-detection: duplicate GPS within 10m/5min by same ambassador
✓Auto-detection: MD5 photo hash match across all submissions
✓Auto-detection: speed anomaly, sequential checks <90 seconds, EXIF age >60s
✓Coaching call auto-task per violation in Steps 02/04/05/06 — ambassador notified with violation type
✓Coaching outcome logging: Completed / No answer / Refused / Accepted. 24h non-completion → auto-escalate to TL.
✓WMS API read-only — on-demand at Step 01, 4-hour cache refresh, offline manual fallback
+Platform Infrastructure & Security12 items
✓5-role RBAC enforced at API and database level — cross-role access impossible at system level (P0 critical)
✓SSO with HungerStation IDP + 2FA mandatory for HSS Manager and Admin
✓AES-256 at rest, TLS 1.3 in transit, signed photo URLs 1-hour expiry, no predictable paths
✓Immutable audit logs — 2-year retention, all submissions/edits/exports/deductions/overrides
✓External pen test — all Critical/High resolved before go-live, report to HungerStation CISO
✓12 mandatory P0/P1 automated test cases validated before go-live authorisation
✓Push: FCM full on Android · in-app alerts on iOS. L1/L2 delivery confirmation required.
✓KSA-resident hosting — 100% KSA, PDPL + NDMO compliant, Data Residency Attestation Letter pre-signature
✓Performance: submission <5s on 4G; dashboard <3s; 3,600+ submissions/day without degradation
✓Helmi AI API integration — Steps 04/05/06, auto-fallback to manual on API unavailabilityAI
✓Training: 60 ambassadors, 2 Team Leaders, HSS management — proficiency test before go-live
✓Arabic RTL implementation — Boolanga provides all translations
Not included in this proposal
✗Native iOS and Android apps — available as a Year 2 engagement
✗Direct HR/payroll API — incentive/deduction data exportable to Excel/Sheets for HS payroll
✗PDPL legal advisory — Boolanga provides KSA hosting certificate; legal consultation not included