✨ My Tasks / کارهای من

Ultra-Modern Glassmorphism Todo & Task Manager for Android

🇺🇸 English Documentation • 🇮🇷 مستندات فارسی

---

🇺🇸 My Tasks — Modern Android Todo App

My Tasks is a high-performance, offline-first task management application for Android built with 100% Jetpack Compose and Material 3. Engineered around a stunning Ultra-Glassmorphism visual theme, it delivers a fluid 60FPS user experience, native dual-calendar scheduling (Jalali Solar Hijri & Gregorian), exact alarm reminders, and fully automated cloud CI/CD releases.

---

📸 Visual Showcase

Dashboard Category groups & active tasks	Dark Mode Frosted glass glow & mesh shaders	Settings Theme, language & JSON backup	Task Entry Subtasks, Jalali picker & recurrence

---

💎 Key Features

• 🎨 Ultra-Glassmorphism UI: Frosted glass cards, translucent Floating Action Button (FAB), multi-layer mesh canvas gradients, and smooth spring micro-animations.
• 🗓️ Dual-Calendar Engine (Jalali & Gregorian): In-house, zero-dependency Persian solar calendar with high-precision leap-year calculations (covering years 1400–1420) and localized Persian numeral conversion (toPersianDigits).
• ⏰ Smart Exact Reminders & Recurrence: Exact alarms scheduled via AlarmManager.setExactAndAllowWhileIdle with recurrence rules (Daily, Weekly, Custom Every X Days) and interactive notification action buttons ("Done" & "Snooze +10m").
• 📋 Hierarchical Subtasks & Task Ordering: Multi-level subtasks with progress tracking, collapsible activity rows, and ergonomic keyboard Done / Enter submission.
• 🔄 Reactive & Offline-First: Powered by AndroidX Room with Coroutine Flows for instant, flicker-free UI updates.
• 💾 Safe Backup & Restore: Complete JSON export and Storage Access Framework (SAF) import to preserve user data without third-party server dependency.
• 🚀 Automated CI/CD Release Pipeline: Every tagged commit automatically triggers GitHub Actions to compile, test, optimize via R8 Proguard, sign, and publish release APKs.

---

🛠️ Architecture & Tech Stack

com.example
├── data/              # Room Database, DAOs, Entities & Repository Layer
│   ├── AppDatabase.kt
│   ├── Entities.kt    # Category, Task, Subtask
│   ├── TodoDao.kt
│   └── TodoRepository.kt
├── ui/                # Jetpack Compose UI Screens, Dialogs & ViewModel
│   ├── MainTodoScreen.kt
│   ├── TaskBottomSheet.kt
│   ├── CategoryManagerBottomSheet.kt
│   ├── ShamsiDatePicker.kt
│   ├── SettingsBottomSheet.kt
│   ├── ReminderManagementScreen.kt
│   ├── GlassmorphismModifier.kt
│   └── TodoViewModel.kt
└── util/              # Scheduling, Audio Feedback & Calendar Helpers
    ├── JalaliCalendar.kt
    ├── ReminderScheduler.kt
    ├── ReminderReceiver.kt
    ├── NotificationActionReceiver.kt
    ├── BootReceiver.kt
    └── SoundManager.kt

• Language: Kotlin 2.0.21
• UI Framework: Jetpack Compose (Material 3)
• Persistence: AndroidX Room 2.6.1 with Coroutines Flow
• Code Shrinker: ProGuard / R8 optimization
• Build System: Gradle 8.11.1 / Android Gradle Plugin (AGP) 8.8.2
• Target Environment: Android 7.0+ (API 24 to 35)

---

⚡ CLI Build & Test Runbook

You can build and test the application directly using the Gradle wrapper:

# 1. Compile Release APK with R8 code shrinking
./gradlew assembleRelease

# 2. Run Local JVM Unit Tests & Robolectric Suites
./gradlew testDebugUnitTest

# 3. Perform Android Lint Quality Gate
./gradlew lintDebug

---

📦 Direct Download (Latest Release)

Release Version	Package File	Architecture	Min SDK	Status
v1.0.6 (Latest)	MyTasks-v1.0.6.apk	Universal	Android 7.0+ (API 24+)	✅ GitHub CI/CD Passed

---

🇮🇷 کارهای من — اپلیکیشن مدیریت وظایف اندروید

«کارهای من / My Tasks» یک اپلیکیشن سبک، آفلاین، امن و بسیار سریع برای مدیریت وظایف روزانه در سیستم‌عامل اندروید است. این برنامه با استفاده از ۱۰۰٪ Jetpack Compose و زبان کاتلین بر پایه معماری مدرن Glassmorphism (طراحی شیشه‌ای) توسعه داده شده تا محیطی چشم‌نواز، روان و بدون لگ را برای کاربران به ارمغان آورد.

---

✨ ویژگی‌های برجسته برنامه

• 🎨 رابط کاربری فوق‌مدرن شیشه‌ای (Glassmorphism): استفاده از کارت‌های مات با افکت شیشه‌ای، دکمه شناور تمام‌شیشه‌ای، گرادینت‌های داینامیک Mesh Canvas و انیمیشن‌های روان ۶۰ فریم بر ثانیه.
• 🗂️ جابجایی پیوسته دسته‌بندی‌ها (Drag & Drop): سیستم پیشرفته مرتب‌سازی دسته‌بندی‌ها با هندل ☰، انیمیشن‌های نرم فنری (Spring physics) و ذخیره آنی و اتمیک در دیتابیس.
• 🗓️ تقویم دوگانه هوشمند (شمسی و میلادی): پیاده‌سازی موتور بومی و مستقل تقویم جلالی با محاسبه دقیق سال‌های کبیسه برای بازه سال‌های ۱۴۰۰ تا ۱۴۲۰ و تبدیل خودکار اعداد به ارقام فارسی.
• ⏰ یادآورها و آلارم‌های دقیق: تنظیم هشدارهای زمان‌بندی‌شده بدون خطا با AlarmManager با امکان تکرار (روزانه، هفتگی و روزهای دلخواه) به همراه دکمه‌های اقدام سریع در اعلان‌ها («انجام شد» و «به تعویق انداختن ۱۰ دقیقه‌ای»).
• 📝 ساب‌تسک‌ها و ثبت سریع با کیبورد: امکان تعریف بی‌نهایت زیرمجموعه کار برای هر تسک با نوار پیشرفت درصد انجام و ثبت سریع با زدن کلید اینتر کیبورد.
• 🔄 بررسی آنلاین آپدیت برنامه: استعلام هوشمند نسخه‌های جدید از GitHub Releases API در بخش تنظیمات و هدایت به دانلود مستقیم APK.
• 💾 پشتیبان‌گیری و بازیابی آفلاین: خروجی گرفتن خودکار با ثبت دقیق تاریخ و ساعت (Timestamped Backup)، عدم جایگزینی فایل‌های قبلی و امکان بازگردانی در هر زمان.
• 🚀 خط لوله انتشار تمام‌اتوماتیک (CI/CD): یکپارچه‌سازی کامل با سرورهای ابری GitHub Actions با امضای دائمی Keystore برای نصب و آپدیت آسان روی نسخه‌های قبلی.

---

🛠️ مشخصات فنی و معماری

• زبان توسعه: کاتلین ۲.۰.۲۱ (Kotlin 2.0.21)
• فریم‌ورک رابط کاربری: Jetpack Compose با کامپوننت‌های Material 3
• پایگاه داده داخلی: AndroidX Room با قابلیت واکنش‌گرایی بر بستر Kotlin Flow
• الگوی معماری: MVVM + Repository Pattern
• فشرده‌سازی باینری: موتور بهینه‌ساز R8 ProGuard
• حداقل اندروید مورد نیاز: اندروید ۷.۰ به بالا (API 24+)

---

📥 دانلود و نصب مستقیم

شما می‌توانید همواره جدیدترین نسخه پکیج نصب برنامه را مستقیماً از لینک زیر یا صفحه Releaseهای گیت‌هاب دریافت کنید:

👉 دانلود آخرین نسخه — MyTasks-v1.0.6.apk

---

🤝 مشارکت و حمایت

اگر این پروژه برای شما مفید و کاربردی بوده است، با دادن یک ستاره (⭐ Star) در بالای صفحه گیت‌هاب از توسعه آن حمایت فرمایید!

Made with ❤️ by Omid Zaferi • ساخته شده با ❤️ برای جامعه توسعه‌دهندگان