PRD & Product Specsوثيقة متطلبات المنتج والمواصفات

Haqqi (حقّي) is a UAE legal-services marketplace: a free bilingual AI assistant explains the law with citations and turns a person’s problem into a structured case brief; by fair rotation the brief reaches 2–3 qualified licensed professionals in the client’s emirate, who send fixed-price offers; the client pays through Haqqi’s checkout while a licensed payment provider holds the funds and releases them to the law firm milestone by milestone.

حقّي منصة إماراتية للخدمات القانونية: مساعد ذكي مجاني ثنائي اللغة يشرح القانون مع ذكر المواد والمصادر، ويحوّل مشكلة الشخص إلى ملخص قضية منظَّم؛ ثم يصل الملخص بنظام التدوير العادل إلى اثنين أو ثلاثة من المهنيين المرخَّصين المؤهَّلين في إمارة العميل، فيرسلون عروضًا بأسعار ثابتة؛ ويدفع العميل عبر صفحة الدفع في حقّي، بينما يحتجز مزوّد دفع مرخَّص المبالغ ويحرّرها لمكتب المحاماة مرحلةً بعد مرحلة.

Visionالرؤية

Every resident of the UAE, in Arabic or English, can understand their legal position in minutes and hire the right licensed professional at a known price, with their money protected until the work is delivered.

أن يتمكّن كل مقيم في دولة الإمارات، بالعربية أو الإنجليزية، من فهم وضعه القانوني خلال دقائق، وتوكيل المهني المرخَّص المناسب بسعر معلوم، مع حماية أمواله حتى تسليم العمل.

Problemالمشكلة

• Opaque price and quality. Clients cannot compare fees or scope before engaging a firm; most first contacts are by phone or WhatsApp with no written scope.
• غموض الأسعار والجودة. لا يستطيع العميل مقارنة الأتعاب أو نطاق العمل قبل التعاقد مع المكتب، وتتم معظم التواصلات الأولى هاتفيًا أو عبر واتساب دون نطاق عمل مكتوب.
• Wrong professional. Many people do not know that only advocates on the roll may appear in court or before rental and tax committees, while legal consultants handle non-judicial work [1, 2].
• اختيار المهني الخطأ. كثيرون لا يعلمون أن المحامين المقيَّدين في الجدول وحدهم يحق لهم الترافع أمام المحاكم ولجان الإيجار والضرائب، وأن المستشار القانوني يقتصر عمله على الأعمال غير القضائية [1, 2].
• High volume, low-ticket demand. MoHRE handled about 188,000 labour disputes in H1 2026 [3], and Dubai’s Rental Disputes Centre registered 103,975 lawsuits in nine years [4]. Free government services are means-tested or one-off [5].
• طلب كبير بقيمة منخفضة لكل حالة. تعاملت وزارة الموارد البشرية والتوطين مع نحو 188,000 نزاع عمالي في النصف الأول من 2026 [3]، وسجّل مركز فض المنازعات الإيجارية في دبي 103,975 دعوى خلال تسع سنوات [4]. أما الخدمات الحكومية المجانية فمشروطة بالدخل أو تُقدَّم لمرة واحدة [5].
• Fear of paying up front. Clients pay retainers before seeing any output; there is no neutral holding of funds and no structured dispute path.
• الخوف من الدفع المسبق. يدفع العميل الأتعاب قبل أن يرى أي نتيجة، ولا توجد جهة محايدة تحتجز المبالغ ولا مسار منظَّم للاعتراض.
• Language and expat reality. About 88% of residents are expatriates [6]; legal information is scattered and mostly not plain-language.
• واقع اللغة والوافدين. نحو 88% من السكان وافدون [6]، والمعلومة القانونية متفرقة ونادرًا ما تُقدَّم بلغة مبسَّطة.

Solutionالحل

Goals and non-goalsالأهداف وما يخرج عن النطاق

Success metricsمقاييس النجاح

Phase 1 vs Phase 2 at a glanceالمرحلة 1 مقابل المرحلة 2 بإيجاز

Haqqi serves three sides: people and companies with a legal need, licensed professionals working through licensed firms, and Haqqi’s own operations team. The contracting partner is always the firm; individual advocates and consultants are members of it (Art. 61) [1].

تخدم حقّي ثلاثة أطراف: الأفراد والشركات أصحاب الحاجة القانونية، والمهنيين المرخَّصين العاملين عبر مكاتب مرخَّصة، وفريق التشغيل في حقّي. والطرف المتعاقد من جهة الشركاء هو المكتب دائمًا، ويكون المحامون والمستشارون أعضاءً فيه (المادة 61) [1].

Roles and permissionsالأدوار والصلاحيات

Persona cardsبطاقات الشخصيات

Rahul, 34 · Dubaiراهول، 34 عامًا · دبي

Expat engineer; employer withheld end-of-service gratuityمهندس وافد؛ امتنع صاحب العمل عن صرف مكافأة نهاية الخدمة

• Understand if he has a claim and the deadline, in English, tonight.
• أن يعرف إن كان له حق ومتى تنتهي المهلة، بالإنجليزية، الليلة.
• Know the cost before talking to anyone.
• أن يعرف التكلفة قبل الحديث مع أي أحد.
• Pay only when he sees work.
• ألّا يدفع إلا حين يرى عملًا.

Mariam, 41 · Abu Dhabiمريم، 41 عامًا · أبوظبي

Emirati; custody and inheritance questionsمواطنة؛ أسئلة في الحضانة والميراث

• Get a discreet, Arabic-first answer with the exact article.
• أن تحصل على إجابة سرّية بالعربية أولًا مع نص المادة.
• Choose a female advocate in her emirate.
• أن تختار محامية في إمارتها.
• Keep documents in one private place.
• أن تحفظ مستنداتها في مكان خاص واحد.

Layla · Sharjah SMEليلى · منشأة في الشارقة

HR and admin manager, 40-staff trading companyمديرة موارد بشرية وإدارة في شركة تجارية من 40 موظفًا

• Have contracts reviewed in 48 h at a fixed price.
• مراجعة العقود خلال 48 ساعة بسعر ثابت.
• Track all matters and spend in one dashboard.
• متابعة جميع القضايا والمصاريف في لوحة واحدة.
• Replace ad-hoc firms with a retainer (Business plan).
• استبدال المكاتب المتفرقة باشتراك دائم (باقة الأعمال).

Sara · Advocate, Dubaiسارة · محامية، دبي

Partner at a 6-lawyer Emirati firmشريكة في مكتب إماراتي من 6 محامين

• Receive qualified, pre-briefed matters without chasing leads.
• تلقّي قضايا مؤهَّلة وملخَّصة دون مطاردة العملاء.
• Get paid reliably once work is accepted.
• ضمان تحصيل أتعابها بمجرد قبول العمل.
• Log filings and receipts so clients stop calling.
• تسجيل الإجراءات والإيصالات حتى يتوقف العملاء عن الاتصال.

Omar · Legal consultantعمر · مستشار قانوني

Consultant at an international firm in Dubaiمستشار في مكتب دولي في دبي

• Answer written questions fast with an AI first draft and citations.
• الإجابة عن الأسئلة المكتوبة بسرعة بمسودة أولى ذكية مع الاستشهادات.
• Run company retainers with clear hour meters.
• إدارة اشتراكات الشركات بعدّادات ساعات واضحة.
• Refer court matters to an advocate without losing the client relationship.
• إحالة القضايا القضائية إلى محامٍ دون خسارة علاقته بالعميل.

Hana · Haqqi operationsهناء · عمليات حقّي

Ops, support and finance team (5–8 people at launch)فريق العمليات والدعم والمالية (5 إلى 8 أشخاص عند الإطلاق)

• See every stuck brief and assign it in one click.
• رؤية كل ملخص متعثّر وإسناده بنقرة واحدة.
• Verify a partner licence in under 10 minutes.
• التحقق من ترخيص الشريك في أقل من 10 دقائق.
• Prove fairness and compliance with exportable logs.
• إثبات العدالة والامتثال بسجلات قابلة للتصدير.

Four surfaces share one design system and one API: the public website, the client app, the partner app (lawyer, consultant, firm) and the admin console. All are built with Expo Router, so the same route tree serves iOS, Android and web.

تتشارك أربع واجهات نظام تصميم واحدًا وواجهة برمجية واحدة: الموقع العام، وتطبيق العميل، وتطبيق الشريك (المحامي والمستشار والمكتب)، ولوحة الإدارة. وكلها مبنية بـ Expo Router، فتخدم شجرة المسارات نفسها iOS وAndroid والويب.

Site mapخريطة الموقع

Navigation per roleالتنقّل حسب الدور

Each workflow below is the contract between product, design and engineering. Timers run on Cloud Tasks; every state change emits a Pub/Sub event (section 9) and an audit record.

كل مسار أدناه هو العقد المشترك بين فرق المنتج والتصميم والهندسة. تعمل المؤقّتات عبر Cloud Tasks، وكل تغيير في الحالة يُطلق حدثًا على Pub/Sub (القسم 9) وسجلَّ تدقيق.

4.1 AI intake → case brief4.1 الاستقبال الذكي ← ملخص القضية

4.2 Sign-up and identity4.2 التسجيل والهوية

4.3 Matching and fair rotation4.3 المطابقة والتدوير العادل

4.4 Offers and comparison4.4 العروض والمقارنة

4.5 Checkout and milestone escrow4.5 الدفع وحجز المبالغ بالمراحل

4.6 Delivery and acceptance4.6 التسليم والقبول

• “Request changes” keeps the milestone in in_progress and resets the 14-day clock on the next delivery (max 2 rounds unless the offer says otherwise).
• «طلب التعديل» يبقي المرحلة في حالة قيد التنفيذ ويعيد احتساب مهلة 14 يومًا عند التسليم التالي (بحد أقصى جولتين ما لم ينص العرض على غير ذلك).
• Court milestones (e.g. “file the claim”) are delivered with the filing receipt from the filings log.
• تُسلَّم مراحل المحاكم (مثل «قيد الدعوى») مع إيصال القيد من سجل الإجراءات.
• Acceptance triggers an NPS prompt and the firm’s tax invoice.
• يطلق القبول استبيان الرضا والفاتورة الضريبية للمكتب.

4.7 Dispute (14-day window)4.7 الاعتراض (مهلة 14 يومًا)

4.8 Consultant → lawyer referral4.8 إحالة المستشار إلى محامٍ

• No referral fee, commission or payment between partners, in any direction (Art. 101) [1].
• لا رسوم إحالة ولا عمولة ولا مدفوعات بين الشركاء في أي اتجاه (المادة 101) [1].
• The consultant may not choose the advocate; an advocate from the same firm may be offered as one of the 3 invites only if the client asks for it.
• لا يختار المستشار المحامي؛ ويجوز أن يكون محامٍ من المكتب نفسه أحد المدعوّين الثلاثة فقط إذا طلب العميل ذلك.
• The referral is logged; the brief, documents and consultant note are shared only after client consent.
• تُسجَّل الإحالة، ولا يُشارك الملخص والمستندات ومذكرة المستشار إلا بعد موافقة العميل.

4.9 Partner onboarding and verification4.9 تسجيل الشركاء والتحقق منهم

Re-verification: automatic reminder 30 days before licence expiry; on expiry the partner is removed from rotation and open offers are withdrawn. Annual re-check of PI insurance and trade licence.

إعادة التحقق: تذكير تلقائي قبل انتهاء الترخيص بثلاثين يومًا؛ وعند انتهائه يُستبعد الشريك من التدوير وتُسحب عروضه المفتوحة. ويُعاد التحقق سنويًا من تأمين المسؤولية المهنية والرخصة التجارية.

4.10 Payouts4.10 تحويل المستحقات

The firm receives its agreed fee in full, less only the payment provider’s processing charge on that fee, passed through at cost and shown on the statement; Haqqi takes no commission or share of partner earnings (counsel to confirm). Processing on Haqqi’s own fees and subscriptions is paid by Haqqi. Payout failures (IBAN mismatch, KYB hold) alert finance and the firm admin within 1 hour.

يحصل المكتب على أتعابه المتفق عليها كاملة، ولا يُخصم منها إلا رسوم معالجة الدفع لدى مزوّد الدفع على هذه الأتعاب، بسعر التكلفة ومع إظهارها في كشف الحساب، ولا تأخذ حقّي أي عمولة أو حصة من أرباح الشركاء (رهنًا بتأكيد المستشار القانوني). وتتحمل حقّي رسوم معالجة الدفع على رسومها واشتراكاتها. وتنبّه حالات فشل التحويل (عدم تطابق الآيبان أو تعليق التحقق) القسمَ المالي ومسؤول المكتب خلال ساعة.

4.11 Support tickets4.11 تذاكر الدعم

Support never gives legal advice; legal questions are routed to the assistant or to a paid written question. Tickets link to the matter, payment and user, and close with a CSAT survey.

لا يقدّم الدعم استشارات قانونية أبدًا؛ وتُحوَّل الأسئلة القانونية إلى المساعد أو إلى سؤال مكتوب مدفوع. وترتبط التذاكر بالقضية والدفعة والمستخدم، وتُغلق باستبيان رضا.

Priorities: P0 launch blocker, P1 needed for public launch, P2 nice to have. Competitor references show what Haqqi matches or beats.

الأولويات: P0 شرط للإطلاق، P1 مطلوب للإطلاق العام، P2 إضافة مرغوبة. وتوضح المقارنات مع المنافسين ما تجاريه حقّي أو تتفوّق فيه.

5.0 Competitor feature benchmark → Haqqi spec5.0 مقارنة ميزات المنافسين ← مواصفات حقّي

5.1 Website (Phase 1 pages)5.1 الموقع (صفحات المرحلة 1)

5.2 AI assistant5.2 المساعد الذكي

5.3 Client dashboard and app5.3 لوحة العميل والتطبيق

5.4 Lawyer dashboard5.4 لوحة المحامي

5.5 Consultant dashboard5.5 لوحة المستشار

5.6 Admin console5.6 لوحة الإدارة

Haqqi earns only from clients and from software subscriptions; it never takes a share of a lawyer’s fee. This avoids the paid client-steering offence in Art. 101 (AED 20,000–200,000 fine) and the non-lawyer partnership rule in Art. 99 [1]. UpCounsel’s 2016 fee-sharing letters show the risk of the alternative [14].

تحقّق حقّي إيراداتها من العملاء ومن اشتراكات البرمجيات فقط، ولا تأخذ أبدًا حصة من أتعاب المحامي. وبذلك تتجنب جريمة استقطاب العملاء مقابل عمولة في المادة 101 (غرامة من 20,000 إلى 200,000 درهم) وحكم الشراكة مع غير المحامين في المادة 99 [1]. وتُظهر رسائل تقاسم الأتعاب التي واجهتها UpCounsel عام 2016 مخاطر البديل [14].

Revenue linesمصادر الإيراد

Worked example (prototype checkout)مثال تطبيقي (صفحة الدفع في النموذج)

Agent model: the firm invoices its fee and Haqqi invoices only its own fee, so the firm’s fee stays outside Haqqi’s taxable turnover [23]. Mandatory VAT registration applies above AED 375,000 of taxable supplies. E-invoicing phase dates must be confirmed with the FTA before build freeze.

نموذج الوكالة: يصدر المكتب فاتورة أتعابه، وتصدر حقّي فاتورة رسومها فقط، فتبقى أتعاب المكتب خارج إيرادات حقّي الخاضعة للضريبة [23]. ويصبح التسجيل الضريبي إلزاميًا عند تجاوز التوريدات الخاضعة 375,000 درهم. ويجب التحقق من مواعيد مراحل الفوترة الإلكترونية مع الهيئة الاتحادية للضرائب قبل تجميد البناء.

Refunds and payoutsالاسترداد والتحويلات

Payout schedule: released funds transfer immediately to the firm’s connected account; payouts to IBAN every Monday (minimum AED 100), next-day payouts as a Pro-plan option if the PSP supports it.

جدول التحويل: تنتقل المبالغ المحرَّرة فورًا إلى الحساب المرتبط للمكتب، وتُصرف إلى الآيبان كل يوم اثنين (بحد أدنى 100 درهم)، مع خيار الصرف في اليوم التالي ضمن الخطة الاحترافية إن دعمه المزوّد.

Payment provider optionsخيارات مزوّد الدفع

Methods: Apple Pay and Google Pay first (wallets are 35% of UAE online value), then cards (credit 27%, debit 15%) [26]. BNPL (Tabby, Tamara; fees about 4–8%, unverified) only for milestones ≥ AED 2,000 (assumption) [27]. Under CBUAE rules Haqqi must not hold client money itself; obtain a regulatory-perimeter opinion [28].

وسائل الدفع: Apple Pay وGoogle Pay أولًا (المحافظ الرقمية 35% من قيمة المدفوعات الإلكترونية في الإمارات)، ثم البطاقات (الائتمانية 27% والخصم 15%) [26]. والشراء الآن والدفع لاحقًا (تابي وتمارا، برسوم نحو 4% إلى 8% غير مؤكدة) فقط للمراحل التي تبلغ 2,000 درهم فأكثر (افتراض) [27]. ووفق أنظمة المصرف المركزي لا يجوز لحقّي الاحتفاظ بأموال العملاء بنفسها، ويلزم الحصول على رأي بشأن النطاق التنظيمي [28].

Trust is the product. Every control below maps to a law, a regulator expectation or a known competitor failure.

الثقة هي جوهر المنتج. وكل ضابط أدناه مرتبط بقانون أو بتوقعات جهة تنظيمية أو بإخفاق معروف لدى منافس.

PDPL (Federal Decree-Law 45/2021)قانون حماية البيانات الشخصية (المرسوم بقانون 45/2021)

Legal launch conditionsالشروط القانونية للإطلاق

• Written opinion from UAE counsel on the revenue model, routing and advertising (Arts. 45, 61, 99, 101).
• رأي مكتوب من مستشار قانوني إماراتي بشأن نموذج الإيراد والتوجيه والإعلان (المواد 45 و61 و99 و101).
• Engagement with the Ministry of Justice and Dubai Legal Affairs Department (and ADJD before Abu Dhabi launch).
• التواصل مع وزارة العدل ودائرة الشؤون القانونية لحكومة دبي (ودائرة القضاء في أبوظبي قبل الإطلاق فيها).
• CBUAE perimeter opinion and signed PSP marketplace agreement covering held funds.
• رأي بشأن النطاق التنظيمي للمصرف المركزي، وعقد سوق موقّع مع مزوّد الدفع يغطي احتجاز المبالغ.
• VAT registration and invoice templates approved by a tax adviser.
• التسجيل الضريبي واعتماد نماذج الفواتير من مستشار ضريبي.
• DPO appointed, DPIA signed off, privacy notice and AI notice published in both languages.
• تعيين مسؤول حماية البيانات، واعتماد تقييم الأثر، ونشر إشعاري الخصوصية والذكاء الاصطناعي باللغتين.
• Trademark clearance for “Haqqi / حقّي” given the HAQQ name collision [20].
• التحقق من العلامة التجارية «حقّي / Haqqi» بسبب التشابه مع اسم HAQQ [20].

● sent by default · ◐ fallback or opt-in · ○ not sent. WhatsApp uses approved Business API templates and requires explicit opt-in (WhatsApp reaches 85.8% of internet users aged 16–64) [37]. Quiet hours 22:00–08:00 GST except P1 events and OTPs.

● يُرسل افتراضيًا · ◐ احتياطي أو باختيار المستخدم · ○ لا يُرسل. يستخدم واتساب قوالب معتمدة عبر واجهة الأعمال ويتطلب اشتراكًا صريحًا (يصل واتساب إلى 85.8% من مستخدمي الإنترنت بين 16 و64 عامًا) [37]. ساعات الهدوء من 22:00 إلى 08:00 بتوقيت الخليج عدا أحداث الأولوية القصوى ورموز التحقق.

Every message is bilingual by user preference, deep-links to the exact screen, carries no legal detail on lock screens (“You have a new update on your matter”), and is logged with delivery status.

تصل كل رسالة بلغة المستخدم المفضلة، وترتبط بالشاشة المعنية مباشرة، ولا تُظهر أي تفاصيل قانونية على شاشة القفل («لديك تحديث جديد في قضيتك»)، وتُسجَّل مع حالة التسليم.

One TypeScript monorepo: Expo + Expo Router + React Native Web for every client surface, NestJS services on Cloud Run, Postgres for money and matters, Firestore for realtime chat. Next.js is an option only if SEO pages need SSR beyond Expo Router’s static rendering.

مستودع واحد بلغة TypeScript: Expo مع Expo Router وReact Native Web لكل واجهات المستخدم، وخدمات NestJS على Cloud Run، وPostgres للأموال والقضايا، وFirestore للمحادثات الفورية. ويبقى Next.js خيارًا فقط إذا احتاجت صفحات تحسين الظهور إلى تصيير على الخادم يتجاوز التصيير الثابت في Expo Router.

Component viewمنظور المكوّنات

Servicesالخدمات

Data model (main entities)نموذج البيانات (الكيانات الرئيسية)

API style and eventsأسلوب الواجهة البرمجية والأحداث

• REST/JSON under /v1, OpenAPI-generated typed client in packages/api-client; cursor pagination; ETags for offers and milestones.
• واجهة REST/JSON تحت ‎/v1، مع عميل مُولَّد من OpenAPI في packages/api-client؛ ترقيم بالمؤشر؛ ووسوم ETag للعروض والمراحل.
• Idempotency-Key header required on every money-moving call; PSP webhooks verified by signature and processed once (inbox table).
• ترويسة Idempotency-Key إلزامية في كل عملية تحرّك المال؛ وإشعارات المزوّد يُتحقق من توقيعها وتُعالج مرة واحدة (جدول وارد).
• Realtime: Firestore listeners for chat, presence and timers display; server writes only via Admin SDK; security rules deny client writes to money fields.
• الوقت الفعلي: مستمعو Firestore للمحادثة والحضور وعرض المؤقّتات؛ والكتابة من الخادم فقط؛ وقواعد الأمان تمنع كتابة العميل في حقول المال.
• Pub/Sub topics: brief.*, invite.*, offer.*, milestone.*, payment.*, dispute.*, partner.*, ai.*, notification.*; dead-letter topics with alerting; events versioned with a schema registry.
• مواضيع Pub/Sub: brief.* وinvite.* وoffer.* وmilestone.* وpayment.* وdispute.* وpartner.* وai.* وnotification.*؛ مع مواضيع للرسائل الفاشلة وتنبيهات؛ وإصدارات للأحداث في سجل مخططات.

AI architectureبنية الذكاء الاصطناعي

Monorepo structureبنية المستودع الموحّد

Environments, CI/CD, observability, securityالبيئات والتكامل والنشر والمراقبة والأمان

Team composition (build phase)تشكيل الفريق (مرحلة البناء)

Risks and dependenciesالمخاطر والاعتماديات

Open questions for the clientأسئلة مفتوحة للعميل

1. Hero CTA wording: keep «احصل على عروض مجانية» (“Get free offers”)?
2. صياغة زر الواجهة: هل نُبقي «احصل على عروض مجانية»؟
3. Does step 4 «تابع قضيتك» (“Follow your case”) stay in the how-it-works steps?
4. هل تبقى الخطوة الرابعة «تابع قضيتك» ضمن خطوات العمل؟
5. Partner subscription prices: AED 399 and AED 1,499 per month?
6. أسعار اشتراك الشركاء: 399 و1,499 درهمًا شهريًا؟
7. Show the consultant’s written-answer price (AED 99) publicly?
8. هل يُعرض سعر الإجابة المكتوبة من المستشار (99 درهمًا) علنًا؟

Client’s Phase 2 listقائمة العميل للمرحلة 2

• UAE PASS sign-up and digital signature.
• التسجيل والتوقيع الرقمي عبر UAE PASS.
• Court-linked features: hearings, judgments, calendar, court-synced case list, official integrations.
• ميزات مرتبطة بالمحاكم: الجلسات والأحكام والتقويم وقائمة القضايا المتزامنة والربط الرسمي.
• Assisted government requests (e.g. براءة ذمة clearance certificate).
• الطلبات الحكومية بمساعدة (مثل شهادة براءة الذمة).
• “How it works” page and practice × emirate SEO listing pages.
• صفحة «كيف تعمل المنصة» وصفحات التخصّص × الإمارة.
• Reviews and experience on profiles.
• التقييمات والخبرات في الملفات.
• Homepage: client segments, offer-comparison and platform-showcase bands.
• الرئيسية: شرائح العملاء وشريطا مقارنة العروض وعرض المنصة.
• Lawyer requests/offers board, case kanban, client CRM, calendar.
• لوحة طلبات وعروض المحامي، كانبان القضايا، إدارة العملاء، التقويم.
• Consultant video sessions.
• الجلسات المرئية للمستشار.
• GCC expansion: KSA, Oman, Qatar, Kuwait, Bahrain.
• التوسع الخليجي: السعودية وعُمان وقطر والكويت والبحرين.