/sys/dashboard/stats


{
  "stats": {
    "totalOrders": 247,
    "pendingOrders": 34,
    "completedOrders": 189,
    "cancelledOrders": 24,
    "totalRevenue": 6175,
    "averageRating": 4.7,
    "totalReviews": 89,
    "uniqueVisitors": 3456,
    "todayVisitors": 127
  },
  "monthlyData": [
    {
      "name": "Яну",
      "orders": 45,
      "revenue": 1125,
      "visitors": 890
    }
    // ... за всички месеци
  ],
  "orderStatusDistribution": [
    {
      "status": "completed",
      "count": 189,
      "percentage": 76.5
    },
    {
      "status": "pending",
      "count": 34,
      "percentage": 13.8
    },
    {
      "status": "cancelled",
      "count": 24,
      "percentage": 9.7
    }
  ],
  "recentActivity": [
    {
      "id": 1,
      "type": "order",
      "message": "Нова поръчка от Мария Петрова",
      "timestamp": "2025-09-07T10:30:00Z",
      "status": "pending",
      "orderId": "ORD-001"
    }
    // ... още активности
  ],
  "growthMetrics": {
    "ordersGrowth": 12, // %
    "revenueGrowth": 8,  // %
    "visitorsGrowth": 15 // %
  }
}




fetchOrders(filters) → GET /sys/orders

филтъри
{
  search: "мария",           // търсене в име, имейл, телефон, ID
  status: "pending",         // pending/completed/cancelled
  dateFrom: "2024-11-01",   // от дата
  dateTo: "2024-11-30",     // до дата
  page: 1,                  // pagination
  limit: 10                 // записи на страница
}

структура
{
  id: 'ORD-001',                    // уникален номер
  customerName: 'Мария Петрова',    // от OrderSection formData
  email: '[email protected]',       // от OrderSection formData
  phone: '+359 888 123 456',        // от OrderSection formData
  address: 'София, ул. Витоша 15', // от OrderSection formData
  city: 'София',                   // от OrderSection formData
  quantity: 2,                     // от OrderSection formData
  totalPrice: 50,                  // изчислено (quantity * 25)
  bookTitle: 'Пепел от детството', // константа
  paymentMethod: 'cash_on_delivery', // константа
  status: 'pending',               // pending/completed/cancelled
  createdAt: '2024-11-15T10:30:00Z',
  updatedAt: '2024-11-15T10:30:00Z',
  completedAt: null                 // когато status = completed
}

Backend API отговор трябва да е:
javascript{
  "orders": [...],           // масив с поръчки
  "totalCount": 156,         // общ брой за pagination
  "currentPage": 1,
  "totalPages": 16,
  "hasNext": true,
  "hasPrev": false
}


fetchRatingsData() → GET /sys/reviews

{
  "stats": {
    "totalReviews": 125,
    "averageRating": 4.6,
    "pendingReviews": 15,
    "approvedReviews": 89,
    "rejectedReviews": 12,
    "hiddenReviews": 9
  },
  "reviews": [
    {
      "id": "REV-001",
      "name": "Мария Петрова",
      "rating": 5,
      "comment": "Изключителна книга! Много емоционална...",
      "status": "pending",  // pending/approved/rejected/hidden
      "createdAt": "2024-11-15T14:30:00Z",
      "isAnonymous": false,
      "helpful": 0,
      "approvedAt": null,
      "rejectedAt": null,
      "hiddenAt": null
    }
    // ... още отзиви
  ],
  "ratingDistribution": [
    {
      "rating": 5,
      "count": 67,
      "percentage": 53.6
    },
    {
      "rating": 4,
      "count": 32,
      "percentage": 25.6
    }
    // ... за всички рейтинги 1-5
  ],
  "monthlyReviews": [
    {
      "month": "Яну",
      "reviews": 8,
      "avgRating": 4.2
    },
    {
      "month": "Фев",
      "reviews": 12,
      "avgRating": 4.4
    }
    // ... за всички месеци
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 15,
    "totalCount": 125,
    "hasNext": true,
    "hasPrev": false
  }
}


sendEmailToCustomer(emailData) → POST /sys/emails/send
{
  "to": "[email protected]",
  "subject": "Потвърждение на вашата поръчка",
  "message": "Здравейте,\n\nБлагодарим ви за поръчката...",
  "type": "order_update"  // добавя се от context
}

sendBulkEmail(bulkData) → POST /sys/emails/bulk-send
{
  "recipients": ["all_customers"],  // или масив с имейли
  "subject": "Промоционално съобщение",
  "message": "Здравейте,\n\nБихте ли се заинтересували...",
  "type": "campaign"
}
Варианти за recipients:
javascript// Всички клиенти
"recipients": ["all_customers"]

// Само клиенти с поръчки
"recipients": ["customers_with_orders"]

// Персонализиран списък
"recipients": ["[email protected]", "[email protected]", "[email protected]"]

generateReport(reportType, period) → GET /sys/reports/{reportType}?period={period}
Report типове:

overview - общ преглед
sales - продажби
traffic - трафик
reviews - отзиви

структура на отговора
{
  "reportType": "overview", // или "sales", "traffic", "reviews"
  "period": "30d",          // или "7d", "3m", "1y"
  "generatedAt": "2024-11-15T10:30:00Z",

  "data": {
    // === OVERVIEW СЕКЦИЯ ===
    "overview": {
      "totalOrders": 247,           // РЕАЛНО - от orders таблица
      "totalRevenue": 6175,         // РЕАЛНО - сума от completed orders
      "totalReviews": 89,           // РЕАЛНО - брой approved reviews
      "averageRating": 4.6,         // РЕАЛНО - средна оценка от reviews
      "totalVisitors": 15847,       // MOCK - нужен visitor tracking
      "conversionRate": 1.56        // MOCK - orders/visitors * 100
    },

    // === SALES ДАННИ ===
    "salesData": [
      {
        "month": "Яну",             // месец на кирилица
        "orders": 18,               // РЕАЛНО - брой orders за месеца
        "revenue": 450,             // РЕАЛНО - приходи за месеца
        "target": 500               // MOCK - предварително зададена цел
      },
      {
        "month": "Фев",
        "orders": 25,
        "revenue": 625,
        "target": 600
      }
      // ... за всички 12 месеца
    ],

    // === TRAFFIC ДАННИ ===
    "trafficData": [
      {
        "date": "01.11",            // дата DD.MM формат
        "visitors": 234,            // MOCK - уникални посетители
        "pageviews": 567,           // MOCK - прегледи на страници
        "sessions": 198             // MOCK - брой сесии
      },
      {
        "date": "02.11",
        "visitors": 267,
        "pageviews": 634,
        "sessions": 223
      }
      // ... за последните 7-30 дни според period
    ],

    // === REVIEWS РАЗПРЕДЕЛЕНИЕ ===
    "reviewsData": [
      {
        "rating": 5,                // рейтинг 1-5
        "count": 48,                // РЕАЛНО - брой отзиви с този рейтинг
        "percentage": 53.9          // РЕАЛНО - изчислен процент
      },
      {
        "rating": 4,
        "count": 26,
        "percentage": 29.2
      },
      {
        "rating": 3,
        "count": 11,
        "percentage": 12.4
      },
      {
        "rating": 2,
        "count": 3,
        "percentage": 3.4
      },
      {
        "rating": 1,
        "count": 1,
        "percentage": 1.1
      }
    ],

    // === ТОП СТРАНИЦИ ===
    "topPages": [
      {
        "page": "/",                // URL на страницата
        "views": 5432,              // MOCK - брой прегледи
        "percentage": 31.2          // MOCK - процент от общите прегледи
      },
      {
        "page": "/order",
        "views": 3456,
        "percentage": 19.8
      },
      {
        "page": "/reviews",
        "views": 2567,
        "percentage": 14.7
      },
      {
        "page": "/about",
        "views": 1789,
        "percentage": 10.3
      },
      {
        "page": "/contact",
        "views": 1234,
        "percentage": 7.1
      }
    ]
  }
}