## ۱. نسخه دمو و راهنمای فعال‌سازی

پس از نصب نرم‌افزار، برنامه به صورت پیش‌فرض در حالت آزمایشی (Demo) اجرا می‌شود. در این حالت می‌توانید تمامی امکانات برنامه را تست کنید، اما محدودیت‌هایی در تعداد ثبت تراکنش‌ها و پروژه‌ها وجود دارد.

### مراحل فعال‌سازی دائمی:

1. وارد بخش تنظیمات (از منوی داشبورد) شوید.
2. در بخش "مدیریت لایسنس"، روی دکمه "ورود کد / فایل لایسنس جدید" کلیک کنید.
3. کد سخت‌افزاری (Machine ID) نمایش داده شده را کپی کرده و برای تیم پشتیبانی ارسال کنید.
4. فایل لایسنس (`.key`) دریافتی را در همان پنجره بارگذاری کنید.

در نسخه دمو به مدت 10 روز میتوانید از تمامی امکانات برنامه استفاده نمایید

## ۲. شروع به کار و تعریف پروژه

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

### ۲-۱. اطلاعات پروژه

با کلیک روی گزینه "ایجاد پروژه جدید"، فرم اطلاعات باز می‌شود که شامل موارد زیر است:

- مشخصات اصلی: نام پروژه، نام کارفرما و نوع کاربری (مسکونی، تجاری و...).
- اطلاعات فنی و مالی: وارد کردن "زیربنا (متراژ)" و "بودجه برآوردی". نرم‌افزار به صورت خودکار هزینه هر متر مربع و سود تقریبی پیمان مدیریت را محاسبه می‌کند.
- زمان‌بندی: تعیین تاریخ شروع و پایان تقریبی پروژه.

## ۳. داشبورد مدیریت

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

### ۳-۱. ویجت‌های کلیدی

مانده حسابتفاوت کل واریزی‌ها و هزینه‌های انجام شده.
صندوق پیامتعداد پیام‌های دریافتی از تلگرام (عکس فاکتور، ویس و...).
هزینه هر متر مربعمیانگین هزینه تمام شده برای هر متر تا این لحظه.
وظایف بازتعداد کارهای در حال انجام یا عقب افتاده.

## ۴. مدیریت هزینه و تنخواه

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

### ۴-۱. دسته‌بندی هزینه‌ها

در هنگام ثبت هزینه، می‌توانید نوع آن را مشخص کنید تا گزارش‌گیری دقیق‌تری داشته باشید:

نوع هزینه | توضیحات
--- | ---
دستمزد (Wages) | پرداخت به پیمانکاران و اکیپ‌های اجرایی (با قابلیت انتخاب از لیست پیمانکاران).
خرید مصالح | هزینه خرید متریال (که همزمان موجودی انبار را نیز افزایش می‌دهد).
ماشین‌آلات | هزینه‌های مربوط به کرایه جرثقیل، بیل مکانیکی، بتنی‌یر و حمل نخاله.
سربار/عمومی | هزینه‌های دفتری، پذیرایی، قبض‌ها و سایر موارد.

### ۴-۲. ویژگی‌های هوشمند ثبت هزینه

- تعریف سریع (+): اگر هنگام ثبت هزینه، متوجه شدید نام "پیمانکار" یا "آیتم کاری" (مثلاً گچ‌کاری) در لیست نیست، کافیست دکمه کوچک (+) کنار فیلد را بزنید و همان لحظه آن را تعریف کنید.
- ثبت واریزی (شارژ): مبالغ دریافتی از کارفرما را در بخش "واریزی" ثبت کنید تا تراز مالی پروژه به‌روز شود.

### ۴-۳. گردش حساب و اسناد

در تب "گردش حساب"، لیست کامل تراکنش‌ها قابل مشاهده است. وضعیت فایل پیوست (تصویر فاکتور یا رسید) با آیکون‌های زیر مشخص می‌شود:

- 🧾 : فایل رسید موجود و قابل مشاهده است.
- ⚠️ : فایل رسید یافت نشد (حذف شده یا مسیر تغییر کرده).

## ۵. انبار و کنترل مصالح

ماژول انبارداری به شما کمک می‌کند تا جریان ورود و خروج متریال را کنترل کرده و از کسری مصالح در لحظات حساس جلوگیری کنید.

### ۵-۱. خرید و ورود به انبار

از طریق دکمه "خرید مصالح" در داشبورد یا تب هزینه، می‌توانید خرید جدید را ثبت کنید. این کار دو اثر دارد:

1. مبلغ خرید به عنوان "هزینه" از حساب پروژه کسر می‌شود.
2. تعداد/مقدار خریداری شده به موجودی انبار اضافه می‌شود.

در پنجره خرید، می‌توانید تصویر فاکتور را اسکن یا آپلود کنید تا در سوابق دیجیتال ذخیره شود.

### ۵-۲. ثبت مصرف (خروج کالا)

برای اینکه بدانید هر متریال کجا مصرف شده است، از گزینه "ثبت مصرف" استفاده کنید. در اینجا مشخص می‌کنید که مثلاً "۵۰ پاکت سیمان" برای "آیتم دیوارچینی" مصرف شده است.

### ۵-۳. کاردکس کالا و نقطه سفارش

با کلیک روی دکمه "کاردکس" جلوی هر کالا، پنجره‌ای باز می‌شود که شامل:

- تاریخچه تراکنش‌ها: لیست کامل زمان‌های خرید و مصرف کالا.
- نمودار موجودی: روند تغییرات موجودی کالا در طول زمان.
- تنظیم نقطه سفارش (Reorder Point): شما می‌توانید عددی را تعیین کنید (مثلاً ۱۰ شاخه تیرآهن). هرگاه موجودی انبار به این عدد برسد، نرم‌افزار در داشبورد و ربات تلگرام هشدار می‌دهد که "موجودی رو به اتمام است".

## ۶. دستیار هوشمند تلگرام ✈️

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

### ۶-۱. اتصال آسان

1. در داشبورد نرم‌افزار روی آیکون "تلگرام" کلیک کنید.
2. کد اتصال نمایش داده شده را کپی کنید.
3. در تلگرام، وارد ربات شده و دستور /connect CODE را ارسال کنید.

### ۶-۲. امکانات ربات

- 🎤 ثبت با پیام صوتی: دیگر نیازی به تایپ نیست! در کارگاه یک ویس بفرستید: "۲ میلیون تومن به جوشکار دادم". این پیام وارد نرم‌افزار می‌شود تا سر فرصت آن را تایید و ثبت کنید.
- 📸 ارسال فاکتور: عکس فاکتورها را همان لحظه بفرستید تا گم نشوند.
- 📊 گزارش وضعیت: با زدن یک دکمه، گزارش کامل پیشرفت پروژه، مانده حساب و نمودار بودجه را در تلگرام ببینید.
- 🔍 استعلام موجودی: نام کالا (مثلاً "سیمان") را در ربات بنویسید تا موجودی لحظه‌ای انبار را به شما بگوید.
- 📄 دانلود PDF: فایل رسمی گزارش مالی پروژه را مستقیماً روی گوشی دریافت کنید.

### ۶-۳. صندوق پیام (Inbox)

تمام اطلاعات ارسالی از تلگرام (ویس، عکس، متن) وارد پنجره "صندوق پیام" در نرم‌افزار می‌شوند. شما می‌توانید با یک کلیک، این پیام‌ها را به "سند حسابداری" تبدیل کنید.

## ۷. پیمانکاران و قراردادها

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

- پروفایل: ثبت اطلاعات تماس، تخصص و شماره کارت.
- تولید قرارداد: امکان تولید خودکار فایل قرارداد (PDF) با وارد کردن شرایط، مبلغ و تعهدات.
- رتبه‌بندی: امکان امتیازدهی به عملکرد پیمانکار برای پروژه‌های آینده.

## ۸. مدیریت وظایف (Kanban)

تابلوی وظایف به شما کمک می‌کند تا کارهای تیم اجرایی را سازماندهی کنید.

- ستون‌بندی: کارها در سه ستون "برای انجام"، "در حال انجام" و "انجام شده" قرار می‌گیرند.
- جابجایی سریع: با استفاده از فلش‌های روی کارت، وضعیت کار را تغییر دهید.
- اولویت‌بندی: کارهای مهم با رنگ متفاوت و برچسب اولویت بالا نمایش داده می‌شوند.

## ۹. اسناد و مدارک

سیستم بایگانی دیجیتال برای دسته‌بندی نقشه‌ها، مجوزها و تصاویر پروژه. فایل‌های دریافتی از طریق تلگرام نیز به صورت خودکار در پوشه مخصوص (Receipts) در این بخش ذخیره می‌شوند.

## ۱۰. گزارش‌گیری و خروجی

### ۱۰-۱. گزارش خودکار هنگام خروج

یکی از ویژگی‌های منحصر‌به‌فرد نرم‌افزار این است که هر بار که برنامه را می‌بندید، سیستم به طور خودکار:

- یک گزارش جامع PDF شامل خلاصه وضعیت مالی و ۱۵ تراکنش آخر می‌سازد.
- این گزارش را به سرور امن ارسال می‌کند تا بتوانید در هر لحظه از طریق ربات تلگرام به آخرین وضعیت پروژه دسترسی داشته باشید.

### ۱۰-۲. سایر گزارش‌ها

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

## ۱۱. تنظیمات و پشتیبانی

- پشتیبان‌گیری (Backup): حتماً به صورت دوره‌ای از دیتابیس خود نسخه پشتیبان تهیه کنید تا در صورت بروز مشکل برای ویندوز، اطلاعات شما محفوظ بماند.
- پشتیبانی آنلاین: دکمه‌های تماس مستقیم با کارشناسان پشتیبانی (تلگرام و واتساپ) در صفحه تنظیمات قرار داده شده است.

## ⚠️ رفع مشکل نمایش فونت (حروف برعکس)

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

علت: وقتی فرمت تاریخ و ساعت ویندوز روی "Persian" باشد، ویندوز سعی می‌کند متن را اصلاح کند و نرم‌افزار هم همزمان آن را اصلاح می‌کند. این "تصحیح مضاعف" باعث برعکس شدن متن می‌شود.

### راه‌حل (در کمتر از ۱ دقیقه):

1. کلید Windows روی کیبورد را بزنید و کلمه Region را جستجو کنید.
2. وارد تنظیمات Region شوید (در ویندوزهای قدیمی Control Panel > Region).
3. در بخش Format، گزینه را از Persian (Iran) به English (United States) تغییر دهید.
4. دکمه OK را بزنید و نرم‌افزار را دوباره باز کنید.

با انجام این کار، مشکل فونت در تمام بخش‌های نرم‌افزار، از جمله نمودارها و گزارش‌ها، کاملاً برطرف خواهد شد.