🚀 تطبيق قارئ/كاتب NFC

الرخصة: GPL v3 باثيون 3.9+ أسلوب الكود: black

تطبيق قوي مبني على PySide6 لقراءة وكتابة أنواع مختلفة من بطاقات NFC بميزات متقدمة وواجهة سهلة الاستخدام.

التثبيت

المتطلبات الأساسية

البدء السريع

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

    git clone https://github.com/Nsfr750/NFC.git
cd NFC

  2. أنشئ وقم بتنشيط بيئة افتراضية:

    python -m venv venv
.\venv\Scripts\activate  # ويندوز
source venv/bin/activate  # لينكس/ماك

  3. قم بتثبيت التبعيات:

    pip install -r requirements.txt

  4. شغل التطبيق:

    python main.py

للحصول على تعليمات التثبيت التفصيلية، راجع PREREQUISITES.md.

الميزات

🚀 المتطلبات

📖 الوثائق

الوثائق الشاملة متاحة باللغتين الإنجليزية والإيطالية، وتشمل:

لبناء الوثائق محليًا:

# تثبيت متطلبات الوثائق
pip install -r requirements-docs.txt

# بناء الوثائق الإنجليزية
cd docs/ENG
make html

# بناء الوثائق الإيطالية
cd ../ITA
make html

ستكون الوثائق متاحة في مجلد _build/html لكل لغة.

📦 التثبيت

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

    git clone https://github.com/Nsfr750/NFC.git
cd NFC

  2. أنشئ وقم بتنشيط بيئة افتراضية (موصى به):

    # ويندوز
python -m venv venv
.\venv\Scripts\activate

# لينكس/ماك
python3 -m venv venv
source venv/bin/activate

  3. قم بتثبيت الحزم المطلوبة:

    pip install -r requirements.txt
  4. (اختياري) قم بتثبيت برامج تشغيل PC/SC إذا لم تكن مثبتة بالفعل:

  5. شغل التطبيق:

    python main.py

🚀 الاستخدام

العمليات الأساسية

  1. قم بتوصيل قارئ NFC الخاص بك
  2. اقرأ بطاقة
  3. اكتب على بطاقة
  4. اقفل بطاقة

🛠️ ميزات متقدمة

🔒 الأمان

يتضمن التطبيق عدة مستويات من الأمان:

  1. حماية بكلمة مرور للعمليات الحساسة
  2. تخزين آمن لتجزئات كلمات المرور
  3. التحقق من سلامة البيانات قبل الكتابة
  4. تحذيرات للعمليات المحتمل خطورتها

🤝 المساهمة

نرحب بالمساهمات في المشروع! يرجى مراجعة إرشادات المساهمة لمزيد من المعلومات حول الإبلاغ عن الأخطاء، أو اقتراح تحسينات، أو إرسال إصلاحات.

📄 الترخيص

هذا المشروع مرخص تحت رخصة GPL-3.0. انظر ملف LICENSE للتفاصيل.

🙏 الشكر

📞 الاتصال

للأسئلة والاقتراحات:

© 2023 Nsfr750. جميع الحقوق محفوظة.