RAKAEZ
Technical Architecture

معمارية النظام والـ API

System Architecture · API Endpoints · Deployment · Security

homeالرئيسية 🔀 Workflows 🗄 DB 📋 BRD
١ · System Architecture

معمارية النظام

٣ طبقات · فصل واضح للمسؤوليات · قابل للتوسع

devices
طبقة العميل · Client Layer

Presentation

📱 iOS App
Swift Native · iPhone & iPad
📱 Android App
Java Native · Phone & Tablet
🖥 Web Admin
Angular SPA · Desktop
south
api
طبقة التطبيق · Application Layer

Microsoft ASP.NET Core API

router
REST API
JSON · OpenAPI
security
Auth/JWT
OAuth 2.0 · OTP
sync
Real-time
SignalR Hubs
conveyor_belt
Background Jobs
Hangfire / Quartz
south
database
طبقة البيانات · Data Layer

SQL Server + Redis + Blob Storage

storage
SQL Server 2022
٥٣ جدول · Primary DB · Replica للقراءة
flash_on
Redis Cache
جلسات · إشعارات · بيانات سريعة
cloud
Azure Blob Storage
صور · ملفات PDF · فيديوهات الموقع
Pattern: Clean Architecture
فصل المنطق التجاري عن التفاصيل التقنية · Domain · Application · Infrastructure · Presentation.
CQRS · Mediator
فصل عمليات القراءة عن الكتابة · MediatR للأوامر والاستعلامات · أداء أعلى.
Repository Pattern
Entity Framework Core · Generic Repository · Unit of Work · سهولة الاختبار.
٢ · Technology Stack

المنظومة التقنية الكاملة

تقنيات Microsoft للباك إند · Native للموبايل · Angular للويب

Backend
ASP.NET Core 8
C# 12
Entity Framework Core
SignalR (Real-time)
MediatR · AutoMapper
FluentValidation
Serilog · ELK Stack
Android
Java 17 (Native)
Android SDK 34
Material Design 3
Retrofit · OkHttp
Room (Local DB)
Firebase FCM (Push)
Glide (Images)
iOS
Swift 5.9 (Native)
iOS SDK 17
SwiftUI · UIKit
Alamofire (Network)
Core Data (Local)
APNS (Push)
Kingfisher (Images)
Web Admin
Angular 17
TypeScript 5
Angular Material
RxJS · NgRx
Chart.js · ApexCharts
PrimeNG (UI Library)
i18n (RTL Arabic)
Database
SQL Server 2022 Enterprise
Redis 7 (Caching)
Elasticsearch (Search)
DevOps
Azure DevOps · CI/CD
Docker · Kubernetes
Application Insights
Storage
Azure Blob Storage
Azure CDN
Azure Key Vault
٣ · API Reference · 180+ Endpoints

نقاط النهاية الرئيسية للـ API

Base URL: https://api.rakaez.com/v1/

securityالمصادقة · Authentication

POST/auth/registerتسجيل مستخدم جديد
POST/auth/loginتسجيل دخول · يرجع JWT
POST/auth/otp/sendإرسال رمز OTP
POST/auth/otp/verifyالتحقق من OTP
POST/auth/refreshتجديد الـ Access Token
POST/auth/logoutتسجيل خروج

folder_specialالمشاريع · Projects

GET/projectsقائمة المشاريع (مع pagination)
GET/projects/{id}تفاصيل مشروع
POST/projectsإنشاء مشروع جديد
PUT/projects/{id}تحديث مشروع
DELETE/projects/{id}حذف (soft delete)
GET/projects/{id}/timelineالجدول الزمني
GET/projects/{id}/budgetالميزانية والمصروفات

event_noteالتخطيط · Planning ⭐ NEW

GET/planning/schedulesكل الجداول النشطة
POST/planning/schedulesإنشاء جدول أسبوعي/نصف شهري
GET/planning/schedules/{id}/itemsبنود الجدول
PUT/planning/items/{id}/progressتحديث نسبة التنفيذ (٠-١٠٠٪)
POST/planning/items/{id}/quality-checkفحص الجودة وإغلاق البند
GET/planning/items/{id}/dependenciesالبنود السابقة (Sequential Lock)

verifiedالاعتمادات · Approvals

GET/approvalsقائمة الاعتمادات (بانتظار/مكتملة)
POST/approvals/{id}/approveاعتماد + توقيع رقمي
POST/approvals/{id}/rejectرفض مع سبب
POST/approvals/{id}/request-revisionطلب تعديل

inventory_2المخزن · Warehouse

GET/warehouse/itemsكتالوج الأصناف
GET/warehouse/inventoryالمخزون الحالي
POST/warehouse/requestsطلب جديد من المهندس (مع كميات)
PUT/warehouse/requests/{id}/processمعالجة الطلب
POST/warehouse/movementsحركة مخزون (دخول/خروج)

apartmentإدارة العقارات VIP · Property Management ⭐ NEW

GET/propertiesعقارات العميل VIP
GET/properties/{id}/maintenanceجدول الصيانة الدورية
POST/properties/{id}/maintenance/requestطلب صيانة
GET/properties/{id}/tenantsالمستأجرين الحاليين والسابقين
GET/properties/{id}/rentsسجل الإيجارات
GET/properties/reports/quarterly/{year}/{quarter}التقرير الربعي

paymentsالمدفوعات · Payments

GET/payments/summary/{projectId}ملخص الدفعات (المدفوع/القادم/المتأخر)
GET/invoicesقائمة الفواتير
POST/payments/processإتمام دفعة (بنك/بطاقة/Fawry)
POST/payments/upload-receiptرفع إيصال تحويل بنكي

notificationsالإشعارات · Notifications

GET/notificationsإشعارات المستخدم
PUT/notifications/{id}/readتعليم كمقروء
POST/notifications/site-subscribe/{siteId}اشتراك في إشعارات موقع
PUT/notifications/preferencesتفضيلات الإشعارات (push/sms/email/whatsapp)
180+
Endpoints
REST
Architecture
JSON
Format
JWT
Auth
٤ · Security & Compliance

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

معايير دولية · حماية متعددة الطبقات

https
التشفير في النقل
  • ✓ TLS 1.3 لكل الاتصالات
  • ✓ Certificate Pinning في الموبايل
  • ✓ HSTS لمنع HTTP downgrade
  • ✓ Perfect Forward Secrecy
enhanced_encryption
التشفير في التخزين
  • ✓ AES-256 للبيانات الحساسة
  • ✓ TDE (Transparent Data Encryption) في SQL Server
  • ✓ كلمات السر بـ bcrypt + salt
  • ✓ Azure Key Vault لإدارة المفاتيح
verified_user
المصادقة والترخيص
  • ✓ JWT بصلاحية ١٥ دقيقة + Refresh Token
  • ✓ OTP عبر SMS لكل دخول جديد
  • ✓ بصمة الإصبع / Face ID في الموبايل
  • ✓ Role-Based Access Control (RBAC)
shield
حماية API
  • ✓ Rate Limiting (١٠٠ طلب/دقيقة)
  • ✓ CORS Policy صارمة
  • ✓ Input Validation (FluentValidation)
  • ✓ SQL Injection Protection (EF Parameters)
  • ✓ XSS & CSRF Protection
history
المراجعة والتدقيق
  • ✓ Audit Log لكل العمليات الحساسة
  • ✓ تسجيل: من · ماذا · متى · IP · User-Agent
  • ✓ احتفاظ بالسجلات لمدة ٧ سنوات
  • ✓ تنبيه فوري لأي نشاط مشبوه
backup
النسخ الاحتياطي
  • ✓ نسخ كاملة يومياً (٢ ص)
  • ✓ نسخ تفاضلية كل ٤ ساعات
  • ✓ Geo-Replication لمناطق متعددة
  • ✓ RTO < ٤ ساعات · RPO < ١ ساعة
٥ · Third-Party Integrations

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

١٢ خدمة خارجية متكاملة مع المنظومة

المدفوعات
  • credit_cardPaymob (بطاقات)
  • phone_iphoneFawry
  • account_balanceInstaPay
  • walletVodafone Cash
التواصل
  • 📱 WhatsApp Business API
  • smsTwilio (SMS)
  • mailSendGrid (Email)
  • phone_in_talkVoice Calls API
إشعارات Push
  • androidFirebase FCM (Android)
  • phone_iphoneAPNS (iOS)
  • webWeb Push (Admin)
الخرائط والمواقع
  • mapGoogle Maps
  • location_onGeocoding API
  • directionsDirections API
التحليلات
  • analyticsGoogle Analytics
  • monitoringApplication Insights
  • bug_reportSentry (Crashes)
المستندات والتوقيع
  • drawالتوقيع الرقمي
  • picture_as_pdfPDF Generation
  • qr_codeQR Code Service
٦ · Deployment & Hosting

النشر والاستضافة

Azure Cloud · CI/CD · ٣ بيئات منفصلة

Development
dev.rakaez.com
  • • Azure App Service (Basic)
  • • SQL Server (Basic)
  • • تحديث تلقائي مع كل push
Staging / UAT
staging.rakaez.com
  • • Azure App Service (Standard)
  • • SQL Server (Standard)
  • • اختبار من فريق QA والعميل
Production
api.rakaez.com
  • • Azure App Service (Premium)
  • • SQL Server (Premium)
  • • Auto-scaling · CDN · WAF
CI/CD Pipeline · Azure DevOps
code
Code Push
build
Build
science
Test
security
Security Scan
cloud_upload
Deploy
99.9%
Uptime SLA
<200ms
API Response (P95)
10K+
Concurrent Users
Auto
Scaling