@mamindom/contracts 1.0.143 → 1.0.145

package/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);
@@ -74,7 +86,7 @@ rpc AssignVariantSizeCharts (AssignVariantSizeChartsRequest) returns (SuccessRes
 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 +182,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 +233,7 @@ message ProductDetailResponse {
   optional float manual_rating = 37;
   optional ProductPromoInfo active_promo = 38;
   repeated ProductColorResponse colors = 39;
-  // Вага товару у кг для розрахунку доставки (variant може override'ити).
+  
   double weight_kg = 40;
 }
 
@@ -630,7 +642,7 @@ message ProductVariantDetailResponse {
 
   optional string color_id = 21;
 
-  // Override-вага варіанту у кг; 0 означає "успадкувати від продукту".
+ 
   double weight_kg = 22;
 }
 
@@ -673,7 +685,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 +714,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 +752,6 @@ message GetVariantSizeChartsRequest {
 }
 
 
-// ─── Bulk lookup by SKU / barcode ─────────────────────────────────────────────
-
 enum IdentifierType {
   IDENTIFIER_TYPE_UNSPECIFIED = 0;
   IDENTIFIER_TYPE_SKU         = 1;
@@ -768,29 +778,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 +808,6 @@ message BulkLookupVariantsResponse {
 }
 
 
-// ─── Product colors ──────────────────────────────────────────────────────────
 
 message ProductColorImagePayload {
   string url = 1;
@@ -881,4 +885,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/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/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/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 {

package/proto/seo_filter.proto

@@ -6,14 +6,9 @@ import "common.proto";
 
 
 service SeoFilterService {
-  // ─── Public ──────────────────────────────────────────────────────────────
 
-  // Резолв ЧПУ-URL → metadata + canonical. Викликається SSR Next.js для
-  // кожного category/[[...filters]] запиту. Якщо combo не знайдено —
-  // повертає isIndexed=false і автогенерований fallback metadata.
   rpc ResolveSeoFilter (ResolveSeoFilterRequest) returns (ResolveSeoFilterResponse);
 
-  // ─── Admin ───────────────────────────────────────────────────────────────
 
   rpc ListSeoFilters (ListSeoFiltersRequest) returns (ListSeoFiltersResponse);
   rpc GetSeoFilter (GetSeoFilterRequest) returns (SeoFilterResponse);
@@ -21,26 +16,24 @@ service SeoFilterService {
   rpc UpdateSeoFilter (UpdateSeoFilterRequest) returns (SeoFilterResponse);
   rpc DeleteSeoFilter (DeleteSeoFilterRequest) returns (DeleteResponse);
 
-  // Топ-N непокритих combinations (за impressions/popularity) — для
-  // швидкого створення SeoFilter з адмін-форми "Автопідказки".
+  
   rpc SuggestSeoFilters (SuggestSeoFiltersRequest) returns (SuggestSeoFiltersResponse);
+
+  rpc ListIndexedForSitemap (ListIndexedForSitemapRequest) returns (ListIndexedForSitemapResponse);
 }
 
-// ─────────────────────────── Domain types ────────────────────────────────
 
-// Частина combo. Однаковий формат і у DB (combo_parts JSON), і у gRPC.
-// type: 'brand'|'price'|'color'|'size'
 message FilterPart {
   string type = 1;
-  // Для brand/color/size:
+ 
   optional string value_id = 2;
   optional string value_slug = 3;
-  // Для price:
+  
   optional int32 price_min = 4;
   optional int32 price_max = 5;
 }
 
-// Локалізовані поля (uk/ru) у форматі { uk: "...", ru: "..." }.
+
 message LocaleStrings {
   string uk = 1;
   string ru = 2;
@@ -62,40 +55,35 @@ message SeoFilterResponse {
   int64 updated_at = 13;
 }
 
-// ─────────────────────────── Resolve (public) ────────────────────────────
 
 message ResolveSeoFilterRequest {
   string category_id = 1;
-  // Канонічно відсортовані URL segments як приходять з Next.js, напр.
-  // ["brend-cybex", "cina-1000-5000"]. Caller гарантує що порядок canonical.
+ 
   repeated string url_segments = 2;
-  string locale = 3; // 'uk' | 'ru'
+  string locale = 3;
 }
 
 message ResolveSeoFilterResponse {
-  // Якщо false → caller рендерить категорію з noindex,follow.
+
   bool found = 1;
-  // Якщо false → caller додає <meta robots="noindex,follow"> навіть якщо
-  // запис знайдено (наприклад, isIndexed=false manual override).
+ 
   bool is_indexed = 2;
   LocaleStrings title = 3;
   LocaleStrings description = 4;
   LocaleStrings h1 = 5;
-  // Canonical-URL-path без host: "/uk/c/koliaski/brend-cybex"
+  
   string canonical_path = 6;
-  // Денормалізовані combo_parts з resolved valueId — для побудови
-  // запиту до products (categoryId + filter ids).
+
   repeated FilterPart resolved_parts = 7;
 }
 
-// ─────────────────────────── List (admin) ────────────────────────────────
 
 message ListSeoFiltersRequest {
   PaginationRequest pagination = 1;
   optional string category_id = 2;
   optional bool is_indexed = 3;
   optional bool is_auto = 4;
-  // Пошук за uk/ru title (для адмін-фільтра).
+  
   optional string search = 5;
 }
 
@@ -108,7 +96,6 @@ message GetSeoFilterRequest {
   string id = 1;
 }
 
-// ─────────────────────────── Create / Update ─────────────────────────────
 
 message CreateSeoFilterRequest {
   string category_id = 1;
@@ -131,24 +118,42 @@ message DeleteSeoFilterRequest {
   string id = 1;
 }
 
-// ─────────────────────────── Suggestions (admin) ─────────────────────────
 
 message SuggestSeoFiltersRequest {
   string category_id = 1;
-  int32 limit = 2; // default 20
+  int32 limit = 2;
 }
 
 message SuggestSeoFilterCandidate {
-  // Запропоновані combo_parts (валідні, з resolved slug).
+
   repeated FilterPart combo_parts = 1;
-  // Оцінка популярності: clicks / impressions / товарообіг (single число).
+  
   int32 score = 2;
-  // Чи існує вже SeoFilter з таким комбо (тоді UI ховає кнопку Create).
+
   bool already_exists = 3;
-  // Pre-built canonical URL path для preview.
+  
   LocaleStrings preview_segments = 4;
 }
 
 message SuggestSeoFiltersResponse {
   repeated SuggestSeoFilterCandidate items = 1;
 }
+
+
+message ListIndexedForSitemapRequest {
+  
+  optional int32 limit = 1;
+  optional string after_id = 2;
+}
+
+message SitemapEntry {
+  string id = 1;
+  string category_slug = 2;
+  LocaleStrings url_segments = 3;
+  int64 updated_at = 4;
+}
+
+message ListIndexedForSitemapResponse {
+  repeated SitemapEntry items = 1;
+  optional string next_after_id = 2;
+}

package/proto/shop_filters.proto

@@ -60,9 +60,7 @@ message ShopFilterOption {
   string value = 1;
   string label = 2;
   int32 count = 3;
-  // slug ОПЦІЙНИЙ — потрібен для побудови ЧПУ-URL фільтрами
-  // (brend-<slug>, kolir-<slug>, rozmir-<slug>). Якщо slug ще не
-  // згенеровано через backfill — пусто, frontend fallback на id.
+  
   optional string slug = 4;
 }