راهنمای سریع

1. بارگذاری فایل: در تب «لیست» فایل اکسل (xlsx / xls / csv) را انتخاب کنید. ستون‌های «نام محل»، «عرض جغرافیایی» و «طول جغرافیایی» به‌صورت خودکار شناسایی می‌شوند؛ اگر سرستون‌ها شناسایی نشوند، ترتیب ستون ۱ تا ۳ ملاک است.
2. دسته‌بندی و فیلتر: پس از بارگذاری، می‌توانید نقاط را بر اساس «نام بیماری»، «ماه تشخیص»، «نام پایگاه»، «نام مرکز» و «نام خانه بهداشت» فیلتر کنید؛ همهٔ لیست‌های کشویی جستجوی داخلی دارند و دکمهٔ ✕ کوچک کنار عنوان، همهٔ فیلترها را یکجا حذف می‌کند. سه دکمهٔ «کل منطقه / منطقه شهری / منطقه روستایی» در تب آمار نیز همهٔ نمودارها، نقشه و جدول را بر اساس «منطقه سکونت» فیلتر می‌کند. نقشه، جدول و خروجی‌ها فقط نقاط فیلترشده را نشان می‌دهند.
3. آمار و گزارش: در تب «📊 آمار»، تعداد موارد بر اساس بیماری/ماه/پایگاه/مرکز به‌صورت نمودار نمایش داده می‌شود؛ «💊 مقایسه بهبودی» با ستون «تاریخ بهبودی» فایل اکسل ساخته می‌شود (ثبت تاریخ = بهبودیافته، خالی = عدم بهبودی)، «🥧 نمودار دایره‌ای» سهم هر «نام مرکز» را نشان می‌دهد و «📈 روند زمانی» تغییرات ماهانه را. کارت «شهری / روستایی» نیز تعداد و درصد موارد را بر اساس «منطقه سکونت» نشان می‌دهد. «خروجی اکسل» و «چاپ گزارش» نیز همان‌جاست.
4. رنگ دایره‌ها: رنگ هر دسته (بیماری/پایگاه) در نقشه، راهنما و همهٔ نمودارها یکسان است. اگر فایل ستون قدیمی «رنگ بندی» (یا «کلیک کنید») با کد رنگ داشته باشد، همان رنگ ملاک قرار می‌گیرد.
5. رسم روی نقشه: نقاط معتبر بلافاصله روی نقشه رسم می‌شوند. با کلیک روی هر ردیفِ جدول، نقشه روی همان نقطه زوم می‌کند.
6. نقشه آنلاین: به‌صورت پیش‌فرض نقشه نشان بارگیری می‌شود (کلید وب نشان داخل برنامه ذخیره است). اگر نقشه بارگیری نشد، روی دکمه «رفتن به OSM» در پیام روی نقشه بزنید یا در تب «نقشه» منبع را روی OSM بگذارید.
7. نقشه آفلاین: وقتی اینترنت دارید، در تب «آفلاین» محدوده دلخواه را دانلود کنید. سپس در منبع نقشه گزینه «آفلاین» را انتخاب کنید؛ حتی بدون اینترنت، کاشی‌های ذخیره‌شده و نقشه برداری استان‌های ایران نمایش داده می‌شوند.
8. ذخیره‌سازی: کاشی‌ها در حافظه مرورگر (IndexedDB) نگهداری می‌شوند و دفعه بعد هم بدون اینترنت در دسترس‌اند. فایل را باز نگه دارید تا داده‌ها پاک نشوند.
9. هشدار پیگیری: اگر فایل ستون «تاریخ پیگیری» داشته باشد، مواردی که موعدشان گذشته یا تا ۷ روز آینده است در کادر «⏰ هشدار تاریخ پیگیری» بالا می‌آیند و نشانگرشان روی نقشه حلقه چشمک‌زن دارد.
10. نمودار پیگیری: در تب آمار، نمودار «🔔 مقایسه پیگیری‌شده و پیگیری‌نشده بر اساس نام بیماری» بر اساس ستون «تاریخ پیگیری» ساخته می‌شود — ثبت تاریخ = پیگیری‌شده، خالی = پیگیری‌نشده.
11. کدملی: ستون «کدملی» با الگوریتم رسمی رقم کنترل بررسی می‌شود؛ موارد نامعتبر با نشان 🪪 در پاپ‌آپ و شمارنده «کدملی نامعتبر» در تب آمار دیده می‌شوند.
12. نقشه حرارتی و خوشه‌بندی: در تب «نقشه» می‌توانید «نقشه حرارتی تراکم» (تراکم موارد روی نقشه) و «خوشه‌بندی» (گروه‌شدن نقاط نزدیک به‌هم در زوم پایین) را روشن کنید.
13. نصب برنامه (PWA): دکمه «📲 نصب برنامه» در سربرگ «پنل مدیریت» قرار دارد و فقط برای حساب اصلی admin نمایش داده می‌شود؛ همهٔ کاربران نیز می‌توانند از منوی مرورگر گزینه «افزودن به صفحه اصلی / Install app» را انتخاب کنند — برنامه مثل یک اپ مستقل نصب می‌شود و پوسته آن آفلاین هم باز می‌شود.
14. پنل مدیریت و پشتیبانی: پیوندهای «🛡️ پنل مدیریت» و «📮 درخواست و پشتیبانی» در پایین پنل سمت چپ قرار دارند؛ پنل مدیریت با همان ورود برنامه باز می‌شود (نیازی به ورود دوم نیست) و درخواست‌های پشتیبانی همان‌جا قابل مشاهده است. بخش‌های «کاربران»، «مجوزها» و «ایجاد گروهی» فقط برای حساب اصلی admin دیده می‌شوند؛ سایر حساب‌ها فقط «درخواست‌ها» و «داده‌ها» را می‌بینند.
15. موبایل و اندروید: در صفحه‌های کوچک، تنها یک ردیف تب‌های «نقاط / آمار / نقشه / آفلاین» — همیشه زیر سربرگ — دیده می‌شود و ردیف تکراری داخل پنل نمایش داده نمی‌شود؛ با لمس هر بخش، پنل مربوطه باز می‌شود. نام کاربر جاری نیز با فونت ریز کنار دکمهٔ «خروج» دیده می‌شود.
16. ماندگاری داده‌ها: نقاط بارگذاری‌شده پس از بستن مرورگر/ریفرش هم می‌مانند (تا وقتی «پاک‌سازی نقاط» نزنید). در «پنل مدیریت ← ☁️ ابر و پشتیبان» می‌توانید از همهٔ داده‌ها «پشتیبان‌گیری کامل» بگیرید و در هر دستگاه دیگری «بازیابی» کنید؛ همچنین با راه‌اندازی یک‌بارهٔ «همگام‌سازی ابری» (Cloudflare رایگان — راهنمای داخل همان تب)، همهٔ حساب‌ها/مجوزها/درخواست‌ها روی سرور مشترک می‌شوند و روی همهٔ دستگاه‌ها یکسان دیده می‌شوند.

راهنمای کامل: فایل راهنمای_استفاده_انلاین_و_آفلاین_از_نقشه_نشان.md در کنار برنامه.