شمشاب
مطالعه‌ی موردی ۰۱ · فین‌تک · B2B

معامله‌ی طلا،
بدون اکسل و کارت‌به‌کارت دستی.

پلتفرم white-label معامله‌ی طلا، نقره و سکه با تسویه‌ی هوشمند، برای طلافروش‌ها و بنکدارها؛ از نرخ لحظه‌ای تا دفتر کل تغییرناپذیر و تحویل فیزیکی.

نقش
محصول و توسعه‌ی full-stack
زمان
اردیبهشت ۱۴۰۵ تا اکنون
استک
Odoo 17 · React 19 · PostgreSQL
وضعیت
زنده روی goldjavadi.ir

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

v1.0.106 نسخه‌ی منتشرشده با تگ و changelog
۹۱۱ کامیت در شش ماه
۱٬۷۵۷ تست در گیت کیفیت
۸ سند تصمیم معماری (ADR)

01مسئله

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

امروزبا شمشاب
کپی‌کردن دستی شماره‌کارت و خطای سقف تسویه‌ی هوشمند با سقف روزانه و ماهانه
دفتر خرید و فروش مبهم دفتر کل تغییرناپذیر دارایی و پول (گرم تا ۶ رقم اعشار)
یک برند، چند مشتری white-label برای هر فروشگاه: نام، رنگ، لوگو، پیامک
بررسی دستی و کُند اپراتور هاب عملیات پولی، تسویه‌ها و گزارش‌ها

02قابلیت‌های شاخص

هر کارت، همان بخش واقعی پورتال است که از کد خود محصول بازسازی شده؛ روی کارت بروید تا حرکتش را ببینید.

TRADE · PRICE LOCK

معامله‌ی آنی با قفل نرخ

نرخ زنده از TGJU، مبلغ به تومان و معادل به گرم تا ۶ رقم اعشار. وقتی مشتری تأیید را می‌زند، نرخ برایش قفل می‌ماند تا بازار وسط خرید جابه‌جا نشود.

SMART BANK · MULTI-LEG

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

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

ATOMIC CAPACITY

رزرو اتمی سقف کارت‌ها

پیش از نشان‌دادن کارت مقصد، ظرفیت روزانه و ماهانه‌اش رزرو می‌شود؛ هیچ پرداختی از سقف رد نمی‌شود و شمارنده‌ها نیمه‌شب تهران امن ریست می‌شوند.

CAPACITY RECOVERY

سقف پر شد؟ رزرو برای فردا

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

IMMUTABLE LEDGER

دفتر کل تغییرناپذیر

هیچ سطر posted حذف یا ویرایش نمی‌شود؛ اصلاح فقط با سند معکوس. موجودی هر دارایی همیشه از خود دفتر حساب می‌شود.

RATE HISTORY

تاریخچه‌ی نرخ هر دارایی

نمودار خرید و فروش از روز تا سال، با همان موتور TradingView که در خود پورتال کار می‌کند.

CARD SCAN → IBAN

اسکن کارت، شبا خودش می‌آید

مشتری از روی کارت عکس می‌گیرد؛ شماره‌ی کارت خوانده می‌شود و شبا و مالکیت حساب خودکار استعلام می‌شود. اگر سرویس جواب ندهد، ورود دستی آماده است.

WHITE-LABEL · ONE CORE

یک هسته، هر فروشگاه با برند خودش

هر طلافروش image و دیتابیس خودش را می‌گیرد و پورتال با نام، لوگو، رنگ، پیشوند پیامک و نام PWA خود او بالا می‌آید؛ کد یکی است.

03نقش من

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

مالک محصولمعماریتوسعه‌ی full-stackDevOps و استقرارQA

04تصمیم‌های کلیدی

هر تصمیم هزینه‌ای داشت. مهم‌ترین‌هایشان و بهایی که برایشان دادیم:

ADR-0002

هر فروشگاه، یک استک جدا

به‌جای یک دیتابیس مشترک multi-tenant، هر مشتری image و Postgres خودش را می‌گیرد.

هزینه: نگه‌داری چند سرور؛ سود: ایزوله‌بودن پول و داده‌ی هر فروشگاه.
LEDGER

دفتر کل تغییرناپذیر

هیچ ردیف مالی ویرایش نمی‌شود؛ اصلاح یعنی ردیف معکوس. موجودی همیشه از دفتر محاسبه می‌شود.

هزینه: گزارش‌گیری پیچیده‌تر؛ سود: ردپای کامل هر ریال.
SMART BANK

رزرو اتمی ظرفیت کارت

پرداخت چندبخشی به کارت‌های مقصد، با رزرو و آزادسازی اتمی سقف روزانه و ماهانه و ریست امن نیمه‌شب تهران.

هزینه: قفل و reconcile؛ سود: هیچ پرداختی از سقف رد نمی‌شود.
ODOO 17

Odoo به‌جای بک‌اند از صفر

حسابداری، نقش‌ها و پنل ادمین آماده؛ تمرکز روی منطق معامله و تسویه.

هزینه: محدودیت‌های فریمورک؛ سود: رسیدن به مشتری، ماه‌ها زودتر.

05معماری

پنج ماژول Odoo با مرز مشخص، یک SPA برای مشتری و یک پنل OWL برای فروشگاه.

معماری شمشاب: پورتال React و پنل ادمین OWL روی پنج ماژول Odoo 17 (portal، auth، trading، smart_bank، core) با PostgreSQL، درگاه پیامک و منابع نرخ.

06تحویل و کیفیت

چون با پول مردم کار داریم، هیچ چیزی بدون عبور از این زنجیره به سرور مشتری نمی‌رسد:

commitتغییر جراحی و کوچک
CIتست واحد و Playwright
دموdemo.shemshab.ir
تگ نسخهVERSION + CHANGELOG
مشتریimage از GHCR

07نتیجه

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

08آموخته‌ها

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