متن‌باز · MIT · آماده استقرار با Docker

سامانه گزارش‌گیری سازمانی

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

زمان پاسخ محاسبات
‎<۵۰ms
رقم اعشار دقت
۱۶
endpoint آماده
۵۱
تست خودکار
۱۱۵

قابلیت‌های سامانه

محاسبات دقیق و آنی با پشتیبانی از ارزهای چندگانه

نرخ تسعیر از منابع معتبر (بانک مرکزی یا API صرافی‌ها) دریافت می‌شود، سود مرکب و اقساط با دقت Decimal تا ۱۶ رقم اعشار محاسبه می‌گردد و مبلغ نهایی در کمتر از ۵۰ میلی‌ثانیه نمایش داده می‌شود.

  • هیچ‌جای مسیر پولی از float استفاده نمی‌شود
  • زنجیره نرخ: بانک مرکزی ← API صرافی ← آخرین نرخ معتبر
  • p99 اندازه‌گیری‌شده: ۱٫۷ میلی‌ثانیه

گردش‌کار تأیید چندمرحله‌ای

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

  • ترتیب مراحل سخت‌گیرانه اعمال می‌شود
  • امضای RSA-2048 روی هش محتوای گزارش
  • تغییر مبلغ پس از تأیید، امضاها را باطل می‌کند

داشبورد هوشمند و هشدارهای آنی

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

  • تشخیص ناهنجاری آماری مبتنی بر MAD
  • هشدار گردش‌کارهای متوقف‌شده
  • هشدارهای تکراری حذف می‌شوند

اتصال یکپارچه به سامانه‌های مالیاتی و بانکی

ارسال خودکار گزارش‌ها به سامانه مودیان، دریافت تأییدیه از درگاه بانک برای تسویه‌ها و تبادل داده با نرم‌افزارهای حسابداری از طریق REST API یا فایل‌های XML/JSON استاندارد.

  • همه فراخوانی‌ها idempotent هستند
  • اعتبارسنجی IBAN با الگوریتم mod-97
  • تلاش مجدد با backoff نمایی

امنیت لایه‌ای و حسابرسی کامل

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

  • زنجیره هش: H(هش قبلی ‖ محتوا)
  • شماره دقیق رکورد دستکاری‌شده گزارش می‌شود
  • پاک‌سازی خودکار گذرواژه و اطلاعات حساس از لاگ

پشته فناوری

بک‌اند با FastAPI و پایتون ۳٫۱۳، فرانت‌اند با Next.js 15 و React 19، پایگاه‌داده PostgreSQL برای محیط عملیاتی، و استقرار با Docker Compose.

  • FastAPI
  • Python 3.13
  • SQLAlchemy 2.0
  • PostgreSQL
  • Next.js 15
  • React 19
  • TypeScript
  • WebSocket
  • Docker
  • Argon2id
  • RSA-PSS
  • JWT

پرسش‌های متداول

سامانه گزارش‌گیری سازمانی چیست و چه مشکلی را حل می‌کند؟

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

چرا محاسبات با Decimal انجام می‌شود و نه اعداد اعشاری معمولی؟

نوع float در محاسبات پولی خطای انباشتی ایجاد می‌کند؛ برای مثال ۰٫۱ + ۰٫۲ دقیقاً ۰٫۳ نمی‌شود. این سامانه تمام مسیر پولی را با Decimal و گرد کردن بانکی تا ۱۶ رقم اعشار محاسبه می‌کند، به‌طوری که مجموع اجزای اصل اقساط دقیقاً برابر مبلغ اولیه است.

گردش‌کار تأیید چند مرحله دارد و امضای دیجیتال چگونه کار می‌کند؟

سه مرحله: مدیر مالی، سپس بازرس و در نهایت مدیرعامل. ترتیب مراحل سخت‌گیرانه اعمال می‌شود و پرش از یک مرحله خطا برمی‌گرداند. هر تصمیم با کلید RSA-2048 روی هش محتوای گزارش امضا می‌شود؛ بنابراین اگر پس از تأیید کسی مبلغ را تغییر دهد، همه امضاها باطل و این موضوع گزارش می‌شود.

آیا امکان اتصال به سامانه مودیان و درگاه بانکی وجود دارد؟

بله. سامانه صورتحساب امضاشده را به سامانه مودیان ارسال می‌کند، از درگاه بانک تأییدیه تسویه می‌گیرد و سند حسابداری دوطرفه را به‌صورت JSON یا XML استاندارد با نرم‌افزار حسابداری تبادل می‌کند. همه فراخوانی‌ها idempotent هستند و در حالت پیش‌فرض sandbox اجرا می‌شوند.

مسیر حسابرسی چگونه از دستکاری جلوگیری می‌کند؟

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

آیا پروژه متن‌باز است و می‌توان آن را در سازمان مستقر کرد؟

بله، تحت مجوز MIT منتشر شده و با Docker Compose در چند دقیقه بالا می‌آید. بک‌اند با FastAPI و پایتون ۳٫۱۳ و فرانت‌اند با Next.js پیاده‌سازی شده و PostgreSQL برای محیط عملیاتی پشتیبانی می‌شود.