راهنمای کامل حاسبوا

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

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

تب امروز

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

شروع فعالیت

روی هر فعالیت در لیست ضربه بزن تا تایمر شروع بشه. فعالیت فعال با رنگ سبز و انیمیشن نبض نمایش داده می‌شه.

چند فعالیت همزمان

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

ثبت در روزهای گذشته

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

حالات و خطا

تب دوم در تب امروز مخصوص ثبت حالات درونی و لغزش‌هاست. این‌ها «صفر-ثانیه» هستن — یعنی تایمر ندارن و فقط زمان وقوع ثبت می‌شه.

ویرایش پیشرفته فعالیت

روی هر لاگ long-press کن تا منوی ویرایش باز بشه. همچنین کلیک روی نوار فعالیت فعال هم ویرایشگر رو باز می‌کنه (زمان پایان در این حالت قفله). در ویرایشگر پیشرفته می‌تونی:

• زمان شروع و پایان رو با تقویم شمسی تنظیم کنی
• آیکون snap — با یک کلیک، زمان شروع رو یک دقیقه بعد از آخرین فعالیت ثبت‌شده تنظیم کن
• Circle Clock Picker — دکمه دایره‌ای وسط: handle آبی (شروع) و فیروزه‌ای (پایان) رو drag کن. drag روی arc بین دو handle هر دو رو با هم جابجا می‌کنه
• هدف جلسه رو بنویسی
• یادداشت اضافه کنی
• کیفیت (۱-۵): خیلی کم، کم، متوسط، زیاد، خیلی زیاد
• شدت (۱ تا ۱۰) رو با IntensitySelectorView تنظیم کنی
• تگ‌های مرتبط (موجودیت‌ها) اضافه کنی
• حالات و رویدادهای مرتبط با آیکون‌های feather

تب محاسبه

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

یادداشت روز

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

پیشرفت روز

سه دکمه برای ارزیابی کلی روز نسبت به روز قبل:

یادداشت آزاد

فیلد متن آزاد برای هر چیزی که می‌خوای درباره روزت بنویسی. بدون محدودیت کاراکتر.

برنامه فردا

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

• نام فعالیت/حالت/رویداد — با AutoComplete از فعالیت‌های موجود
• نوع شرط — تعداد (count) یا مدت زمان (duration)
• حداقل یا حداکثر — min یا max
• مقدار شرط — عدد (تعداد یا دقیقه)
• یادآوری — ساعت دلخواه برای نوتیف
• تکرارپذیری — روزانه، هفتگی، ماهانه یا سفارشی
• جبران خودکار — اگر برنامه انجام نشد، جبران ثبت بشه

تب روند

آمار عمیق فعالیت‌هات رو اینجا می‌بینی. بازه زمانی رو انتخاب کن و داده‌ها رو تحلیل کن.

کارت خلاصه

بالای صفحه روند، کارت‌های خلاصه نمایش داده می‌شن. هر کارت قابل کلیک‌ه:

توگل پوشش و ثبت‌نشده

کارت‌های «پوشش» و «ثبت‌نشده» قابل توگل هستن:

تعادل زندگی

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

الگوهای خطا

لیست خطاهای ثبت‌شده با:

• تعداد تکرار به صورت «X بار»
• progress bar نسبی
• علت رایج با پیشوند «علت:»
• کلیک برای دیدن جزئیات و ویرایش

کیفیت فعالیت

بر اساس تگ‌های مرتبط (موجودیت‌ها) محاسبه می‌شه. اگر تگ نداری، راهنمای اضافه کردن تگ نمایش داده می‌شه.

بخش محاسبه

تقویم ماهانه که وضعیت محاسبه هر روز رو نشون می‌ده:

تب من (تنظیمات)

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

مدیریت فعالیت‌ها و دسته‌ها

• اضافه کردن فعالیت جدید با نام، آیکون (از ۲۸۷ آیکون Feather)، رنگ، و دسته
• ویرایش و حذف فعالیت‌های موجود
• تنظیم ترتیب نمایش (تعداد، زمان، الفبایی، آخرین استفاده)
• ایجاد دسته‌بندی جدید با رنگ دلخواه

تنظیمات نوتیفیکیشن

• حالت نمایش: همیشه / فقط وقتی فعالیت فعال داری / هرگز
• انتخاب فعالیت‌های نمایش‌داده‌شده در دکمه‌های سریع
• رنگ متن نوتیف (سفید/سیاه) برای سازگاری با تم دستگاه
• تنظیم ساعت یادآوری صبح محاسبه (پیش‌فرض ۸:۰۰)

تنظیمات ظاهری

• حالت شب (تم تاریک/روشن)
• قفل برنامه با رمز عبور
• خروجی Excel از تمام لاگ‌ها

حالت توسعه

با ۵ ضربه روی آیکون برنامه در صفحه تنظیمات فعال می‌شه:

• درج داده نمونه: ۱ هفته / ۱ ماه / ۳ ماه
• درج داده سشن‌های استفاده از اپ
• تست یادآوری‌ها با popup
• مشاهده لاگ‌های AppLogger
• سفر در زمان — تنظیم زمان برنامه به هر تاریخ دلخواه، مکث/ادامه، جهش ±روز/دقیقه، تریگر جبران ۲۳:۵۸
• Rollback خودکار — هنگام غیرفعال‌سازی، همه داده‌های تست حذف می‌شوند

سیستم جبران

جبران برای پیگیری تکالیف انجام‌نشده‌ست — چه قضاهای عبادی، چه فعالیت‌هایی که باید جبران بشن. هر جبران یک فعالیت جبران‌کننده داره که با انجامش، زمان باقی‌مانده کاهش پیدا می‌کنه.

افزودن جبران

پیگیری جبران‌ها

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

تکرارپذیری برنامه‌های روزانه

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

تکرار سفارشی

با انتخاب «سفارشی» می‌تونی الگوی دقیق‌تری تعریف کنی:

• روزهای هفته — انتخاب یک یا چند روز (شنبه تا جمعه)
• فاصله تکرار — هر N روز / هفته / ماه
• پایان تکرار — هرگز / تا تاریخ مشخص / بعد از N بار

ویرایش و حذف تکرارها

حدیث روز

هر روز یک حدیث از مجموعه ۳۸۲ حدیث به صورت تصادفی نمایش داده می‌شه. حدیث شامل متن عربی، ترجمه فارسی، و مرجع‌ه.

• نمایش در صفحه اصلی با لینک به صفحه کامل
• دکمه «حدیث تصادفی» برای دیدن حدیث جدید
• دکمه کپی برای کپی کردن متن کامل به کلیپ‌بورد
• نوتیفیکیشن صبحگاهی ساعت ۶ با حدیث روز
• کلیک روی نوتیف → باز شدن همان حدیث در HadithActivity

سفر در زمان (حالت توسعه)

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

فعال‌سازی

تب من ← تنظیمات ← Developer Mode (۵ ضربه روی آیکون برنامه) ← سفر در زمان

نوتیفیکیشن دائمی

نوتیف دائمی مثل یک ویجت در نوار اعلان کار می‌کنه و همیشه وضعیت فعالیت جاری رو نشون می‌ده.

• تایمر زنده — آپدیت هر ثانیه
• تا ۳ دکمه سریع برای شروع فعالیت‌های پرکاربرد
• دکمه توقف فعالیت فعال
• رنگ متن قابل تنظیم (سفید/سیاه)
• آیکون فعالیت در نوتیف
• صدای هوشمند — موفقیت ✅ صدای موفقیت، ناتمام ⚠️ صدای اخطار

تنظیمات صدای نوتیف

در تنظیمات نوتیف می‌تونی برای هر نوع نوتیف صدای جداگانه تنظیم کنی:

ویجت‌های دسکتاپ

سه نوع ویجت برای صفحه اصلی گوشی داری:

سیستم یادآوری

حاسبوا سه نوع یادآوری داره که همه قابل تنظیم هستن:

دسته‌بندی‌ها و الگوهای زندگی

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

الگوهای زندگی

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

حالات پیش‌فرض

حالات در یک جدول مستقل ذخیره می‌شن و به فعالیت‌ها لینک می‌شن:

برچسب‌های تکمیلی (تگ‌ها)

برچسب‌ها برای توصیف بیشتر هر فعالیت استفاده می‌شن و در سه دسته هستن:

نکات کاربردی