Watch
1
0
Fork
You've already forked Seyyed_arc
0
forked from hesabix/arc
Seyyed_arc/docs/QUICK_SALES_AUDIT_HARDENING_2026-10-17.md

5.8 KiB

سخت‌سازی فروش سریع پس از ممیزی

این سند تغییرات ممیزی فروش سریع در شاخه codex/quick-sales-audit-hardening را برای بازبینی، استقرار و آزمون ثبت می‌کند.

ثبت فاکتور و مبالغ

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

دسترسی و حریم اطلاعات مشتری

سه مجوز مستقل به بخش quick_sales افزوده شده است:

  • create_customer: ثبت سریع مشتری
  • view_customer_contact: جست‌وجو و مشاهده اطلاعات تماس مشتری
  • view_customer_balance: مشاهده مانده حساب مشتری

کاربری که مجوز متناظر در بخش اشخاص (people.add یا people.view) دارد نیز مجاز است. migration برای کاربران فعلی دارای مجوز ثبت/ویرایش فاکتور، این سه دسترسی را فعال می‌کند و مقدارهای صریح قبلی را تغییر نمی‌دهد.

مشتری ناشناس و تنظیمات

  • خواندن مشتری ناشناس دیگر داده‌ای در پایگاه داده ایجاد یا ویرایش نمی‌کند.
  • ایجاد مشتری ناشناس فقط با POST و مجوز ثبت فاکتور انجام می‌شود.
  • تنها شناسه ذخیره‌شده در تنظیمات، مشتری ناشناس را مشخص می‌کند؛ تشابه نام یک شخص واقعی با عنوان «مشتری ناشناس» سبب انتخاب خودکار او نمی‌شود.
  • ارز پیش‌فرض باید به کسب‌وکار تخصیص داده شده باشد.
  • قالب چاپ باید منتشرشده، متعلق به همان کسب‌وکار و مربوط به فاکتورها باشد.

رابط کاربری

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

migration و ترتیب استقرار

migration جدید:

20261017_000001_quick_sales_audit_permissions

والد آن 20261015_000001_quick_sales_web_shortcut است و یک head جدید موازی نمی‌سازد. ترتیب استقرار پیشنهادی: اجرای migration، استقرار API، سپس انتشار رابط کاربری است. API جدید برای فروش سریع، وجود quick_sale_request_id را الزامی می‌کند؛ بنابراین رابط قدیمی نباید بعد از استقرار API برای ثبت فروش سریع استفاده شود.

آزمون پذیرش پیشنهادی

  1. یک فروش را با دوبار کلیک سریع روی ثبت ارسال کنید؛ فقط یک فاکتور باید ایجاد شود.
  2. دو صندوق هم‌زمان آخرین موجودی یک کالا را بفروشند؛ یکی باید خطای کسری دریافت کند.
  3. دو صندوق هم‌زمان مانده بستانکاری یک مشتری را اعمال کنند؛ درخواست دوم باید مانده جدید را دریافت کند.
  4. یک پرونده کسری را هم‌زمان در دو نشست اصلاح کنید؛ فقط یک سند اصلاح ساخته شود.
  5. دسترسی‌های سه‌گانه مشتری را جداگانه خاموش و رفتار جست‌وجو، ثبت و مانده را بررسی کنید.
  6. یک قیمت صفر در لیست قیمت تعریف و ثبت مبلغ صفر همان ردیف را کنترل کنید.
  7. دکمه پرداختی با ارز متفاوت بسازید؛ رابط باید پیش از افزودن پرداخت آن را رد کند.