Financial Operations / Payment/References

بررسی جداول زیر:


wallet

جدول ثبت تراکنش‌های مالی و کیف پول

مقدمه

این جدول برای ثبت و نگهداری کلیه رویدادهای مالی، شامل واریز، برداشت، انتقال و تسویه حساب‌ها طراحی شده است. هر رکورد نشان‌دهنده یک تغییر مالی مشخص بوده و امکان ردیابی منبع، مقصد، وضعیت تأیید و شرح تراکنش را فراهم می‌کند. این ساختار پایه‌ی اصلی کنترل گردش مالی در سامانه محسوب می‌شود.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT شناسه یکتای هر تراکنش مالی
branch BIGINT شناسه دفتر
operator_type ENUM('erp','b2b','b2c') نوع منبع ثبت‌کننده تراکنش
operator INT   شناسه کاربر متصل به جدول اپراتورها
target_type ENUM('manual','bill','pay','hub','credit','wa') نوع مقصد یا دلیل ایجاد تراکنش
target BIGINT شناسه رکورد مقصد مربوط به تراکنش
object_type ENUM('branch','colleague','passenger') نوع مالک یا ذی‌نفع تراکنش
object BIGINT شناسه ذی‌نفع تراکنش
credit BIGINT مبلغ بستانکاری ثبت‌شده
debit BIGINT مبلغ بدهکاری ثبت‌شده
description VARCHAR(255) توضیح تکمیلی درباره تراکنش
confirm_at DATETIME زمان تأیید نهایی تراکنش
confirm_by BIGINT شناسه شخص یا سامانه تأییدکننده
confirm_note VARCHAR(255) یادداشت مربوط به فرآیند تأیید
status INT وضعیت جاری تراکنش (فعال، تأیید شده، لغو شده و مشابه آن)
created_at DATETIME زمان ایجاد رکورد تراکنش

نتیجه‌گیری

این جدول نقش ستون فقرات بخش مالی سامانه را ایفا می‌کند و تمامی تغییرات مربوط به مانده حساب‌ها از طریق آن قابل پیگیری است. با اتکا به این ساختار می‌توان گزارش‌های دقیق مالی، کنترل وضعیت پرداخت‌ها و بررسی سوابق گردش مالی هر ذی‌نفع را با دقت بالا انجام داد.

مستند پایگاه داده – جدول کیف پول و تراکنش‌های مالی

credit_cards

جدول کارت‌های اعتباری و برداشت مالی

مقدمه

این جدول برای نگهداری اطلاعات مربوط به کارت‌های اعتباری کاربران، شامل شماره کارت، شناسه امنیتی، تاریخ انقضا و محدودیت‌های برداشت طراحی شده است. داده‌های این جدول در فرایند پرداخت، واریز، و کنترل امنیت مالی در سامانه کاربرد دارد و امکان مدیریت کارت‌های فعال، مسدود و منقضی شده را فراهم می‌کند.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT AUTO_INCREMENT شناسه یکتای کارت در سامانه
passenger_id BIGINT شناسه دارنده کارت (کاربر یا مسافر)
identity_code VARCHAR(20) کد شناسایی یا شماره ملی مرتبط با کارت
mobile VARCHAR(11) شماره همراه ثبت‌شده جهت احراز و اعلان تراکنش‌ها
card_number VARCHAR(16) شماره کارت بانکی
cvv2 INT کد امنیتی کارت بانکی
expire_date DATE تاریخ انقضای کارت بانکی
withdrawal_limit VARCHAR(255) حد مجاز برداشت برای کارت در بازه زمانی مشخص
blocked_amount VARCHAR(255) مبلغ مسدود شده کارت در صورت وجود محدودیت اعتباری
status INT وضعیت کارت (فعال، در انتظار تأیید، مسدود یا منقضی)
created_at DATETIME تاریخ ایجاد رکورد کارت
updated_at DATETIME تاریخ آخرین ویرایش اطلاعات کارت
renewal_in DATETIME تاریخ تمدید مجدد کارت توسط دارنده
جدول دیتا مهمی را نمایان میکند . 
در آن دیتای کمی وجود دارد و ارزش جدولی چندانی ندارد.

نتیجه‌گیری

جدول کارت‌های اعتباری، یکی از اجزای اصلی بخش مالی سامانه است و به مدیریت دقیق اطلاعات کاربران، تراکنش‌های آنان و سطح دسترسی مالی کمک می‌کند. اطلاعات ثبت‌شده در این جدول امکان تطبیق اعتبار، بررسی زمان اعتبارسنجی، و کاهش خطاهای ناشی از تراکنش‌های نامعتبر را فراهم می‌سازد.

مستند پایگاه داده – جدول کارت‌های اعتباری و برداشت مالی

payment_gateway

جدول ثبت عملیات درگاه پرداخت

مقدمه

این جدول برای ثبت و پیگیری کامل عملیات پرداخت از طریق درگاه بانکی طراحی شده است. هر رکورد نمایانگر یک درخواست پرداخت بوده و شامل اطلاعات مبلغ، وضعیت، پاسخ درگاه و شناسه‌های رهگیری است. این ساختار امکان بررسی خطاها، تطبیق پرداخت‌ها و گزارش‌گیری مالی دقیق را فراهم می‌کند.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT UNSIGNED AUTO_INCREMENT شناسه یکتای عملیات پرداخت
slug VARCHAR(255) شناسه متنی یکتا برای رهگیری درخواست پرداخت
object_type ENUM('pay') نوع عملیات مرتبط با پرداخت
object INT شناسه رکورد مرتبط با پرداخت در سامانه
amount VARCHAR(255) مبلغ پرداختی ارسال‌شده به درگاه
return VARCHAR(255) نشانی بازگشت کاربر پس از انجام پرداخت
drive VARCHAR(255)  نوع سرویس‌دهنده درگاه پرداخت
serial_id VARCHAR(255) شناسه مرجع یا کد پیگیری صادرشده توسط درگاه
result LONGTEXT پاسخ کامل دریافتی از درگاه پرداخت
status INT وضعیت عملیات پرداخت (ناموفق، موفق، در انتظار بررسی)
created_at TIMESTAMP زمان ایجاد درخواست پرداخت
updated_at TIMESTAMP زمان آخرین به‌روزرسانی وضعیت پرداخت

نتیجه‌گیری

جدول درگاه پرداخت نقش کلیدی در کنترل و پایش فرآیندهای مالی سامانه دارد. با استفاده از داده‌های این جدول می‌توان وضعیت هر پرداخت را به‌صورت شفاف بررسی کرد، خطاهای احتمالی را شناسایی نمود و تطبیق دقیقی میان درخواست‌های مالی و پاسخ‌های بانکی انجام داد.

مستند پایگاه داده – جدول درگاه پرداخت

payment_discount

جدول تخفیف‌ها و کدهای پرداخت

مقدمه

این جدول برای تعریف و مدیریت تخفیف‌های قابل استفاده در فرآیند پرداخت طراحی شده است. هر رکورد می‌تواند نمایانگر یک کد تخفیف عمومی یا اختصاصی باشد که با شرایط مشخصی مانند نوع تخفیف، سقف استفاده، تاریخ انقضا و دامنه کاربران قابل اعمال است. این ساختار نقش مهمی در سیاست‌های تشویقی و کنترل مالی سامانه دارد.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT AUTO_INCREMENT شناسه یکتای هر تخفیف
branch SMALLINT UNSIGNED شناسه دفتر متصل به جدول آفیس
title VARCHAR(255) عنوان نمایشی تخفیف
code VARCHAR(255) کد تخفیف قابل استفاده در پرداخت
discount_type ENUM('percentage','amount') نوع تخفیف (درصدی یا مبلغ ثابت)
discount_value INT مقدار تخفیف بر اساس نوع انتخاب‌شده
type ENUM('lottery') نوع منبع یا سناریوی تخصیص تخفیف
group BIGINT شناسه گروه کاربران مجاز به استفاده از تخفیف
user BIGINT شناسه کاربر مشخص در صورت اختصاصی بودن تخفیف
expiration DATETIME تاریخ و زمان انقضای اعتبار تخفیف
limit INT حداکثر تعداد دفعات مجاز استفاده از تخفیف
status INT وضعیت تخفیف (فعال یا غیرفعال)
created_at DATETIME زمان ایجاد تخفیف در سامانه

نتیجه‌گیری

جدول تخفیف‌های پرداخت امکان پیاده‌سازی سیاست‌های متنوع تشویقی و کنترلی را در سامانه فراهم می‌کند. با استفاده از این ساختار می‌توان تخفیف‌های هدفمند، محدود و زمان‌دار تعریف کرد و تأثیر آن‌ها را بر فرآیند پرداخت و رفتار کاربران به‌صورت دقیق مدیریت نمود.

مستند پایگاه داده – جدول تخفیف‌های پرداخت

temporary_payment

جدول پرداخت‌های موقت

مقدمه

این جدول برای ذخیره‌سازی موقت اطلاعات پرداخت در حین انجام عملیات مالی طراحی شده است. رکوردهای این جدول معمولاً پیش از تأیید نهایی پرداخت یا در زمان تبادل اطلاعات با درگاه بانکی ایجاد می‌شوند و نقش واسط میان درخواست اولیه و ثبت نهایی تراکنش مالی را ایفا می‌کنند.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT شناسه یکتای پرداخت موقت
branch INT شناسه دفتر متصل به جدول آفیس
operator_type ENUM('b2e','b2b','b2c') نوع اپراتور یا مدل تجاری پرداخت
operator INT شناسه اپراتور یا کاربر ایجادکننده درخواست پرداخت
gateway_id BIGINT ارجاع به رکورد درگاه پرداخت مرتبط
request LONGTEXT اطلاعات کامل درخواست ارسال‌شده به درگاه پرداخت
response LONGTEXT پاسخ دریافتی از درگاه پرداخت در صورت بازگشت
status INT وضعیت پرداخت موقت (در انتظار، موفق، ناموفق)
created_at DATETIME زمان ایجاد رکورد پرداخت موقت
updated_at DATETIME زمان آخرین به‌روزرسانی وضعیت پرداخت

نتیجه‌گیری

جدول پرداخت‌های موقت نقش حیاتی در پایداری و اطمینان فرآیندهای مالی سامانه دارد. این ساختار امکان ثبت مرحله‌ای اطلاعات، مدیریت خطاهای احتمالی در ارتباط با درگاه و جلوگیری از ثبت تراکنش‌های ناقص یا تکراری را فراهم می‌سازد و مکمل جداول نهایی پرداخت و کیف پول محسوب می‌شود.

مستند پایگاه داده – جدول پرداخت‌های موقت

pays

جدول اسناد دریافت و پرداخت

مقدمه

این جدول هسته‌ی اصلی ثبت عملیات مالی سامانه محسوب می‌شود و برای ذخیره‌سازی تمامی اسناد دریافت، پرداخت، انتقال، تسویه و ثبت‌های حسابداری مورد استفاده قرار می‌گیرد. هر رکورد نمایانگر یک سند مالی مستقل است که می‌تواند به اشخاص، حساب‌ها، اشیاء عملیاتی و اسناد پشتیبان متصل باشد.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT شناسه یکتای سند مالی
serial INT شماره سریال سند، معمولاً برای اسناد دستی
branch SMALLINT UNSIGNED شناسه دفتر متصل به آفیس
year INT سال مالی مربوط به سند
group BIGINT گروه یا دسته‌بندی حسابداری سند
type ENUM('receive','payment') نوع سند مالی (دریافت یا پرداخت)
type_pay ENUM('gateway','card','pay','pos','coupon',...) روش یا ابزار پرداخت
deadline VARCHAR(255) تاریخ یا مهلت تسویه سند
moeen INT شناسه حساب معین مرتبط با سند
object_type ENUM('airline','hotel','reference','aggregation',...) نوع شیء عملیاتی مرتبط با سند
object LONGTEXT شناسه یا داده شیء عملیاتی
account_party_type ENUM('bank','account','colleague','remittance',...) نوع طرف حساب سند
account_party BIGINT شناسه حساب یا طرف مالی عملیات
functor_type ENUM('colleague','customer','other','personnel',...) نوع ذی‌نفع یا دریافت‌کننده
functor_account VARCHAR(255) حساب یا شناسه ذی‌نفع
currency VARCHAR(255) نوع ارز سند
fee INT کارمزد مرتبط با عملیات مالی
currency_amount BIGINT مبلغ ارزی سند
wage BIGINT مبلغ دستمزد یا سهم سامانه
tracking_code VARCHAR(255) کد رهگیری یا مرجع پرداخت
documents LONGTEXT اسناد و فایل‌های پیوست مالی
description LONGTEXT توضیحات تکمیلی سند
financial_lock ENUM('Lock') قفل مالی برای جلوگیری از تغییرات
relationship BIGINT ارتباط با سند یا مرجع مالی دیگر
establishment BIGINT شناسه مجموعه یا نهاد ثبت‌کننده
details LONGTEXT جزئیات محاسباتی یا اطلاعات تکمیلی
status INT وضعیت سند مالی
accounting_sync TINYINT(1) وضعیت همگام‌سازی با سیستم حسابداری
document_at DATETIME تاریخ صدور سند مالی
created_at TIMESTAMP زمان ایجاد رکورد
updated_at TIMESTAMP زمان آخرین ویرایش سند

نتیجه‌گیری

جدول اسناد مالی ستون فقرات سیستم حسابداری و پرداخت سامانه است. این ساختار امکان ردیابی کامل جریان‌های مالی، کنترل حساب‌ها، اتصال به اشیاء عملیاتی و تهیه گزارش‌های دقیق مدیریتی و حسابداری را فراهم می‌سازد و مبنای اصلی تحلیل مالی سیستم به شمار می‌رود.

مستند پایگاه داده – جدول اسناد مالی

pledgers

جدول تعهدات و تضمین‌های مالی

مقدمه

این جدول برای ثبت اطلاعات مربوط به تعهدات مالی، تضمین‌ها و اسناد ضمانتی مورد استفاده قرار می‌گیرد. هر رکورد نشان‌دهنده یک تعهد مشخص است که می‌تواند به یک سند مالی، عامل اجرایی یا فرآیند خاص در سیستم مرتبط باشد و نقش کنترلی مهمی در مدیریت ریسک‌های مالی ایفا می‌کند.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT UNSIGNED شناسه یکتای تعهد مالی
type VARCHAR(255) نوع تعهد یا ماهیت تضمین ثبت‌شده
serial_id BIGINT شناسه سند یا رکورد مرجع که تعهد به آن وابسته است
factor BIGINT شناسه عامل یا فاکتور مرتبط با تعهد
amount BIGINT مبلغ تعهد یا تضمین مالی
created_at TIMESTAMP زمان ایجاد رکورد تعهد
updated_at TIMESTAMP زمان آخرین به‌روزرسانی اطلاعات تعهد

نتیجه‌گیری

جدول تعهدات مالی ابزاری کلیدی برای ثبت و پیگیری تضمین‌ها و مسئولیت‌های مالی در سامانه است. این ساختار امکان کنترل تعهدات باز، ارتباط آن‌ها با اسناد مالی و تحلیل ریسک‌های مرتبط را فراهم کرده و مکمل مهمی برای هسته حسابداری و پرداخت سیستم محسوب می‌شود.

مستند پایگاه داده – جدول تعهدات مالی

factors

جدول مراجع بلیط مسافران

مقدمه

این جدول برای ثبت اطلاعات هر بلیط صادرشده برای مسافران در سامانه طراحی شده است. هر رکورد نمایانگر یک مرجع مستقل فروش یا صدور بلیط بوده و تمامی اطلاعات پایه‌ای مربوط به مسافر، مسیر، وضعیت مالی و فرآیند تأیید را در خود نگهداری می‌کند. این ساختار، پایه‌ی اصلی اتصال بین فروش، حسابداری و گزارش‌گیری عملیاتی سیستم محسوب می‌شود.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT UNSIGNED شناسه یکتای مرجع بلیط
serial BIGINT شماره سریال داخلی مرجع فروش
branch SMALLINT UNSIGNED شناسه دفتر با کلید خارجی متصل به دفاتر
slug VARCHAR(255) شناسه متنی مرجع برای لینک یا رهگیری
type_factor INT نوع سند مالی مرتبط با بلیط
operator INT UNSIGNED اپراتور ثبت‌کننده یا صادرکننده بلیط
colleague_auth INT شناسه همکار یا عامل مجاز فروش
customer BIGINT UNSIGNED شناسه مسافر یا مشتری
description LONGTEXT توضیحات عمومی مربوط به بلیط
financial_desc LONGTEXT توضیحات مالی و حسابداری بلیط
route ENUM('internal','international') نوع مسیر بلیط (داخلی یا خارجی)
income VARCHAR(255) نوع درآمد
discount BIGINT مبلغ تخفیف اعمال‌شده روی بلیط
checkout VARCHAR(255) اطلاعات تسویه یا روش پرداخت
print INT وضعیت چاپ بلیط (۰ بدون چاپ، ۱ چاپ بدون قیمت، ۲ چاپ با قیمت)
confirmation TIMESTAMP زمان تأیید نهایی بلیط توسط مسافر
status INT وضعیت جاری مرجع بلیط
created_at TIMESTAMP زمان ایجاد رکورد بلیط
updated_at TIMESTAMP زمان آخرین ویرایش اطلاعات
snapshot_updated_at DATETIME زمان آخرین ثبت تصویر وضعیت مرجع

نتیجه‌گیری

جدول مراجع بلیط، نقطه‌ی اتصال بین مسافر، فروش، عملیات و حسابداری در سامانه است. این جدول امکان ردیابی کامل هر بلیط، بررسی وضعیت مالی، کنترل فرآیند تأیید و تهیه گزارش‌های دقیق عملیاتی و مدیریتی را فراهم می‌سازد و یکی از مهم‌ترین جداول محوری سیستم به شمار می‌رود.

مستند پایگاه داده – جدول مراجع بلیط

factor_items

جدول اقلام تشکیل‌دهنده بلیط

مقدمه

این جدول برای ثبت جزئیات هر یک از اقلام تشکیل‌دهنده یک بلیط در سامانه طراحی شده است. هر بلیط می‌تواند شامل چندین خدمت یا محصول مختلف مانند پرواز، هتل، سرویس زمینی یا خدمات جانبی باشد که هر یک به‌صورت مستقل در این جدول ذخیره می‌شوند. این ساختار امکان مدیریت ترکیبی بلیط‌ها و محاسبات مالی دقیق برای هر بخش را فراهم می‌کند.

ساختار جدول

نام ستون نوع داده توضیح
id BIGINT شناسه یکتا
factor_id BIGINT UNSIGNED شناسه مرجع بلیط مرتبط
product ENUM نوع محصول یا خدمت اصلی بلیط
byproduct ENUM زیرنوع یا دسته‌بندی تکمیلی خدمت
details LONGTEXT جزئیات کامل مربوط به این قلم بلیط
customer_id BIGINT UNSIGNED شناسه مسافر یا ذی‌نفع این قلم
supplier_id BIGINT UNSIGNED شناسه تأمین‌کننده یا ارائه‌دهنده خدمت
currency VARCHAR(255) نوع واحد پولی محاسبه
fee INT کارمزد یا هزینه جانبی مرتبط با قلم
currency_amount INT مبلغ بر اساس واحد پول ثبت‌شده
buy BIGINT مبلغ خرید یا بهای تمام‌شده
sale BIGINT مبلغ فروش این قلم
type_value_added ENUM نوع ارزش افزوده اعمال‌شده
value_added BIGINT مقدار ارزش افزوده
deadline VARCHAR(255) مهلت زمانی یا سررسید انجام خدمت
financial_lock ENUM وضعیت قفل مالی قلم بلیط
relationship BIGINT ارتباط مالی با قلم یا سند دیگر
failure_bill INT وضعیت صدور سند ناموفق
status INT وضعیت جاری قلم بلیط
created_at TIMESTAMP زمان ایجاد رکورد
updated_at TIMESTAMP زمان آخرین ویرایش

نتیجه‌گیری

جدول اقلام بلیط، امکان تفکیک و مدیریت دقیق اجزای تشکیل‌دهنده هر بلیط را فراهم می‌سازد. این ساختار، پایه‌ی محاسبات مالی، کنترل سود و زیان، مدیریت تأمین‌کنندگان و گزارش‌گیری جزئی از فروش را تشکیل می‌دهد و نقش حیاتی در یکپارچگی فرآیند فروش و حسابداری سامانه ایفا می‌کند.