Code Timer Tracker - متتبع وقت البرمجة

تطبيق ويب حديث ومتكامل لتتبع وقت البرمجة وإدارة المشاريع، مصمم خصيصًا للمبرمجين والمطورين لزيادة الإنتاجية وتنظيم وقت العمل.

🌟 المميزات الرئيسية

• لوحة تحكم شاملة: تعرض إحصائيات مفصلة عن وقت العمل (يومي، أسبوعي)، المشاريع النشطة، والإيرادات القابلة للفوترة.
• إدارة الجلسات: مؤقت نشط لتتبع وقت المهام بدقة، مع إمكانية الإيقاف المؤقت، وتحديد المشروع والمهمة والوسوم (Tags).
• تقنية بومودورو (Pomodoro): مؤقت بومودورو مدمج (عمل/راحة) لزيادة التركيز وتجنب الإرهاق.
• إدارة المشاريع: إضافة مشاريع متعددة مع تحديد التسعير بالساعة (Rate) ولون مميز لكل مشروع.
• سجل الجلسات (سجل المهام): جدول مفصل بجميع الجلسات السابقة مع إمكانية الفلترة حسب المشروع والتاريخ.
• تقارير وتحليلات ورسوم بيانية: رسوم بيانية دقيقة (باستخدام Chart.js) لتوزيع الوقت على المشاريع، والإنتاجية الأسبوعية، والاتجاه الزمني.
• جلسات سريعة: قوالب جاهزة لبدء الجلسات بسرعة (مثال: إصلاح أخطاء 25د، ميزة جديدة 45د، مراجعة كود 30د).
• تنبيهات صوتية: أصوات مدمجة للتنبيه ببدء/انتهاء الجلسات وفترات الراحة.
• كشف الخمول (Idle Detection): تنبيه ذكي عند عدم وجود نشاط لفترة أثناء تشغيل المؤقت.
• تصدير البيانات: إمكانية تصدير جميع بيانات الجلسات والمشاريع إلى ملف JSON للاحتفاظ بنسخة احتياطية.
• اختصارات لوحة المفاتيح: لدعم التنقل السريع والتحكم في المؤقت.
• واجهة عصرية بتصميم متجاوب: تدعم الوضع الليلي (Dark Mode) وتعمل بسلاسة على الشاشات المختلفة.

🛠️ التقنيات المستخدمة

تم بناء المشروع باستخدام التقنيات الأساسية للويب (Vanilla Web Technologies):

• HTML5: لهيكلة صفحات التطبيق.
• CSS3: لتصميم الواجهة وتضمين الحركات (Animations) ودعم الوضع الليلي (CSS Variables).
• JavaScript (Vanilla): لبرمجة منطق التطبيق بالكامل (بدون أطر عمل إضافية)، مما يضمن أداء سريع وخفيف.
• Chart.js: لإنشاء الرسوم البيانية التفاعلية.
• Font Awesome: للأيقونات بخطوط عصرية ومناسبة.
• Local Storage: لحفظ وتخزين البيانات محليًا في متصفح المستخدم بدون الحاجة لقواعد بيانات.

🚀 كيفية الاستخدام (التثبيت والتشغيل خطوة بخطوة)

هذا التطبيق مجاني بالكامل ويعمل مباشرة في المتصفح، ولا يحتاج إلى تثبيت أي برامج أو قواعد بيانات أو خوادم (Servers).

1. تحميل المشروع:
   • قم بتنزيل المشروع كملف ZIP أو استخدم أمر الأستنساخ (Clone):

     git clone https://github.com/your-username/Code-Timer-Tracker.git

2. تشغيل التطبيق:
   • قم بالانتقال إلى مجلد المشروع.
   • افتح ملف index.html مباشرة باستخدام أي متصفح ويب حديث (مثل Google Chrome, Firefox, Edge, Safari).

⌨️ اختصارات لوحة المفاتيح (Shortcuts)

• Ctrl + 1 (أو Cmd + 1): للانتقال السريع إلى لوحة التحكم.
• Ctrl + 2 (أو Cmd + 2): للانتقال السريع إلى صفحة المؤقت النشط.
• Ctrl + 3 (أو Cmd + 3): للانتقال السريع إلى صفحة المشاريع.
• المسافة (Space): لتبديل حالة المؤقت (بدء / إيقاف مؤقت) إذا كنت في أي صفحة.

📁 هيكلية المشروع

• index.html: الملف الرئيسي الذي يحتوي على واجهة المستخدم.
• style.css: ملف التنسيقات والأنماط، ويحتوي على الألوان، والخطوط، والوضع الليلي، وتجاوب الشاشات.
• script.js: الملف الأساسي الذي يحتوي على كافة الوظائف البرمجية (المنطق) الخاصة بالتعامل مع البيانات وحركات التطبيق باستخدام الـ Class CodeTimerTracker.

🤝 المساهمة (Contributing)

نرحب بأي مساهمات لتطوير التطبيق! إذا كان لديك أي اقتراحات إضافية، أو قمت بإصلاح أي أخطاء (Bugs)، لا تتردد في:

1. عمل Fork للمستودع.
2. إنشاء فرع جديد (Branch) لميزتك (git checkout -b feature/AmazingFeature).
3. عمل Commit للتعديلات (git commit -m 'Add some AmazingFeature').
4. رفع الفرع (git push origin feature/AmazingFeature).
5. التقدم بطلب Pull Request جديد.

📄 الترخيص (License)

هذا المشروع متاح تحت ترخيص MIT. يمكنك استخدامه، التعديل عليه، ونشره كما تشاء.

---

تم تطويره بـ ❤️ للمبرمجين.