عرض فني ومالي متكامل

نظرة عامة على المشروع

AI Business Copilot هو منصة SaaS مدعومة بالذكاء الاصطناعي تستهدف التجار في السوق المصري والعربي. المنصة ليست ERP تقليدياً، بل نظام ذكي يساعد التاجر على اتخاذ قرارات شراء وبيع مبنية على البيانات.

Mobile Application

تطبيق Flutter (Android + iOS) مع إدارة مخزون وOCR وAI Chat

تسجيل دخول OTP
إدارة المنتجات والمخزون
تصوير الفواتير (OCR)
AI Chat Assistant
تنبيهات ذكية
دعم Offline

Web Dashboard

لوحة تحكم Next.js تفاعلية بتقارير وتحليلات وإدارة اشتراكات

Dashboard تفاعلي
إدارة المخزون المتقدمة
التقارير والتحليلات
إدارة الفروع والمستخدمين
مراقبة الأداء والمبيعات
تصدير PDF/Excel

Backend APIs

Python FastAPI مع Multi-tenant Architecture وجميع الـ APIs

RESTful API + WebSocket
JWT Authentication
Multi-tenant Architecture
Celery Workers
File Upload (AWS S3)
Swagger Documentation

AI Insights Engine

تحليل ذكي: ركود، توقع طلب، اقتراح قرارات بيع وشراء

كشف المنتجات الراكدة
تحليل حركة المبيعات
توقع نقص المخزون
اقتراحات الشراء والبيع
تنبيهات ذكية
تحليل الأرباح والخسائر

OCR Invoice Scanner

استخراج بيانات الفواتير تلقائياً بدعم عربي وإنجليزي

تصوير الفواتير بالكاميرا
استخراج البيانات تلقائياً
تحويل البيانات إلى مخزون
دعم اللغة العربية
دعم اللغة الإنجليزية
شاشة مراجعة قبل الحفظ

Subscription & Payments

نظام باقات متكامل مع بوابات الدفع المصرية والدولية

باقات Basic / Pro / Business
اشتراك شهري وسنوي
Free Trial 14 يوم
Paymob + InstaPay + فوري
محافظ إلكترونية (Vodafone, Orange, Etisalat, WE)
Stripe + PayPal (Phase 2)

المعمارية التقنية الكاملة

المكون	القرار التقني	التفاصيل
Architecture Pattern	Modular Monolith	معمارية مُبسّطة قابلة للتوسع التدريجي لـ Microservices
Multi-tenancy	Shared Database + Row-Level Isolation	tenant_id في كل الجداول + فصل تام للبيانات
API Style	RESTful API + WebSocket + Webhook	Real-time للإشعارات + Webhook للمدفوعات
Authentication	JWT Access Token (15 min) + Refresh Token (30 days) + OTP	أمان عالي مع تجربة مستخدم سلسة
Caching Layer	Redis 7 (AWS ElastiCache)	Session cache + API response cache + Rate limiting
Queue System	Celery + Redis Broker	OCR jobs + AI analysis + Notifications
Storage	AWS S3 + CloudFront CDN	صور المنتجات + الفواتير + تقارير PDF
AI Engine	DeepSeek V3.2 + Local Processing	توفير 85-90% مقارنة بـ OpenAI
OCR Engine	Tesseract OCR (Open Source) + DeepSeek NLP	مجاني + دقة عالية للعربية
Vector DB	PostgreSQL pgvector	مُدمج في قاعدة البيانات الرئيسية
Monitoring	Sentry + CloudWatch + Custom Dashboards	Errors + Infrastructure + Business metrics

🔧 Architecture Diagram

┌─────────────────────────────────────────────────────────────────┐
│                         CLIENTS                                  │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐         │
│  │  Flutter     │  │   Next.js    │  │   Admin      │         │
│  │  Mobile App  │  │   Web Dash   │  │   Panel      │         │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘         │
└─────────┼─────────────────┼─────────────────┼─────────────────┘
          │                 │                 │
          └─────────────────┼─────────────────┘
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│              AWS Application Load Balancer                       │
│                    (SSL Termination)                              │
└─────────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│              ECS Fargate (FastAPI Backend)                       │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐             │
│  │  Auth   │ │Products │ │Inventory│ │  OCR    │             │
│  │ (OTP+JWT)│ │  CRUD   │ │  Mgmt   │ │Tesseract│             │
│  └─────────┘ └─────────┘ └─────────┘ └────┬────┘             │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐       │                  │
│  │  AI     │ │Payments │ │Reports │       │                  │
│  │DeepSeek │ │ Paymob  │ │PDF/Excel│       │                  │
│  │  RAG    │ │ Webhooks│ │ Export  │       │                  │
│  └────┬────┘ └─────────┘ └─────────┘       │                  │
│       │                                     │                  │
│       └─────────────────────────────────────┘                  │
│              DeepSeek V3.2 (NLP Parsing)                         │
└─────────────────────────────────────────────────────────────────┘
                            │
        ┌───────────────────┼───────────────────┐
        ▼                   ▼                   ▼
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│  PostgreSQL  │    │    Redis     │    │    AWS S3    │
│   (RDS)      │    │(ElastiCache) │    │  (Storage)   │
│  + pgvector  │    │  Cache/Queue │    │  Images/PDFs │
│  Embeddings  │    │  Sessions    │    │  Invoices    │
└──────────────┘    └──────────────┘    └──────────────┘

تصميم قاعدة البيانات — Multi-Tenant

الجدول	الغرض	الأعمدة الرئيسية
tenants	الجدول الرئيسي للمستأجرين (التجار)	id, name, plan, status, created_at
users	مستخدمو كل tenant مع أدوار مختلفة	id, tenant_id, phone, role, otp_verified
products	كتالوج المنتجات لكل تاجر	id, tenant_id, sku, name, category, cost_price, sell_price, embedding
inventory	المخزون الفعلي لكل منتج وفرع	id, tenant_id, product_id, branch_id, qty, min_threshold
transactions	كل حركة بيع وشراء وإرجاع	id, tenant_id, type, product_id, qty, price, date
invoices	الفواتير الممسوحة + نتيجة OCR	id, tenant_id, image_url, ocr_data, status, created_at
ai_insights	نتائج تحليل الـ AI المخزنة	id, tenant_id, product_id, insight_type, score, generated_at
subscriptions	اشتراكات وحالة الدفع	id, tenant_id, plan, status, start_date, end_date
payments	سجل المدفوعات الكامل	id, tenant_id, amount, method, gateway_ref, status
notifications	سجل التنبيهات المرسلة	id, tenant_id, user_id, type, message, read_at
branches	فروع التاجر	id, tenant_id, name, address, manager_id
audit_logs	سجل كل العمليات للمراجعة	id, tenant_id, user_id, action, entity, timestamp

API Structure — Endpoints Map

كل الـ APIs تتبع الصيغة: /api/v1/{module}/{resource} — مع versioning كامل من البداية لضمان التوسع

Module	Endpoint	الوظيفة
Auth	POST /auth/send-otp	إرسال OTP على الموبايل
Auth	POST /auth/verify-otp	التحقق من OTP + إصدار JWT
Auth	POST /auth/refresh	تجديد الـ Access Token
Products	GET /products	جلب كل المنتجات مع فلترة وpagination
Products	POST /products	إضافة منتج جديد
Products	PUT /products/{id}	تعديل بيانات منتج
Products	DELETE /products/{id}	حذف منتج
Inventory	GET /inventory	جلب المخزون الكامل
Inventory	POST /inventory/adjust	تعديل كمية المخزون يدوياً
Inventory	GET /inventory/low-stock	المنتجات تحت الحد الأدنى
Transactions	POST /transactions/sale	تسجيل عملية بيع
Transactions	POST /transactions/purchase	تسجيل عملية شراء
Transactions	GET /transactions/history	سجل الحركات مع فلترة تاريخ
OCR	POST /ocr/scan-invoice	رفع صورة فاتورة + استخراج بيانات
OCR	POST /ocr/confirm	تأكيد بيانات OCR وحفظها في المخزون
AI	GET /ai/insights	جلب كل التحليلات الذكية
AI	GET /ai/slow-moving	المنتجات الراكدة مرتبة بالأسوأ
AI	GET /ai/demand-forecast	توقع الطلب للأسابيع القادمة
AI	POST /ai/chat	إرسال سؤال للـ AI Chat Assistant
Reports	GET /reports/profit-loss	تقرير الأرباح والخسائر
Reports	GET /reports/sales-summary	ملخص المبيعات بفترة محددة
Reports	GET /reports/export/pdf	تصدير تقرير PDF
Subscriptions	GET /subscriptions/plans	عرض الباقات المتاحة
Subscriptions	POST /subscriptions/subscribe	الاشتراك في باقة
Subscriptions	POST /payments/webhook	استقبال Webhook من بوابة الدفع
Notifications	GET /notifications	جلب كل التنبيهات
Notifications	POST /notifications/read/{id}	تحديد تنبيه كمقروء
Admin	GET /admin/tenants	لوحة تحكم المشرف — كل التجار
Admin	GET /admin/metrics	إحصائيات المنصة الكاملة

Mobile Application — Flutter

التقنية	التفاصيل
Framework	Flutter 3.x (Dart) — Android 7.0+ و iOS 14+
State Management	Riverpod 2.x — أفضل خيار لـ Flutter 3 مع code generation
Navigation	GoRouter — Declarative routing مع deep linking
Network Layer	Dio + Retrofit — Type-safe API calls مع interceptors
Local Storage	Hive (fast NoSQL) + SharedPreferences للـ settings
Camera & OCR	camera plugin + image_picker + رفع للـ Backend OCR API
Push Notifications	Firebase Cloud Messaging (FCM) + flutter_local_notifications
Authentication	Firebase Auth (OTP) أو Twilio Verify + JWT storage آمن
Offline Support	Hive local cache + background sync عند عودة الاتصال
Localization	flutter_localizations: Arabic (RTL) + English
Charts	fl_chart لرسوم بيانية المبيعات والمخزون
UI Components	Material 3 + Custom Design System خاص بالمشروع
Analytics	Firebase Analytics لتتبع سلوك المستخدم
Testing	flutter_test + integration_test + Mockito

شاشات التطبيق الكاملة

Authentication Flow

Splash Screen مع تحقق من الـ JWT المحفوظ
شاشة إدخال رقم الهاتف مع country picker
شاشة إدخال OTP (6 أرقام) مع timer وإعادة إرسال
شاشة اختيار الباقة للمستخدمين الجدد (Free Trial)
شاشة إعداد الملف الشخصي والمتجر

Home Dashboard

ملخص يومي: المبيعات، الأرباح، المنتجات المباعة
تنبيهات عاجلة: نقص مخزون، منتجات راكدة
Quick Actions: إضافة منتج، تسجيل بيع، مسح فاتورة
رسم بياني للمبيعات (أسبوعي / شهري)
AI Insights مختصرة مع رابط لعرض الكل

إدارة المخزون

قائمة المنتجات مع بحث وفلترة بالفئة والحالة
شاشة تفاصيل المنتج: سعر التكلفة، البيع، الكمية، الحركة
إضافة منتج: اسم، SKU، فئة، سعر تكلفة وبيع، صورة، الحد الأدنى
فلتر: راكد / منخفض / طبيعي / مرتفع الحركة
باركود scanner للبحث السريع

OCR Invoice Scanner

تصوير الفاتورة بالكاميرا أو اختيار من المعرض
عرض نتيجة OCR للمراجعة قبل الحفظ (Confirmation Step)
خريطة ربط الحقول: اسم المنتج، الكمية، السعر، التاريخ
تعديل يدوي لأي حقل قبل التأكيد
حفظ البيانات تلقائياً في المخزون بعد التأكيد

AI Chat Assistant

واجهة محادثة طبيعية بالعربية والإنجليزية
سجل المحادثات السابقة
أسئلة مقترحة كـ Quick Replies
ربط الإجابات ببيانات المخزون الحقيقية للتاجر عبر RAG

التقارير والتحليلات

تقرير المبيعات: يومي، أسبوعي، شهري
تقرير الأرباح والخسائر مع رسوم بيانية
أكثر وأقل المنتجات مبيعاً
المنتجات الراكدة مع توصية AI
تصدير PDF مباشرة من الموبايل

Web Dashboard — Next.js

التقنية	التفاصيل
Framework	Next.js 14 (App Router) + TypeScript Strict Mode
Styling	Tailwind CSS 3.x + shadcn/ui كـ component library
State Management	Zustand (global) + TanStack Query v5 (server state + caching)
Charts & Viz	Recharts + ApexCharts لرسوم بيانية تفاعلية
Tables	TanStack Table v8 مع sorting, filtering, pagination
Forms	React Hook Form + Zod لـ validation
API Client	Axios + custom hooks with TanStack Query
Auth	NextAuth.js أو custom JWT middleware + HTTP-only cookies
RTL Support	Tailwind RTL plugin + direction: rtl على مستوى المستند
PDF Export	react-pdf أو jsPDF لتصدير التقارير
Excel Export	xlsx (SheetJS) لتصدير البيانات
Notifications	React Hot Toast + WebSocket للتنبيهات الفورية
i18n	next-intl: دعم عربي وإنجليزي مع dynamic switching
Testing	Vitest + Testing Library + Playwright للـ E2E
Performance	SSR + ISR + Image Optimization + Code Splitting

صفحات لوحة التحكم الكاملة

Main Dashboard /dashboard

KPI Cards: إجمالي المبيعات، الأرباح، المنتجات، العملاء
Sales Trend Chart: رسم بياني خطي للمبيعات (يومي/أسبوعي/شهري)
Top Products Table: أكثر المنتجات ربحاً ومبيعاً
Inventory Alerts Widget: بطاقات التنبيهات العاجلة
AI Insights Summary: أهم 3 توصيات AI
Activity Feed: آخر الحركات والعمليات

إدارة المخزون /inventory

جدول كامل للمنتجات مع: SKU، الفئة، الكمية، سعر التكلفة، سعر البيع، حالة الحركة
Bulk Actions: تعديل أسعار متعددة دفعة واحدة
فلترة متقدمة: الفئة، الحالة، نطاق السعر، الفرع
Export Excel/CSV لكل بيانات المخزون
Inventory History: سجل كل تغييرات المخزون
Reorder Points: ضبط حد إعادة الطلب لكل منتج

التقارير والتحليلات /reports

Profit & Loss Statement: بيان كامل بأي فترة زمنية
Sales by Category: مقارنة مبيعات الفئات
Margin Analysis: هامش الربح لكل منتج
Dead Stock Report: المنتجات الراكدة مع أيام الركود
Cash Flow Overview: التدفق النقدي الشهري
Export: PDF, Excel لكل تقرير

AI Insights /ai-insights

Slow-Moving Products Dashboard: قائمة المنتجات الراكدة مرتبة بدرجة الركود
Demand Forecast Charts: توقعات الأسابيع القادمة لكل منتج
Purchase Recommendations: مقترحات إعادة الطلب مع الكميات
Sales Recommendations: منتجات يُنصح بتخفيضها أو ترويجها
AI Chat Widget مدمج في الصفحة

إدارة الاشتراكات /subscriptions

عدد المشتركين الكلي + النشطون + التجريبيون
Monthly Recurring Revenue (MRR) و Annual Recurring Revenue (ARR)
Churn Rate + New Subscribers Chart
جدول التجار مع: الباقة، تاريخ الانتهاء، الحالة، إجمالي المدفوع
إيقاف/تفعيل/ترقية أي حساب يدوياً

إدارة المستخدمين والفروع /settings

إضافة مستخدمين فرعيين مع تحديد الصلاحيات
Role-Based Access Control: Admin, Manager, Cashier, Viewer
إضافة وتعديل الفروع مع تخصيص مخزون لكل فرع
Audit Log: سجل كل العمليات والتغييرات

Backend — Python FastAPI

التقنية	التفاصيل
Framework	FastAPI 0.110+ — async/await native, Pydantic v2
Python Version	Python 3.12 (latest stable)
ORM	SQLAlchemy 2.x (Async) + Alembic للـ migrations
Database	PostgreSQL 16 (AWS RDS) — Primary DB
Cache & Queue	Redis 7 (AWS ElastiCache) — Sessions + Celery Broker
Task Queue	Celery 5.x — OCR Jobs, AI Analysis, Email/SMS notifications
File Storage	AWS S3 + boto3 — صور، فواتير، PDFs
Authentication	python-jose (JWT) + bcrypt + OTP via SMS
Validation	Pydantic v2 — request/response schemas مع auto-docs
API Docs	Swagger UI + ReDoc — تولد تلقائياً من الكود
Testing	pytest + pytest-asyncio + httpx + factory_boy
Code Quality	Black (formatter) + Ruff (linter) + mypy (type checks)
Rate Limiting	slowapi (per tenant, per endpoint)
Logging	structlog + JSON logging → CloudWatch
CORS	مضبوط بدقة — origins المسموح بها فقط
Containerization	Docker + docker-compose للـ dev + ECS للـ production

بنية الكود — Project Structure

Backend Folder Structure

├── app/
│   ├── api/v1/           ← كل الـ Routers مقسمة بالـ Module
│   ├── models/           ← SQLAlchemy models + relationships
│   ├── schemas/          ← Pydantic schemas (Request/Response)
│   ├── services/         ← Business Logic Layer (منفصل عن الـ Routes)
│   ├── repositories/     ← Database Access Layer (Data Access Pattern)
│   ├── core/             ← Config, Security, Dependencies, Middleware
│   ├── workers/          ← Celery tasks (OCR, AI, Notifications)
│   └── integrations/     ← DeepSeek, Tesseract, Payment Gateways
├── migrations/           ← Alembic migration scripts
├── tests/                ← Unit + Integration tests
└── docker/               ← Dockerfile + docker-compose

Multi-Tenant Middleware

الميزة	التطبيق
Tenant Identification	من JWT claims: sub + tenant_id + role
Data Isolation	WHERE tenant_id = :tenant_id في كل query
Plan Enforcement	Middleware يتحقق من حدود الباقة قبل كل عملية
Rate Limiting	per-tenant limits: Basic 100 req/min, Pro 500, Business 2000
Audit Trail	كل write operation يُسجل في audit_logs تلقائياً

AI Insights Engine — المعمارية الكاملة

الـ AI Engine يعمل على مستويين: (1) Rule-based Alerts للتنبيهات الفورية والقرارات البسيطة، (2) ML-based Analysis للتحليلات العميقة وتوقع الطلب. كلاهما يتشاركان نفس Data Pipeline.

A. Slow-Moving Detection (كشف الركود)

حساب Velocity Score لكل منتج: (المبيعات في 30 يوم) / (متوسط المخزون)
تصنيف: Fast-moving (>0.5) / Normal (0.2-0.5) / Slow (0.05-0.2) / Dead (<0.05)
Days-on-Shelf: عدد أيام المنتج في المخزون بدون بيع
Capital-at-Risk: قيمة المنتجات الراكدة بالجنيه
تحديث تلقائي كل 24 ساعة عبر Celery Scheduled Task

B. Demand Forecasting (توقع الطلب)

الموديل: Facebook Prophet (Time-Series Forecasting) مع seasonal decomposition
Input: بيانات المبيعات التاريخية (90 يوم minimum)
Output: توقع أسبوعي و شهري لكل منتج مع confidence interval
Fallback: Moving Average بسيط للمنتجات حديثة الإضافة
Retraining: الموديل يُعاد تدريبه أسبوعياً ببيانات جديدة

C. Purchase Recommendations (اقتراح الشراء)

Reorder Point = Lead Time Demand + Safety Stock
يُقارن المخزون الحالي بالـ Reorder Point تلقائياً
ينتج قائمة بالمنتجات التي تحتاج إعادة طلب مع الكميات المقترحة
يراعي: متوسط المبيعات، الـ Lead Time، الحد الأدنى المُدخل من التاجر

D. AI Chat Assistant — RAG Architecture

LLM: DeepSeek V3.2 كـ reasoning engine (أرخص 20x من GPT-4o)
Context Injection: RAG: بيانات المخزون الفعلية تُحقن في كل prompt
Vector Store: PostgreSQL pgvector لتخزين embeddings
System Prompt: محدد بدقة: التاجر، نوع البيانات، الصلاحيات، اللغة
Response Caching: Redis cache للأسئلة الشائعة (cache TTL: 1 hour)
Languages: يفهم ويجيب بالعربية والإنجليزية وخلط اللغتين

E. Smart Notifications Engine

Low Stock Alert: عندما تنزل الكمية تحت threshold المحدد
Dead Stock Alert: منتج لم يُباع منذ 45 يوم
Demand Spike Alert: زيادة غير طبيعية في الطلب (+50% عن المعدل)
Sales Drop Alert: انخفاض مبيعات أكثر من 30% أسبوعياً
Reorder Alert: منتج وصل لـ Reorder Point
Daily Summary: تقرير يومي مختصر (Push Notification + Email)

OCR Invoice Scanner — Pipeline كامل

الخطوة	التفاصيل
Step 1: Capture	التقاط صورة الفاتورة بكاميرا الموبايل أو رفع من المعرض
Step 2: Pre-processing	Image enhancement: contrast, deskew, denoise قبل الإرسال
Step 3: OCR Engine	Tesseract OCR (Open Source) — يدعم العربية بدقة عالية
Step 4: NLP Parsing	DeepSeek V3.2 يحول النص الخام لـ structured JSON (منتجات، كميات، أسعار)
Step 5: Confidence Score	كل حقل له confidence score — حقول منخفضة تُعلَّم للمراجعة
Step 6: User Review	التاجر يراجع ويعدل قبل التأكيد (Confirmation Screen)
Step 7: Auto-import	الحفظ في جداول المخزون والـ Transactions تلقائياً

دعم أنواع الفواتير

أنواع الفواتير المدعومة

فواتير مكتوبة بالعربية بالكامل
فواتير مكتوبة بالإنجليزية بالكامل
فواتير تجمع العربية والإنجليزية (الأكثر شيوعاً في السوق المصري)
فواتير مطبوعة + فواتير مكتوبة يدوياً (handwritten)
فواتير ضريبية الإلكترونية (e-invoice format)

Accuracy & Fallback

Tesseract OCR: دقة 90%+ للفواتير المطبوعة الواضحة
DeepSeek V3.2 Post-processing: يرفع الدقة الفعلية لـ 85%+
أي حقل بـ confidence < 80% يُلوّن بالأصفر في شاشة المراجعة
الفواتير الإجمالية: مقارنة آلية بين مجموع البنود والإجمالي المكتوب

نظام الاشتراكات والمدفوعات

هيكل الباقات

الميزة	Basic	Pro	Business
السعر الشهري	299 جنيه	599 جنيه	1,199 جنيه
السعر السنوي	2,999 جنيه	5,999 جنيه	11,999 جنيه
عدد المنتجات	حتى 500	حتى 3,000	غير محدود
المستخدمون	1	3	10
الفروع	1	2	غير محدود
OCR فواتير/شهر	50	200	غير محدود
AI Chat	محدود 50 رسالة	غير محدود	غير محدود + Priority
AI Insights	أساسية	كاملة	كاملة + تخصيص
تصدير التقارير	PDF فقط	PDF + Excel	PDF + Excel + API
دعم فني	Email فقط	Email + Chat	Dedicated Support
Free Trial	14 يوم	14 يوم	14 يوم

بوابات الدفع المدعومة

طريقة الدفع	التطبيق
Paymob / Kashier	البوابة الرئيسية — تدعم البطاقات البنكية (Visa/MasterCard) وكل المحافظ
InstaPay	دفع فوري عبر تطبيقات البنوك — Webhook للتأكيد الفوري
فوري (Fawry)	الدفع النقدي في نقاط فوري — مناسب للتجار بدون بطاقات
Vodafone Cash	محفظة إلكترونية — عبر Paymob أو API مباشر
Orange Cash	محفظة إلكترونية — عبر Paymob
Etisalat Cash (e&)	محفظة إلكترونية — عبر Paymob
WE Pay	محفظة WE — عبر Paymob
QR Code	QR Payment مرتبط بالـ Dynamic QR من البوابة

Payment Flow الكامل

الخطوة 1

اختيار الباقة

التاجر يختار الباقة ويضغط اشتراك

الخطوة 2

اختيار طريقة الدفع

يُعرض عليه طرق الدفع المتاحة حسب موقعه

الخطوة 3

إتمام الدفع

يتم التحويل لبوابة الدفع (أو الدفع In-App للمحافظ)

الخطوة 4

Webhook Confirmation

البوابة ترسل Webhook لـ Backend عند النجاح/الفشل

الخطوة 5

تفعيل الاشتراك

Backend يُحدث حالة الاشتراك فوراً

الخطوة 6

إشعار التأكيد

التاجر يحصل على إشعار Push + Email بالتأكيد

الخطوة 7

فاتورة ضريبية

فاتورة ضريبية PDF تُولَّد تلقائياً وتُرسَل بالإيميل

Subscription Lifecycle

الحالة	التفاصيل
Free Trial	14 يوم — كل مزايا Pro متاحة — لا يحتاج كرت بنكي
Trial Expiry	تنبيه قبل 3 أيام + يوم الانتهاء — Downgrade تلقائي
Active	كل المزايا متاحة حسب الباقة
Payment Failed	Grace Period 3 أيام — إشعار يومي بالتجديد
Suspended	بعد Grace Period — القراءة فقط — لا يمكن إضافة بيانات
Cancelled	بيانات محفوظة 90 يوم ثم حذف — إشعار قبل الحذف
Upgrade	فوري — Proration حساب الفرق بالأيام المتبقية
Renewal Auto	تجديد تلقائي مع إشعار قبل 7 أيام

البنية التحتية — AWS Architecture

الخدمة	الاستخدام
ECS Fargate	تشغيل Backend FastAPI containers بدون إدارة servers
RDS PostgreSQL	قاعدة البيانات الرئيسية — Multi-AZ للـ production
ElastiCache Redis	Caching + Celery Broker
S3	تخزين الصور والفواتير والـ PDFs
CloudFront CDN	توزيع الـ Static Assets و Images عالمياً
Application Load Balancer	توزيع الحمل + SSL Termination
Route 53	DNS Management
ACM	SSL/TLS Certificates مجانية وتجديد تلقائي
CloudWatch	Logs + Metrics + Alarms
ECR	Container Registry لتخزين Docker images
Secrets Manager	تخزين آمن لـ API Keys وكلمات المرور
SES	إرسال الإيميلات (تأكيدات، تقارير، تنبيهات)
SNS	إرسال SMS للـ OTP (أو Twilio)

CI/CD Pipeline

1

GitHub Actions Trigger

عند كل push لـ main branch

2

Run Tests

pytest (Backend) + Flutter test (Mobile) + Vitest (Web)

3

Code Quality

Black, Ruff, mypy, ESLint, Dart analyze

4

Build & Push

Build Docker Image → Push to ECR

5

Deploy to ECS

Deploy to ECS Fargate (Rolling Update — Zero Downtime)

6

Database Migrations

Alembic تشتغل تلقائياً بعد الـ Deploy

7

Health Check & Rollback

تأكيد نجاح الـ Deploy + Rollback تلقائي عند الفشل

Security Measures

أمان الشبكة

HTTPS فقط — HTTP يُحوَّل تلقائياً
JWT with RS256 (asymmetric signing)
API Rate Limiting per tenant و per IP
WAF (Web Application Firewall) للحماية من الهجمات

أمان البيانات

SQL Injection Protection: ORM queries فقط
Input Validation: Pydantic v2 على كل request
Secrets في AWS Secrets Manager
S3 Bucket: Private + Pre-signed URLs

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

VPC: Backend في Private Subnet
لا يمكن الوصول مباشرة من الإنترنت
Security Groups مضبوطة بدقة
Network ACLs للحماية الإضافية

خطة التطوير والجدول الزمني (4 شهور)

الشهر 1

Phase 1 — Foundation & Core (الأساس)

AWS Infrastructure: ECS, RDS, Redis, S3, CI/CD pipeline شغال بالكامل
Backend Foundation: Auth (OTP + JWT), tenant middleware, Products API, Inventory API
Mobile App: شاشات Auth, Home Dashboard (skeleton), Products List
Web Dashboard: Login, Dashboard (skeleton), Products page
Database: كل الجداول منشأة مع Migrations
Swagger Documentation: كل الـ APIs الجاهزة موثقة

الشهر 2

Phase 2 — Core Features (الأساسيات)

Mobile: إدارة مخزون كاملة، OCR Scanner، Push Notifications، Offline Mode
Web: Dashboard كامل مع Charts، Inventory Management، Reports أساسية
Backend: Transactions API، OCR Pipeline، Celery Workers، File Upload
Payments: Paymob Integration، Subscription System، Webhooks
AI Chat: نسخة أولى مع RAG على بيانات المخزون
Testing: Coverage > 70% على الـ Backend

الشهر 3

Phase 3 — AI Engine & Advanced (الذكاء الاصطناعي)

AI Insights Engine كامل: Slow-moving، Demand Forecast، Purchase Recommendations
Smart Notifications System: Low stock، Dead stock، Sales alerts
Advanced Reports: P&L، Margin Analysis، Cash Flow، Export PDF/Excel
Multi-branch Support: إدارة الفروع والمستخدمين وصلاحياتهم
OCR تحسينات: دقة أعلى للفواتير العربية، Bulk invoice processing
Performance Optimization: Caching، Query Optimization، Load Testing

الشهر 4

Phase 4 — Polish, Testing & Launch (التلميع والإطلاق)

UAT مع مجموعة تجار أوائل (5-10 تجار) وجمع Feedback
Bug Fixing بناءً على UAT
Performance Testing: Load Test حتى 1000 concurrent users
Security Audit: Penetration Testing أساسي
App Store Submission: Apple App Store + Google Play
Go-Live على Production AWS
Onboarding Documentation للتجار

عرض الأسعار التفصيلي

المكون / الوحدة	وصف النطاق	التكلفة (EGP)
Mobile App (Flutter)	Auth + Inventory + OCR + AI Chat + Notifications + Offline + Design	350,000
Web Dashboard (Next.js)	Dashboard + Reports + Inventory + Multi-user + Subscriptions page	250,000
Backend APIs (FastAPI)	Multi-tenant + Auth + All APIs + WebSocket + Celery + File Upload	300,000
AI Insights Engine	Demand Forecast + Slow-moving + RAG Chat + Recommendations + Alerts	250,000
OCR Invoice Scanner	Tesseract + DeepSeek post-processing + Arabic support + Validation UI	100,000
Subscription & Payments	Paymob + All Egyptian wallets + Plans + Webhooks + Invoices	150,000
UI/UX Design	Mobile Design System + Web Design + Prototypes + Assets	100,000
Infrastructure & DevOps	AWS Setup + Docker + CI/CD + Monitoring + Security + Documentation	100,000

الإجمالي — MVP كامل

1,500,000

جنيه مصري

شاملة كل المكونات المذكورة أعلاه — مدة التنفيذ 4 شهور

تكاليف التشغيل الشهرية (بعد الإطلاق)

المكون / الوحدة	وصف النطاق	التكلفة الشهرية
AWS Infrastructure (MVP Scale)	ECS + RDS + Redis + S3 + CloudFront + Load Balancer	15,000 — 25,000 جنيه/شهر
DeepSeek API (AI Chat + OCR)	حسب عدد المستخدمين والاستخدام الفعلي — أرخص 20x من OpenAI	5,000 — 12,000 جنيه/شهر
Tesseract OCR	مجاني (Open Source)	0 جنيه/شهر
SMS OTP (Twilio / Infobip)	حسب عدد تسجيلات الدخول	2,000 — 4,000 جنيه/شهر
PostgreSQL pgvector	مُدمج في RDS — لا تكلفة إضافية	0 جنيه/شهر
Firebase (Push Notifications)	مجاني للـ MVP Scale	0 جنيه/شهر
Sentry (Error Monitoring)	Team plan	1,300 جنيه/شهر

الإجمالي التشغيلي الشهري: ~23,300 — 42,300 جنيه مصري

نموذج الدفع المقترح

30%

450,000 ج.م

عند التعاقد
بدء العمل فوراً

25%

375,000 ج.م

نهاية الشهر 1
Foundation Complete

25%

375,000 ج.م

نهاية الشهر 2
Core Features

20%

300,000 ج.م

الإطلاق النهائي
Go-Live (الشهر 4)

خطة بديلة لتقليل تكلفة الـ AI Tokens (Token Burn Strategy)

المشروع هيستخدم AI كتير، وده معناه "حرق توكنز". خلينا نعمل خطة ذكية توفر 85-90% من تكلفة الـ AI:

1. Smart AI Router

80% أسئلة بسيطة → DeepSeek V3.2 (رخيص جداً)
15% أسئلة معقدة → DeepSeek R1 (أغلى شوية)
5% Critical Tasks → GPT-4o-mini (احتياطي فقط)

2. Response Caching (Redis)

60-70% توفير — الأسئلة المتكررة تُخزن لمدة ساعة
"ما أكثر المنتجات ربحاً؟" — نفس الإجابة لكل المستخدمين
Cache invalidation ذكي عند تغيير البيانات

3. Prompt Compression

30-40% توفير — ضغط الـ Context قبل الإرسال
إرسال بيانات ضرورية فقط في الـ Prompt
فلترة الـ Context لإرسال بيانات ضرورية فقط

4. Local Embeddings

100% توفير — sentence-transformers محلياً
بدل OpenAI Embeddings ($0.10/1K tokens)
384-dim embeddings كافية للـ RAG
تخزين في PostgreSQL pgvector

5. Batch Processing للـ Insights

50% توفير — تحليلات AI تُحسب مرة يومياً مش فورية
Slow-moving detection: يُحسب ليلاً عبر Celery
Demand forecast: يُحدث أسبوعياً
النتائج تُخزن في ai_insights table

6. Rate Limiting حسب الباقة

Basic: 50 رسالة AI/شهر
Pro: غير محدود (مع fair use)
Business: Priority + غير محدود
تحكم في التكلفة + تحفيز الترقية

مقارنة التكلفة: OpenAI vs DeepSeek

الاستخدام	OpenAI GPT-4o	DeepSeek V3.2	التوفير
AI Chat (10,000 رسالة/شهر)	~25,000 — 60,000 ج.م	~2,500 — 7,000 ج.م	~85-90%
OCR Post-processing	~5,000 — 10,000 ج.م	~500 — 1,500 ج.م	~90%
AI Insights (Batch)	~7,500 — 15,000 ج.م	~750 — 2,000 ج.م	~90%
Embeddings	~2,000 — 5,000 ج.م	0 ج.م (محلي)	100%
الإجمالي الشهري	~40,000 — 90,000 ج.م	~3,750 — 10,500 ج.م	~85-90%

تحليل المخاطر والتخفيف

الخطر	الاحتمالية	التأثير	خطة التخفيف
تأخر التوصيلات مع بوابات الدفع	متوسطة	عالي	البدء بـ Paymob فقط — إضافة باقي البوابات تدريجياً
دقة OCR منخفضة للفواتير اليدوية	عالية	متوسط	Confirmation Screen إلزامي + تحسين مستمر
تكلفة AI API مرتفعة	متوسطة	متوسط	DeepSeek V3.2 + Response Caching + Local Embeddings
انتهاء الـ Timeline	متوسطة	عالي	MVP Scope محدد بدقة + Weekly sprints + Buffer 2 أسبوع
تغيير متطلبات العميل	عالية	عالي	Change Request Process واضح مع تقييم أثر على الوقت والتكلفة
أداء الـ AI عند الـ Scale	منخفضة	عالي	Async processing + Queue + Caching من البداية

ضمانات المشروع

Clean Code

الكود مكتوب بمعايير Clean Code ومقروء بالكامل — يتبع SOLID principles

Test Coverage

Test Coverage لا تقل عن 70% على الـ Backend الحيوي — pytest + integration tests

Documentation

كل API موثقة بـ Swagger قبل التسليم + Technical Documentation كامل

Production Ready

الكود يعمل على AWS Production Environment وليس localhost فقط

Performance

Load Testing حتى 1000 concurrent users قبل الإطلاق

Full Ownership

الكود والملكية الفكرية 100% للعميل — GitHub Private Repository

ما يشمله التسليم النهائي

Source Code

Source Code كامل على GitHub Private Repository
ملكية فكرية 100% للعميل
Clean Code + Comments + Documentation

Technical Documentation

توثيق APIs كامل (Swagger + Postman Collection)
Architecture Diagrams
Database Schema Documentation
Deployment Guide

User Documentation

User Manual للتجار
Onboarding Guide
FAQ للأسئلة الشائعة

Infrastructure

AWS Account Transfer: كل الموارد تحت حساب العميل
Environment Variables و Secrets documentation
CI/CD Pipeline موثق ومُسلَّم