🚀 Crypto Options Exchange Platform

یک پلتفرم کامل و امن برای معاملات آپشن ارزهای دیجیتال با معماری میکروسرویس.

✨ ویژگی‌های کلیدی

• 🔐 احراز هویت امن: JWT با refresh token rotation و 2FA
• 💼 مدیریت چند ارزی: پشتیبانی از BTC، ETH، TRX، USDT
• 🏦 کیف‌پول امن: تولید آدرس‌های منحصر به فرد برای هر کاربر
• 📊 معاملات واقعی: موتور تطبیق سفارش با قیمت‌گذاری زنده
• 🛡️ امنیت بالا: bcrypt، rate limiting، validation کامل
• 🐳 کانتینری‌شده: اجرا با Docker/Podman
• 📱 فرانت‌اند مدرن: Next.js 15 با Tailwind CSS

🏗️ معماری فنی

میکروسرویس‌ها

crypto-exchange/ ├── backend/ │ ├── user-service/ # NestJS - مدیریت کاربران و احراز هویت ✅ │ ├── wallet-service/ # Rust - مدیریت کیف‌پول‌ها ✅ │ ├── deposit-service/ # Rust - پردازش واریزها │ └── tron-listener/ # Rust - مانیتورینگ بلاکچین ├── frontend/ # Next.js 15 - رابط کاربری ├── docker/ # کانتینرهای Docker/Podman ├── deployment/ # تنظیمات استقرار تولید └── init-db/ # اسکریپت‌های راه‌اندازی دیتابیس

پایگاه داده

• PostgreSQL 15: داده‌های تراکنشی و کاربران
• Redis 7: کش، session، پیام‌رسانی real-time
• Schema: crypto با 6 جدول اصلی

🚀 شروع سریع

پیش‌نیازها

• Node.js 18+
• Rust 1.70+ (برای سرویس‌های مالی)
• Podman 4.0+ یا Docker
• PostgreSQL 15 (با Podman خودکار نصب می‌شود)

نصب و راه‌اندازی

1. کلون ریپازیتوری: git clone https://github.com/pprofessor/Crypto.git cd Crypto

2. راه‌اندازی دیتابیس (با Podman): cd docker podman-compose -f docker-compose-simple.yml up -d

3. راه‌اندازی سرویس کاربران: cd backend/user-service npm install cp .env.example .env # تنظیم متغیرهای محیطی npx ts-node src/main.ts

4. راه‌اندازی سرویس کیف‌پول: cd backend/wallet-service cargo build cp .env.example .env # تنظیم متغیرهای محیطی cargo run

5. تست APIها:

تست ثبت‌نام کاربر

curl -X POST http://localhost:3001/api/auth/register -H "Content-Type: application/json" -d '{"email":"test@example.com","username":"testuser","password":"Test@1234"}'

تست ایجاد کیف پول (بعد از دریافت user_id از ثبت‌نام)

curl -X POST http://localhost:8080/api/users/{user_id}/wallets -H "Content-Type: application/json" -d '{"user_id":"uuid-v4-string","currency_symbol":"BTC","public_address":"optional-address"}'

📚 مستندات کامل

• 📋 چک‌لیست پیشرفت پروژه - وضعیت فعلی و نقشه راه
• 🔧 مرجع API - مستندات کامل endpoints
• 🗃️ طرح دیتابیس - جداول و روابط
• ⚙️ راهنمای استقرار - استقرار روی سرور اوبونتو
• 👛 مستندات کیف پول - راهنمای سرویس کیف پول

🔐 APIهای فعلی (آماده)

احراز هویت (/api/auth/*) - پورت 3001

• POST /register - ثبت‌نام کاربر جدید
• POST /login - ورود با ایمیل یا نام کاربری
• POST /refresh - تمدید توکن دسترسی
• POST /logout - خروج و باطل‌سازی توکن
• POST /change-password - تغییر رمز عبور
• GET /profile - دریافت پروفایل کاربر
• PUT /profile - به‌روزرسانی پروفایل

مدیریت کیف پول (/api/users/{user_id}/wallets) - پورت 8080

• POST / - ایجاد کیف پول جدید
• GET / - دریافت لیست کیف‌پول‌های کاربر
• GET /{wallet_id} - دریافت اطلاعات یک کیف پول خاص
• GET /health - سلامت سرویس

وضعیت سرویس

• GET /health - سلامت سرویس (در هر دو سرویس)

🗃️ ساختار دیتابیس

جداول اصلی:

1. users - اطلاعات کاربران (تأیید هویت، KYC، محدودیت‌ها)
2. cryptocurrencies - ارزهای پشتیبانی‌شده
3. wallets - کیف‌پول‌های کاربران
4. transactions - تراکنش‌های مالی
5. orders - سفارش‌های معاملاتی
6. refresh_tokens - توکن‌های بازنشانی

🛠️ توسعه

تنظیمات محیط توسعه

1. کپی فایل env: cd backend/user-service cp .env.example .env

cd backend/wallet-service cp .env.example .env

2. ویرایش فایل‌های .env با مقادیر مناسب

3. نصب وابستگی‌ها:

سرویس کاربران

cd backend/user-service npm install

سرویس کیف‌پول

cd backend/wallet-service cargo build

4. راه‌اندازی سرویس‌ها:

سرویس کاربران

cd backend/user-service npm run start:dev

سرویس کیف‌پول

cd backend/wallet-service cargo run

📊 وضعیت توسعه

✅ تکمیل شده

• ساختار پروژه و ریپازیتوری GitHub
• راه‌اندازی PostgreSQL و Redis با Podman
• طراحی کامل schema دیتابیس
• سرویس کاربران (NestJS) با احراز هویت کامل
• سرویس کیف‌پول (Rust) با APIهای اصلی
• مستندات API و طرح دیتابیس
• تنظیمات Docker/Podman

🔄 در حال توسعه

• سرویس واریز (Rust)
• فرانت‌اند Next.js
• موتور معاملاتی
• تست‌های واحد سرویس کیف‌پول

⏳ برنامه‌ریزی شده

• تست‌های واحد و یکپارچه‌سازی
• سیستم KYC/AML
• اعلان‌های real-time
• استقرار تولید با SSL

🤝 مشارکت

1. Fork ریپازیتوری
2. ایجاد Branch جدید (git checkout -b feature/AmazingFeature)
3. Commit تغییرات (git commit -m 'Add some AmazingFeature')
4. Push به Branch (git push origin feature/AmazingFeature)
5. باز کردن Pull Request

📝 لایسنس

این پروژه تحت لایسنس MIT منتشر شده است. جزئیات بیشتر در فایل LICENSE.

👥 حمایت

• گزارش باگ یا درخواست قابلیت جدید: Issues
• سؤالات فنی: Discussions
• ایمیل: [اطلاعات تماس]

📞 تماس با ما

• توسعه‌دهنده اصلی: [اطلاعات شما]
• GitHub: @pprofessor
• ریپازیتوری: https://github.com/pprofessor/Crypto

---

آخرین بروزرسانی: 2026-01-05
ورژن: 2.1.0
وضعیت: در حال توسعه فعال - wallet-service اضافه شد