Developer Resources

دروستکردنی سیستەمێکی حجزکردنی قەبارەدار: مۆدێلی بنکەدراوەی سەرەکی و نەخشەکانی API خۆڕاگر

ڕێنمایی گەشەپێدەر بۆ بیناسازی سیستەمی حجزکردنی قەبارەدار. فێربە دیزاینی شێمای بنکەدراوەی سەرەکی، نەخشەکانی API idempotent، مامەڵەکردن لەگەڵ هاوکاتی، و هەنگاوەکانی جێبەجێکردنی پراکتیکی.

2 min read

Mewayz Team

Editorial Team

Developer Resources

هەموو گەشەپێدەرێک کە ئەرکی دروستکردنی سیستەمی حجزکردنی پێسپێردراوە، بە خێرایی تێدەگات کە ئەوە تەحەدایەکی فریودەرانەیە. لە ڕووکەشدا، تەنها بەستنەوەی بەکارهێنەرێک، سەرچاوەیەک (وەک شوێنی کات یان کورسی) و کاتێکە. لە ڕاستیدا، ئەوە ڕێکخستنێکی گرەوێکی بەرزە لە یەکپارچەیی داتا، هاوکاتی کاتی ڕاستەقینە و لۆژیکی بازرگانی کە دەبێت بەبێ کەموکوڕی لە ژێر بارگاویکردنەوەدا کار بکات. سیستەمێکی خراپ دیزاینکراو دەبێتە هۆی دوو جار حجزکردن و بێزاری کڕیاران و کابوسەکانی کارکردن. بۆ بزنسەکانی 138K+ لەسەر پلاتفۆرمەکانی وەک Mewayz، بزوێنەرێکی بەهێزی حجزکردن شتێکی لوکس نییە؛ ئەوە بڕبڕەی پشتی کارکردنە بۆ خزمەتگوزارییەکان، دامەزراندن و بەڕێوەبردنی سەروەت و سامان. ئەم ڕێنماییە دیزاینی بنکەدراوەی بنەڕەتی و نەخشەکانی API دەشکێنێت کە پێویستە بۆ دروستکردنی سیستەمێک کە لە یەکەم ١٠٠ حجزکردنتەوە تا یەکەم ملیۆن حجزکردنت گەورەتر بێت.

شێمای بنکەدراوەی بنەڕەتی: زیاتر لە تەنها خشتەکان

بنکەدراوە تاکە سەرچاوەی ڕاستییە بۆ سیستەمی حجزکردنەکەت. دیزاینەکەی هەموو شتێک دیکتە دەکات- لە ئەدای پرسیارەوە تا ئاڵۆزی لۆژیکی کارەکەت. ڕێبازێکی بێهەڵوێستی بە یەک خشتەی bookings لە ژێر پێداویستییەکانی جیهانی ڕاستەقینە وەک چاوپێکەوتنە دووبارەبووەکان، لیستەکانی چاوەڕوانی، یان پلەبەندی سەرچاوەکان دەڕوخێت.

بە مۆدێلکردنی یەکە سەرەکییەکان بە شێوەیەکی جیاواز دەست پێ بکە. ئەم جیاکردنەوەی نیگەرانییەکان بۆ نەرمی و نەرمی زۆر گرنگە. خشتەی سەرچاوەکان ی تۆ پێناسەی ئەوە دەکات کە دەتوانرێت چی حجز بکرێت- ژووری کۆنفڕانس، کاتی ستایلست، ئۆتۆمبێلی کرێ. هەر سەرچاوەیەک دەبێ یاساکانی Availability ی بەستراوەتەوە، کە دەتوانێت سادە بێت (9-بۆ-5، دووشەممە-هەینی) یان ئاڵۆز بێت (کاتژمێرەکانی تایبەتمەند، بەرواری ڕەشبوونەوە، کاتی بافەر لە نێوان حجزکردنەکاندا). هەڵگرتنی بەردەستبوون بە جیا لە خودی سەرچاوەکە ڕێگە بە خشتەی داینامیکی و نوێکردنەوەی ئاسانتر دەدات.

پەیوەندییەکانی یەکە سەرەکییەکان

دڵی سیستەمەکە یەکگرتنی نێوان بەکارهێنەران، سەرچاوە و شوێنی کاتە. خشتەی بەهێزی Bookings نابێت تەنها کاتێکی بەرواری دەستپێکردن و کۆتایی هەڵبگرێت. دەبێت مەیدانێکی دۆخ لەخۆبگرێت کە بەهاکانی لە دەرەوەی 'دڵنیاکراوە' بێت-بیر لە pending_payment، tentative، هەڵوەشاوەتەوە، no_show بکەرەوە. ئەمە ڕێگە بە کاری دەوڵەمەند دەدات وەک ڕاگرتنی شوێنێک بۆ ماوەیەکی کاتی لەکاتێکدا بەکارهێنەرێک کۆتایی بە کۆتایی هاتنی کۆتایی دێت. سەرەڕای ئەوە، مێتاداتای وەک source (وێب، مۆبایل، API)، ip_address بۆ دۆزینەوەی ساختەکاری، و ژمارەیەکی version یان updated_at مۆری کاتی بۆ کۆنترۆڵکردنی هاوکاتی گەشبینانە، کە دواتر باسی دەکەین.

مامەڵەکردن لەگەڵ هاوکاتی: کێشەی بارودۆخی ڕەگەز

کاتێک دوو بەکارهێنەر هەوڵدەدەن دوا شوێنی بەردەست لە هەمان ساتدا حجز بکەن، تۆ مەرجی پێشبڕکێت هەیە. زنجیرەی بێهەڵوێستی چێک-هەڵبژاردن-دانان ڕێچکەیەکە بۆ دوو جار حجزکردن. چەندین ستراتیژی تاقیکردنەوەی شەڕ هەیە بۆ ڕێگریکردن لەم کارە، هەریەکەیان ئاڵوگۆڕی نێوان ئەنجامدان و ئاڵۆزییەکانیان هەیە.

  • قفڵکردنی ڕەشبینانە: ئەمە بریتییە لە دانانی قوفڵێکی ئاستی ڕیز لەسەر سەرچاوە یان شوێنی کات بۆ ماوەی مامەڵەی حجزکردن. سادەیە و گەرەنتی یەکپارچەیی دەکات بەڵام بە شێوەیەکی بەرچاو توانای کەمدەکاتەوە و دەتوانێت ببێتە هۆی بنبەست لە ژێر هاوکاتی بەرزدا. وەک ئەوە وایە هێمای “تێک مەکە” لەسەر ڕیزێکی بنکەدراوە دابنێیت.
  • کۆنترۆڵی هاوکاتی گەشبینانە (OCC): زیاتر گونجاوە بۆ بەرنامەکانی وێب-پێوەر. لێرەدا، تۆ ڕیزەکان قفڵ ناکەیت. لەبری ئەوە، لە کاتی نوێکردنەوەدا ژمارەی وەشانی یان مۆری کات دەپشکنیت. حجزکردنەکە تەنها لەو کاتەدا بەردەوام دەبێت کە دۆخی سەرچاوەکە نەگۆڕاوە لەو کاتەوەی بەکارهێنەر سەیری کردووە. ئەگەر ناکۆکییەک دۆزرایەوە، بەکارهێنەر ئاگادار دەکرێتەوە و دەبێت هەوڵی دووبارە بداتەوە. ئەم نەخشە زۆر قەبارەی هەیە بەڵام پێویستی بە لۆژیکی چارەسەرکردنی ناکۆکی بیرکراوە هەیە.
  • کۆت و بەندەکانی ئاستی بنکەدراوە: بەهێزترین ڕێگا بریتییە لە دیزاینکردنی سکیماکەت بۆ ئەوەی دوو جار حجزکردن لە ڕووی فیزیکییەوە مەحاڵ بێت. بەکارهێنانی سنووردارکردنی UNIQUE لەسەر تێکەڵەیەک لە resource_id، start_time، و end_time (بە مەرجێک کە دۆخ != 'هەڵوەشاوەتەوە') بەو مانایەیە کە بنکەدراوە خۆی هەر جێگیرکردنێک ڕەتدەکاتەوە کە سەریەککەوتنێک دروست بکات. ئەمەش جێبەجێکردنەکە دەگوازێتەوە بۆ بزوێنەری بنکەدراوە، کە بە شێوەیەکی نائاسایی باشە لەو کارەدا.

دیزاینکردنی API ی Idempotent و Resilient

API ی تۆ دەروازەیە. شکستی تۆڕ، تێکچوونی ئەپی مۆبایل، یان بەکارهێنەرانی بێ تاقەت کە دوو جار لێدانی "ناردن" بەو مانایەیە کە خاڵی کۆتایی حجزکردنەکەت دەبێت idepotent بێت- ئەنجامدانی هەمان داواکاری چەندین جار هەمان کاریگەری هەیە وەک ئەوەی جارێک بیکەیت. ئەمە بۆ پرۆسەی پەیوەست بە پارەدان دانوستان ناکرێت.

جێبەجێکردنی idempotency بە داواکردن لە کڕیارەکان بۆ ناردنی idempotency_key ی ناوازە (بۆ نموونە، لایەنی کرێدەرێکی دروستکراوی UUID) لەگەڵ هەر داواکارییەکی دروستکردنی حجزکردن. API ی تۆ ئەم کلیلە هەڵدەگرێت کە بەستراوەتەوە بە ناسنامەی حجزکردنی دەرەنجامی. داواکاری دووبارە بە هەمان کلیل وردەکارییەکانی حجزکردنی پێشتر دروستکراو دەگەڕێنێتەوە، ڕێگری دەکات لە دووبارەبوونەوەی پارە و حجزکردن. ئەم نەخشە ناوەندییە بۆ متمانەپێکراوی سیستەمی دارایی و مامەڵەکردن، لەوانەش مۆدیولەکانی Mewayz API، کە مامەڵە لەگەڵ فەسڵکردن و خشتەی کارکردن دەکەن.

کلیلی APIی حجزکردنی قەبارەدار تەنها خێرایی نییە؛ ئەوە پێشبینیکردنە. خاڵی کۆتایی idepotent کە کۆدی هەڵەی ڕوون و یەکگرتووی هەیە، بەهای زیاترە لە خاڵێکی خێراتر کە مامەڵەی دووبارە لە ژێر شکستدا بەرهەم دەهێنێت.

بەڕێوەبردنی دەوڵەت و قەڵغانی سووڕی ژیان

حجزکردن ئامێرێکی دەوڵەتە. لە pendingەوە دەگۆڕێت بۆ confirmed بۆ completed یان cancelled. هەر گواستنەوەیەک دەبێت کرداری تایبەت دەستپێبکات- ناردنی ئیمەیڵی پشتڕاستکردنەوە، نوێکردنەوەی ساڵنامەی سەرچاوە، پرۆسێسکردنی گەڕاندنەوەی پارە، یان تۆمارکردنی ڕێڕەوی وردبینی. ئەمە بە بەکارهێنانی چینێکی خزمەتگوزاری باش پێناسەکراو یان بیناسازی ڕووداو-بزوێنەر جێبەجێ بکە.

بۆ نموونە کاتێک حجزکردنێک هەڵدەوەشێتەوە، خزمەتگوزارییەکەت دەبێت:

  1. سیاسەتی هەڵوەشاندنەوە پشتڕاست بکەرەوە (بۆ نموونە، "ئاگاداری ٢٤ کاتژمێری پێویستە").
  2. bookings.status نوێ بکەرەوە بۆ cancelled.
  3. ڕووداوێکی booking.cancelled دەربکە.
  4. با گوێگران بکەن کە: هەر گەڕانەوەیەکی بەشەکی لە ڕێگەی دەروازەی پارەدانەوە پرۆسێس بکەن، ئیمەیڵێکی هەڵوەشاندنەوە بنێرن، و بە ئیختیاری، ئاگادارکردنەوەیەک بۆ لیستی چاوەڕوانی دەستپێبکەن.

ئەم دیزاینە جیاکراوە، هاوشێوەی چۆنیەتی کارکردنی سیستەمی کارپێکردنی مۆدیۆلاری Mewayz، سیستەمەکە دەکاتە درێژکراوە. زیادکردنی ئاگادارکردنەوەی کورتەنامەیەکی نوێ یان یەکخستنی لەگەڵ CRM بابەتی زیادکردنی گوێگرێکی نوێی ڕووداوە بەبێ ئەوەی دەست لە لۆژیکی سەرەکی حجزکردن بدەیت.

شێوازەکانی پرسیارکردن بۆ ئەنجامدان لە پێوەر

لەگەڵ گەشەکردنی قەبارەی حجزکردنەکەت، پرسیارە ناکارامەکان داشبۆرد و ڕاپۆرتکردنەکەت دەهێنێتە گەڕان. کارە باوەکان بریتین لە "دۆزینەوەی هەموو حجزکردنەکان بۆ سەرچاوەی X لە مانگی ئایاردا" و "چاوپێکەوتنەکانی داهاتووی بەکارهێنەرێکم پیشان بدە."

ستراتیژی ئیندێکسکردن لە پێش هەموو شتێکەوەیە. ئیندێکسە پێکهاتەکان لەسەر (resource_id, start_time) و (user_id, start_time) زۆر گرنگن. بۆ پرسیارەکانی مەودای بەروار کە spans گەورە دەگرێتەوە، بیر لە دابەشکردنی خشتەی bookings بکەرەوە بەپێی بەروار (بۆ نموونە، بەپێی مانگ). ئەمەش ڕێگە بە بنکەدراوە دەدات بە خێرایی تەواوی بەشەکان لە سکانێکدا دەربکات. جگە لەوەش، دوور بکەوەرەوە لە SELECT *. لە پرسیارەکانتدا ڕوون بە، تەنها ئەو ستوونانە بهێنە کە پێویستن بۆ دیمەن یان کارپێکردنی تایبەت بۆ کەمکردنەوەی بیرگە و سەرپێچی تۆڕ.

هەنگاو بە هەنگاو: جێبەجێکردنی ڕەوتی حجزکردنی بەهێز

با بەناو لۆژیکی لایەنی سێرڤەردا بڕۆن بۆ یەک دروستکردنی حجزکردن، کە بنەماکانی باسکراو لەخۆبگرین.

💡 DID YOU KNOW?

Mewayz replaces 8+ business tools in one platform

CRM · Invoicing · HR · Projects · Booking · eCommerce · POS · Analytics. Free forever plan available.

Start Free →

هەنگاوی یەکەم: داوای چەسپاندن و پشکنینی Idempotency

چەسپاندنی باری سوودبەخشی هاتوو (ناسنامەی_بەکارهێنەر، ناسنامەی_سەرچاوە، شوێنی کاتیی داواکراو). دەستبەجێ idempotency_key لە بەرامبەر خشتەیەکی تایبەت یان کاشی Redis بپشکنە. ئەگەر یەکسانبوونێک هەبوو، دەستبەجێ وەڵامی هەڵگیراو بگەڕێنەرەوە (HTTP 200 باشە لەگەڵ داتاکانی حجزکردنی هەبوو).

هەنگاوی دووەم: پشتڕاستکردنەوەی بەردەستبوون

پرسیار بکە بۆ ئەوەی بزانیت کە ئایا شوێنەکە ئازادە یان نا. ئەمە دەبێت حساب بۆ حجزکردنی ئێستای دڵنیاکراوە و pending بکات، هەروەها یاساکانی بەردەستبوونی سەرچاوەکە. ئەگەر دەتوانیت یەک پرسیاری ئەتۆمی بەکاربهێنە، بە بەکارهێنانی سنووردارکردنی بنکەدراوە. بۆ نموونە: SELECT COUNT(*) FROM حجزکردنەکان WHERE resource_id = ? AND tsrange(کاتی دەستپێکردن، کاتی کۆتایی) && tsrange(?, ?) AND دۆخی NOT IN ('هەڵوەشاوەتەوە'، 'پێشاندانی نییە').

هەنگاوی سێیەم: مامەڵەی ئەتۆمی

دروستکردنەکە لە مامەڵەی بنکەدراوەدا بپێچە. لەناو ئەودا:
1. دووبارە پشتڕاستکردنەوەی بەردەستبوون (پشکنینی کۆتایی).
2. تۆماری نوێی حجزکردن بە دۆخی pending_payment یان confirmed دابنێ.
3. تۆمارێک دابنێ کە ناسنامەی حجزکردنی سەرکەوتوو بەستراوەتەوە بە idempotency_key.
4. مامەڵەکە ئەنجام بدە. ئەگەر هەر هەنگاوێک شکستی هێنا، تەواوی مامەڵەکە دەگەڕێتەوە دواوە، هیچ نیوە دۆخێک نامێنێتەوە.

هەنگاوی چوارەم: کردارەکانی دوای دروستکردن

دوای سەرکەوتنی مامەڵەکە، بەڵام پێش وەڵامدانەوەی کرێدەر، کارەکانی ناهاوسەنگ یان ڕووداوەکان بۆ کردارەکانی ڕێڕەوی ناگرینگ: ناردنی ئیمەیڵی پشتڕاستکردنەوە، نوێکردنەوەی ئیندێکسی گەڕان، یان تۆمارکردنی شیکارییەکان بکوژێنەرەوە. وەڵامی API نابێت چاوەڕێی ئەمانە بکات.

یەکگرتن لەگەڵ سیستەمی کارپێکردنی بازرگانی فراوانتر

سیستەمی حجزکردن بە دەگمەن لە بۆشاییدا بوونی هەیە. بەهای ڕاستەقینەی کاتێک لەگەڵ ئەرکەکانی تری بازرگانیدا یەکدەخرێت، دەکرێتەوە. کاتێک کە حجزکردنێک دروست دەکرێت، پێویستە بە شێوەیەکی پۆتانسێل: پەیوەندییەک لە CRM دروست بکات، فاکتورەیەک دروست بکات، ساڵنامەی ئەندامێکی تیم لە مۆدیۆلی HRدا بلۆک بکات، یان بەرنامە بۆ ئۆتۆمبێلێک لە بەڕێوەبەری بەلەمەوە دابنێت. ئەمە فەلسەفەی مۆدیۆلاری پشت پلاتفۆرمەکانی وەک Mewayz ە، کە مۆدیۆلی Booking بە شێوەیەکی ئۆتۆماتیکی لەگەڵ ٢٠٧ پلاتفۆرمی تر هاوکات دەبێت.

بۆ گەشەپێدەران، ئەمە بە واتای دیزاینکردنی مۆدێلی داتا و ڕووداوەکانی سیستەمی حجزکردنەکەتە بە لەبەرچاوگرتنی خاڵەکانی یەکگرتن. ئاشکراکردنی وێبهۆکەکان بۆ ڕووداوە سەرەکییەکان (booking.created، booking.updated) ڕێگە بە سیستەمەکانی تر دەدات کاردانەوەیان هەبێت. دابینکردنی APIیەکی ڕوون و باش بەڵگەدار، وەک ئەوەی کە بە 4.99$/مۆدیول/مانگ لەگەڵ Mewayz پێشکەش دەکرێت، هاوبەشەکان و تیمە ناوخۆییەکان دەتوانن کاری تایبەت دروست بکەن، لە هەڵمەتەکانی کورتەنامەی بەدواداچوونی ئۆتۆماتیکیەوە تا هاوکاتکردن لەگەڵ نەرمەکاڵای ژمێریاری دەرەکی.

دروستکردنی سیستەمێکی حجزکردنی قەبارەدار مەشقێکە لە پێشبینیکردنی شکست و دیزاینکردن بۆ یەکدەنگی. بە دەستپێکردن بە شێمایەکی بنکەدراوەی تۆکمە و جێبەجێکراوی سنووردارکردن، بەکارهێنانی نەخشەکانی APIی idempotent، و پلاندانان بۆ یەکگرتن لە ڕۆژی یەکەمەوە، تۆ زیاتر لە ئامرازێکی خشتەکردن دروست دەکەیت. تۆ سیستەمێکی دەماری ناوەندی و متمانەپێکراو بۆ کارەکانی بنەمادار بە خزمەتگوزاری دروست دەکەیت کە دەتوانێت بەبێ کێشە لەگەڵ بزنسەکەدا گەشە بکات، لۆجستیکی ئاڵۆز دەکاتە سوودێکی کێبڕکێ.

پرسیارە زۆرەکان

گرنگترین سنووردارکردنی بنکەدراوە چییە بۆ ڕێگریکردن لە دوو جار حجزکردن؟

سنووردارێکی ناوازە لەسەر تێکەڵکردنی resource_id، start_time و end_time (فلتەر کراوە بۆ دۆخی چالاک) بەهێزترینە، چونکە ڕێگری دەکات لە سەریەککەوتنی حجزکردن لە ئاستی بزوێنەری بنکەدراوەدا، کە ئەتۆمییە و متمانەپێکراوە.

بۆچی کلیلی idempotency پێویستە بۆ APIی حجزکردن؟

کلیلی idempotency دڵنیای دەدات لەوەی کە ئەگەر کرێدەرێک هەوڵی داواکارییەکی شکستخواردوو بداتەوە (بۆ نموونە، بەهۆی کاتبەسەرچوونی تۆڕەوە)، تەنها یەک حجزکردن دروست دەکات و جارێک پارە لە بەکارهێنەرەکە وەردەگرێت، ڕێگری دەکات لە دووبارەکردنەوە و دروستکردنی متمانەی بەکارهێنەر لە پرۆسەی پارەدان.

ئایا پێویستە قفڵکردنی گەشبینانە یان ڕەشبینانە بەکاربهێنم بۆ کۆنترۆڵکردنی هاوکات؟

بۆ زۆربەی سیستەمەکانی حجزکردنی وێب، کۆنترۆڵی هاوکاتی گەشبینانە (OCC) بۆ قەبارەدانان باشترە. قفڵکردنی ڕەشبینانە دەتوانێت سادەتر بێت بۆ سیناریۆی هاوکاتی زۆر کەم بەڵام زۆرجار دەبێتە گەردنی تەنگ لەگەڵ گەشەکردنی قەبارەی بەکارهێنەر.

چۆن دەبێت مامەڵە لەگەڵ ناوچە کاتییەکان بکەم لە سیستەمی حجزکردندا؟

هەمیشە هەموو مۆری کاتەکان لە کاتی گشتگیری هاوئاهەنگ (UTC) لە بنکەدراوەی خۆتدا هەڵبگرە. گۆڕینی بۆ ناوچەی کاتیی ناوخۆیی بەکارهێنەر یان سەرچاوە تەنها لە چینە پێشکەشکردنی بەرنامەکەدا، بە بەکارهێنانی کتێبخانەی ناوچەی کاتیی متمانەپێکراو.

سودی تەلارسازییەکی ڕووداو-بزوێنەر چییە بۆ حجزکردنی بەڕێوەبردنی سووڕی ژیان؟

تەلارسازییەکی ڕووداو-بزوێنەر لۆژیکی سەرەکی حجزکردن لە کاریگەرییە لاوەکییەکانی وەک ئاگادارکردنەوە و یەکخستنەوە جیادەکاتەوە، ئەمەش وا دەکات سیستەمەکە زیاتر پارێزگاری لێبکرێت، درێژبکرێتەوە و خۆڕاگرتر بێت بەرامبەر بە شکستەکان لە پرۆسەی ناگرینگدا.

ئەمڕۆ سیستەمی کارپێکردنی کارەکەت دروست بکە

لە فریلانسەرەکانەوە تا ئاژانسەکان، مێوایز بە 208 مۆدیۆلی یەکگرتوو 138,000+ بزنس بەهێز دەکات. بەخۆڕایی دەست پێ بکە، کاتێک گەشە دەکەیت بەرزی بکەرەوە.

دروستکردنی ئەکاونتی بێبەرامبەر →

Try Mewayz Free

All-in-one platform for CRM, invoicing, projects, HR & more. No credit card required.

Related Guide

Booking & Scheduling Guide →

Streamline appointments and scheduling with automated confirmations, reminders, and calendar sync.

booking system architecture scalable database design booking API patterns idempotent APIs concurrency control resource scheduling Mewayz API

Start managing your business smarter today

Join 30,000+ businesses. Free forever plan · No credit card required.

Ready to put this into practice?

Join 30,000+ businesses using Mewayz. Free forever plan — no credit card required.

Start Free Trial →

Ready to take action?

Start your free Mewayz trial today

All-in-one business platform. No credit card required.

Start Free →

14-day free trial · No credit card · Cancel anytime