@mamindom/contracts 1.0.124 → 1.0.126

package/dist/proto/bonus_settings.proto

@@ -0,0 +1,35 @@
+syntax = "proto3";
+
+package promo.v1;
+
+
+service BonusSettingsService {
+  rpc GetBonusSettings    (GetBonusSettingsRequest)    returns (BonusSettingsResponse);
+  rpc UpdateBonusSettings (UpdateBonusSettingsRequest) returns (BonusSettingsResponse);
+}
+
+
+message BonusSettingsResponse {
+  // Курс нарахування бонусів від суми замовлення (0.02 = 2%).
+  double earn_rate         = 1;
+  // Курс списання бонусів (1 бонус = N грн, default 1.0).
+  double redeem_rate       = 2;
+  // Мінімальна сума замовлення для нарахування бонусів (0 = без обмеження).
+  double min_order_for_earn = 3;
+  // Максимальний відсоток від суми замовлення, який можна оплатити бонусами
+  // (1.0 = до 100%, 0.5 = до 50%; 0 — без обмеження).
+  double max_redeem_share  = 4;
+
+  string updated_at        = 5;
+}
+
+
+message GetBonusSettingsRequest {}
+
+
+message UpdateBonusSettingsRequest {
+  optional double earn_rate          = 1;
+  optional double redeem_rate        = 2;
+  optional double min_order_for_earn = 3;
+  optional double max_redeem_share   = 4;
+}

package/dist/proto/delivery_settings.proto

@@ -0,0 +1,35 @@
+syntax = "proto3";
+
+package delivery.v1;
+
+
+service DeliverySettingsService {
+  rpc GetDeliverySettings    (GetDeliverySettingsRequest)    returns (DeliverySettingsResponse);
+  rpc UpdateDeliverySettings (UpdateDeliverySettingsRequest) returns (DeliverySettingsResponse);
+}
+
+
+message DeliverySettingsResponse {
+  // Дефолтна вага позиції у кг — fallback коли catalog не повертає weight.
+  double default_item_weight_kg   = 1;
+  // Поріг безкоштовної доставки в грн (0 = вимкнено).
+  double free_shipping_threshold  = 2;
+  // Дефолтна оголошена вартість на одиницю товару у грн (для страхування НП).
+  double default_declared_value   = 3;
+  // Reference відправника у НП (вибране warehouse адміністратором у settings).
+  optional string np_sender_warehouse_ref = 4;
+
+  string updated_at = 5;
+}
+
+
+message GetDeliverySettingsRequest {}
+
+
+message UpdateDeliverySettingsRequest {
+  optional double default_item_weight_kg   = 1;
+  optional double free_shipping_threshold  = 2;
+  optional double default_declared_value   = 3;
+  optional string np_sender_warehouse_ref  = 4;
+  bool   clear_np_sender_warehouse_ref     = 5;
+}

package/dist/proto/manager.proto

@@ -0,0 +1,88 @@
+syntax = "proto3";
+
+package manager.v1;
+
+service ManagerService {
+  rpc ListManagers(ListManagersRequest) returns (ListManagersResponse);
+  rpc GetManager(GetManagerRequest) returns (ManagerProfileDto);
+  rpc CreateManager(CreateManagerRequest) returns (ManagerProfileDto);
+  rpc UpdateManager(UpdateManagerRequest) returns (ManagerProfileDto);
+  rpc SetManagerActive(SetManagerActiveRequest) returns (ManagerProfileDto);
+  rpc TerminateManager(TerminateManagerRequest) returns (ManagerProfileDto);
+  rpc ReorderManagers(ReorderManagersRequest) returns (BoolResult);
+  rpc AddVacation(AddVacationRequest) returns (AddVacationResponse);
+  rpc DeleteVacation(DeleteVacationRequest) returns (BoolResult);
+  rpc ReassignUnassigned(ReassignUnassignedRequest) returns (ReassignUnassignedResponse);
+}
+
+message Vacation {
+  string id        = 1;
+  string starts_at = 2;
+  string ends_at   = 3;
+  string reason    = 4;
+}
+
+message ManagerProfileDto {
+  string id                    = 1;
+  string account_id            = 2;
+  string display_name          = 3;
+  string email                 = 4;
+  bool   is_active             = 5;
+  int32  queue_order           = 6;
+  int32  assigned_count        = 7;
+  string terminated_at         = 8;
+  string reassignment_strategy = 9;
+  repeated Vacation vacations  = 10;
+  string created_at            = 11;
+  string updated_at            = 12;
+}
+
+message ListManagersRequest {}
+message ListManagersResponse {
+  repeated ManagerProfileDto items = 1;
+}
+
+message GetManagerRequest { string id = 1; }
+
+message CreateManagerRequest {
+  string account_id                     = 1;
+  optional string display_name          = 2;
+  optional string email                 = 3;
+  optional string reassignment_strategy = 4; // URGENT_ONLY | ALL
+}
+
+message UpdateManagerRequest {
+  string id                             = 1;
+  optional string display_name          = 2;
+  optional string email                 = 3;
+  optional string reassignment_strategy = 4;
+}
+
+message SetManagerActiveRequest {
+  string id        = 1;
+  bool   is_active = 2;
+}
+
+message TerminateManagerRequest { string id = 1; }
+
+message ReorderManagersRequest {
+  repeated string ordered_ids = 1;
+}
+
+message AddVacationRequest {
+  string manager_id = 1;
+  string starts_at  = 2; // ISO date
+  string ends_at    = 3;
+  optional string reason = 4;
+}
+message AddVacationResponse { string id = 1; }
+
+message DeleteVacationRequest { string id = 1; }
+
+message ReassignUnassignedRequest {}
+message ReassignUnassignedResponse {
+  bool ok = 1;
+  int32 reassigned_count = 2;
+}
+
+message BoolResult { bool ok = 1; }

package/dist/proto/notification.proto

@@ -0,0 +1,317 @@
+syntax = "proto3";
+
+package notification.v1;
+
+
+// Admin API для керування шаблонами нотифікацій, Telegram-чатами,
+// надсилання test-пакета, перегляду логів.
+
+service NotificationTemplateService {
+  rpc ListTemplates       (ListTemplatesRequest)       returns (ListTemplatesResponse);
+  rpc GetTemplate         (GetTemplateRequest)         returns (TemplateResponse);
+  rpc UpsertTemplate      (UpsertTemplateRequest)      returns (TemplateResponse);
+  rpc UpdateTemplate      (UpdateTemplateRequest)      returns (TemplateResponse);
+  rpc ToggleTemplate      (ToggleTemplateRequest)      returns (TemplateResponse);
+  rpc ListVersions        (ListVersionsRequest)        returns (ListVersionsResponse);
+  rpc RestoreVersion      (RestoreVersionRequest)      returns (TemplateResponse);
+  rpc RenderPreview       (RenderPreviewRequest)       returns (RenderPreviewResponse);
+  rpc SendTest            (SendTestRequest)            returns (SendTestResponse);
+}
+
+service NotificationLogsService {
+  rpc ListLogs (ListLogsRequest) returns (ListLogsResponse);
+}
+
+service TelegramChatsService {
+  rpc ListChats   (ListChatsRequest)   returns (ListChatsResponse);
+  rpc UpsertChat  (UpsertChatRequest)  returns (TelegramChatResponse);
+  rpc DeleteChat  (DeleteChatRequest)  returns (DeleteChatResponse);
+  rpc TestSendTelegram (TestSendTelegramRequest) returns (TestSendTelegramResponse);
+}
+
+
+enum NotificationChannel {
+  NOTIFICATION_CHANNEL_UNSPECIFIED = 0;
+  EMAIL    = 1;
+  SMS      = 2;
+  TELEGRAM = 3;
+}
+
+enum NotificationLocale {
+  NOTIFICATION_LOCALE_UNSPECIFIED = 0;
+  UK = 1;
+  RU = 2;
+}
+
+enum NotificationCategory {
+  NOTIFICATION_CATEGORY_UNSPECIFIED = 0;
+  TRANSACTIONAL = 1;
+  ACCOUNT       = 2;
+  MARKETING     = 3;
+  ADMIN         = 4;
+  OTP           = 5;
+}
+
+enum NotificationStatus {
+  NOTIFICATION_STATUS_UNSPECIFIED = 0;
+  PENDING    = 1;
+  SENT       = 2;
+  FAILED     = 3;
+  SIMULATED  = 4;
+  SUPPRESSED = 5;
+}
+
+enum TelegramTopic {
+  TELEGRAM_TOPIC_UNSPECIFIED = 0;
+  ORDERS         = 1;
+  ORDERS_ALERTS  = 2;
+  PAYMENTS       = 3;
+  WAREHOUSE      = 4;
+  REVIEWS        = 5;
+  CALLBACK       = 6;
+  REPORTS        = 7;
+  ALERTS         = 8;
+  GENERAL        = 9;
+}
+
+
+message NotificationTemplate {
+  string id = 1;
+  string key = 2;
+  NotificationChannel channel = 3;
+  NotificationLocale locale = 4;
+  NotificationCategory category = 5;
+  string title = 6;
+  string subject = 7;
+  // JSON-stringified Tiptap content (передаємо як string щоб не
+  // використовувати proto google.protobuf.Struct).
+  string content_json = 8;
+  string body_html = 9;
+  string body_text = 10;
+  // JSON array of variable names (для autocomplete).
+  string variables_json = 11;
+  bool is_active = 12;
+  int32 version = 13;
+  int64 created_at = 14;
+  int64 updated_at = 15;
+}
+
+message TemplateResponse {
+  bool ok = 1;
+  NotificationTemplate template = 2;
+  string error_message = 3;
+}
+
+
+// ─── List ────────────────────────────────────────────────────────────
+
+message ListTemplatesRequest {
+  optional NotificationChannel channel = 1;
+  optional NotificationLocale locale = 2;
+  optional NotificationCategory category = 3;
+  optional string search = 4;
+}
+
+message ListTemplatesResponse {
+  repeated NotificationTemplate items = 1;
+}
+
+
+// ─── Get ─────────────────────────────────────────────────────────────
+
+message GetTemplateRequest {
+  string id = 1;
+}
+
+
+// ─── Upsert (create new) ─────────────────────────────────────────────
+
+message UpsertTemplateRequest {
+  string key = 1;
+  NotificationChannel channel = 2;
+  NotificationLocale locale = 3;
+  NotificationCategory category = 4;
+  string title = 5;
+  string subject = 6;
+  string content_json = 7;
+  string body_html = 8;
+  string body_text = 9;
+  string variables_json = 10;
+  bool is_active = 11;
+}
+
+
+// ─── Update by id (з versioning) ─────────────────────────────────────
+
+message UpdateTemplateRequest {
+  string id = 1;
+  optional string title = 2;
+  optional string subject = 3;
+  optional string content_json = 4;
+  string body_html = 5;
+  string body_text = 6;
+  optional string variables_json = 7;
+  optional bool is_active = 8;
+  // Admin id для audit (хто змінив).
+  optional string actor_id = 9;
+}
+
+
+// ─── Toggle (вмикання/вимикання) ────────────────────────────────────
+
+message ToggleTemplateRequest {
+  string id = 1;
+  bool is_active = 2;
+}
+
+
+// ─── Versions ────────────────────────────────────────────────────────
+
+message NotificationTemplateVersion {
+  string id = 1;
+  int32 version = 2;
+  string title = 3;
+  string subject = 4;
+  string content_json = 5;
+  string body_html = 6;
+  string body_text = 7;
+  string variables_json = 8;
+  optional string created_by_id = 9;
+  int64 created_at = 10;
+}
+
+message ListVersionsRequest {
+  string template_id = 1;
+}
+
+message ListVersionsResponse {
+  repeated NotificationTemplateVersion items = 1;
+}
+
+message RestoreVersionRequest {
+  string template_id = 1;
+  int32 version = 2;
+  optional string actor_id = 3;
+}
+
+
+// ─── Preview ────────────────────────────────────────────────────────
+
+message RenderPreviewRequest {
+  string body_html = 1;
+  // JSON-stringified variables { "order.number": "MD-2026-0001", ... }
+  string variables_json = 2;
+  optional string subject = 3;
+}
+
+message RenderPreviewResponse {
+  string html = 1;
+  string subject = 2;
+}
+
+
+// ─── Test send ───────────────────────────────────────────────────────
+
+message SendTestRequest {
+  string template_id = 1;
+  // email або phone (залежно від channel).
+  string recipient = 2;
+  // JSON-stringified test variables.
+  string variables_json = 3;
+}
+
+message SendTestResponse {
+  bool ok = 1;
+  string error_message = 2;
+}
+
+
+// ─── Logs ────────────────────────────────────────────────────────────
+
+message NotificationLog {
+  string id = 1;
+  string template_key = 2;
+  NotificationChannel channel = 3;
+  NotificationLocale locale = 4;
+  string recipient = 5;
+  optional string order_id = 6;
+  optional string user_id = 7;
+  NotificationStatus status = 8;
+  optional string provider_message_id = 9;
+  optional string provider_name = 10;
+  optional string error = 11;
+  optional int64 sent_at = 12;
+  int64 created_at = 13;
+}
+
+message ListLogsRequest {
+  optional NotificationChannel channel = 1;
+  optional NotificationStatus status = 2;
+  optional string template_key = 3;
+  optional string order_id = 4;
+  optional string user_id = 5;
+  optional string recipient = 6;
+  optional int64 date_from = 7;
+  optional int64 date_to = 8;
+  int32 page = 9;
+  int32 limit = 10;
+}
+
+message ListLogsResponse {
+  repeated NotificationLog items = 1;
+  int32 total = 2;
+  int32 page = 3;
+  int32 limit = 4;
+}
+
+
+// ─── Telegram chats ──────────────────────────────────────────────────
+
+message TelegramChat {
+  string id = 1;
+  string chat_id = 2;
+  TelegramTopic topic = 3;
+  string label = 4;
+  optional string tag = 5;
+  bool is_active = 6;
+  int64 created_at = 7;
+  int64 updated_at = 8;
+}
+
+message TelegramChatResponse {
+  bool ok = 1;
+  TelegramChat chat = 2;
+  string error_message = 3;
+}
+
+message ListChatsRequest {}
+
+message ListChatsResponse {
+  repeated TelegramChat items = 1;
+}
+
+message UpsertChatRequest {
+  string chat_id = 1;
+  TelegramTopic topic = 2;
+  string label = 3;
+  optional string tag = 4;
+  bool is_active = 5;
+}
+
+message DeleteChatRequest {
+  string id = 1;
+}
+
+message DeleteChatResponse {
+  bool ok = 1;
+  string error_message = 2;
+}
+
+message TestSendTelegramRequest {
+  string chat_id = 1;
+}
+
+message TestSendTelegramResponse {
+  bool ok = 1;
+  string error_message = 2;
+}

package/dist/proto/product.proto

@@ -144,20 +144,20 @@ message ProductListItemResponse {
   string id = 1;
   string sku = 2;
   string slug = 3;
-  
+
   ProductStatus status = 4;
-  
+
   map<string, string> name = 5;
   string main_image = 6;
-  
+
   double price = 7;
   optional double old_price = 8;
-  
+
   int32 total_stock = 9;
-  
+
   optional string brand_id = 10;
   repeated string category_ids = 11;
-  
+
   int32 sort_order = 12;
   int32 category_sort_order = 13;
   optional string barcode = 14;
@@ -170,6 +170,8 @@ message ProductListItemResponse {
   int32 review_count = 21;
   repeated ProductStickerResponse stickers = 22;
   optional ProductPromoInfo active_promo = 23;
+  // Вага у кг для розрахунку доставки (0 → fallback на defaultItemWeightKg).
+  double weight_kg = 24;
 }
 
 
@@ -219,6 +221,8 @@ message ProductDetailResponse {
   optional float manual_rating = 37;
   optional ProductPromoInfo active_promo = 38;
   repeated ProductColorResponse colors = 39;
+  // Вага товару у кг для розрахунку доставки (variant може override'ити).
+  double weight_kg = 40;
 }
 
 
@@ -362,6 +366,7 @@ message CreateProductRequest {
      optional string group_id = 24;
   map<string, string> color_label = 25;
    optional string color_hex = 26;
+  optional double weight_kg = 27;
 }
 
 message UpdateProductRequest {
@@ -396,6 +401,7 @@ message UpdateProductRequest {
    map<string, string> color_label = 23;
    optional string color_hex = 24;
   optional float manual_rating = 25;
+  optional double weight_kg = 26;
 }
 
 message SetManualRatingRequest {
@@ -597,12 +603,12 @@ message ProductVariantDetailResponse {
   optional string barcode = 4;
   int32 sort_order = 5;
 
-  
+
   double price = 6;
   optional double old_price = 7;
   int32 stock = 8;
 
-  
+
   map<string, string> options = 9;
 
 
@@ -623,6 +629,9 @@ message ProductVariantDetailResponse {
   VariantOverrides overrides = 20;
 
   optional string color_id = 21;
+
+  // Override-вага варіанту у кг; 0 означає "успадкувати від продукту".
+  double weight_kg = 22;
 }
 
 message VariantOverrides {
@@ -637,6 +646,7 @@ message VariantOverrides {
   bool has_own_attributes = 9;
   bool has_own_video = 10;
   bool has_own_old_price = 11;
+  bool has_own_weight = 12;
 }
 
 
@@ -650,7 +660,7 @@ message CreateProductVariantRequest {
   optional double old_price = 6;
   int32 stock = 7;
 
-  map<string, string> options = 8;   
+  map<string, string> options = 8;
   map<string, string> name = 9;
   map<string, string> short_description = 10;
   map<string, string> description = 11;
@@ -663,6 +673,8 @@ message CreateProductVariantRequest {
   repeated ProductImagePayload images = 17;
   repeated string attribute_value_ids = 18;
   optional string color_id = 19;
+  // Override-вага варіанту у кг (null/unset → успадкувати від продукту).
+  optional double weight_kg = 20;
 }
 
 
@@ -690,6 +702,8 @@ message UpdateProductVariantRequest {
   repeated ProductImagePayload images = 17;
   repeated string attribute_value_ids = 18;
   optional string color_id = 19;
+  // Override-вага варіанту у кг (null/unset → успадкувати від продукту).
+  optional double weight_kg = 20;
 
 
   bool clear_price = 30;
@@ -704,6 +718,7 @@ message UpdateProductVariantRequest {
   bool clear_attributes = 39;
   bool clear_video = 40;
   bool clear_color = 41;
+  bool clear_weight = 42;
 }
 
 message GetProductVariantRequest {
@@ -773,6 +788,8 @@ message VariantLookupResult {
   string name_uk      = 9;
   string main_image   = 10;
   optional string color_id = 11;
+  // Вага у кг (variant.weight_kg ?? product.weight_kg ?? 0).
+  double weight_kg    = 12;
 }
 
 message BulkLookupVariantsRequest {