راهنمای کامل سیستم حضور و غیاب فارسیب

۱مقدمه

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

مزایای کلیدی

• ✅ تحت وب و موبایل (PWA) — بدون نیاز به نصب از گوگل‌پلی
• ✅ ذخیره‌سازی محلی — داده‌ها روی دستگاه شما می‌مانند
• ✅ پشتیبانی کامل تقویم شمسی
• ✅ خروجی Excel و PDF برای همه گزارشات
• ✅ لایسنس امن با تأیید آنلاین
• ✅ پشتیبان‌گیری خودکار و دستی

۲نصب و راه‌اندازی

روش اول: نصب به‌صورت PWA روی موبایل

1. مرورگر Chrome (اندروید) یا Safari (iOS) را باز کنید
2. به آدرس https://farssib.ir/att بروید
3. در اندروید: منوی سه‌نقطه → «Install app» یا «Add to Home screen»
4. در iOS: دکمه Share → «Add to Home Screen»
5. آیکون سیب سبز روی صفحه اصلی اضافه می‌شود

روش دوم: استفاده مستقیم از مرورگر

بدون نصب، از هر مرورگری می‌توانید به آدرس بالا بروید و از برنامه استفاده کنید.

پیش‌نیازها

• مرورگر مدرن (Chrome 80+، Safari 14+، Firefox 78+)
• اتصال اینترنت (فقط برای فعال‌سازی و بررسی دوره‌ای لایسنس)
• حداقل ۵۰ مگابایت فضای دیسک

۳فعال‌سازی لایسنس

در اولین اجرا، صفحه فعال‌سازی نمایش داده می‌شود:

1. کد دستگاه شما نمایش داده می‌شود — روی دکمه «📋 کپی» بزنید
2. کد را به پشتیبانی فارسیب ارسال کنید (farssib.ir)
3. کلید لایسنس دریافت می‌کنید (مثلاً FARSI-1234-ABCD)
4. کلید را در فیلد «کلید لایسنس» وارد کنید
5. روی «✅ فعال‌سازی آنلاین» کلیک کنید
6. پیام موفقیت → به صفحه ورود منتقل می‌شوید

شرایط لایسنس

حالت آفلاین (Grace Period)

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

۴ورود به سیستم

پس از فعال‌سازی، صفحه ورود نمایش داده می‌شود:

۵آشنایی با رابط کاربری

قسمت‌های اصلی

• 📊سایدبار چپ: منوی دسترسی به همه بخش‌ها
• 🍎هدر بالا: لوگو و نام کاربر (در موبایل)
• 📱دکمه ☰: در موبایل، سایدبار را باز/بسته می‌کند
• 🚪پایین سایدبار: نمایش لایسنس + دکمه خروج

ویژگی‌های هوشمند

• تقویم شمسی: روی هر فیلد تاریخ کلیک کنید، تقویم باز می‌شود
• جستجو: در بیشتر جداول، کادر جستجو در بالای صفحه هست
• فیلتر سریع تاریخ: در داشبورد و گزارشات، «این ماه» / «ماه قبل» و ...
• خروجی Excel: دکمه «خروجی Excel» در جداول

۶تعریف پرسنل

اولین قدم برای راه‌اندازی سیستم، تعریف پرسنل است. به تعریف پرسنل بروید:

ویرایش و حذف

• روی دکمه «ویرایش» هر ردیف کلیک کنید
• فرم با مقادیر پر می‌شود، تغییر دهید و «به‌روزرسانی» بزنید
• حذف: دکمه قرمز «حذف» (تأیید می‌خواهد)

۷گروه پرسنلی

پرسنل را می‌توانید در گروه‌های مختلف دسته‌بندی کنید:

• مدیران
• کارشناسان
• کارگران
• پیمانکاران

هر پرسنل می‌تواند به یک گروه تعلق داشته باشد.

۸تعریف شیفت

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

فیلدهای اصلی

قوانین شیفت (۴ تیک)

• ☑️ اضافه‌کار قبل: اگر قبل از شیفت تردد شد، به‌عنوان اضافه‌کار محاسبه شود
• ☑️ اضافه‌کار بعد: اگر بعد از شیفت تردد شد، اضافه‌کار محاسبه شود
• ☑️ کسرکار شروع: اگر دیر آمد، کسرکار ثبت شود
• ☑️ کسرکار پایان: اگر زود رفت، کسرکار ثبت شود

۹الگوی حقوق

الگوی حقوق، مقادیر مالی و ضرایب محاسبه حقوق را تعیین می‌کند.

درآمد ثابت و کسور ثابت

هر خط یک آیتم با فرمت نام : مبلغ:

حق مسکن : 9000000
حق اولاد : 3000000
بن خواربار : 5000000

کسور ثابت:

قسط وام : 2000000
سرمایه‌گذاری : 500000

۱۰کارگزینی

کارگزینی یعنی «اتصال پرسنل به شیفت و الگوی حقوق در یک بازه تاریخ».

مراحل

1. پرسنل را از لیست انتخاب کنید
2. شیفت را انتخاب کنید (مثلاً «شیفت صبح»)
3. الگوی حقوق را انتخاب کنید
4. از تاریخ (شمسی) — مثلاً 1404/01/01
5. تا تاریخ — مثلاً 1404/12/29
6. ذخیره کنید

قوانین مهم

• ❌ همپوشانی مجاز نیست — نمی‌توانید برای یک پرسنل دو کارگزینی همزمان داشته باشید
• ✅ تعویض شیفت: اگر پرسنل شیفتش تغییر کرد، دو کارگزینی با بازه‌های غیرهمپوشان بسازید
• ✅ برای همه پرسنل باید کارگزینی داشته باشید

۱۱پروفایل دستگاه

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

فیلدها

ویژگی ویژه: ساخت خودکار پرسنل

اگر ستون «نام پرسنل» را تعریف کنید:

• پرسنلانی که در دیتابیس نیستند خودکار ساخته می‌شوند
• نام از فایل خوانده می‌شود
• در جدول پرسنل با برچسب خودکار مشخص می‌شوند

No  TMNo  EnNo  Name     DateTime
1   1     1     AMiN     2025/12/09 08:53:30
2   1     2     VAfADR   2025/12/09 16:14:30
3   1     3     NIAZPOR  2025/12/10 21:23:13

۱۲پردازش تردد

مرحله ۱: خواندن فایل

1. به پردازش تردد بروید
2. پروفایل دستگاه را انتخاب کنید
3. فایل را انتخاب کنید
4. «بارگذاری و ثبت» بزنید

نتیجه نمایش داده می‌شود:

• ✅ تعداد ترددهای ثبت‌شده
• 👥 پرسنل خودکار ساخته‌شده
• ⚠️ کدهای ناشناخته (اگر ستون نام تعریف نشده)

مرحله ۲: تولید کاردکس

1. بازه تاریخ را وارد کنید (مثلاً 1404/01/01 تا 1404/01/31)
2. دکمه «تولید کاردکس» بزنید
3. یا دکمه «پردازش کامل» بزنید تا کل داده‌ها پردازش شوند

پیش‌نیازهای تولید کاردکس

• ✅ پرسنل تعریف شده
• ✅ شیفت تعریف شده
• ✅ الگوی حقوق تعریف شده
• ✅ کارگزینی ثبت شده — مهم‌ترین!
• ✅ تردد خام وارد شده

دکمه «🔄 بازسازی همه»

اگر همه چیز خراب شد و می‌خواهید از صفر شروع کنید، این دکمه کل کاردکس را پاک و از نو می‌سازد.

۱۳کاردکس پرسنل

گزارش کاردکس، وضعیت هر روز یک پرسنل را نمایش می‌دهد.

نحوه نمایش

1. به کاردکس پرسنل بروید
2. پرسنل را انتخاب کنید
3. حالت را انتخاب کنید:
   • ماه شمسی: سال و ماه را وارد کنید
   • بازه دلخواه: تاریخ شروع و پایان
4. «نمایش» بزنید

آمار بالای جدول

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

• حاضر روزهای با تردد
• غایب روزهای بدون تردد و بدون مرخصی
• مرخصی روزهای مرخصی
• ماموریت روزهای ماموریت
• تعطیل جمعه‌ها و تعطیلات

هر ردیف جدول

• تاریخ: تاریخ شمسی
• روز: نام روز هفته
• شیفت: شیفت آن روز
• ورود/خروج: ساعت‌های واقعی
• کارکرد: مجموع زمان کار
• اضافه: اضافه‌کار
• کسری: کسر کار
• تعطیل: کار در تعطیل
• وضعیت: بج رنگی
• یادداشت: توضیحات

دکمه «🔄 بازسازی این بازه»

اگر بعد از تغییر مرخصی/ماموریت، کاردکس به‌روز نشد، این دکمه را بزنید تا همه روزهای بازه از نو محاسبه شوند.

۱۴ویرایش و ثبت دستی تردد

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

ثبت تردد دستی

1. به مدیریت تردد بروید
2. در فرم «➕ ثبت تردد دستی»:
   • پرسنل را انتخاب کنید
   • تاریخ را وارد کنید (از تقویم)
   • ساعت را وارد کنید (مثلاً 08:30)
   • توضیح (اختیاری): «فراموشی ثبت ورود»
3. دکمه «💾 ثبت تردد» بزنید

ویرایش تردد موجود

1. در بخش «📋 ترددهای خام» ردیف مورد نظر را پیدا کنید
2. روی ✏️ کلیک کنید
3. تاریخ جدید را وارد کنید
4. ساعت جدید را وارد کنید
5. تأیید کنید → کاردکس روز قبل و جدید بازسازی می‌شوند

حذف تردد

روی 🗑 کلیک کنید → تأیید → تردد حذف و کاردکس بازسازی می‌شود.

نشانه‌گذاری «دستی»

ترددهایی که به‌صورت دستی ثبت یا ویرایش شده‌اند، با برچسب زرد دستی در لیست نمایش داده می‌شوند.

۱۵مرخصی

دو نوع مرخصی پشتیبانی می‌شود:

مرخصی روزانه

1. به مرخصی بروید
2. پرسنل را انتخاب کنید
3. نوع: استحقاقی / استعلاجی / بدون حقوق
4. حالت: روزانه
5. از تاریخ و تا تاریخ (می‌تواند چند روز باشد)
6. ذخیره کنید

نتیجه: آن روزها در کاردکس با بج مرخصی نمایش داده می‌شوند و کسرکار محاسبه نمی‌شود.

مرخصی ساعتی

1. حالت: ساعتی
2. تاریخ: یک روز
3. ساعت شروع و پایان

نتیجه: فقط همان ساعت‌ها از کسرکار کم می‌شود. اگر ۲ ساعت مرخصی گرفتید و ۲ ساعت تأخیر داشتید، هیچ کسری ثبت نمی‌شود.

بازسازی خودکار کاردکس

بعد از ثبت یا حذف مرخصی، کاردکس روزهای مربوطه خودکار بازسازی می‌شود. نیازی به کار دستی نیست.

۱۶ماموریت

مشابه مرخصی، دو حالت دارد:

• روزانه: کل روز یا چند روز
• ساعتی: فقط چند ساعت

تفاوت با مرخصی: ماموریت معمولاً در کاردکس به‌عنوان ماموریت ثبت می‌شود و از کسری کار کم می‌کند.

۱۷مساعده / وام / غرامت

چهار نوع تراکنش مالی:

ثبت تراکنش

1. پرسنل را انتخاب کنید
2. نوع را انتخاب کنید
3. مبلغ (ریال)
4. تاریخ
5. تعداد اقساط (فقط برای وام)
6. توضیح

۱۸تقویم تعطیلات

تعطیلات رسمی را در این بخش تعریف کنید تا در محاسبه کاردکس لحاظ شود.

ابزارهای سریع

• 📥 وارد کردن تعطیلات ۱۴۰۴: با یک کلیک، ۲۷ تعطیلات رسمی اضافه می‌شوند
• 📅 همه جمعه‌های سال: همه جمعه‌های سال را تعطیل ثبت می‌کند
• 📊 خروجی Excel: دانلود لیست
• 🗑 پاک کردن: حذف همه

تعطیلات سالانه

اگر می‌خواهید تعطیلاتی در همه سال‌ها تکرار شود (مثلاً نوروز)، گزینه «تکرار سالانه» را انتخاب کنید.

تأثیر بر کاردکس

• روز تعطیل: کارکرد = اضافه‌کار تعطیل
• نرخ اضافه‌کار تعطیل: طبق الگوی حقوق (معمولاً ۲ برابر)
• اگر پرسنل در تعطیل کار نکرد → بج تعطیل

۱۹گزارشات

۴ نوع گزارش

۱) تجمیعی کارکرد

جدولی از همه پرسنل با ستون‌های:

• روز کل، حاضر، غایب
• مرخصی روز، ماموریت روز
• مرخصی ساعتی، ماموریت ساعتی
• کارکرد، اضافه، کسری، تعطیل

۲) گزارش مرخصی

لیست همه مرخصی‌های بازه با جمع روز و دقیقه.

۳) گزارش ماموریت

لیست همه ماموریت‌های بازه.

۴) فهرست پرسنل

اطلاعات پایه همه پرسنل.

فیلتر سریع تاریخ

دکمه‌های: این ماه / ماه قبل / فصل جاری / امسال / سال قبل / ۷ روز اخیر / ۳۰ روز اخیر

خروجی

• 📊 Excel: دانلود فایل xlsx
• 🖨 چاپ/PDF: با حفظ قالب و راست‌به‌چپ

۲۰گزارش حقوق

محاسبه حقوق ماهانه

1. به گزارش حقوق بروید
2. سال و ماه شمسی را وارد کنید
3. دکمه «محاسبه حقوق» بزنید

جدول نتیجه

برای هر پرسنل:

• حضور (تعداد روز)
• کارکرد، اضافه‌کار، کسری
• حقوق پایه
• جمع درآمد
• بیمه، کسورات
• خالص پرداختی

فیش حقوقی

دکمه «چاپ» در هر ردیف → فیش تک‌نفره در صفحه جدید → قابل چاپ یا ذخیره PDF.

خروجی

• Excel: جدول کامل حقوق
• چاپ/PDF: کل جدول یا فیش تکی

۲۱مدیریت کاربران

فقط برای مدیر کل قابل دسترسی است.

ثبت کاربر جدید

1. نام کاربری (یکتا)
2. رمز عبور (حداقل ۴ کاراکتر)
3. تکرار رمز
4. نام کامل
5. نقش (مدیر کل / سرپرست / اپراتور / نقش سفارشی)
6. وضعیت (فعال/غیرفعال)

مدیریت نقش‌ها

روی دکمه «مدیریت نقش‌ها» بزنید:

• ایجاد نقش جدید: نام بدهید (مثلاً «حسابدار»)
• تیک دسترسی‌ها: کدام صفحات قابل دسترسی باشد
• تغییرات فوری اعمال می‌شوند

نقش‌های پیش‌فرض

۲۲پشتیبان‌گیری و بازیابی

پشتیبان‌گیری خودکار

• هر ۲۴ ساعت یک‌بار خودکار
• فقط اگر داده‌ای تغییر کرده باشد
• فایل JSON دانلود می‌شود

پشتیبان‌گیری دستی

1. به پشتیبان‌گیری بروید
2. دکمه «💾 دانلود بک‌آپ کامل»
3. فایل hrm_backup_YYYY-MM-DD_xxx.json دانلود می‌شود
4. آن را در جای امن (ایمیل، فلش، ابر) نگه دارید

بازیابی

1. دکمه «انتخاب فایل» → فایل JSON را انتخاب کنید
2. روی «♻️ بازیابی از فایل» بزنید
3. سیستم خلاصه محتوا را نشان می‌دهد
4. تأیید کنید

خروجی Excel

دکمه «📊 دانلود فایل Excel» تمام جداول را در یک فایل xlsx می‌ریزد.

پاک کردن کل داده

دکمه قرمز «🗑 پاک کردن» → دو مرحله تأیید (اول Confirm، بعد تایپ «حذف همه»).

هشدار در داشبورد

• اگر تا حالا بک‌آپ نگرفته‌اید → هشدار قرمز
• اگر بیش از ۷ روز از بک‌آپ گذشته → هشدار قرمز
• اگر ۲-۷ روز گذشته → هشدار زرد

۲۳سوالات متداول و رفع مشکلات