@prodoctors/contracts 1.6.0 → 1.8.0

package/gen/analytics.ts

@@ -79,6 +79,136 @@ export interface TopProductsResponse {
   items: TopProduct[];
 }
 
+export interface AnalyticsRangeRequest {
+  /** today | 7days | 30days | 12months */
+  range?: string | undefined;
+}
+
+export interface AnalyticsSummary {
+  revenue: number;
+  orders: number;
+  avgCheck: number;
+  /** sotuvi bo'lgan filiallar soni */
+  pharmacies: number;
+  revenueGrowth: number;
+  ordersGrowth: number;
+}
+
+export interface AnalyticsSeriesPoint {
+  /** YYYY-MM-DD yoki YYYY-MM */
+  period: string;
+  revenue: number;
+  orders: number;
+}
+
+export interface CityBreakdownItem {
+  id: string;
+  city: string;
+  orders: number;
+  revenue: number;
+}
+
+export interface ProductBreakdownItem {
+  id: string;
+  name: string;
+  category: string;
+  /** sotilgan birlik soni */
+  orders: number;
+  revenue: number;
+  stock: number;
+}
+
+export interface PharmacyBreakdownItem {
+  id: string;
+  name: string;
+  city: string;
+  orders: number;
+  revenue: number;
+  /** % oldingi davrga nisbatan */
+  growth: number;
+}
+
+export interface AnalyticsOverviewResponse {
+  summary: AnalyticsSummary | undefined;
+  series: AnalyticsSeriesPoint[];
+  cities: CityBreakdownItem[];
+  topProducts: ProductBreakdownItem[];
+  topPharmacies: PharmacyBreakdownItem[];
+}
+
+export interface SalesAnalyticsResponse {
+  summary: AnalyticsSummary | undefined;
+  series: AnalyticsSeriesPoint[];
+}
+
+export interface ProductsAnalyticsSummary {
+  productsSold: number;
+  revenue: number;
+  lowStock: number;
+  categories: number;
+}
+
+export interface ProductsAnalyticsResponse {
+  summary: ProductsAnalyticsSummary | undefined;
+  products: ProductBreakdownItem[];
+}
+
+export interface PharmaciesAnalyticsResponse {
+  summary: AnalyticsSummary | undefined;
+  cities: CityBreakdownItem[];
+  pharmacies: PharmacyBreakdownItem[];
+}
+
+export interface SalesReportResponse {
+  summary: AnalyticsSummary | undefined;
+  series: AnalyticsSeriesPoint[];
+  topPharmacies: PharmacyBreakdownItem[];
+}
+
+export interface OrderStatusCount {
+  /** SaleStatus */
+  status: string;
+  count: number;
+}
+
+export interface OrdersReportResponse {
+  total: number;
+  /** DRAFT */
+  processing: number;
+  /** COMPLETED */
+  completed: number;
+  /** CANCELLED + REFUNDED */
+  cancelled: number;
+  statuses: OrderStatusCount[];
+  recent: RecentOrder[];
+}
+
+export interface InventoryCategoryCount {
+  id: string;
+  name: string;
+  count: number;
+}
+
+export interface InventoryRiskItem {
+  id: string;
+  nameRu: string;
+  nameUz: string;
+  /** LOW_STOCK | EXPIRING */
+  risk: string;
+}
+
+export interface InventoryReportResponse {
+  totalItems: number;
+  lowStock: number;
+  expiring: number;
+  branches: number;
+  categories: InventoryCategoryCount[];
+  risks: InventoryRiskItem[];
+}
+
+export interface EmptyRequest {
+}
+
 export const ANALYTICS_V1_PACKAGE_NAME = "analytics.v1";
 
 export interface AnalyticsServiceClient {
@@ -89,6 +219,20 @@ export interface AnalyticsServiceClient {
   getRecentOrders(request: RecentOrdersRequest): Observable<RecentOrdersResponse>;
 
   getTopProducts(request: TopProductsRequest): Observable<TopProductsResponse>;
+
+  getAnalyticsOverview(request: AnalyticsRangeRequest): Observable<AnalyticsOverviewResponse>;
+
+  getSalesAnalytics(request: AnalyticsRangeRequest): Observable<SalesAnalyticsResponse>;
+
+  getProductsAnalytics(request: AnalyticsRangeRequest): Observable<ProductsAnalyticsResponse>;
+
+  getPharmaciesAnalytics(request: AnalyticsRangeRequest): Observable<PharmaciesAnalyticsResponse>;
+
+  getSalesReport(request: AnalyticsRangeRequest): Observable<SalesReportResponse>;
+
+  getOrdersReport(request: AnalyticsRangeRequest): Observable<OrdersReportResponse>;
+
+  getInventoryReport(request: EmptyRequest): Observable<InventoryReportResponse>;
 }
 
 export interface AnalyticsServiceController {
@@ -107,11 +251,51 @@ export interface AnalyticsServiceController {
   getTopProducts(
     request: TopProductsRequest,
   ): Promise<TopProductsResponse> | Observable<TopProductsResponse> | TopProductsResponse;
+
+  getAnalyticsOverview(
+    request: AnalyticsRangeRequest,
+  ): Promise<AnalyticsOverviewResponse> | Observable<AnalyticsOverviewResponse> | AnalyticsOverviewResponse;
+
+  getSalesAnalytics(
+    request: AnalyticsRangeRequest,
+  ): Promise<SalesAnalyticsResponse> | Observable<SalesAnalyticsResponse> | SalesAnalyticsResponse;
+
+  getProductsAnalytics(
+    request: AnalyticsRangeRequest,
+  ): Promise<ProductsAnalyticsResponse> | Observable<ProductsAnalyticsResponse> | ProductsAnalyticsResponse;
+
+  getPharmaciesAnalytics(
+    request: AnalyticsRangeRequest,
+  ): Promise<PharmaciesAnalyticsResponse> | Observable<PharmaciesAnalyticsResponse> | PharmaciesAnalyticsResponse;
+
+  getSalesReport(
+    request: AnalyticsRangeRequest,
+  ): Promise<SalesReportResponse> | Observable<SalesReportResponse> | SalesReportResponse;
+
+  getOrdersReport(
+    request: AnalyticsRangeRequest,
+  ): Promise<OrdersReportResponse> | Observable<OrdersReportResponse> | OrdersReportResponse;
+
+  getInventoryReport(
+    request: EmptyRequest,
+  ): Promise<InventoryReportResponse> | Observable<InventoryReportResponse> | InventoryReportResponse;
 }
 
 export function AnalyticsServiceControllerMethods() {
   return function (constructor: Function) {
-    const grpcMethods: string[] = ["getDashboardStats", "getSalesTrend", "getRecentOrders", "getTopProducts"];
+    const grpcMethods: string[] = [
+      "getDashboardStats",
+      "getSalesTrend",
+      "getRecentOrders",
+      "getTopProducts",
+      "getAnalyticsOverview",
+      "getSalesAnalytics",
+      "getProductsAnalytics",
+      "getPharmaciesAnalytics",
+      "getSalesReport",
+      "getOrdersReport",
+      "getInventoryReport",
+    ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
       GrpcMethod("AnalyticsService", method)(constructor.prototype[method], method, descriptor);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prodoctors/contracts",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Protobuf definitions and generated Typescript types for ProDoctors",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/proto/analytics.proto

@@ -69,9 +69,139 @@ message TopProductsResponse {
   repeated TopProduct items = 1;
 }
 
+// ---------------- Analytics sahifalari ----------------
+
+message AnalyticsRangeRequest {
+  optional string range = 1; // today | 7days | 30days | 12months
+}
+
+message AnalyticsSummary {
+  double revenue = 1;
+  int32 orders = 2;
+  double avg_check = 3;
+  int32 pharmacies = 4; // sotuvi bo'lgan filiallar soni
+  double revenue_growth = 5;
+  double orders_growth = 6;
+}
+
+message AnalyticsSeriesPoint {
+  string period = 1; // YYYY-MM-DD yoki YYYY-MM
+  double revenue = 2;
+  int32 orders = 3;
+}
+
+message CityBreakdownItem {
+  string id = 1;
+  string city = 2;
+  int32 orders = 3;
+  double revenue = 4;
+}
+
+message ProductBreakdownItem {
+  string id = 1;
+  string name = 2;
+  string category = 3;
+  int32 orders = 4; // sotilgan birlik soni
+  double revenue = 5;
+  int32 stock = 6;
+}
+
+message PharmacyBreakdownItem {
+  string id = 1;
+  string name = 2;
+  string city = 3;
+  int32 orders = 4;
+  double revenue = 5;
+  double growth = 6; // % oldingi davrga nisbatan
+}
+
+message AnalyticsOverviewResponse {
+  AnalyticsSummary summary = 1;
+  repeated AnalyticsSeriesPoint series = 2;
+  repeated CityBreakdownItem cities = 3;
+  repeated ProductBreakdownItem top_products = 4;
+  repeated PharmacyBreakdownItem top_pharmacies = 5;
+}
+
+message SalesAnalyticsResponse {
+  AnalyticsSummary summary = 1;
+  repeated AnalyticsSeriesPoint series = 2;
+}
+
+message ProductsAnalyticsSummary {
+  int32 products_sold = 1;
+  double revenue = 2;
+  int32 low_stock = 3;
+  int32 categories = 4;
+}
+
+message ProductsAnalyticsResponse {
+  ProductsAnalyticsSummary summary = 1;
+  repeated ProductBreakdownItem products = 2;
+}
+
+message PharmaciesAnalyticsResponse {
+  AnalyticsSummary summary = 1;
+  repeated CityBreakdownItem cities = 2;
+  repeated PharmacyBreakdownItem pharmacies = 3;
+}
+
+// ---------------- Reports (hisobotlar) ----------------
+
+message SalesReportResponse {
+  AnalyticsSummary summary = 1;
+  repeated AnalyticsSeriesPoint series = 2;
+  repeated PharmacyBreakdownItem top_pharmacies = 3;
+}
+
+message OrderStatusCount {
+  string status = 1; // SaleStatus
+  int32 count = 2;
+}
+
+message OrdersReportResponse {
+  int32 total = 1;
+  int32 processing = 2; // DRAFT
+  int32 completed = 3; // COMPLETED
+  int32 cancelled = 4; // CANCELLED + REFUNDED
+  repeated OrderStatusCount statuses = 5;
+  repeated RecentOrder recent = 6;
+}
+
+message InventoryCategoryCount {
+  string id = 1;
+  string name = 2;
+  int32 count = 3;
+}
+
+message InventoryRiskItem {
+  string id = 1;
+  string name_ru = 2;
+  string name_uz = 3;
+  string risk = 4; // LOW_STOCK | EXPIRING
+}
+
+message InventoryReportResponse {
+  int32 total_items = 1;
+  int32 low_stock = 2;
+  int32 expiring = 3;
+  int32 branches = 4;
+  repeated InventoryCategoryCount categories = 5;
+  repeated InventoryRiskItem risks = 6;
+}
+
+message EmptyRequest {}
+
 service AnalyticsService {
   rpc GetDashboardStats(DashboardStatsRequest) returns (DashboardStatsResponse);
   rpc GetSalesTrend(SalesTrendRequest) returns (SalesTrendResponse);
   rpc GetRecentOrders(RecentOrdersRequest) returns (RecentOrdersResponse);
   rpc GetTopProducts(TopProductsRequest) returns (TopProductsResponse);
+  rpc GetAnalyticsOverview(AnalyticsRangeRequest) returns (AnalyticsOverviewResponse);
+  rpc GetSalesAnalytics(AnalyticsRangeRequest) returns (SalesAnalyticsResponse);
+  rpc GetProductsAnalytics(AnalyticsRangeRequest) returns (ProductsAnalyticsResponse);
+  rpc GetPharmaciesAnalytics(AnalyticsRangeRequest) returns (PharmaciesAnalyticsResponse);
+  rpc GetSalesReport(AnalyticsRangeRequest) returns (SalesReportResponse);
+  rpc GetOrdersReport(AnalyticsRangeRequest) returns (OrdersReportResponse);
+  rpc GetInventoryReport(EmptyRequest) returns (InventoryReportResponse);
 }