بصفتي CUSTOMER، أريد:
  - تصفح والبحث عن المنتجات
  - إضافة منتجات إلى سلة التسوق (مستقبلاً)
  - تقديم طلب بعناصر متعددة
  - عرض سجل طلباتي
  - إلغاء طلب غير مدفوع خلال 30 دقيقة
  - الدفع مقابل طلب
  - عرض حالة الدفع

بصفتي ADMIN، أريد:
  - إدارة المنتجات (CRUD)
  - عرض جميع الطلبات
  - إلغاء أي طلب
  - معالجة الاستردادات
  - عرض إحصائيات الأعمال

التنفيذ ناجح

CREATE TABLE users (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL UNIQUE,
    password_hash VARCHAR(255) NOT NULL,
    role VARCHAR(20) NOT NULL DEFAULT 'CUSTOMER',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

CREATE TABLE products (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(200) NOT NULL,
    sku VARCHAR(20) NOT NULL UNIQUE,
    price DECIMAL(10,2) NOT NULL,
    stock INT NOT NULL DEFAULT 0,
    category VARCHAR(50),
    status TINYINT NOT NULL DEFAULT 1,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    INDEX idx_product_name (name),
    INDEX idx_product_category (category)
);

CREATE TABLE orders (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    user_id BIGINT NOT NULL,
    order_number VARCHAR(20) NOT NULL UNIQUE,
    status VARCHAR(20) NOT NULL DEFAULT 'PENDING',
    total_amount DECIMAL(10,2) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    INDEX idx_order_user (user_id),
    INDEX idx_order_status_created (status, created_at DESC),
    FOREIGN KEY (user_id) REFERENCES users(id)
);

CREATE TABLE order_items (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    order_id BIGINT NOT NULL,
    product_id BIGINT NOT NULL,
    quantity INT NOT NULL,
    unit_price DECIMAL(10,2) NOT NULL,
    subtotal DECIMAL(10,2) NOT NULL,
    FOREIGN KEY (order_id) REFERENCES orders(id),
    FOREIGN KEY (product_id) REFERENCES products(id)
);

CREATE TABLE payments (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    order_id BIGINT NOT NULL UNIQUE,
    transaction_id VARCHAR(50) UNIQUE,
    method VARCHAR(20) NOT NULL,
    status VARCHAR(20) NOT NULL DEFAULT 'PENDING',
    amount DECIMAL(10,2) NOT NULL,
    paid_at TIMESTAMP NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (order_id) REFERENCES orders(id)
);

CREATE TABLE

// استجابة ناجحة
public record ApiResponse<T>(
    int code,
    String message,
    T data,
    Instant timestamp
) {
    public static <T> ApiResponse<T> success(T data) {
        return new ApiResponse<>(200, "OK", data, Instant.now());
    }
    public static <T> ApiResponse<T> created(T data) {
        return new ApiResponse<>(201, "Created", data, Instant.now());
    }
}

// استجابة مرقمة
public record PagedResponse<T>(
    List<T> content,
    int page,
    int size,
    long totalElements,
    int totalPages
) {}

// التنفيذ ناجح

# قائمة المنتجات مع الترقيم والفرز والتصفية
GET /api/v1/products?page=0&size=20&sort=price,desc&category=electronics&minPrice=100&maxPrice=999

# تم تنفيذ الأمر بنجاح

# مستند تصميم منظومة OrderFlow

## 1. المتطلبات التجارية
- نظام إدارة طلبات التجارة الإلكترونية
- 4 وحدات: المستخدمون، المنتجات، الطلبات، المدفوعات
- دوران: CUSTOMER، ADMIN
- المتوقع: 10,000 DAU، 1,000 طلب/يوم

## 2. حزمة التقنيات
- Java 17 + Spring Boot 3.2.x
- MySQL 8.0 + Spring Data JPA
- Redis 7 + Caffeine (تخزين مؤقت ثنائي المستوى)
- Spring Security + JWT (خادم موارد OAuth2)
- نشر Docker + Kubernetes

## 3. تصميم قاعدة البيانات
- 5 جداول: users، products، orders، order_items، payments
- فهارس على أعمدة الاستعلام عالية التردد

## 4. مواصفات واجهة برمجة التطبيقات
- واجهة برمجة تطبيقات RESTful مع إصدارات (/api/v1/)
- مصادقة JWT Bearer
- تنسيق استجابة موحد: ApiResponse<T>
- الترقيم: معاملات page، size، sort

## 5. المتطلبات غير الوظيفية
- زمن استجابة P99 < 100 مللي ثانية
- معدل الخطأ < 0.1%
- التوفر > 99.9%
- تغطية الاختبار الآلي > 80%