Skip to content

haydary1986/taskly

Repository files navigation

توثيق مشروع Taskly - نظام إدارة القوى العاملة 🏢🚀

Version - 0.1.0 Website - erticaz.com

Taskly هو نظام احترافي ومتكامل لإدارة القوى العاملة (Workforce Management System). تم تصميمه لتنظيم ومراقبة أداء الموظفين في مختلف الأقسام مثل المبيعات، البرمجة، والتصميم. يدمج النظام بين متابعة المهام وتتبع الحضور الميداني (Geo-fencing) ومؤشرات الأداء (KPIs). تم تطوير هذا النظام بواسطة Erticaz.


✨ جميع المميزات حسب الأقسام (Features)

📊 1. الإدارة والتحكم (Management & KPIs)

  • لوحة التحكم (Dashboard): عرض ملخص شامل بأرقام فورية (موظفين، عملاء، مهام نشطة، زيارات يومية) مخصصة حسب دور المستخدم.
  • مؤشرات الأداء (KPI): تبويبات منفصلة لمؤشرات المبيعات، مؤشرات المبرمجين، وترتيب أفضل الموظفين (Leaderboard).
  • التقارير والتصدير: تصدير جداول البيانات والزيارات بصيغ CSV، Excel، JSON مع إمكانية الفلترة حسب التاريخ.
  • إدارة المشاريع: إنشاء مشاريع وتتبع نسبة الإنجاز والفرق بين الساعات المقدرة والفعلية.
  • مركز الأمان (Security Center): سجل محاولات تسجيل الدخول، قواعد الجدار الناري، كشف عناوين الـ IP واستخدام Tor / VPN / Proxy.
  • إدارة المستخدمين والأدوار: تخصيص متقن لصلاحيات 7 أدوار محددة (مدير عام، مشرف، مراقب، مندوب مبيعات، مبرمج، مصمم، مسؤول سوشيال ميديا).

📋 2. إدارة المهام (Task Management)

  • إسناد المهام: إنشاء وتعيين مهام برمجية أو ميدانية، مع تحديد الأولويات وتواريخ الاستحقاق.
  • التكرار التلقائي (Recurring Tasks): إمكانية ضبط المهام لتتكرر يدوياً، أسبوعياً، أو شهرياً.
  • ربط بمشاريع برمجية (GitHub Integration): للتحكم بمهام المبرمجين ومراجعة الأكواد.
  • المهام الجماعية (Bulk Assignment): إمكانية تعيين مهمة واحدة لعدة موظفين.
  • لوحة أعمال السوشيال ميديا (Kanban): وتيرة عمل لإدارة طلبات التصميم وحالتها (مطلوب، قيد التنفيذ، منشور).

📍 3. التتبع الميداني والمبيعات (Sales & Tracking)

  • الخريطة التفاعلية (Interactive Map): عرض مباشر لمواقع مندوبي المبيعات (Live Tracking) وتوزيع العملاء.
  • إثبات الحضور الميداني (Check-In System): تسجيل الوصول الميداني بالـ GPS مع التقاط صورة إلزامية للتحقق. يشمل كشف Impossible Travel Detection لمنع حوادث التلاعب.
  • إدارة العملاء الذكية: كشف التكرار للعملاء، وتحديد مواقعهم الجغرافية تلقائياً.
  • مسح وطباعة البطاقات: إمكانية مسح الـ QR للعملاء، وطباعة بطاقات فواتير حرارية أو فواتير شخصية باستخدام أحجام ورقية متنوعة وإعدادات مخصصة.
  • العمل بدون إنترنت (Offline Sync): القدرة لمندوبي المبيعات على تسجيل البيانات الميدانية دون إنترنت.

💻 4. أدوات المطورين (Developer Tools)

  • مراجعة الكود (Code Review): تقديم شيفرة برمجية للزملاء للموافقة أو التعديل، مع تتبع الفروع في Github.
  • متتبع الوقت الدقيق (Time Tracking): مؤقت لتسجيل وقت إنجاز المهام بالساعة والدقيقة والمقارنة مع وقت المشروع.

💬 5. التواصل والمزامنة (Communication)

  • المحادثة الفورية (Live Chat): غرف محادثة من خلال WebSockets تدعم مؤشر الكتابة (Typing Indicator).
  • نظام الإشعارات الموحد: تنبيهات حية ومترابطة عبر المتصفح (Web-push)، أو من خلال البريد الإلكتروني (SMTP)، وتنبيهات مباشرة على تطبيق Telegram.
  • تسجيل الدخول السحري (Magic Login): القدرة على الولوج المؤقت من خلال إرسال روابط لمرة واحدة (بريد وتليجرام) بدون حفظ كلمة المرور.
  • تطبيق ويب تقدمي (PWA): القدرة على تثبيت التطبيق وتشغيله بهيكل يوافق الهواتف والـ Desktop.

⚙️ طريقة التثبيت والتشغيل (Installation)

النظام مبني بهيكلية Monorepo باستخدام تقنية TurboRepo. الواجهة الخلفية (Backend) تعمل بـ Next.js 15 مع Payload CMS v3 و MongoDB. بينما الواجهة الأمامية (Frontend) بـ Nuxt 3.

يلزمك للحصول على البيئة المطلوبة تثبيت Node.js و pnpm و Docker (في حال الرغبة بخادم منفصل).

الخطوة الأولى: التنزيل والتنصيب المبدئي لبيئة التطوير (Development)

  1. استنساخ المستودع:

    git clone https://github.com/haydary1986/taskly.git
    cd taskly
  2. تنصيب الحزم والاعتماديات:

    pnpm install
  3. تحضير قاعدة البيانات والتشغيل: يُفضل تشغيل حاوية MongoDB محلية، أو إعداد قاعدة بيانات Mongo خارجية وتمرير الرابط كمتغير للبيئة عبر ملفات .env.

    لتشغيل بيئة التطوير للواجهتين الأمامية والخلفية معاً بضغطة زر عبر Turbo:

    pnpm run dev

    سيتم تشغيل واجهة الـ API على المنفذ 3000 وواجهة الويب على المنفذ 3001.

الخطوة الثانية: الإطلاق السحابي والنشر (Production via Docker)

يحتوي المشروع على ملفات إعداد لـ Docker جاهزة للتشغيل بجميع حاوياتها (قاعدة بيانات، واجهة خلفية، واجهة أمامية):

  1. تشغيل الدوكر محلياً خوادم منفصلة (Standard Docker-Compose):

    # بناء الصور وتشغيل الحاويات في الخلفية
    docker compose up -d --build
  2. النشر الاحترافي عبر Coolify: إذا كنت تستخدم أداة Coolify لإدارة السيرفرات السحابية، فالملف مجهز للاستخدام المباشر لكي تتلائم المنافذ (Ports) مع نظام التوجيه Traefik تلقائياً:

    docker compose -f docker-compose.coolify.yml up -d --build

About

نظام إدارة القوى العاملة - Workforce Management System | Vue.js + Go

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages