masaruk Logo

Open Questions & Assumptions

Unresolved questions, ambiguities, and assumptions identified during analysis

1. Purpose

This document records all unresolved questions, ambiguities, contradictions, and assumptions identified across the analysis of UI screens, business logic, APIs, and architecture. These items require explicit confirmation from the product owner before final implementation.

2. Taxation & Pricing Questions

2.1VAT Rate Discrepancy (15% vs 20%)

Where it appeared: 15% VAT shown in Booking Details; 20% VAT shown in Ad Campaign

Impact: Financial inconsistencies, Incorrect reports, Accounting/legal risks

Open Question: What is the official VAT rate for Bookings vs Advertising campaigns?

Assumption (temporary): Standard VAT = 15% (Saudi Arabia), unless advertising is intentionally taxed differently

2.2Currency Discrepancy (SAR vs $)

Where it appeared: Admin/Provider: SAR (ر.س); Mobile/Web: displayed as $ in several screens

Impact: User confusion, Incorrect pricing display

Open Question: Should all B2C experiences display SAR? Is USD intentional for international audiences?

Assumption (temporary): Core system currency = SAR. $ is placeholder from UI design

3. Booking & Cancellation Logic

3.1Missing Cancellation Flow in Admin

Where it appeared: Admin إدارة الحجوزات screen has no cancellation action

Open Question: How does an Admin cancel a booking? Does cancellation automatically trigger refund?

Assumption (temporary): Cancellation is triggered in Booking Details (not implemented in UI yet)

3.2Refund Policy Confirmation

Where it appeared: Detailed refund percentages shown in Trip Details (Mobile/B2C)

Open Question: Are these fixed global rules? Or per-provider policies?

Assumption (temporary): Refund rules are global unless defined otherwise

4. Ad Campaigns Logic

4.1'منتهية / منبهه / منتبهة' Label Ambiguity

Where it appeared: Admin إدارة الإعلانات table, pink badge text unclear

Open Question: What is the exact Arabic label for expired campaigns?

Assumption (temporary): Intended label is 'منتهية' (Expired)

4.2Ad Payment Flow Unclear

Where it appeared: Ad campaign creation shows payment summary but no payment screen captured

Open Question: Does ad campaign payment use the same gateway as bookings?

Assumption (temporary): Same payment flow (HyperPay/STC Pay) used

5. UI/UX Ambiguities

5.1Login Field Discrepancy

Where it appeared: Login screen shows 'الاسم بالكامل' instead of email/phone

Open Question: Should login accept email or phone number?

Assumption (temporary): Login uses email (or phone) as per FR-Auth-02

5.2Placeholder Mismatches in Forms

Where it appeared: عدد الليالي placeholder shows 'ادخل رقم الهوية/الإقامة'

Open Question: Is this a UI bug or intentional?

Assumption (temporary): UI bug - will be fixed in development

5.3Search Placeholder in Arabic/English

Where it appeared: Mobile search bar shows 'Search' in English

Open Question: Should placeholder be localized to Arabic?

Assumption (temporary): All UI should be Arabic-first (RTL)

6. Technical Questions

6.1Hotel Star Rating Range

Where it appeared: Hotels table shows 1-7 stars

Open Question: Why 7 stars? Standard is 1-5

Assumption (temporary): 7-star hotels exist in Saudi Arabia (luxury category)

6.2Rating Submission Trigger

Where it appeared: Rating flow appears after completed trip

Open Question: Is push notification mandatory? What's the time window?

Assumption (temporary): Push notification sent 24h after trip end

7. Resolved Questions (2026-02-01)

R-1Platform Settings Module Specification ✅ CLOSED

RESOLVED: Created analysis/04-functional-spec/platform-settings-module.md as SSOT for VAT/Pricing, Support settings, Legal info, and Payment methods.

Resolution Status

All items must be resolved before production release.