# راهنمای کاربران

## نقش‌ها

### مدیر کل

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

### مدیر تأمین

فاکتور دستی ثبت می‌کند، فایل مالی وارد می‌کند، کالا و درخواست‌کننده را مدیریت می‌کند، مغایرت را رفع می‌کند و تحویل کامل/جزئی را برای انبار می‌فرستد.

### انباردار

فقط صف انبار تخصیص‌یافتهٔ خود را می‌بیند و می‌تواند «تحویل»، «لغو با دلیل»، «برگشت با دلیل» و سپس «تحویل مجدد همان درخواست» را ثبت کند.

## گردش استاندارد

1. مدیر تأمین از «فاکتورها» فاکتور مالی یا دستی را باز می‌کند.
2. درخواست‌کننده و انبار را انتخاب می‌کند؛ در حالت جزئی، ردیف‌ها و مقدار هر ردیف را تعیین می‌کند.
3. سامانه مقدار باقیمانده را در تراکنش کنترل و درخواست را در صف همان انبار ثبت می‌کند.
4. انباردار جزئیات و سابقه را بازبینی و نتیجه را ثبت می‌کند.
5. تمام مراحل با عامل، نقش، IP، زمان جلالی/UTC و دلیل در timeline و audit باقی می‌مانند.

## فاکتور بدون ردیف

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

## لغو، برگشت و تحویل مجدد

- لغو فقط روی درخواست در انتظار یا برگشت‌خورده و با دلیل انجام می‌شود.
- برگشت فقط پس از تحویل و با دلیل ثبت می‌شود.
- تحویل مجدد همان شناسه و همان اقلام را دنبال می‌کند و رخداد جدید به timeline اضافه می‌شود؛ سابقهٔ قبلی بازنویسی نمی‌شود.

## رفع مغایرت

در صفحهٔ مغایرت، نسخهٔ دستی و مالی کنار هم نمایش داده می‌شوند. برای اطلاعات هویتی و هر ردیف کالا منبع نهایی را انتخاب کنید. نسخهٔ resolved جدید ساخته می‌شود و انتخاب‌ها audit می‌شوند؛ نسخه‌های قبلی حذف یا ویرایش نمی‌شوند.

## گزارش

در «گزارش‌ها» بازهٔ امروز، دیروز یا بازهٔ سفارشی جلالی را انتخاب کنید. فایل خروجی چهار sheet دارد: «وضعیت تحویل»، «ثبت خروج تأمین»، «تاریخچه انبارداری» و «تغییرات مالی». سبز نشان‌دهندهٔ تحویل کامل و زرد نشان‌دهندهٔ جزئی/درانتظار است؛ متن وضعیت همیشه همراه رنگ وجود دارد.

## اعلان و تم

اعلان داخل سامانه مستقل از مجوز مرورگر است. فعال‌کردن Web Push نیازمند اجازهٔ صریح مرورگر و کلید VAPID سرور است. تم روشن/تیره در همان مرورگر ذخیره می‌شود.