مشخصات فنی ژرفبان
ژرفبان نرمافزار تحت وب است: در مرورگر رایانه و موبایل باز میشود، هر شرکت نصب و نشانی جداگانهٔ خودش را دارد و داده در PostgreSQL نگه داشته میشود. بستههای مالی حرفهای و جامع API فقطخواندنی و وبهوک امضاشده دارند، گزارشها به اکسل و PDF میروند، هر شب پشتیبان گرفته میشود و هر هفته بازیابی تمرین میشود. جزئیات هر کدام را پایینتر آوردهایم.
ژرفبان روی چه چیزی اجرا میشود؟
یک برنامهٔ وب با دو بخش، رابط کاربری و سرویس حسابداری، که برای هر شرکت جداگانه نصب میشود.
- رابط کاربری
- برنامهٔ وب React، راستبهچپ و فارسی، بدون نصب روی رایانهٔ کاربر.
- سرور
- Node.js با Fastify، در دو سرویس جدا: رابط کاربری و حسابداری.
- پایگاه داده
- PostgreSQL نسخهٔ ۱۸.
- جداسازی مشتریها
- هر شرکت نصب جداگانه با پایگاه داده و نشانی اختصاصی خودش دارد و کار روی یک نصب به نصب دیگری دست نمیزند.
- محل نصب
- نسخهٔ ابری، یا نصب روی سرور خود شرکت. شرایط نصب روی سرور شرکت را در صفحهٔ حسابداری ابری آوردهایم.
با چه مرورگر و دستگاهی کار میکند؟
با مرورگر. صفحهها خودشان را با اندازهٔ نمایشگر رایانه و موبایل هماهنگ میکنند.
- مرورگر
- آزمونهای خودکار مرورگر روی Chromium، موتور Chrome و Edge، اجرا میشوند. اگر سازمانتان مرورگر دیگری را استاندارد کرده، آن را در دمو امتحان کنید.
- ورود
- با شمارهٔ موبایل و کد پیامکی. کلید عبور (passkey) هم پشتیبانی میشود و افزودنش کد پیامکی تازه میخواهد.
- افزونهٔ مرورگر
- افزونهٔ Chrome ژرفبان برای کارپوشهٔ مودیان و سامانهٔ جامع تجارت. دربارهٔ افزونه
- اپلیکیشن اندروید
- «ژرفبان فروش» برای کارشناس فروش: ارسال تماسهای ضبطشده و پیامکهای کاری. فایل نصبی امضاشده از نشانی خود ژرفبان داده میشود، نه از Google Play. ضبط تماس فقط با گوشی سامسونگ کار میکند و آیفون پشتیبانی نمیشود.
API ژرفبان چه چیزی را میدهد؟
API نسخهٔ ۱ فقط میخواند و هیچ مسیری در آن چیزی ثبت نمیکند. هر کلید فقط به یک دفتر دسترسی دارد و دفتر از خود کلید خوانده میشود، نه از پارامتری که فراخواننده میفرستد. ثبت از راه API در نقشهٔ راه است.
- نشانی پایه
- نشانی اختصاصی شرکت شما، بهعلاوهٔ
/fin/api/v1 - احراز هویت
- سرآیند
Authorization: Bearer zbk_…. کلید نامعتبر، باطلشده یا منقضی یک پیام یکسان میگیرد تا چیزی دربارهٔ کلید لو نرود. - کلید
- فقط مدیر سیستم، از داخل خود ژرفبان، کلید میسازد و هیچ کلیدی نمیتواند کلید دیگری بسازد. کلید فقط یک بار نمایش داده میشود، تاریخ انقضای اختیاری دارد، باطلشدنی است و آخرین استفادهاش ثبت میشود.
- صفحهبندی
- پارامترهای
limitوoffset؛ هر صفحه پیشفرض ۵۰ و حداکثر ۲۰۰ ردیف.
| مسیر | چه میدهد |
|---|---|
/whoami | کلید و دفتری که به آن دسترسی دارد؛ اولین فراخوانی برای آزمودن راهاندازی |
/fiscal-years | سالهای مالی همان دفتر |
/accounts | سرفصل حسابها، با انتخاب سطح |
/parties | طرفحسابها، با جستجو |
/vouchers | اسناد، با فیلتر سال مالی و وضعیت دائمی یا موقت |
/vouchers/:id | یک سند با ردیفهایش |
/reports/trial-balance | تراز آزمایشی |
/reports/by-class | گزارش گروههای حساب |
وبهوکها چطور کار میکنند و چطور اصالتشان را بسنجیم؟
برای هر مقصد رویدادها را انتخاب میکنید. ارسال هیچوقت ثبت سند را معطل نمیکند: رویداد در صف مینشیند و جدا ارسال میشود.
| رویداد | کی ارسال میشود |
|---|---|
voucher.created | ثبت سند |
voucher.posted | دائمیشدن سند |
sales_invoice.issued | صدور فاکتور فروش |
cheque.created | ثبت چک |
cheque.status_changed | تغییر وضعیت چک |
statement.posted | ثبت صورتوضعیت |
payment_order.approved | تأیید دستور پرداخت |
- بدنه
- JSON با سه فیلد
event،company_idوdata. - سرآیندها
x-zharfban-event،x-zharfban-timestampوx-zharfban-signature.- امضا
- HMAC با الگوریتم
SHA-256و کلید امضای همان مقصد، روی زمان ارسال و بدنه با هم. چون زمان جزو متن امضاشده است، ارسالی را که مدتی بعد دوباره فرستاده شود میتوانید رد کنید. - تلاش دوباره
- اگر مقصد پاسخ موفق ندهد، ارسال تا ۶ بار انجام میشود: بار اول و ۵ بار دوباره، به فاصلهٔ ۵، ۱۵، ۶۰، ۲۴۰، ۷۲۰ دقیقه. پس از آخرین شکست، ارسال رها و مقصد غیرفعال میشود تا نشانیاش بررسی و دوباره فعال شود. هر تلاش حداکثر ۱۰ ثانیه منتظر پاسخ میماند.
- ایمنی مقصد
- تغییر مسیر (redirect) دنبال نمیشود و نشانی مقصد پیش از هر تلاش دوباره بررسی میشود تا به نشانی داخلی شبکه نرسد.
- دفتر تحویل
- وضعیت هر ارسال، یعنی تحویلشده، در صف یا رهاشده، همراه تعداد تلاشها و آخرین پاسخ مقصد.
از ژرفبان چه خروجیهایی میگیرید؟
فایلهایی که سامانهها و بانکها میپذیرند، با همان قالب آنها، و گزارشهایی که در اکسل هم قابل جمع و فیلترند.
| قالب | چه چیزی |
|---|---|
| اکسل | گزارشهای مالی، با مبلغ بهصورت عدد واقعی در سلول، واحد ریال در سرستون، برگهٔ راستبهچپ، فیلتر خودکار و ردیف جمع با فرمول |
| چاپ و PDF | هر گزارش از نوار ابزار خودش چاپ میشود و از پنجرهٔ چاپ مرورگر به PDF ذخیره میشود |
| اکسل یا CSV | فایل سامانهٔ دفاتر تجاری الکترونیکی برای بازهٔ ماهانه یا سهماهه؛ برای مبلغهای بسیار بزرگ CSV پیشنهاد میشود تا هیچ رقمی گم نشود |
| DBF | لیست بیمهٔ تأمین اجتماعی هر کارگاه و ماه، جفت فایل DSKKAR00 و DSKWOR00 |
| متن | فایلهای WP و WH مالیات حقوق |
| اکسل بانک | فایل «Records» انتقال گروهی بانک ملی از دستور پرداخت گروهی |
| JSON | هر چه API فقطخواندنی میدهد: حسابها، طرفحسابها، اسناد و تراز |
فهرست کامل سامانههایی که ژرفبان به آنها وصل میشود در صفحهٔ اتصالها آمده است.
پشتیبانگیری و بازیابی چطور انجام میشود؟
پشتیبانی که هیچوقت بازیابی نشده، فقط یک امید است. برای همین بازیابی هم مثل پشتیبانگیری خودکار است.
- هر شب
- از هر نصب ابری پشتیبان گرفته میشود.
- هر هفته
- آخرین پشتیبان در یک پایگاه دادهٔ جدا و دورریختنی بازیابی میشود، جدولهای اصلی شمرده میشوند و نتیجه با تاریخ ثبت میشود. این تمرین روی پایگاه دادهٔ اصلی انجام نمیشود.
- پیش از هر بهروزرسانی
- از پایگاه داده نسخه گرفته میشود، بعد تغییرات اعمال میشود. اگر نسخهٔ تازه سالم بالا نیاید، نرمافزار خودکار به نسخهٔ قبلی برمیگردد.
- تغییر ساختار داده
- طوری نوشته میشود که نسخهٔ قبلی نرمافزار هم با آن کار کند. بررسی خودکار هر حذف یا تغییر نام ستونی را که دلیلش ثبت نشده باشد رد میکند.
- نصب روی سرور شرکت
- محدودهٔ پشتیبانگیری و تمرین بازیابی در شرح کار همان نصب نوشته میشود.
اگر از ژرفبان برویم، دادهمان چه میشود؟
حذف خودکار در کار نیست: با پایان یا توقف اشتراک، نصب فقط از دسترس خارج میشود. راه بیرون بردن داده هم از روز اول در دسترس است.
- توقف، نه حذف
- وقتی اشتراکی تمام یا متوقف میشود، نصب فقط از دسترس خارج میشود. پایگاه داده، فایلهای پیوست و نسخهٔ نرمافزار دستنخورده میمانند و ادامهٔ کار فوری است.
- حذف
- حذف دفاتر یک شرکت هیچوقت خودکار نیست و با یک فرمان هم انجام نمیشود؛ کاری عمدی و دستی است، با پشتیبانِ تازه در دست.
- بیرون بردن داده
- گزارشها به اکسل، فایل دفاتر الکترونیکی هر دوره و API فقطخواندنی برای حسابها، طرفحسابها، اسناد و تراز.
- در قرارداد
- شکل و زمان تحویل کامل داده هنگام پایان قرارداد را در قرارداد بنویسید و پیش از امضا، یک خروجی واقعی را در دمو امتحان کنید.
جلسهٔ فنی بخواهید
در دموی آنلاین، API و وبهوک را در تنظیمات و خروجی اکسل را روی گزارشها ببینید. برای پرسشهای تیم فناوری، همراه دموی مالی یک جلسهٔ فنی هم بخواهید.
پیام واتساپ را در ساعات کاری و ایمیل را حداکثر ظرف یک روز کاری جواب میدهیم · تماس: ۰۹۰۱ ۲۲۲ ۲۰۸۰