📦 پچ‌نوت نسخه 1.5

تاریخ انتشار: 2025/07/15

✨ ویژگی‌های جدید

افزوده شدن سیستم ثبت و کسر بدهی ما با تفکیک نوع عملیات
نمایش لیست بدهی ما با جدول، مجموع، و دکمه حذف ردیف
بهبود طراحی دکمه‌ها با کلاس مشترک btn-clean
اصلاح مودال ثبت واریزی برای نمایش وسط و واکنش‌گرا شدن فرم
افزوده شدن مجموع قابل محاسبه در لیست واریزی‌ها

🛠️ فایل‌های جدید پروژه

add_debt_mine.php - ثبت بدهی یا کسر بدهی ما
get_debt_mine.php - دریافت لیست بدهی‌های ما برای هر پروژه
delete_debt_mine.php - حذف یک ردیف بدهی ما از جدول

🧱 تغییرات پایگاه‌داده

افزوده شدن جدول جدید project_debt_mine با فیلدهای:
- project_id - شناسه پروژه
- amount - مبلغ بدهی
- action_type - نوع عملیات ('ثبت' یا 'کسر')
- description - توضیحات
- action_date - تاریخ انجام عملیات

💡 تغییرات در `finance.php`

اضافه شدن دکمه‌های بدهی ما (ثبت، کسر، لیست) داخل کارت هر پروژه
افزوده شدن مودال debtMineModal برای ثبت و کسر بدهی
افزوده شدن مودال debtMineListModal برای نمایش لیست بدهی‌ها
افزوده شدن توابع:
- attachDebtMineButtons() - اتصال دکمه‌ها به رویدادها
- showDebtMineList(projectId) - دریافت و نمایش لیست بدهی‌ها
- applyButtonStyles() - اعمال کلاس استایل تمیز به دکمه‌ها

⚙️ تغییرات عمومی

افزوده شدن کلاس CSS btn-clean برای استایل مشترک دکمه‌ها
تضمین رمزگذاری UTF-8 برای نمایش درست متن فارسی
اصلاح کد مجموع بدهی برای جلوگیری از جمع رشته‌ای (استفاده از parseInt)

🧪 نکات تست و اشکال‌زدایی

اگر پروژه‌ها لود نمی‌شدن: اضافه کردن دستی $_SESSION['user_id'] در load_finance.php
اگر متن فارسی به‌صورت علامت سوال نمایش داده می‌شد: بررسی charset پایگاه‌داده و تنظیم UTF-8 در اتصال PDO

📅 برنامه مرحله بعدی (نسخه 1.6)

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

📄 Patch Notes — نسخه 1.3

تاریخ انتشار: 2025/07/13

✅ ویژگی‌های جدید

افزودن هدر واکنش‌گرا با آیکون حساب کاربری
اضافه شدن مودال ورود به حساب کاربری با اعتبارسنجی سمت سرور
ذخیره وضعیت لاگین کاربر با localStorage تا زمان خروج
نمایش نام کاربر کنار آیکون پس از ورود
افزودن دکمه خروج با حذف سشن و پاک‌سازی حافظه محلی

⚙️ تغییرات ساختاری

جداسازی فرم ساخت پروژه‌ها از بخش عمومی — نمایش فقط بعد از ورود
افزودن شناسه کاربر به دیتابیس پروژه‌ها و محدود کردن نمایش به حساب کاربری وارد شده
استفاده از $_SESSION در فایل‌های PHP برای مدیریت پروژه‌های کاربر
بازسازی رفتار جاوااسکریپت برای کنترل بهتر نمایش اجزای صفحه

🐞 رفع باگ‌ها

جلوگیری از تکرار آیکون حساب کاربری پس از ورود
اصلاح شرط نمایش مودال هنگام کلیک بعد از ورود
بهبود نام‌نویسی کاربر زیر آیکون با چیدمان عمودی و سنتر متن

🧩 موارد آماده‌سازی برای نسخه 1.4

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

پچ‌نوت نسخه 1.2 – PearFlow

📦 پچ‌نوت نسخه 1.2 – PearFlow

تاریخ انتشار: 07/11/2025

/p>

نوع نسخه: Feature + UX Improvements

🌟 قابلیت‌های جدید

جدید اضافه‌شدن لیست تسک‌ها در هر پروژه، با نمایش زیر تایمر
تعامل امکان تیک‌زدن تسک‌ها و ذخیره وضعیت آنها به‌صورت لحظه‌ای
افکت انیمیشن جذاب هنگام تیک‌زدن یا تغییر وضعیت تسک‌ها
حذف دکمه 🗑️ کنار هر تسک برای حذف فوری بدون رفرش
ویرایش افزودن تسک‌های جدید از داخل مودال ویرایش، بدون جایگزینی کل لیست
لودینگ لودینگ "⏳ در حال ذخیره..." فقط هنگام حذف پروژه به‌صورت محلی نمایش داده می‌شود
فارسی‌سازی حل مشکل نمایش علامت سؤال در عنوان پروژه‌های فارسی با utf8mb4

🧩 ساختار فایل‌های پروژه

نام فایل	شرح عملکرد
index.html	رابط کامل کاربری شامل فرم‌ها، تایمر، تسک‌ها، مودال‌ها و دکمه‌ها
save.php	ذخیره‌سازی پروژه جدید با زمان، ددلاین و لیست تسک‌ها در دیتابیس
load.php	بارگذاری و نمایش لیست پروژه‌ها در Frontend
edit.php	ویرایش اطلاعات پروژه + افزودن تسک‌های جدید به لیست قبلی
delete.php	حذف پروژه از پایگاه داده
update_tasks.php	به‌روزرسانی لیست تسک‌ها هنگام تغییر یا حذف
get_remaining.php	دریافت زمان باقی‌مانده و وضعیت اجرا برای تایمر
start_timer.php	شروع تایمر پروژه و ثبت حالت اجرای آن
stop_timer.php	توقف تایمر و ذخیره مقدار باقی‌مانده

📦 Patch Notes – PearFlow نسخه 1.1.0

تاریخ انتشار: 07/11/2025

/p>

توسعه‌دهنده: یاسین با همراهی Copilot

🚀 قابلیت‌های جدید

✏️ ویرایش پروژه‌ها: فرم مودالی با امکان تغییر نام، ددلاین، و زمان
⏱ افزودن زمان: اضافه کردن زمان به remaining بدون تغییر زمان کل
🔁 تنظیم مجدد زمان کل: ریست duration و remaining به مقدار جدید
🧠 منطق هوشمند: فقط یکی از دو فیلد زمان قابل استفاده است
🔒 کنترل همزمانی: جلوگیری از اجرای همزمان تایمر در چند تب با پیام هشدار
🎨 استایل هماهنگ: فرم ویرایش با استایل مشابه فرم افزودن پروژه

🛠 فایل‌های استفاده‌شده و کاربرد آن‌ها

نام فایل	کاربرد
`index.html`	رابط کاربری اصلی، تایمر، فرم‌ها، مودال و اسکریپت‌ها
`save.php`	ذخیره پروژه جدید در پایگاه داده
`load.php`	بارگذاری لیست پروژه‌ها
`update_remaining.php`	ذخیره زمان باقی‌مانده
`start_timer.php`	شروع تایمر (running = 1)
`stop_timer.php`	توقف تایمر و ذخیره remaining
`get_remaining.php`	دریافت وضعیت پروژه برای همگام‌سازی
`delete.php`	حذف پروژه
`edit.php`	اعمال تغییرات ویرایش‌شده (نام، ددلاین، زمان)
`sounds/alert.mp3`	صدای هشدار پیام تأیید فعالیت
`fonts/Morabba-Medium.ttf`	فونت فارسی برای ظاهر حرفه‌ای

🧪 نکات فنی

ارتباط با سرور از طریق fetch و JSON
تایمر مستقل برای هر پروژه با setInterval
همگام‌سازی وضعیت پروژه‌ها هر ۵ ثانیه
پیام تأیید فعالیت هر ۱۵ دقیقه با صدا و گزینه‌های بله/خیر

📌 نکات مهم برای توسعه‌دهندگان

ساختار جدول projects باید شامل فیلدهای زیر باشد:

id, name, duration, remaining, deadline, running

در صورت افزودن قابلیت‌های جدید (مثلاً pause/resume یا چندکاربره)، ساختار پایگاه داده باید گسترش یابد

📦 Patch Notes – PearFlow نسخه 1.0.0

تاریخ انتشار: 07/10/2025

p>

توسعه‌دهنده: یاسین با همراهی Copilot

🚀 قابلیت‌های جدید

مدیریت پروژه‌ها: افزودن پروژه با نام، مدت زمان و ددلاین
تایمر مستقل: شمارش معکوس با نوار دایره‌ای و رنگ پویا (قرمز → سبز)
همگام‌سازی بین تب‌ها: تایمر در همه تب‌ها یکسان و هماهنگ
پیام تأیید فعالیت: نمایش هر ۱۵ دقیقه با صدای هشدار
کنترل کامل: دکمه‌های شروع، توقف و حذف با AJAX

🎨 طراحی و رابط کاربری

استفاده از فونت فارسی Morabba در کل پروژه
فرم وسط‌چین با استایل مینیمال و استروک خاکستری
رنگ‌بندی گرادیانی سبز–آبی برای پس‌زمینه و دکمه‌ها

🛠 بهبودهای فنی

AJAX کامل با fetch و JSON
ساختار ماژولار برای تایمر هر پروژه
حذف setInterval(loadProjects) برای جلوگیری از ریست تایمرها
همگام‌سازی فقط برای پروژه فعال هر ۵ ثانیه

⚠️ نکات مهم

جدول projects باید شامل فیلدهای: id, name, duration, remaining, deadline, running باشد
فایل‌های PHP مورد نیاز: save.php, load.php, update_remaining.php, start_timer.php, stop_timer.php, get_remaining.php, delete.php

← بازگشت به صفحه اصلی