CHECKPOINT // Nodra Freelance & Gaming Ledger

##Image Gallery:

---

چک‌پوینت نرم‌افزار مدیریت و لجر فریلنسینگ گیمینگ

چک پوینت یک نرم‌افزار بسیار سبک، تخصصی و کاملا آفلاین هست و برای ثبت، مدیریت و محاسبه‌ی درآمد پروژه‌ها و بوست‌های گیمینگ طراحی شده.

📥 راهنمای دانلود برای کاربران ویندوز: برای دریافت نرم‌افزار، روی دکمه سبز بالا یا اینجا (صفحه Releases) کلیک کنید. در صفحه باز شده، از بخش Assets فایل نصبی (با پسوند .exe یا .msi) را دانلود و نصب کنید.

---

✨ قابلیت‌های اصلی چک‌پوینت

۱. 🔒 کاملاً آفلاین و امن (۱۰۰٪ Local & Private)

• تمامی اطلاعات، مبالغ، یادداشت‌ها و اسکرین‌شات‌های شما فقط روی کامپیوتر خودتان ذخیره می‌شوند.
• سرعت فوق‌العاده بالا به لطف استفاده از موتور پایگاه‌داده محلی (SQLite در نسخه دسکتاپ و IndexedDB در مرورگر).

---

۲. 🪙 تبدیل هوشمند و دوطرفه گلد (Gold) و تومان (TOMAN)

• پشتیبانی اختصاصی از اقتصاد World of Warcraft:
  • نرخ گلد در نسخه Retail (به ازای هر ۱۰۰۰ گلد).
  • نرخ گلد در نسخه Classic (به صورت تک گلد).
• امکان تغییر نرخ پیش‌فرض لحظه‌ای با یک کلیک.
• محاسبه آنی و خودکار درآمد کل، مبالغ تسویه‌شده (Paid) و مبالغ در انتظار پرداخت یا در حال انجام (Pending / Working).

---

۳. 📋 ثبت و چسباندن اسکرین شات پایان کار/بوست Ctrl+V (Proof of Work)

• نیازی به ذخیره کردن فایل اسکرین‌شات روی کامپیوتر نیست!
• کافیست با ابزار عکس‌برداری ویندوز (Win + Shift + S) از پایان دانجن، ترید گلد یا تاییدیه مشتری عکس بگیرید و مستقیماً داخل پنجره ثبت کار Ctrl + V بزنید تا عکس ضمیمه شود.
• امکان مشاهده تصاویر در اندازه کامل (Lightbox) و دانلود آن‌ها.

---

۴. 🧾 صدور رسید کار و خروجی دیسکورد (Receipt & Discord Export)

• ایجاد فاکتور و رسید مرتب شامل عنوان کار، کارفرما/پلتفرم، زمان، دستمزد و اسکرین‌شات‌ها.
• کپی با یک کلیک برای دیسکورد (Discord Markdown): متن گزارش را به صورت آماده در دیسکورد برای ادورتایزر، لیدر یا مشتری بفرستید.
• امکان ذخیره تصویر رسید برای ارسال در تلگرام یا دیسکورد.

---

۵. 👥 مدیریت کارهای تیمی و تقسیم سهم (Team Runs & Split Payouts)

• برای ریدهای دونفره یا چندنفره (Duo / Team / GDKP)، نام هم‌تیمی‌ها را مشخص کنید.
• امکان فیلتر کردن فوری کارها بر اساس نام هر هم‌تیمی برای محاسبه بدهی‌ها یا سهم نهایی.

---

۶. 📊 نمودارها و آمار مالی دقیق (Analytics)

• نمایش روند درآمد روزانه، هفتگی، ماهانه و سالانه به تومان یا گلد.
• تفکیک سهم درآمدی بازی‌ها و پلتفرم‌ها (Retail vs Classic vs Addons).

---

💾 راهنمای پشتیبان‌گیری (Backup) و بازیابی (Restore)

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

📥 نحوه گرفتن نسخه پشتیبان (Backup)

1. کلید میانبر Ctrl + , را بزنید یا روی آیکون Settings (چرخ‌دنده) در بالای صفحه کلیک کنید.
2. در بخش Data Backup & Portability:
   • Full JSON Backup: یک فایل پشتیبان کامل شامل تمام کارهای ثبت‌شده به همراه اسکرین‌شات‌ها دانلود می‌شود. این فایل را در جای امن (مانند گوگل درایو یا فلش) نگه دارید.
   • Export CSV Spreadsheet: فایل اکسل از لیست کارها برای حساب‌کتاب شخصی یا گزارش‌گیری.

📤 نحوه بازگردانی اطلاعات (Restore)

1. پنجره Settings را باز کنید.
2. روی دکمه Restore JSON کلیک کنید و فایل بکاپ .json قبلی خود را انتخاب کنید.
3. در چند ثانیه تمام اطلاعات و تصاویر بدون هیچ نقصی جایگذاری و بازگردانی می‌شوند.

🛡️ اسنپ‌شات‌های خودکار روزانه (Automatic Snapshots)

• نسخه دسکتاپ ویندوز به صورت خودکار روزانه یک نسخه پشتیبان داخلی ذخیره می‌کند تا حتی اگر اشتباهاً رکوردی را پاک کردید، بتوانید با یک کلیک از لیست اسنپ‌شات‌ها به روزهای قبل برگردید.

---

⌨️ کلیدهای میانبر پرکاربرد (Shortcuts)

برای اینکه سریع‌تر و بدون نیاز به موس با برنامه کار کنید، کلیدهای زیر در دسترس هستند:

Shortcut	Action
?	Open Keyboard Shortcuts Guide
N	Log New Work Entry
1	Overview View
2	Ledger View
3	Analytics View
4	Exchange View
/	Focus Search Bar
Alt+E	Export Ledger to CSV
Alt+B	Full JSON Backup with Screenshots
Ctrl+V	Paste Screenshot Proof (in modal)
Esc	Close any open modal or clear search

---

Getting Started

# 1. Install dependencies
npm install

# 2. Run local development server
npm run dev

# 3. Build for production
npm run build

---

Developer Guide

For code conventions, component hierarchy, and git manual workflow, see AGENTS.md.