forked from hesabix/arc
75 lines
5.8 KiB
Markdown
75 lines
5.8 KiB
Markdown
# سختسازی فروش سریع پس از ممیزی
|
|
|
|
این سند تغییرات ممیزی فروش سریع در شاخه
|
|
`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. دکمه پرداختی با ارز متفاوت بسازید؛ رابط باید پیش از افزودن پرداخت آن را رد کند.
|