🚀 IDEV - منصة الشحن والتوصيل مع تكامل Web3 والبلوك تشين

منصة شحن وتوصيل متطورة مع تكامل Web3 والبلوك تشين

📋 جدول المحتويات

نظرة عامة
الميزات الرئيسية
تكوين بوابة الدفع Web3
التقنيات المستخدمة
التثبيت والإعداد
الاستخدام
المساهمة
الترخيص

🌟 نظرة عامة

IDEV هي منصة شحن وتوصيل متطورة تجمع بين التقنيات التقليدية وأحدث تقنيات Web3 والبلوك تشين. توفر المنصة تجربة شاملة لإدارة الشحنات والتوصيل مع دعم المدفوعات اللامركزية والعقود الذكية.

🎯 الهدف

إنشاء منصة شحن وتوصيل متكاملة تستفيد من قوة تقنيات Web3 والبلوك تشين لتوفير:

شفافية كاملة في عملية الشحن
أمان متقدم للمعاملات المالية
لامركزية في إدارة البيانات
تكامل مع مختلف شبكات البلوك تشين

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

🏠 لوحات التحكم المتخصصة

لوحة تحكم العميل - إدارة الطلبات والتتبع
لوحة تحكم المتجر - إدارة المخزون والطلبات
لوحة تحكم السائق - تتبع الرحلات والتوصيل
لوحة تحكم الإدارة - مراقبة النظام والإحصائيات

🔐 نظام مصادقة متقدم

تسجيل متعدد المراحل مع التحقق من الهوية
تكامل World ID للتحقق من الهوية
Internet Identity للهوية اللامركزية
KYC/AML للامتثال التنظيمي

🚚 نظام تتبع ذكي

تتبع في الوقت الفعلي للشحنات
خرائط تفاعلية مع Google Maps
إشعارات ذكية للمستخدمين
تحليلات متقدمة للأداء

💰 نظام دفع Web3 متطور

دفع بالعملات المشفرة (BTC, ETH, USDT, USDC, DAI)
تكامل DeFi مع بروتوكولات التمويل اللامركزي
دفع NFT للسلع الرقمية
عقود ذكية للضمان (Escrow)

💳 تكوين بوابة الدفع Web3

🔄 استبدال بوابات الدفع التقليدية

تم استبدال بوابات الدفع التقليدية (Stripe, PayPal, Razorpay) بنظام دفع متطور مبني على Web3 والبلوك تشين:

❌ البوابات التقليدية السابقة:

# تم إزالة هذه البوابات
STRIPE_PUBLISHABLE_KEY=pk_test_...
PAYPAL_CLIENT_ID=your-paypal-client-id
RAZORPAY_KEY_ID=your-razorpay-key-id

✅ بوابات الدفع الجديدة Web3:

🌐 بوابات الدفع الرئيسية

1. Ethereum Payment Gateway

ETHEREUM_PAYMENT_GATEWAY_ENABLED=true
ETHEREUM_PAYMENT_CONTRACT_ADDRESS=0x1234567890123456789012345678901234567890
ETHEREUM_PAYMENT_GAS_LIMIT=21000
ETHEREUM_PAYMENT_GAS_PRICE=20000000000
ETHEREUM_PAYMENT_CONFIRMATION_BLOCKS=12

2. Polygon Payment Gateway

POLYGON_PAYMENT_GATEWAY_ENABLED=true
POLYGON_PAYMENT_CONTRACT_ADDRESS=0x1234567890123456789012345678901234567890
POLYGON_PAYMENT_GAS_LIMIT=21000
POLYGON_PAYMENT_GAS_PRICE=30000000000
POLYGON_PAYMENT_CONFIRMATION_BLOCKS=30

3. Binance Smart Chain (BSC)

BSC_PAYMENT_GATEWAY_ENABLED=true
BSC_PAYMENT_CONTRACT_ADDRESS=0x1234567890123456789012345678901234567890
BSC_PAYMENT_GAS_LIMIT=21000
BSC_PAYMENT_GAS_PRICE=5000000000
BSC_PAYMENT_CONFIRMATION_BLOCKS=15

4. Internet Computer Protocol (ICP)

ICP_PAYMENT_GATEWAY_ENABLED=true
ICP_PAYMENT_CANISTER_ID=your-icp-payment-canister-id
ICP_PAYMENT_CYCLES=1000000000
ICP_PAYMENT_TIMEOUT=60000
ICP_PAYMENT_RETRY_ATTEMPTS=3

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

Multi-Chain Payment Router

MULTI_CHAIN_PAYMENT_ROUTER_ENABLED=true
MULTI_CHAIN_ROUTER_CONTRACT_ADDRESS=0x1234567890123456789012345678901234567890
MULTI_CHAIN_ROUTER_GAS_LIMIT=100000

Cross-Chain Bridge

CROSS_CHAIN_BRIDGE_ENABLED=true
CROSS_CHAIN_BRIDGE_CONTRACT_ADDRESS=0x1234567890123456789012345678901234567890
CROSS_CHAIN_BRIDGE_GAS_LIMIT=200000

Stablecoin Support

USDT_PAYMENT_ENABLED=true
USDT_CONTRACT_ADDRESS=0xdAC17F958D2ee523a2206206994597C13D831ec7
USDC_PAYMENT_ENABLED=true
USDC_CONTRACT_ADDRESS=0xA0b86a33E6441b8C4C8C0C8C0C8C0C8C0C8C0C8C
DAI_PAYMENT_ENABLED=true
DAI_CONTRACT_ADDRESS=0x6B175474E89094C44Da98b954EedeAC495271d0F

DeFi Integration

DEFI_PAYMENT_ENABLED=true
DEFI_PROTOCOL_ADDRESS=0x1234567890123456789012345678901234567890
DEFI_LIQUIDITY_POOL_ADDRESS=0x1234567890123456789012345678901234567890
DEFI_STAKING_REWARDS_ENABLED=true

NFT Payment Support

NFT_PAYMENT_ENABLED=true
NFT_CONTRACT_ADDRESS=0x1234567890123456789012345678901234567890
NFT_PAYMENT_METHODS=ERC721,ERC1155,ICP_NFT

Smart Contract Escrow

PAYMENT_ESCROW_ENABLED=true
ESCROW_CONTRACT_ADDRESS=0x1234567890123456789012345678901234567890
ESCROW_RELEASE_CONDITIONS=delivery_confirmed,time_based
ESCROW_TIMEOUT_DURATION=604800

🛡️ الأمان والحماية

Payment Security & Validation

PAYMENT_VALIDATION_ENABLED=true
PAYMENT_SIGNATURE_VERIFICATION=true
PAYMENT_DOUBLE_SPEND_PROTECTION=true
PAYMENT_REPLAY_ATTACK_PROTECTION=true

Payment Compliance & KYC

PAYMENT_KYC_ENABLED=true
PAYMENT_AML_ENABLED=true
PAYMENT_SANCTIONS_CHECK=true
PAYMENT_TRANSACTION_LIMITS=10000

📊 المراقبة والتحليلات

Payment Analytics & Monitoring

PAYMENT_ANALYTICS_ENABLED=true
PAYMENT_METRICS_COLLECTION=true
PAYMENT_PERFORMANCE_MONITORING=true
PAYMENT_ERROR_TRACKING=true

Payment Webhook Configuration

PAYMENT_WEBHOOK_ENABLED=true
PAYMENT_WEBHOOK_SECRET=your-payment-webhook-secret
PAYMENT_WEBHOOK_TIMEOUT=30000
PAYMENT_WEBHOOK_RETRY_ATTEMPTS=3

💰 إعدادات الرسوم

Payment Fee Configuration

PAYMENT_FEE_ENABLED=true
PAYMENT_FEE_PERCENTAGE=0.5
PAYMENT_FEE_MINIMUM=0.001
PAYMENT_FEE_MAXIMUM=0.1
PAYMENT_FEE_CURRENCY=ETH

Payment Refund Configuration

PAYMENT_REFUND_ENABLED=true
PAYMENT_REFUND_TIMEOUT=86400
PAYMENT_REFUND_GAS_LIMIT=50000
PAYMENT_REFUND_GAS_PRICE=20000000000

🧪 التطوير والاختبار

Payment Testing & Development

PAYMENT_TEST_MODE=true
PAYMENT_TEST_NETWORKS=goerli,mumbai,bsc-testnet
PAYMENT_TEST_TOKENS=test-eth,test-usdt,test-usdc
PAYMENT_TEST_AMOUNTS=0.001,0.01,0.1

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

Frontend

React 18+ - مكتبة واجهة المستخدم
Vite - أداة البناء السريعة
Tailwind CSS - إطار عمل CSS
Framer Motion - مكتبة الرسوم المتحركة
Radix UI - مكونات واجهة المستخدم
i18next - الترجمة والدعم متعدد اللغات

Backend

Rust - لغة البرمجة الرئيسية
Docker - حاويات التطبيق
PostgreSQL - قاعدة البيانات الرئيسية
Redis - تخزين مؤقت وجلسات

Web3 & Blockchain

Ethereum - الشبكة الرئيسية
Polygon - حلول Layer 2
Binance Smart Chain - شبكة BSC
Internet Computer Protocol - شبكة ICP
Web3.js - مكتبة التفاعل مع البلوك تشين
Ethers.js - مكتبة إيثيريوم

الخدمات الخارجية

Google Maps API - الخرائط والموقع
Twilio - الرسائل النصية
SendGrid - البريد الإلكتروني
OpenAI - الذكاء الاصطناعي
Shopify/WooCommerce - تكامل المتاجر

🚀 التثبيت والإعداد

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

# Node.js 18+
node --version

# npm أو pnpm
npm --version
# أو
pnpm --version

# Git
git --version

1. استنساخ المشروع

git clone https://github.com/samar-ux/I-dev.git
cd I-dev

2. تثبيت التبعيات

# Frontend
npm install
# أو
pnpm install

# Backend (إذا كان متوفراً)
cd backend
cargo build

3. إعداد متغيرات البيئة

# انسخ ملف القالب
cp backend/env.example backend/.env
cp config/env.template .env

# حدث القيم حسب احتياجاتك
nano backend/.env
nano .env

4. إعداد قاعدة البيانات

# PostgreSQL
sudo service postgresql start

# Redis
sudo service redis-server start

5. تشغيل المشروع

# Frontend
npm run dev
# أو
pnpm dev

# Backend (إذا كان متوفراً)
cd backend
cargo run

📖 الاستخدام

1. تسجيل الدخول

اختر نوع المستخدم (عميل، متجر، سائق، مدير)
اختر مستوى التحقق (عادي، متقدم، Web3)
أكمل عملية التسجيل

2. إدارة الشحنات

إنشاء شحنة جديدة
تتبع حالة الشحنة
إدارة المرتجعات

3. المدفوعات Web3

ربط المحفظة الرقمية
اختيار العملة المشفرة
تأكيد المعاملة

4. لوحة التحكم

عرض الإحصائيات
إدارة المستخدمين
مراقبة النظام

🤝 المساهمة

نرحب بمساهماتكم! يرجى اتباع الخطوات التالية:

Fork المشروع
إنشاء branch جديد (git checkout -b feature/amazing-feature)
Commit التغييرات (git commit -m 'Add amazing feature')
Push إلى الـ branch (git push origin feature/amazing-feature)
فتح Pull Request

معايير المساهمة

اتباع معايير الكود المحددة
كتابة اختبارات للوظائف الجديدة
تحديث الوثائق عند الحاجة
استخدام رسائل commit واضحة

📄 الترخيص

هذا المشروع مرخص تحت رخصة MIT - راجع ملف LICENSE للتفاصيل.

📞 الدعم والاتصال

GitHub Issues: فتح issue
Email: support@idev-shipping.com
Website: https://idev-shipping.com

🔄 آخر التحديثات

📅 التحديث الأخير - ديسمبر 2024

✨ ميزات جديدة مضافة:

نظام إرسال كود تأكيد الشحنة - SMS, Email, WhatsApp مع واجهة عرض متقدمة
تبسيط نظام التسجيل - بطاقات موحدة للتسجيل وتسجيل الدخول
تكامل Internet Identity - نظام هوية لامركزية متقدم
روابط السوشيال ميديا - تكامل مع منصات التواصل الاجتماعي
إصلاح مشاكل البيئة - حل مشاكل process.env في Vite

🛠️ تحسينات تقنية:

تحسين أداء النظام
إصلاح الأخطاء البرمجية
تحسين تجربة المستخدم
تحديث المكتبات والتبعيات

🔗 روابط مفيدة:

🙏 شكر وتقدير

فريق تطوير React
مجتمع Web3 والبلوك تشين
مطوري Tailwind CSS
مجتمع المصادر المفتوحة

🚀 IDEV - مستقبل الشحن والتوصيل مع Web3

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
backend		backend
config		config
dist		dist
grafana		grafana
public		public
src		src
ssl		ssl
.gitignore		.gitignore
BUSINESS_PLATFORMS_INTEGRATION_README.md		BUSINESS_PLATFORMS_INTEGRATION_README.md
BUSINESS_PLATFORMS_WEB3_PAYMENTS_README.md		BUSINESS_PLATFORMS_WEB3_PAYMENTS_README.md
CANISTER_93343-A7BDB-4F45F_README.md		CANISTER_93343-A7BDB-4F45F_README.md
CARGO_TOML_FIX.md		CARGO_TOML_FIX.md
CHANGELOG.md		CHANGELOG.md
DECENTRALIZED_INFRASTRUCTURE_README.md		DECENTRALIZED_INFRASTRUCTURE_README.md
DFX_INSTALLATION_GUIDE_WINDOWS.md		DFX_INSTALLATION_GUIDE_WINDOWS.md
Dockerfile.icp		Dockerfile.icp
ENVIRONMENT_GUIDE.md		ENVIRONMENT_GUIDE.md
ENVIRONMENT_SETUP.md		ENVIRONMENT_SETUP.md
Enhanced_Design_Report.md		Enhanced_Design_Report.md
FINAL_DOCUMENTATION.md		FINAL_DOCUMENTATION.md
ICP_DEPLOYMENT_CHECKLIST_REPORT.md		ICP_DEPLOYMENT_CHECKLIST_REPORT.md
ICP_DEPLOYMENT_GUIDE.md		ICP_DEPLOYMENT_GUIDE.md
ICP_INTEGRATION_README.md		ICP_INTEGRATION_README.md
ICP_QUICK_START.md		ICP_QUICK_START.md
ICP_SETUP_COMPLETION_SUMMARY.md		ICP_SETUP_COMPLETION_SUMMARY.md
ICP_WINDOWS_INSTALLATION_GUIDE.md		ICP_WINDOWS_INSTALLATION_GUIDE.md
INTERNET_IDENTITY_REDIRECT_SOLUTION.md		INTERNET_IDENTITY_REDIRECT_SOLUTION.md
Internationalization_Implementation_Report.md		Internationalization_Implementation_Report.md
PROFILE_UPDATE_README.md		PROFILE_UPDATE_README.md
PROJECT_COMPLETION_SUMMARY.md		PROJECT_COMPLETION_SUMMARY.md
REACT_ICONS_FIX.md		REACT_ICONS_FIX.md
README-BLOCKCHAIN.md		README-BLOCKCHAIN.md
README.md		README.md
README_ICP.md		README_ICP.md
SMART_TRACKING_SYSTEM_README.md		SMART_TRACKING_SYSTEM_README.md
TWO_LEVEL_AUTH_README.md		TWO_LEVEL_AUTH_README.md
canister-config.json		canister-config.json
canister.json		canister.json
components.json		components.json
deploy-icp.sh		deploy-icp.sh
dfx.json		dfx.json
docker-compose.icp.yml		docker-compose.icp.yml
docker-compose.yml		docker-compose.yml
eslint.config.js		eslint.config.js
icp-config.json		icp-config.json
icp-production.env		icp-production.env
icp.env		icp.env
icp_rules.yml		icp_rules.yml
index.html		index.html
init-db.sql		init-db.sql
install-dfx-windows.sh		install-dfx-windows.sh
install.sh		install.sh
jsconfig.json		jsconfig.json
manage-canister.sh		manage-canister.sh
nginx.icp.conf		nginx.icp.conf
package.json		package.json
performance-test.js		performance-test.js
pnpm-lock.yaml		pnpm-lock.yaml
prometheus.icp.yml		prometheus.icp.yml
setup-icp-windows.sh		setup-icp-windows.sh
test-blockchain-integration.sh		test-blockchain-integration.sh
test-features.sh		test-features.sh
test-icp-deployment.sh		test-icp-deployment.sh
vite.config.icp.js		vite.config.icp.js
vite.config.js		vite.config.js

samar-ux/I-dev

Folders and files

Latest commit

History

Repository files navigation