@mamindom/contracts 1.0.140 → 1.0.142

package/gen/shop_filters.ts

@@ -13,36 +13,16 @@ export const protobufPackage = "catalog.v1";
 
 export interface GetShopFiltersRequest {
   categoryId: string;
-  /**
-   * Поточно застосовані фільтри. Counts по кожному facet рахуються
-   * з виключенням саме того facet — щоб лічильники реагували на вибір.
-   */
   brandIds: string[];
   colorIds: string[];
   sizeIds: string[];
   priceMin?: number | undefined;
   priceMax?: number | undefined;
   inStock?: boolean | undefined;
-  search?:
-    | string
-    | undefined;
-  /**
-   * Обмеження множини товарів акцією — фасети рахуються тільки
-   * по товарах, що належать поточній акції.
-   */
-  promotionFilter?:
-    | PromotionFilter
-    | undefined;
-  /** Динамічні атрибути окрім color/size (матеріал, виробник тощо). */
+  search?: string | undefined;
+  promotionFilter?: PromotionFilter | undefined;
   attributeValueIds: string[];
-  /**
-   * Явний прапор "ціновий фільтр активний". Без нього неможливо
-   * відрізнити "користувач не вибирав" від "обрав від 0".
-   */
-  priceActive?:
-    | boolean
-    | undefined;
-  /** 'uk' | 'ru' — для локалізації labels у відповіді (дефолт uk). */
+  priceActive?: boolean | undefined;
   locale?: string | undefined;
 }
 
@@ -53,7 +33,14 @@ export interface GetShopFiltersResponse {
   attributes: ShopFilterAttribute[];
   priceMin: number;
   priceMax: number;
-  subcategoryIds: string[];
+  subcategories: ShopFilterSubcategory[];
+}
+
+export interface ShopFilterSubcategory {
+  id: string;
+  slug: string;
+  label: string;
+  count: number;
 }
 
 export interface ShopFilterOption {
@@ -71,10 +58,6 @@ export interface ShopFilterColorOption {
 
 export interface ShopFilterAttribute {
   slug: string;
-  /**
-   * Локалізована назва атрибута (на стороні gateway вже згорнута у
-   * одну рядкову label згідно locale запиту).
-   */
   label: string;
   values: ShopFilterOption[];
 }

package/package.json

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

package/proto/audit.proto

@@ -11,11 +11,11 @@ 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"
+  string action                = 4;  
+  string target_type           = 5;  
   optional string target_id    = 6;
-  optional string summary      = 7;  // human-readable summary
-  optional string before_json  = 8;  // serialized JSON snapshot (small!)
+  optional string summary      = 7;  
+  optional string before_json  = 8;  
   optional string after_json   = 9;
   optional string ip           = 10;
   optional string user_agent   = 11;
@@ -32,8 +32,8 @@ message ListAuditRequest {
   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 action_group = 7;  
+  optional string from         = 8;  
   optional string to           = 9;
 }
 

package/proto/banner.proto

@@ -118,7 +118,7 @@ message UpdateBannerRequest {
   string id = 1;
   optional string slug = 2;
   map<string, string> name = 3;
-  // empty = не оновлювати; non-empty = заміна повного списку плейсментів.
+  
   repeated BannerPlacement placements = 4;
   optional bool status = 5;
   optional int32 sort_order = 6;

package/proto/bonus_settings.proto

@@ -10,14 +10,13 @@ service BonusSettingsService {
 
 
 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;

package/proto/brand.proto

@@ -30,7 +30,7 @@ message BrandResponse {
   optional string guid_1c = 8;
   optional string image_id = 9;
 
-  // Кількість АКТИВНИХ товарів бренду (для shop UI).
+  
   int32 product_count = 10;
 }
 

package/proto/bundle.proto

@@ -42,7 +42,6 @@ service BundleService {
 }
 
 
-// ─── Enums ────────────────────────────────────────────────────────────────────
 
 enum BundleStatus {
   BUNDLE_STATUS_UNSPECIFIED = 0;
@@ -83,7 +82,6 @@ enum RuleOperator {
 }
 
 
-// ─── Requests ─────────────────────────────────────────────────────────────────
 
 message GetBundlesRequest {
   PaginationRequest pagination = 1;
@@ -122,7 +120,7 @@ message CreateBundleRequest {
   repeated BundleItemPayload items = 15;
   string created_by_id = 16;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 17;
   PriceMode price_mode = 18;
   bool require_all_in_stock = 19;
@@ -155,7 +153,7 @@ message UpdateBundleRequest {
 
   repeated BundleItemPayload items = 16;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 17;
   optional PriceMode price_mode = 18;
   optional bool require_all_in_stock = 19;
@@ -252,7 +250,6 @@ message AddCrossSellLinkRequest {
 }
 
 
-// ─── Responses ────────────────────────────────────────────────────────────────
 
 message GetBundlesResponse {
   repeated BundleListItemResponse items = 1;
@@ -312,7 +309,7 @@ message BundleDetailResponse {
   double final_price = 19;
   bool in_stock = 20;
 
-  // NEW
+  
   repeated DisplayPlacement display_placements = 21;
   PriceMode price_mode = 22;
   bool require_all_in_stock = 23;
@@ -360,26 +357,25 @@ message BundleItemAvailability {
 }
 
 message ExportBundlesResponse {
-  string content = 1; // JSON string or CSV string
+  string content = 1; 
   string format = 2;
   int32 count = 3;
 }
 
 message GenerateBundleCollageRequest {
   string bundle_id = 1;
-  // Optional: override cell pixel size (default 400)
+  
   optional int32 cell_size = 2;
 }
 
 message GenerateBundleCollageResponse {
-  string url = 1;       // Public CDN/S3 URL of the collage JPEG
-  string key = 2;       // S3 object key
-  int32 width = 3;      // Final image width in pixels
-  int32 height = 4;     // Final image height in pixels
+  string url = 1;       
+  string key = 2;     
+  int32 width = 3;      
+  int32 height = 4;     
   string bundle_id = 5;
 }
 
-// ── Bulk Lookup ──────────────────────────────────────────────────────────────
 
 message BulkLookupBundlesRequest {
   repeated string slugs = 1;
@@ -396,7 +392,6 @@ message BulkLookupBundlesResponse {
   repeated BundleLookupResult results = 1;
 }
 
-// ── Bundle Related Products ──────────────────────────────────────────────────
 
 enum BundleRelatedType {
   BUNDLE_RELATED_TYPE_UNSPECIFIED = 0;

package/proto/search.proto

@@ -4,8 +4,7 @@ package catalog.v1;
 
 import "common.proto";
 
-// SearchService — окремий сервіс під autocomplete та керування пошуком
-// (синоніми, популярні запити). Логіка та індекс живуть у catalog-service.
+
 service SearchService {
   // ─── Public (autocomplete) ───────────────────────────────────────────────
   rpc Suggest (SuggestRequest) returns (SuggestResponse);

package/proto/seo_filter.proto

@@ -0,0 +1,154 @@
+syntax = "proto3";
+
+package catalog.v1;
+
+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);
+  rpc CreateSeoFilter (CreateSeoFilterRequest) returns (SeoFilterResponse);
+  rpc UpdateSeoFilter (UpdateSeoFilterRequest) returns (SeoFilterResponse);
+  rpc DeleteSeoFilter (DeleteSeoFilterRequest) returns (DeleteResponse);
+
+  // Топ-N непокритих combinations (за impressions/popularity) — для
+  // швидкого створення SeoFilter з адмін-форми "Автопідказки".
+  rpc SuggestSeoFilters (SuggestSeoFiltersRequest) returns (SuggestSeoFiltersResponse);
+}
+
+// ─────────────────────────── 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;
+}
+
+message SeoFilterResponse {
+  string id = 1;
+  string category_id = 2;
+  string combo_hash = 3;
+  repeated FilterPart combo_parts = 4;
+  LocaleStrings url_segments = 5;
+  LocaleStrings title = 6;
+  LocaleStrings description = 7;
+  LocaleStrings h1 = 8;
+  bool is_indexed = 9;
+  bool is_auto = 10;
+  int32 popularity = 11;
+  int64 created_at = 12;
+  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'
+}
+
+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;
+}
+
+message ListSeoFiltersResponse {
+  repeated SeoFilterResponse items = 1;
+  PaginationMeta meta = 2;
+}
+
+message GetSeoFilterRequest {
+  string id = 1;
+}
+
+// ─────────────────────────── Create / Update ─────────────────────────────
+
+message CreateSeoFilterRequest {
+  string category_id = 1;
+  repeated FilterPart combo_parts = 2;
+  LocaleStrings title = 3;
+  LocaleStrings description = 4;
+  LocaleStrings h1 = 5;
+  bool is_indexed = 6;
+}
+
+message UpdateSeoFilterRequest {
+  string id = 1;
+  optional LocaleStrings title = 2;
+  optional LocaleStrings description = 3;
+  optional LocaleStrings h1 = 4;
+  optional bool is_indexed = 5;
+}
+
+message DeleteSeoFilterRequest {
+  string id = 1;
+}
+
+// ─────────────────────────── Suggestions (admin) ─────────────────────────
+
+message SuggestSeoFiltersRequest {
+  string category_id = 1;
+  int32 limit = 2; // default 20
+}
+
+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;
+}

package/proto/shop_filters.proto

@@ -15,8 +15,7 @@ service ShopFilterService {
 message GetShopFiltersRequest {
   string category_id = 1;
 
-  // Поточно застосовані фільтри. Counts по кожному facet рахуються
-  // з виключенням саме того facet — щоб лічильники реагували на вибір.
+
   repeated string brand_ids = 2;
   repeated string color_ids = 3;
   repeated string size_ids = 4;
@@ -25,18 +24,16 @@ message GetShopFiltersRequest {
   optional bool in_stock = 7;
   optional string search = 8;
 
-  // Обмеження множини товарів акцією — фасети рахуються тільки
-  // по товарах, що належать поточній акції.
+  
   optional PromotionFilter promotion_filter = 9;
 
-  // Динамічні атрибути окрім color/size (матеріал, виробник тощо).
+  
   repeated string attribute_value_ids = 10;
 
-  // Явний прапор "ціновий фільтр активний". Без нього неможливо
-  // відрізнити "користувач не вибирав" від "обрав від 0".
+  
   optional bool price_active = 11;
 
-  // 'uk' | 'ru' — для локалізації labels у відповіді (дефолт uk).
+ 
   optional string locale = 12;
 }
 
@@ -48,7 +45,15 @@ message GetShopFiltersResponse {
   repeated ShopFilterAttribute attributes = 4;
   double price_min = 5;
   double price_max = 6;
-  repeated string subcategory_ids = 7;
+  
+  repeated ShopFilterSubcategory subcategories = 7;
+}
+
+message ShopFilterSubcategory {
+  string id = 1;
+  string slug = 2;
+  string label = 3;
+  int32 count = 4;
 }
 
 message ShopFilterOption {
@@ -66,8 +71,7 @@ message ShopFilterColorOption {
 
 message ShopFilterAttribute {
   string slug = 1;
-  // Локалізована назва атрибута (на стороні gateway вже згорнута у
-  // одну рядкову label згідно locale запиту).
+
   string label = 2;
   repeated ShopFilterOption values = 3;
 }