@mamindom/contracts 1.0.144 → 1.0.146

package/dist/proto/product.proto

@@ -15,6 +15,18 @@ service ProductService {
   rpc DeleteProduct (DeleteProductRequest) returns (DeleteResponse);
   rpc SetManualRating (SetManualRatingRequest) returns (SuccessResponse);
 
+  
+  rpc UpsertProducts (UpsertProductsRequest) returns (UpsertProductsResponse);
+
+
+  rpc UpsertPrices (UpsertPricesRequest) returns (UpsertPricesResponse);
+
+ 
+  rpc UpsertCharacteristics (UpsertCharacteristicsRequest) returns (UpsertCharacteristicsResponse);
+
+
+  rpc UpsertStocks (UpsertStocksRequest) returns (UpsertStocksResponse);
+
  
   rpc BulkUpdateStatus (BulkUpdateStatusRequest) returns (SuccessResponse);
   rpc BulkUpdateCategory (BulkUpdateCategoryRequest) returns (SuccessResponse);
@@ -54,27 +66,25 @@ service ProductService {
   rpc BulkLookupProducts (BulkLookupProductsRequest) returns (BulkLookupProductsResponse);
   rpc BulkLookupVariants (BulkLookupVariantsRequest) returns (BulkLookupVariantsResponse);
 
-     
-   rpc CreateProductGroup (CreateProductGroupRequest) returns (ProductGroupResponse);
-   rpc UpdateProductGroup (UpdateProductGroupRequest) returns (ProductGroupResponse);
-   rpc DeleteProductGroup (DeleteProductGroupRequest) returns (SuccessResponse);
-   rpc GetProductGroup (GetProductGroupRequest) returns (ProductGroupResponse);
-   rpc GetProductGroups (GetProductGroupsRequest) returns (GetProductGroupsResponse);
-   rpc AddProductToGroup (AddProductToGroupRequest) returns (SuccessResponse);
-   rpc RemoveProductFromGroup (RemoveProductFromGroupRequest) returns (SuccessResponse);
+  rpc CreateProductGroup (CreateProductGroupRequest) returns (ProductGroupResponse);
+  rpc UpdateProductGroup (UpdateProductGroupRequest) returns (ProductGroupResponse);
+  rpc DeleteProductGroup (DeleteProductGroupRequest) returns (SuccessResponse);
+  rpc GetProductGroup (GetProductGroupRequest) returns (ProductGroupResponse);
+  rpc GetProductGroups (GetProductGroupsRequest) returns (GetProductGroupsResponse);
+  rpc AddProductToGroup (AddProductToGroupRequest) returns (SuccessResponse);
+  rpc RemoveProductFromGroup (RemoveProductFromGroupRequest) returns (SuccessResponse);
 
 
-   rpc CreateProductVariant (CreateProductVariantRequest) returns (ProductVariantDetailResponse);
-   rpc UpdateProductVariant (UpdateProductVariantRequest) returns (ProductVariantDetailResponse);
-   rpc GetProductVariant (GetProductVariantRequest) returns (ProductVariantDetailResponse);
+  rpc CreateProductVariant (CreateProductVariantRequest) returns (ProductVariantDetailResponse);
+  rpc UpdateProductVariant (UpdateProductVariantRequest) returns (ProductVariantDetailResponse);
+  rpc GetProductVariant (GetProductVariantRequest) returns (ProductVariantDetailResponse);
 
 
 
-rpc AssignVariantSizeCharts (AssignVariantSizeChartsRequest) returns (SuccessResponse);
-rpc RemoveVariantSizeChart (RemoveVariantSizeChartRequest) returns (SuccessResponse);
-rpc GetVariantSizeCharts (GetVariantSizeChartsRequest) returns (GetProductSizeChartsResponse);
+  rpc AssignVariantSizeCharts (AssignVariantSizeChartsRequest) returns (SuccessResponse);
+  rpc RemoveVariantSizeChart (RemoveVariantSizeChartRequest) returns (SuccessResponse);
+  rpc GetVariantSizeCharts (GetVariantSizeChartsRequest) returns (GetProductSizeChartsResponse);
 
-  // ─── Product colors (нова ієрархія: Product → Color → Variant) ──────────────
   rpc CreateProductColor (CreateProductColorRequest) returns (ProductColorResponse);
   rpc UpdateProductColor (UpdateProductColorRequest) returns (ProductColorResponse);
   rpc DeleteProductColor (DeleteProductColorRequest) returns (DeleteResponse);
@@ -170,7 +180,7 @@ message ProductListItemResponse {
   int32 review_count = 21;
   repeated ProductStickerResponse stickers = 22;
   optional ProductPromoInfo active_promo = 23;
-  // Вага у кг для розрахунку доставки (0 → fallback на defaultItemWeightKg).
+  
   double weight_kg = 24;
 }
 
@@ -221,7 +231,7 @@ message ProductDetailResponse {
   optional float manual_rating = 37;
   optional ProductPromoInfo active_promo = 38;
   repeated ProductColorResponse colors = 39;
-  // Вага товару у кг для розрахунку доставки (variant може override'ити).
+  
   double weight_kg = 40;
 }
 
@@ -451,8 +461,9 @@ enum ProductStatus {
   PRODUCT_STATUS_UNSPECIFIED = 0;
   PRODUCT_STATUS_DRAFT = 1; 
   PRODUCT_STATUS_ACTIVE = 2; 
-  PRODUCT_STATUS_INACTIVE = 3; 
-  PRODUCT_STATUS_ARCHIVED = 4; 
+  PRODUCT_STATUS_INACTIVE = 3;
+  PRODUCT_STATUS_ARCHIVED = 4;
+  PRODUCT_STATUS_MODERATION = 5; 
 }
 
 enum RelatedProductType {
@@ -630,7 +641,7 @@ message ProductVariantDetailResponse {
 
   optional string color_id = 21;
 
-  // Override-вага варіанту у кг; 0 означає "успадкувати від продукту".
+ 
   double weight_kg = 22;
 }
 
@@ -673,7 +684,7 @@ 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;
 }
 
@@ -702,7 +713,7 @@ 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;
 
 
@@ -740,8 +751,6 @@ message GetVariantSizeChartsRequest {
 }
 
 
-// ─── Bulk lookup by SKU / barcode ─────────────────────────────────────────────
-
 enum IdentifierType {
   IDENTIFIER_TYPE_UNSPECIFIED = 0;
   IDENTIFIER_TYPE_SKU         = 1;
@@ -768,29 +777,24 @@ message BulkLookupProductsResponse {
   repeated ProductLookupResult results = 1;
 }
 
-// ─── Bulk lookup variants by ID (for cart price snapshot) ────────────────────
-//
-// Використовується cart-service для отримання актуальної ціни саме за варіантом
-// (variant.price якщо has_own_price, інакше product.price). Повертає достатньо
-// для побудови line snapshot: ціна/стара ціна/назва/sku/stock/main_image.
 
 message VariantLookupResult {
   string variant_id   = 1;
   string product_id   = 2;
   string sku          = 3;
   bool   found        = 4;
-  // Резолвлена з урахуванням variant override.
+
   double price        = 5;
   optional double old_price = 6;
   int32  stock        = 7;
   bool   has_own_price = 8;
-  // Локалізована назва (uk → ru → перше) для зручності клієнта.
+  
   string name_uk      = 9;
   string main_image   = 10;
   optional string color_id = 11;
-  // Вага у кг (variant.weight_kg ?? product.weight_kg ?? 0).
+  
   double weight_kg    = 12;
-  // Розмір з variant.options.size — для відображення у замовленнях.
+ 
   string size         = 13;
 }
 
@@ -803,7 +807,6 @@ message BulkLookupVariantsResponse {
 }
 
 
-// ─── Product colors ──────────────────────────────────────────────────────────
 
 message ProductColorImagePayload {
   string url = 1;
@@ -881,4 +884,111 @@ message ReorderProductColorsRequest {
 message ColorSortOrderItem {
   string color_id = 1;
   int32 sort_order = 2;
+}
+
+
+message ProductSyncItem {
+  string product_guid = 1;                   
+  string sku = 2;                            
+  map<string, string> name = 3;              
+  optional string brand_value_guid = 4;      
+  repeated string attribute_value_guids = 5; 
+  repeated string characteristic_guids = 6;  
+  repeated string category_guids = 7;        
+}
+
+message UpsertProductsRequest {
+  repeated ProductSyncItem items = 1;
+  string sync_id = 2;
+  string created_by = 3;                      
+  string color_property_guid = 4;             
+}
+
+message ProductUpsertResult {
+  string guid = 1;                           
+  string status = 2;                       
+  optional string reason = 3;
+  optional string id = 4;
+  int32 attributes_linked = 5;
+  int32 attributes_skipped = 6;              
+  int32 variants_created = 7;
+  int32 variants_updated = 8;
+  int32 variants_skipped = 9;              
+}
+
+message UpsertProductsResponse {
+  repeated ProductUpsertResult results = 1;
+}
+
+message PriceSyncItem {
+  string product_guid = 1;
+  optional string characteristic_guid = 2;   
+  double price = 3;
+  optional double old_price = 4;             
+}
+
+message UpsertPricesRequest {
+  repeated PriceSyncItem items = 1;
+  string sync_id = 2;
+}
+
+message PriceUpsertResult {
+  string guid = 1;                          
+  string status = 2;                        
+  optional string reason = 3;
+}
+
+message UpsertPricesResponse {
+  repeated PriceUpsertResult results = 1;
+}
+
+
+message CharacteristicPropertyLink {
+  string property_guid = 1;
+  string value_guid = 2;
+}
+
+message CharacteristicSyncItem {
+  string characteristic_guid = 1;
+  map<string, string> name = 2;           
+  repeated CharacteristicPropertyLink properties = 3;
+}
+
+message UpsertCharacteristicsRequest {
+  repeated CharacteristicSyncItem items = 1;
+  string sync_id = 2;
+}
+
+message CharacteristicUpsertResult {
+  string guid = 1;                           
+  string status = 2;                          
+  optional string reason = 3;
+  optional string id = 4;
+}
+
+message UpsertCharacteristicsResponse {
+  repeated CharacteristicUpsertResult results = 1;
+}
+
+
+message StockSyncItem {
+  string product_guid = 1;
+  optional string characteristic_guid = 2;    
+  string warehouse_guid = 3;
+  int32 quantity = 4;
+}
+
+message UpsertStocksRequest {
+  repeated StockSyncItem items = 1;
+  string sync_id = 2;
+}
+
+message StockUpsertResult {
+  string guid = 1;                             
+  string status = 2;                        
+  optional string reason = 3;
+}
+
+message UpsertStocksResponse {
+  repeated StockUpsertResult results = 1;
 }

package/dist/proto/promotion.proto

@@ -19,28 +19,27 @@ service PromotionService {
   rpc GetActivePromotions       (GetActivePromotionsRequest)       returns (GetActivePromotionsResponse);
   rpc GetActivePromotionsSnapshot (GetActivePromotionsSnapshotRequest) returns (GetActivePromotionsSnapshotResponse);
 
-  // Products
+  
   rpc GetPromotionProducts      (GetPromotionProductsRequest)      returns (GetPromotionProductsResponse);
   rpc GetPromotionEligibleProductIds (GetPromotionEligibleProductIdsRequest) returns (GetPromotionEligibleProductIdsResponse);
   rpc AddPromotionProducts      (AddPromotionProductsRequest)      returns (SuccessResponse);
   rpc RemovePromotionProducts   (RemovePromotionProductsRequest)   returns (SuccessResponse);
 
-  // Categories
+ 
   rpc GetPromotionCategories    (GetPromotionCategoriesRequest)    returns (GetPromotionCategoriesResponse);
   rpc SetPromotionCategories    (SetPromotionCategoriesRequest)    returns (SuccessResponse);
 
-  // Brands
+
   rpc GetPromotionBrands        (GetPromotionBrandsRequest)        returns (GetPromotionBrandsResponse);
   rpc SetPromotionBrands        (SetPromotionBrandsRequest)        returns (SuccessResponse);
 
-  // Bundles
+
   rpc GetPromotionBundles       (GetPromotionBundlesRequest)       returns (GetPromotionBundlesResponse);
   rpc AddPromotionBundles       (AddPromotionBundlesRequest)       returns (SuccessResponse);
   rpc RemovePromotionBundles    (RemovePromotionBundlesRequest)    returns (SuccessResponse);
 }
 
 
-// ─── Enums ────────────────────────────────────────────────────────────────────
 
 enum PromotionType {
   PROMOTION_TYPE_UNSPECIFIED           = 0;
@@ -99,7 +98,6 @@ enum ExclusionEntityType {
 }
 
 
-// ─── Condition / Exclusion payloads ───────────────────────────────────────────
 
 message PromotionConditionPayload {
   ConditionLogic logic_type     = 1;
@@ -126,7 +124,6 @@ message PromotionExclusionResponse {
 }
 
 
-// ─── Main response ────────────────────────────────────────────────────────────
 
 message PromotionResponse {
   string              id           = 1;
@@ -178,7 +175,6 @@ message PromotionResponse {
 }
 
 
-// ─── List ─────────────────────────────────────────────────────────────────────
 
 message GetPromotionsRequest {
   PaginationRequest pagination  = 1;
@@ -188,8 +184,8 @@ message GetPromotionsRequest {
   optional string category_id  = 5;
   optional string date_from    = 6;
   optional string date_to      = 7;
-  optional string sort_by      = 8;  // startDate | endDate | priority | discountValue
-  optional string sort_dir     = 9;  // asc | desc
+  optional string sort_by      = 8;  
+  optional string sort_dir     = 9; 
 }
 
 message GetPromotionsResponse {
@@ -216,7 +212,6 @@ message PromotionListItem {
 }
 
 
-// ─── CRUD requests ───────────────────────────────────────────────────────────
 
 message GetPromotionRequest {
   string id = 1;
@@ -314,7 +309,6 @@ message UpdatePromotionStatusRequest {
 }
 
 
-// ─── Bulk apply ───────────────────────────────────────────────────────────────
 
 message BulkApplyToCategoriesRequest {
   string          promotion_id = 1;
@@ -322,7 +316,6 @@ message BulkApplyToCategoriesRequest {
 }
 
 
-// ─── Active promotions ────────────────────────────────────────────────────────
 
 message GetActivePromotionsRequest {
   PaginationRequest pagination = 1;
@@ -335,7 +328,6 @@ message GetActivePromotionsResponse {
 }
 
 
-// ─── Products ─────────────────────────────────────────────────────────────────
 
 message PromotionProductItem {
   string          id          = 1;
@@ -376,8 +368,7 @@ message GetPromotionEligibleProductIdsRequest {
   string promotion_id = 1;
 }
 
-// Returns the full membership of the promotion (NOT resolved to a flat list).
-// Catalog-service joins these (UNION include − exclude) using its own data.
+
 message GetPromotionEligibleProductIdsResponse {
   repeated string include_product_ids   = 1;
   repeated string include_category_ids  = 2;
@@ -388,7 +379,6 @@ message GetPromotionEligibleProductIdsResponse {
   optional bool   exists                = 7;
 }
 
-// ─── Active promotions snapshot (for cross-service enrichment) ───────────────
 
 message GetActivePromotionsSnapshotRequest {}
 
@@ -402,14 +392,14 @@ message ActivePromotionSnapshotItem {
   optional string seo_slug = 7;
   optional string starts_at = 8;
   optional string ends_at = 9;
-  // Resolved eligible product IDs (already deduped, exclusions applied).
+  
   repeated string product_ids = 10;
   repeated string category_ids = 11;
   repeated string brand_ids = 12;
   repeated string excluded_product_ids = 13;
   repeated string excluded_category_ids = 14;
   repeated string excluded_brand_ids = 15;
-  // Per-product label/color override (key = productId).
+  
   map<string, string> product_labels = 16;
   map<string, string> product_label_colors = 17;
 }
@@ -420,7 +410,6 @@ message GetActivePromotionsSnapshotResponse {
 }
 
 
-// ─── Categories ───────────────────────────────────────────────────────────────
 
 message GetPromotionCategoriesRequest {
   string promotion_id = 1;
@@ -436,7 +425,6 @@ message SetPromotionCategoriesRequest {
 }
 
 
-// ─── Brands ───────────────────────────────────────────────────────────────────
 
 message GetPromotionBrandsRequest {
   string promotion_id = 1;
@@ -452,7 +440,6 @@ message SetPromotionBrandsRequest {
 }
 
 
-// ─── Bundles ──────────────────────────────────────────────────────────────────
 
 message GetPromotionBundlesRequest {
   string promotion_id = 1;

package/dist/proto/rbac.proto

@@ -3,17 +3,17 @@ 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);
 }
@@ -71,7 +71,7 @@ message UpdateRoleRequest {
   optional string name         = 2;
   optional string description  = 3;
   optional string color        = 4;
-  // Якщо передано — повна заміна; якщо не передано — без змін.
+  
   repeated string permission_keys = 5;
   bool replace_permissions     = 6;
 }
@@ -86,8 +86,7 @@ message DeleteRoleResponse {
 
 message AssignAccountRoleRequest {
   string account_id        = 1;
-  // Якщо custom_role_id порожній — користувач відвʼязується від кастомної ролі,
-  // і дозволи беруться з системної.
+  
   optional string custom_role_id = 2;
 }
 
@@ -100,10 +99,9 @@ message GetAccountPermissionsRequest {
 }
 
 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;
 }

package/dist/proto/search.proto

@@ -6,42 +6,41 @@ import "common.proto";
 
 
 service SearchService {
-  // ─── Public (autocomplete) ───────────────────────────────────────────────
+  
   rpc Suggest (SuggestRequest) returns (SuggestResponse);
 
-  // ─── Admin: synonyms ─────────────────────────────────────────────────────
+
   rpc ListSynonyms (ListSynonymsRequest) returns (ListSynonymsResponse);
   rpc CreateSynonym (CreateSynonymRequest) returns (SynonymResponse);
   rpc UpdateSynonym (UpdateSynonymRequest) returns (SynonymResponse);
   rpc DeleteSynonym (DeleteSynonymRequest) returns (DeleteResponse);
   rpc SyncSynonymsToTypesense (SyncSynonymsRequest) returns (SuccessResponse);
 
-  // ─── Admin: popular queries ──────────────────────────────────────────────
+ 
   rpc ListPopularQueries (ListPopularQueriesRequest) returns (ListPopularQueriesResponse);
   rpc CreatePopularQuery (CreatePopularQueryRequest) returns (PopularQueryResponse);
   rpc UpdatePopularQuery (UpdatePopularQueryRequest) returns (PopularQueryResponse);
   rpc DeletePopularQuery (DeletePopularQueryRequest) returns (DeleteResponse);
   rpc ReorderPopularQueries (ReorderPopularQueriesRequest) returns (SuccessResponse);
 
-  // ─── Admin: zero-result analytics ────────────────────────────────────────
+ 
   rpc ListZeroResults (ListZeroResultsRequest) returns (ListZeroResultsResponse);
   rpc ClearZeroResults (ClearZeroResultsRequest) returns (SuccessResponse);
 }
 
-// ─────────────────────────── Suggest (public) ─────────────────────────────
 
 message SuggestRequest {
   string q = 1;
-  int32 limit = 2;        // 1..20, default 8
-  bool only_in_stock = 3; // default true
-  string locale = 4;      // 'uk' | 'ru', default 'uk'
+  int32 limit = 2;        
+  bool only_in_stock = 3;
+  string locale = 4;   
 }
 
 message SuggestProduct {
   string id = 1;
   string sku = 2;
   string slug = 3;
-  string name = 4;        // already локалізована (uk/ru)
+  string name = 4;       
   string main_image = 5;
   double price = 6;
   optional double old_price = 7;
@@ -62,10 +61,9 @@ message SuggestResponse {
   repeated SuggestProduct products = 2;
   repeated SuggestCategory categories = 3;
   repeated string popular_queries = 4;
-  int32 total = 5;   // загальна кількість збігів у продуктах
+  int32 total = 5;  
 }
 
-// ─────────────────────────── Synonyms (admin) ─────────────────────────────
 
 enum SynonymType {
   SYNONYM_MULTI_WAY = 0;
@@ -118,7 +116,6 @@ message DeleteSynonymRequest {
 message SyncSynonymsRequest {
 }
 
-// ───────────────────────── Popular queries (admin) ────────────────────────
 
 message PopularQueryResponse {
   string id = 1;
@@ -163,10 +160,9 @@ message ReorderPopularQueryItem {
   int32 sort_order = 2;
 }
 
-// ─────────────────────── Zero-result analytics (admin) ─────────────────────
 
 message ListZeroResultsRequest {
-  optional int32 limit = 1; // default 100, max 500
+  optional int32 limit = 1; 
 }
 
 message ZeroResultItem {