Screen Inventory (MVP)¶
Complete screen list per app for the MVP launch in Kuwait, plus the Scale screens already known so navigation is designed with room for them. Every screen exists in Arabic (RTL) and English (LTR). Detailed specs for the eight highest-stakes screens are in Key Screens.
Conventions: SRS ref points to the owning requirements module (e.g. RFQ → RFQ module). Phase = MVP / Scale / Vision. Customer screens ship on web (Next.js) and mobile (Flutter) unless noted; Vendor ships mobile-first with full web parity; Admin is web-only.
Customer app (~32 screens)¶
| # | Screen | Purpose | Primary actions | SRS ref | Phase |
|---|---|---|---|---|---|
| C01 | Splash / launch | Brand moment, session bootstrap, locale detection | — (auto-routes) | AUTH | MVP |
| C02 | Onboarding carousel | 3 slides: what Yam3at is, trust promise, language choice | Choose language, Skip, Get started | AUTH | MVP |
| C03 | Sign up | Create account via email, phone, Google, Apple | Sign up, switch to Login | AUTH | MVP |
| C04 | Login | Returning-user auth, social buttons, biometric re-entry (mobile) | Log in, Forgot password | AUTH | MVP |
| C05 | OTP verification | Verify phone (or email code) during signup/login | Enter code, Resend (cooldown) | AUTH | MVP |
| C06 | Forgot / reset password | Recover account via email or SMS | Send link/code, Set new password | AUTH | MVP |
| C07 | Complete profile | Name, preferred language, city after social signup | Save & continue, Skip | AUTH | MVP |
| C08 | Home | Inspire + resume: active event card, pending quotes, categories, featured vendors | Search, open category, resume event/RFQ | MKT | MVP |
| C09 | Category listing | Browse vendors within one category (e.g. قاعات / Venues) | Filter, sort, open vendor | MKT | MVP |
| C10 | Search results | Keyword + filtered vendor discovery (Meilisearch) | Refine filters, open vendor, save favorite | MKT | MVP |
| C11 | Filters sheet | Budget range, city/area, rating, category, availability date | Apply, Reset | MKT | MVP |
| C12 | Vendor profile | Vendor storefront: gallery, services, packages, reviews, policies | Request quote, Message, Favorite, Share | LST | MVP |
| C13 | Service / package detail | Full description, pricing, inclusions of one catalog item | Request quote (pre-filled), back to profile | LST | MVP |
| C14 | Gallery viewer | Full-screen swipeable photos/videos | Swipe, zoom, close | LST | MVP |
| C15 | Reviews list | All reviews of a vendor with rating breakdown | Filter by rating, report review | REV | MVP |
| C16 | Create event wizard | Name, type, date, city, guest count, budget → creates the Event container | Next/Back, Create event | EVT | MVP |
| C17 | Events list | All my events (upcoming, past) | Open event, create event | EVT | MVP |
| C18 | Event dashboard | Single-event hub: budget vs committed, RFQs, quotes, bookings, messages | Add vendors (new RFQ), open quotes/bookings | EVT | MVP |
| C19 | RFQ wizard — steps 1–4 | Compose a multi-vendor request: details → requirements → budget/attachments → vendor selection → review | Next/Back, Save draft, Send RFQ | RFQ | MVP |
| C20 | RFQ list & detail | Track sent RFQs and statuses (Draft…Expired) | Open quotes, cancel RFQ, nudge/resend | RFQ | MVP |
| C21 | Quote compare | Side-by-side comparison of quotes received for one RFQ | Accept, Negotiate (message), Reject | RFQ | MVP |
| C22 | Quote detail | One quote in full: line items, validity, terms, vendor card | Accept, Message vendor, Reject | RFQ | MVP |
| C23 | Booking summary | Pre-payment review: scope, dates, deposit vs remaining, cancellation policy | Proceed to payment, edit details | BKG | MVP |
| C24 | Checkout / payment | Pay deposit or balance via KNET, card, Apple Pay, Google Pay | Select method, Pay | PAY | MVP |
| C25 | Payment result | Success/failure state with receipt and next steps | View booking, Retry, Download receipt | PAY | MVP |
| C26 | Bookings list | All bookings across events, filterable by status | Open booking | BKG | MVP |
| C27 | Booking detail | Status, payments, vendor contact, policy, refund request | Message vendor, Request refund/cancel | BKG | MVP |
| C28 | Messages inbox | All conversations, grouped, unread badges | Open thread, search | MSG | MVP |
| C29 | Chat thread | Text/image/PDF messaging with a vendor, RFQ/booking context pinned | Send, attach, view quote/booking | MSG | MVP |
| C30 | Notifications center | Push/email event feed in-app | Open target, mark read | MSG | MVP |
| C31 | Favorites | Saved vendors | Open vendor, remove | REV | MVP |
| C32 | Write review | Rate + review a completed booking | Submit review, add photos | REV | MVP |
| C33 | Profile & settings | Personal info, language, notification prefs, payment history, delete account | Edit, switch language, logout | AUTH | MVP |
| C34 | CMS pages | About, Terms, Privacy, FAQ, Help | Read, contact support | ADM | MVP |
| C35 | Planner suite (budget, checklist, guest list, timeline) | Deep event-planning tools inside the event dashboard | Add items, track | EVT | Scale |
| C36 | Wallet | Stored balance, refunds-to-wallet, promo credits | Top up, view transactions | PAY | Scale |
Vendor app (~22 screens)¶
| # | Screen | Purpose | Primary actions | SRS ref | Phase |
|---|---|---|---|---|---|
| V01 | Vendor landing / value pitch | Convert businesses: plans, benefits, social proof | Start registration, Login | VOS | MVP |
| V02 | Registration wizard — business info | Legal name (ar/en), category, city, contacts | Next, Save draft | VOS | MVP |
| V03 | Registration wizard — license upload | Commercial license number + document upload, signatory info | Upload, Next | VOS | MVP |
| V04 | Registration wizard — plan selection | Choose Free/Basic/Professional/Enterprise, see limits | Select plan, Pay (if paid) | VOS | MVP |
| V05 | Pending approval | Post-submission holding state with status and edit access | Edit submission, Contact support | VOS | MVP |
| V06 | Vendor dashboard | Triage home: new RFQs, expiring quotes, today's bookings, revenue snapshot | Open RFQ inbox, respond, view bookings | VOS | MVP |
| V07 | Business profile editor | Public storefront content: descriptions (ar/en), logo, location, hours, policies | Save, Preview as customer | LST | MVP |
| V08 | Listings / services list | Manage catalog of services & packages | Add, edit, activate/deactivate | LST | MVP |
| V09 | Listing editor | Create/edit a service: name (ar/en), description, price-from, inclusions | Save, publish | LST | MVP |
| V10 | Gallery manager | Upload/reorder photos & videos, set cover | Upload, reorder, delete | LST | MVP |
| V11 | RFQ inbox | Incoming quote requests, prioritized by fit and expiry | Open RFQ, decline | RFQ | MVP |
| V12 | RFQ detail | Full customer requirement: event, date, budget band, attachments | Create quote, Message, Decline | RFQ | MVP |
| V13 | Quote composer | Build a quote: line items, discounts, validity, terms, attachments | Send quote, Save draft | RFQ | MVP |
| V14 | Quotes sent list | Track quote statuses (Pending, Negotiating, Accepted…) | Open, revise, withdraw | RFQ | MVP |
| V15 | Bookings list & detail | Confirmed work: schedule, payment status, customer contact | Mark completed, Message customer | BKG | MVP |
| V16 | Messages inbox & thread | Same messaging engine as customer, vendor context | Reply, attach, quick replies | MSG | MVP |
| V17 | Reviews | Received reviews with public-reply capability | Reply, report abuse | REV | MVP |
| V18 | Subscription & billing | Current plan, usage (quotes used/limit), invoices, upgrade | Upgrade/downgrade, pay renewal, download invoice | VOS | MVP |
| V19 | Analytics | Profile views, RFQ→quote→booking funnel, response time (depth gated by plan) | Change period, export (Pro+) | VOS | MVP |
| V20 | Vendor settings & notifications | Team contact info, notification prefs, language | Save | VOS | MVP |
| V21 | Availability calendar | Manage bookable dates; blocks reflected in search; Google Calendar sync | Block/unblock dates, sync | LST | Scale |
| V22 | Team members | Invite staff with roles (Enterprise plan) | Invite, set role, remove | VOS | Scale |
Admin panel (~17 screens)¶
| # | Screen | Purpose | Primary actions | SRS ref | Phase |
|---|---|---|---|---|---|
| A01 | Admin login (+2FA) | Secure staff access | Log in, verify 2FA | ADM | MVP |
| A02 | Overview dashboard | Platform KPIs: registrations, revenue, RFQ volume, pending queues | Jump to queues | ADM | MVP |
| A03 | Vendor approval queue | Review registrations & license documents | Approve, Reject (with reason), Request changes | VOS | MVP |
| A04 | Vendors list & detail | Full vendor record: profile, plan, quotes, bookings, flags | Suspend, edit plan, impersonate-view | ADM | MVP |
| A05 | Customers list & detail | Customer accounts and activity | Suspend, reset access, view events | ADM | MVP |
| A06 | Categories manager | Marketplace taxonomy (ar/en names, icons, ordering) | Add, edit, reorder, deactivate | MKT | MVP |
| A07 | Listings moderation | Review flagged/new listings and galleries | Approve, unpublish, warn vendor | LST | MVP |
| A08 | RFQ & quotes oversight | Monitor RFQ flow health, policy compliance (e.g. off-platform contact) | Open records, flag, annotate | RFQ | MVP |
| A09 | Bookings oversight | All bookings, dispute entry point | Open booking, initiate refund flow | BKG | MVP |
| A10 | Payments & refunds | PSP transactions, refund requests queue, reconciliation | Approve/deny refund, retry, export | PAY | MVP |
| A11 | Subscription plans manager | Configure plan pricing/limits/features per country | Edit plan, schedule change | VOS | MVP |
| A12 | Reviews moderation | Reported or auto-flagged reviews | Keep, remove (with reason), warn user | REV | MVP |
| A13 | CMS editor | Static pages, FAQ, home banners in both languages | Create/edit/publish page | ADM | MVP |
| A14 | Notifications & announcements | Compose platform announcements (email/push) to segments | Draft, schedule, send | MSG | MVP |
| A15 | Reports | Revenue, growth, conversion, category performance | Filter period, export CSV | ADM | MVP |
| A16 | Admin users & roles | Staff accounts, role-permission matrix | Invite, assign role, deactivate | ADM | MVP |
| A17 | Audit log | Immutable record of admin and sensitive system actions | Search, filter, export | ADM | MVP |
| A18 | Promo codes & campaigns | Discount codes, referral configuration | Create code, set rules, expire | ADM | Scale |
Cross-cutting screen requirements¶
Every screen above must define, before build:
- Four states: loading (skeleton), empty (warm + directive), error (retryable), success/content — see Design Principles §6.
- Both directions: RTL Arabic and LTR English pass the RTL testing checklist.
- Auth & permission behavior: what a logged-out user sees (customer web screens C08–C15, C34 are public and indexable; everything else gates).
- Deep-link target: every push notification and email must land on a specific screen with context (e.g. quote received → C22).
Total MVP surface: ~32 customer + ~20 vendor + ~17 admin ≈ 69 screens, of which the eight in Key Screens carry the majority of conversion and trust risk and are specified first.