Skip to main content

Overview

WHOT is an iOS-first, two-player card game platform built around the Nigerian game of Whot. The MVP combines live gameplay with invite-only distributor-customer onboarding and moderated encrypted chat for entitled pairs.

Current Product Scope​

AreaCurrent position
GameplayTwo-player gameplay with invite flow, authoritative rules, reconnect support, and scoreboards
IdentityAuthentication, distributor provisioning, customer identity, and JWT claims
RelationshipsDistributor-customer invites, assignments, and entitlement checks
ChatModerated encrypted one-to-one chat with receipts, archive retention, legal hold, and audited review
ClientsSwiftUI iOS shell plus internal staff-console shell

Handover Posture​

The current MVP is materially implemented and suitable for product review and continued engineering work. It is not yet production-complete: the remaining launch work includes managed PostgreSQL, production infrastructure, hosted secret management, complete iOS flows, monitoring dashboards, scheduled archive-expiry jobs, and final release assets.

Current state versus target state

Where this handbook distinguishes between current state and target state, current state reflects what is implemented in the repository today. Target state reflects the documented production destination.

  1. System Architecture
  2. Infrastructure
  3. Database Schema
  4. API Documentation
  5. Authentication
  6. Security Notes
  7. Deployment
  8. Backup and Recovery
  9. Future Recommendations

Core Product Positioning​

WHOT uses moderated encrypted chat, not end-to-end encryption. Messages are protected in transit and at rest while authorized staff access remains possible under documented moderation, support, legal, and safety workflows.

Documentation Coverage​

This handbook consolidates the repository's cross-service specs, service READMEs, service-level design documents, release notes, review reports, game rules, and operations guidance. The original authored documents are retained in the appendix for traceability and raw-Markdown reuse.