@mamindom/contracts 1.0.125 → 1.0.126

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@mamindom/contracts",
 	"description": "proto",
-	"version": "1.0.125",
+	"version": "1.0.126",
 	"main": "./dist/src/index.js",
 	"types": "./dist/src/index.d.ts",
 	"exports": {

package/proto/audit.proto

@@ -0,0 +1,59 @@
+syntax = "proto3";
+
+package audit.v1;
+
+service AuditService {
+  rpc LogAction(LogActionRequest) returns (LogActionResponse);
+  rpc ListAudit(ListAuditRequest) returns (ListAuditResponse);
+}
+
+message LogActionRequest {
+  optional string actor_id     = 1;
+  optional string actor_name   = 2;
+  optional string actor_email  = 3;
+  string action                = 4;  // e.g. "order.cancelled", "product.price_changed"
+  string target_type           = 5;  // e.g. "order", "product", "role"
+  optional string target_id    = 6;
+  optional string summary      = 7;  // human-readable summary
+  optional string before_json  = 8;  // serialized JSON snapshot (small!)
+  optional string after_json   = 9;
+  optional string ip           = 10;
+  optional string user_agent   = 11;
+}
+
+message LogActionResponse {
+  bool ok = 1;
+}
+
+message ListAuditRequest {
+  optional int32 page          = 1;
+  optional int32 limit         = 2;
+  optional string actor_id     = 3;
+  optional string target_type  = 4;
+  optional string target_id    = 5;
+  optional string action       = 6;
+  optional string action_group = 7;  // "orders" matches order.* etc
+  optional string from         = 8;  // ISO date
+  optional string to           = 9;
+}
+
+message AuditEntry {
+  string id            = 1;
+  string actor_id      = 2;
+  string actor_name    = 3;
+  string actor_email   = 4;
+  string action        = 5;
+  string target_type   = 6;
+  string target_id     = 7;
+  string summary       = 8;
+  string before_json   = 9;
+  string after_json    = 10;
+  string ip            = 11;
+  string user_agent    = 12;
+  string created_at    = 13;
+}
+
+message ListAuditResponse {
+  repeated AuditEntry items = 1;
+  int32 total = 2;
+}

package/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/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/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 {

package/proto/rbac.proto

@@ -0,0 +1,109 @@
+syntax = "proto3";
+
+package rbac.v1;
+
+service RbacService {
+  // Permissions catalog (read-only, seeded).
+  rpc ListPermissions(ListPermissionsRequest) returns (ListPermissionsResponse);
+
+  // Roles CRUD.
+  rpc ListRoles(ListRolesRequest) returns (ListRolesResponse);
+  rpc GetRole(GetRoleRequest) returns (RbacRole);
+  rpc CreateRole(CreateRoleRequest) returns (RbacRole);
+  rpc UpdateRole(UpdateRoleRequest) returns (RbacRole);
+  rpc DeleteRole(DeleteRoleRequest) returns (DeleteRoleResponse);
+
+  // Account ↔ role bindings.
+  rpc AssignAccountRole(AssignAccountRoleRequest) returns (AssignAccountRoleResponse);
+  rpc GetAccountPermissions(GetAccountPermissionsRequest) returns (GetAccountPermissionsResponse);
+}
+
+message RbacPermission {
+  string id          = 1;
+  string key         = 2;
+  string group_key   = 3;
+  string label       = 4;
+  string description = 5;
+}
+
+message RbacRole {
+  string id            = 1;
+  string slug          = 2;
+  string name          = 3;
+  string description   = 4;
+  string color         = 5;
+  bool   is_system     = 6;
+  bool   is_protected  = 7;
+  int32  users_count   = 8;
+  repeated string permission_keys = 9;
+  string created_at    = 10;
+  string updated_at    = 11;
+}
+
+message ListPermissionsRequest {}
+
+message ListPermissionsResponse {
+  repeated RbacPermission items = 1;
+}
+
+message ListRolesRequest {
+  optional string search = 1;
+}
+
+message ListRolesResponse {
+  repeated RbacRole items = 1;
+}
+
+message GetRoleRequest {
+  string id = 1;
+}
+
+message CreateRoleRequest {
+  string slug                  = 1;
+  string name                  = 2;
+  string description           = 3;
+  string color                 = 4;
+  repeated string permission_keys = 5;
+}
+
+message UpdateRoleRequest {
+  string id                    = 1;
+  optional string name         = 2;
+  optional string description  = 3;
+  optional string color        = 4;
+  // Якщо передано — повна заміна; якщо не передано — без змін.
+  repeated string permission_keys = 5;
+  bool replace_permissions     = 6;
+}
+
+message DeleteRoleRequest {
+  string id = 1;
+}
+
+message DeleteRoleResponse {
+  bool ok = 1;
+}
+
+message AssignAccountRoleRequest {
+  string account_id        = 1;
+  // Якщо custom_role_id порожній — користувач відвʼязується від кастомної ролі,
+  // і дозволи беруться з системної.
+  optional string custom_role_id = 2;
+}
+
+message AssignAccountRoleResponse {
+  bool ok = 1;
+}
+
+message GetAccountPermissionsRequest {
+  string account_id = 1;
+}
+
+message GetAccountPermissionsResponse {
+  // Effective permissions з урахуванням system role + custom role override.
+  // Може містити "*" — повний доступ (ADMIN).
+  repeated string permission_keys = 1;
+  // Слаг ефективної ролі (для UI/labels).
+  string role_slug = 2;
+  string role_name = 3;
+}