Skip to content

scz0x/Gold_APPV6

Repository files navigation

محفظة الذهب - Gold Wallet

تطبيق عربي متطور لإدارة وتتبع استثمارات الذهب مع واجهة مستخدم عصرية متوافقة مع iOS.

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

📊 إدارة المحفظة

  • تتبع دقيق لعمليات الشراء والبيع
  • حساب الأرباح والخسائر التلقائي
  • عرض القيمة السوقية الحالية للمحفظة
  • دعم جميع عيارات الذهب (18، 21، 22، 24)

📈 مراقبة الأسعار

  • عرض الأسعار الحالية للذهب بجميع العيارات
  • رسوم بيانية لتتبع تحركات الأسعار
  • تنبيهات ذكية عند وصول الأسعار للمستوى المطلوب
  • مؤشرات أداء يومية (أعلى/أدنى سعر، التغيير اليومي)

🎯 أهداف الادخار

  • تحديد أهداف شخصية للادخار بالجرام
  • تتبع التقدم نحو الهدف
  • حساب المبلغ المطلوب لإتمام الهدف
  • شريط تقدم بصري

🔔 التنبيهات الذكية

  • تنبيهات عند ارتفاع السعر فوق مستوى معين
  • تنبيهات عند انخفاض السعر تحت مستوى معين
  • تنبيهات عند تغير الأسعار بنسبة محددة
  • إدارة شاملة للتنبيهات (تفعيل/إلغاء/حذف)

📱 تجربة مستخدم متميزة

  • تصميم متوافق مع iOS
  • دعم كامل للوضع الليلي والنهاري
  • واجهة عربية بالكامل
  • تجربة لمسية محسنة للهواتف المحمولة

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

Frontend Framework

  • React 18 - مكتبة JavaScript للواجهات
  • TypeScript - لتحسين جودة الكود
  • Tailwind CSS v4 - لتصميم الواجهات
  • Lucide React - للرموز

UI Components

  • Shadcn/UI - مكتبة مكونات عالية الجودة
  • Recharts - للرسوم البيانية
  • Sonner - للإشعارات
  • Motion/React - للحركات والتأثيرات

State Management

  • React Context - لإدارة الحالة العامة
  • React Hooks - لإدارة الحالة المحلية
  • localStorage - لحفظ البيانات محلياً

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

├── App.tsx                    # المكون الرئيسي
├── components/
│   ├── auth/                  # مكونات التسجيل والمصادقة
│   │   ├── AuthProvider.tsx
│   │   ├── AuthWrapper.tsx
│   │   ├── LoginScreen.tsx
│   │   └── RegisterScreen.tsx
│   ├── dashboard/             # مكونات الصفحة الرئيسية
│   │   ├── Dashboard.tsx
│   │   ├── GoldPriceChart.tsx
│   │   └── SavingsGoal.tsx
│   ├── transactions/          # مكونات المعاملات
│   │   ├── TransactionsScreen.tsx
│   │   ├── AddPurchaseModal.tsx
│   │   └── AddSaleModal.tsx
│   ├── alerts/                # مكونات التنبيهات
│   │   ├── AlertsScreen.tsx
│   │   └── CreateAlertModal.tsx
│   ├── settings/              # مكونات الإعدادات
│   │   ├── UserSettingsScreen.tsx
│   │   ├── ChangePasswordModal.tsx
│   │   └── DeleteAccountModal.tsx
│   ├── ui/                    # مكونات الواجهة الأساسية
│   └── ...
├── styles/
│   └── globals.css           # الأنماط العامة
└── README.md                 # هذا الملف

🎨 نظام التصميم

الألوان

  • الخلفية الفاتحة: #FEFEFE
  • الخلفية الغامقة: #000000
  • اللون الأساسي: #D4AF37 (الذهبي)
  • اللون الثانوي: #F1F3F4 (الرمادي الفاتح)
  • لون النجاح: #16A34A (الأخضر)
  • لون الخطر: #DC2626 (الأحمر)

الخطوط

  • الخط الأساسي: Tajawal
  • الخط الاحتياطي: -apple-system, BlinkMacSystemFont

المقاسات

  • نقاط اللمس: 44px (معيار iOS)
  • الانحناءات: 8px - 24px
  • المسافات: 4px - 32px

🚀 كيفية التشغيل

المتطلبات المسبقة

  • Node.js 18 أو أحدث
  • npm أو yarn

التثبيت

# نسخ المشروع
git clone [repository-url]

# الانتقال للمجلد
cd gold-wallet

# تثبيت الحزم
npm install

# تشغيل التطبيق
npm run dev

البناء للإنتاج

# بناء التطبيق
npm run build

# معاينة النسخة المبنية
npm run preview

📱 الصفحات والوظائف

1. الصفحة الرئيسية (Dashboard)

  • عرض ملخص المحفظة
  • أزرار الشراء والبيع
  • رسم بياني للأسعار
  • تتبع أهداف الادخار

2. صفحة المعاملات

  • قائمة بجميع المعاملات
  • تصفية وبحث متقدم
  • تفاصيل كل معاملة

3. صفحة التنبيهات

  • إنشاء تنبيهات جديدة
  • إدارة التنبيهات الموجودة
  • إحصائيات التنبيهات

4. صفحة الأخبار

  • آخر أخبار الذهب
  • تحليلات السوق
  • توصيات الخبراء

5. صفحة الإعدادات

  • إعدادات الحساب
  • تغيير كلمة المرور
  • إعدادات الإشعارات
  • حذف الحساب

🔐 الأمان والخصوصية

حماية البيانات

  • تشفير كلمات المرور
  • حفظ البيانات محلياً
  • عدم مشاركة المعلومات مع أطراف ثالثة

المصادقة

  • تسجيل دخول آمن
  • إعادة تعيين كلمة المرور
  • تسجيل خروج تلقائي

🌐 التوافق

المتصفحات المدعومة

  • Chrome 80+
  • Firefox 75+
  • Safari 13+
  • Edge 80+

الأجهزة المدعومة

  • iPhone 8 وأحدث
  • iPad (جميع الأجيال)
  • أجهزة Android الحديثة
  • أجهزة الكمبيوتر المكتبية

📈 الميزات القادمة

نسخة 2.0

  • دعم عملات أخرى
  • تصدير التقارير
  • مزامنة سحابية
  • تطبيق الهاتف المحمول

نسخة 2.1

  • ذكاء اصطناعي للتوصيات
  • دعم أكثر من مستخدم
  • واجهة برمجة التطبيقات
  • تحليلات متقدمة

👨‍💻 المطور

أحمد الزهراني

📄 الترخيص

هذا المشروع مرخص تحت MIT License.

🤝 المساهمة

نرحب بالمساهمات! يرجى قراءة دليل المساهمة للمزيد من المعلومات.

🐛 الإبلاغ عن الأخطاء

إذا واجهت أي مشاكل، يرجى إنشاء Issue جديد.

🙏 شكر وتقدير


صُنع بـ ❤️ في المملكة العربية السعودية

© 2025 أحمد الزهراني. جميع الحقوق محفوظة.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages