@prodoctors/contracts 1.5.0 → 1.7.0

package/dist/proto/paths.d.ts

@@ -9,4 +9,5 @@ export declare const PROTO_PATHS: {
     readonly SALES: string;
     readonly SHIFT: string;
     readonly RESERVATION: string;
+    readonly ANALYTICS: string;
 };

package/dist/proto/paths.js

@@ -13,4 +13,5 @@ exports.PROTO_PATHS = {
     SALES: (0, path_1.join)(__dirname, "../../proto/sales.proto"),
     SHIFT: (0, path_1.join)(__dirname, "../../proto/shift.proto"),
     RESERVATION: (0, path_1.join)(__dirname, "../../proto/reservation.proto"),
+    ANALYTICS: (0, path_1.join)(__dirname, "../../proto/analytics.proto"),
 };

package/gen/analytics.ts

@@ -0,0 +1,240 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.5
+//   protoc               v7.34.0
+// source: analytics.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "analytics.v1";
+
+export interface DashboardStatsRequest {
+  /** today | 7days | 30days | 12months (default: today) */
+  range?: string | undefined;
+}
+
+export interface DashboardStatsResponse {
+  revenue: number;
+  /** % oldingi teng davrga nisbatan */
+  revenueGrowth: number;
+  orders: number;
+  ordersGrowth: number;
+  users: number;
+  usersGrowth: number;
+  products: number;
+  productsGrowth: number;
+}
+
+export interface SalesTrendRequest {
+  /** default 12 */
+  months?: number | undefined;
+}
+
+export interface SalesTrendPoint {
+  /** "YYYY-MM" */
+  period: string;
+  revenue: number;
+}
+
+export interface SalesTrendResponse {
+  points: SalesTrendPoint[];
+}
+
+export interface RecentOrdersRequest {
+  /** default 10 */
+  limit?: number | undefined;
+}
+
+export interface RecentOrder {
+  id: string;
+  orderNumber: string;
+  pharmacy: string;
+  city: string;
+  amount: number;
+  /** SaleStatus (admin UI holatga o'giradi) */
+  status: string;
+}
+
+export interface RecentOrdersResponse {
+  items: RecentOrder[];
+}
+
+export interface TopProductsRequest {
+  /** default 5 */
+  limit?: number | undefined;
+}
+
+export interface TopProduct {
+  id: string;
+  name: string;
+  category: string;
+  stock: number;
+  price: number;
+  soldQuantity: number;
+}
+
+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 const ANALYTICS_V1_PACKAGE_NAME = "analytics.v1";
+
+export interface AnalyticsServiceClient {
+  getDashboardStats(request: DashboardStatsRequest): Observable<DashboardStatsResponse>;
+
+  getSalesTrend(request: SalesTrendRequest): Observable<SalesTrendResponse>;
+
+  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>;
+}
+
+export interface AnalyticsServiceController {
+  getDashboardStats(
+    request: DashboardStatsRequest,
+  ): Promise<DashboardStatsResponse> | Observable<DashboardStatsResponse> | DashboardStatsResponse;
+
+  getSalesTrend(
+    request: SalesTrendRequest,
+  ): Promise<SalesTrendResponse> | Observable<SalesTrendResponse> | SalesTrendResponse;
+
+  getRecentOrders(
+    request: RecentOrdersRequest,
+  ): Promise<RecentOrdersResponse> | Observable<RecentOrdersResponse> | RecentOrdersResponse;
+
+  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;
+}
+
+export function AnalyticsServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "getDashboardStats",
+      "getSalesTrend",
+      "getRecentOrders",
+      "getTopProducts",
+      "getAnalyticsOverview",
+      "getSalesAnalytics",
+      "getProductsAnalytics",
+      "getPharmaciesAnalytics",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("AnalyticsService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("AnalyticsService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const ANALYTICS_SERVICE_NAME = "AnalyticsService";

package/package.json

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

package/proto/analytics.proto

@@ -0,0 +1,158 @@
+syntax = "proto3";
+
+package analytics.v1;
+
+// Admin analitikasi: xom aggregatlar (POS SaleOrder asosida). Display
+// formatlash (i18n kalitlar, valyuta) frontend zimmasida.
+
+// ---------------- Dashboard (admin bosh sahifa) ----------------
+
+message DashboardStatsRequest {
+  optional string range = 1; // today | 7days | 30days | 12months (default: today)
+}
+
+message DashboardStatsResponse {
+  double revenue = 1;
+  double revenue_growth = 2; // % oldingi teng davrga nisbatan
+  int32 orders = 3;
+  double orders_growth = 4;
+  int32 users = 5;
+  double users_growth = 6;
+  int32 products = 7;
+  double products_growth = 8;
+}
+
+message SalesTrendRequest {
+  optional int32 months = 1; // default 12
+}
+
+message SalesTrendPoint {
+  string period = 1; // "YYYY-MM"
+  double revenue = 2;
+}
+
+message SalesTrendResponse {
+  repeated SalesTrendPoint points = 1;
+}
+
+message RecentOrdersRequest {
+  optional int32 limit = 1; // default 10
+}
+
+message RecentOrder {
+  string id = 1;
+  string order_number = 2;
+  string pharmacy = 3;
+  string city = 4;
+  double amount = 5;
+  string status = 6; // SaleStatus (admin UI holatga o'giradi)
+}
+
+message RecentOrdersResponse {
+  repeated RecentOrder items = 1;
+}
+
+message TopProductsRequest {
+  optional int32 limit = 1; // default 5
+}
+
+message TopProduct {
+  string id = 1;
+  string name = 2;
+  string category = 3;
+  int32 stock = 4;
+  double price = 5;
+  double sold_quantity = 6;
+}
+
+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;
+}
+
+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);
+}