🚀 پلتفرم بهره‌وری شخصی (Productivity Platform)

این پروژه یک سیستم جامع و هوشمند برای بهبود بهره‌وری شخصی است که ترکیبی از پیگیری عادات روزانه 📅، مدیریت وظایف 📋 و تحلیل کد برنامه‌نویسی 💻 ارائه می‌دهد. هدف اصلی تولید گزارش‌های هوشمندانه برای کمک به کاربران در حفظ عادات سالم و اولویت‌بندی وظایف است. 🎯

✨ ویژگی‌ها

• 🔄 موتور عادات (Habit Engine): پیگیری و تحلیل عادات روزانه با محاسبه سازگاری و پیشنهادهای بهبود شخصی‌سازی شده.
• ⏰ موتور وظایف (Task Engine): برنامه‌ریزی هوشمند وظایف بر اساس اولویت و زمان‌بندی، با ادغام کامل با عادات شما.
• 🔍 تحلیل‌گر کد (Code Analyzer): بررسی کدهای برنامه‌نویسی برای شناسایی مشکلات و نقض قوانین کدنویسی حرفه‌ای.
• 📊 گزارش‌دهی پیشرفته: تولید گزارش مارک‌داون جامع شامل تحلیل عادات، برنامه وظایف و مشکلات کد با نمودارها و آمار.

🛠️ پیش‌نیازها

• 🐍 پایتون ۳.۷ یا بالاتر
• 📦 هیچ وابستگی خارجی خاصی نیاز نیست (از کتابخانه استاندارد پایتون استفاده می‌کند)

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

۱. مخزن را کلون کنید:

git clone <repository-url>
cd productivity_platform

۲. مطمئن شوید پایتون نصب است:

python --version

▶️ نحوه اجرا

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

برای اجرای برنامه اصلی و تولید گزارش بهره‌وری:

python main.py

این دستور جادویی ✨:

• 🎯 نمونه عادات و وظایف را ایجاد می‌کند
• 🧠 برنامه‌ریزی هوشمند وظایف را انجام می‌دهد
• 🔍 کدهای موجود را تحلیل می‌کند
• 📄 گزارش نهایی را در فایل productivity_report.md ذخیره می‌کند

اجرای رابط وب (UX حرفه‌ای)

برای اجرای رابط کاربری وب با طراحی مدرن:

pip install flask
python web.py

سپس مرورگر خود را باز کنید و به آدرس http://localhost:5000 بروید.

رابط وب شامل صفحات زیر است:

• 🏠 داشبورد: نمای کلی از همه بخش‌ها
• 🔄 عادات: مدیریت و تحلیل عادات روزانه
• ⏰ وظایف: برنامه‌ریزی هوشمند وظایف
• 🔍 تحلیل کد: بررسی کیفیت کد
• 📊 تولید گزارش: ایجاد گزارش مارک‌داون کامل

📈 خروجی نمونه

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

• 📅 برنامه وظایف آگاه از عادات: لیست وظایف مرتب‌شده بر اساس اولویت و زمان‌بندی هوشمند
• 📊 تحلیل عادات و پیشنهادها: آمار سازگاری و پیشنهادهای بهبود شخصی‌سازی شده برای هر عادت
• ⚠️ گزارش تحلیل‌گر کد: مشکلات شناسایی‌شده در فایل‌های کد با پیشنهادهای رفع

گزارش کامل مارک‌داون نیز در productivity_report.md ذخیره می‌شود و آماده مطالعه است! 📖

🏗️ ساختار پروژه

productivity_platform/
├── main.py                    # 🎯 نقطه شروع برنامه
├── productivity_report.md     # 📄 گزارش تولیدشده
├── code_analyzer/             # 🔍 تحلیل‌گر کد
│   ├── analyzer.py
│   ├── parser/
│   ├── report/
│   └── rules/
├── core/                      # ⚙️ قراردادها و ابزارهای پایه
│   ├── contracts/
│   └── utils/
├── habit_engine/              # 🔄 موتور پیگیری عادات
│   ├── domain/
│   ├── persistence/
│   └── services/
├── integration/               # 🔗 ادغام بخش‌ها و گزارش‌دهی
├── task_engine/               # ⏰ موتور مدیریت وظایف
│   ├── algorithms/
│   ├── domain/
│   └── services/
└── tests/                     # 🧪 تست‌های واحد

🤝 توسعه و مشارکت

• 💡 برای افزودن قوانین جدید تحلیل کد، فایل‌های موجود در code_analyzer/rules/ را بررسی کنید.
• 🚀 برای گسترش موتور عادات، به habit_engine/ مراجعه کنید.
• 🧪 تست‌ها در فولدر tests/ قرار دارند و همیشه آماده اجرا هستند.

📄 درباره پروژه

این پروژه توسط کیمیا حمزه و یاسمین امرالهی و زیر نظر استاد تیزناز از دانشکده شریعتی منتشر شده است. 🌟

📞 تماس

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

---

نکته: این پروژه هنوز در حال توسعه است و ویژگی‌های جدیدی به زودی اضافه خواهد شد! 🌱