@mamindom/contracts 1.0.213 → 1.0.216

package/dist/events/auth/otp-requested.interface.d.ts

@@ -6,4 +6,9 @@ export interface OtpRequestedEvent {
     userId?: string;
     identifier?: string;
     type?: string;
+    /**
+     * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+     * Необов'язкове: старі продюсери поле не шлють.
+     */
+    locale?: 'UK' | 'RU';
 }

package/dist/events/orders/order-cancelled.interface.d.ts

@@ -15,4 +15,9 @@ export interface OrderCancelledEvent {
         email: string;
         phone: string;
     };
+    /**
+     * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+     * Необов'язкове: старі продюсери поле не шлють.
+     */
+    locale?: 'UK' | 'RU';
 }

package/dist/events/orders/order-created.interface.d.ts

@@ -15,6 +15,11 @@ export interface OrderCreatedEvent {
         sku: string;
         quantity: number;
         price: string;
+        /** Знімок назви, фото й підсумку рядка — для таблиці товарів у листі. */
+        name?: string;
+        imageUrl?: string;
+        size?: string;
+        lineTotal?: string;
     }>;
     delivery: {
         method: string;
@@ -34,4 +39,9 @@ export interface OrderCreatedEvent {
         email: string;
     };
     createdAt: number;
+    /**
+     * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+     * Необов'язкове: старі продюсери поле не шлють.
+     */
+    locale?: 'UK' | 'RU';
 }

package/dist/events/orders/order-money.interface.d.ts

@@ -22,4 +22,9 @@ export interface OrderSurchargeRequestedEvent {
         email: string;
         phone: string;
     };
+    /**
+     * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+     * Необов'язкове: старі продюсери поле не шлють.
+     */
+    locale?: 'UK' | 'RU';
 }

package/dist/events/orders/order-status-changed.interface.d.ts

@@ -17,4 +17,9 @@ export interface OrderStatusChangedEvent {
     };
     trackingNumber?: string;
     trackingUrl?: string;
+    /**
+     * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+     * Необов'язкове: старі продюсери поле не шлють.
+     */
+    locale?: 'UK' | 'RU';
 }

package/dist/gen/auth.d.ts

@@ -9,6 +9,8 @@ export interface LogoutResponse {
 export interface SendOtpRequest {
     identifier: string;
     type: string;
+    /** Мова сайту (uk | ru) — нею прийде лист/SMS із кодом. */
+    locale?: string | undefined;
 }
 export interface SendOtpResponse {
     ok: boolean;
@@ -34,6 +36,7 @@ export interface RegisterRequest {
 export interface RequestPasswordResetRequest {
     identifier: string;
     type: string;
+    locale?: string | undefined;
 }
 export interface RequestPasswordResetResponse {
     ok: boolean;

package/dist/gen/bonus_settings.d.ts

@@ -1,7 +1,9 @@
 import { Observable } from "rxjs";
 export declare const protobufPackage = "promo.v1";
 export interface BonusSettingsResponse {
-    earnRate: number;
+    earnStepUah: number;
+    earnPerStepUah: number;
+    earnMinPriceUah: number;
     redeemRate: number;
     minOrderForEarn: number;
     maxRedeemShare: number;
@@ -10,7 +12,9 @@ export interface BonusSettingsResponse {
 export interface GetBonusSettingsRequest {
 }
 export interface UpdateBonusSettingsRequest {
-    earnRate?: number | undefined;
+    earnStepUah?: number | undefined;
+    earnPerStepUah?: number | undefined;
+    earnMinPriceUah?: number | undefined;
     redeemRate?: number | undefined;
     minOrderForEarn?: number | undefined;
     maxRedeemShare?: number | undefined;

package/dist/gen/notification.d.ts

@@ -49,6 +49,10 @@ export declare enum NotificationStatus {
     FAILED = 3,
     SIMULATED = 4,
     SUPPRESSED = 5,
+    /** DUPLICATE - Не надіслано: таке саме повідомлення вже пішло раніше (повтор події). */
+    DUPLICATE = 6,
+    /** DISABLED - Не надіслано: адмін вимкнув шаблон цього листа. */
+    DISABLED = 7,
     UNRECOGNIZED = -1
 }
 export declare enum TelegramTopic {
@@ -276,6 +280,13 @@ export interface BrandingProfile {
     resolvedBrandUrl: string;
     resolvedSupportEmail: string;
     headerHtml: string;
+    /**
+     * Оформлення листа за замовчуванням (JSON EmailTheme) і глобальні шапка й
+     * підвал блоками (JSON EmailBlock[]). Порожній рядок — «як у коді».
+     */
+    themeJson: string;
+    headerBlocksJson: string;
+    footerBlocksJson: string;
 }
 export interface UpdateBrandingRequest {
     logoUrl?: string | undefined;
@@ -285,6 +296,9 @@ export interface UpdateBrandingRequest {
     footerHtml?: string | undefined;
     actorId: string;
     headerHtml?: string | undefined;
+    themeJson?: string | undefined;
+    headerBlocksJson?: string | undefined;
+    footerBlocksJson?: string | undefined;
 }
 export interface NotificationTemplate {
     id: string;
@@ -377,15 +391,69 @@ export interface RenderPreviewRequest {
     variablesJson: string;
     subject?: string | undefined;
     brandingJson?: string | undefined;
+    /**
+     * Блоковий лист (JSON EmailDocument). Якщо заданий — рендеримо його, а
+     * body_html лише запасний шлях, як і при відправці.
+     */
+    contentJson?: string | undefined;
+    /** Категорія впливає на лист: у масових є посилання «Відписатися». */
+    category?: NotificationCategory | undefined;
+    locale?: NotificationLocale | undefined;
+    /** Ключ листа — щоб попередити про змінні, яких цей лист не отримає. */
+    templateKey?: string | undefined;
 }
 export interface RenderPreviewResponse {
     html: string;
     subject: string;
+    /** Плейн-текстова версія — саме та, що піде в листі. */
+    text: string;
+    /** Попередження (невідома змінна, порожній alt, зламана розмітка тощо). */
+    warnings: string[];
 }
 export interface SendTestRequest {
     templateId: string;
     recipient: string;
     variablesJson: string;
+    /**
+     * Незбережений стан редактора. Задані поля замінюють збережені — тестовий
+     * лист показує те, що адмін бачить зараз, а не останнє збереження.
+     */
+    subject?: string | undefined;
+    contentJson?: string | undefined;
+    bodyHtml?: string | undefined;
+    bodyText?: string | undefined;
+}
+export interface GetTemplateVariablesRequest {
+    key: string;
+}
+export interface TemplateVariable {
+    path: string;
+    label: string;
+    example: string;
+    isList: boolean;
+}
+export interface TemplateVariablesResponse {
+    /** event — лист шле система за подією; campaign — лист розсилки. */
+    source: string;
+    trigger: string;
+    variables: TemplateVariable[];
+    /** Приклад значень (JSON) — для попереднього перегляду. */
+    sampleJson: string;
+}
+export interface DuplicateTemplateRequest {
+    id: string;
+    newKey: string;
+    locale?: NotificationLocale | undefined;
+    title?: string | undefined;
+    actorId?: string | undefined;
+}
+export interface DeleteTemplateRequest {
+    id: string;
+    actorId?: string | undefined;
+}
+export interface DeleteTemplateResponse {
+    ok: boolean;
+    errorMessage: string;
 }
 export interface SendTestResponse {
     ok: boolean;
@@ -476,6 +544,12 @@ export interface NotificationTemplateServiceClient {
     restoreVersion(request: RestoreVersionRequest): Observable<TemplateResponse>;
     renderPreview(request: RenderPreviewRequest): Observable<RenderPreviewResponse>;
     sendTest(request: SendTestRequest): Observable<SendTestResponse>;
+    /** Які змінні реально передає система в шаблон із цим ключем + приклад значень. */
+    getTemplateVariables(request: GetTemplateVariablesRequest): Observable<TemplateVariablesResponse>;
+    /** Копія шаблону під новим ключем і/або мовою (з тілом, блоками й темою). */
+    duplicateTemplate(request: DuplicateTemplateRequest): Observable<TemplateResponse>;
+    /** Видалення — лише для листів, створених адміном; системні ключі не видаляються. */
+    deleteTemplate(request: DeleteTemplateRequest): Observable<DeleteTemplateResponse>;
     sendToCustomer(request: SendToCustomerRequest): Observable<SendToCustomerResponse>;
 }
 export interface NotificationTemplateServiceController {
@@ -488,6 +562,12 @@ export interface NotificationTemplateServiceController {
     restoreVersion(request: RestoreVersionRequest): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
     renderPreview(request: RenderPreviewRequest): Promise<RenderPreviewResponse> | Observable<RenderPreviewResponse> | RenderPreviewResponse;
     sendTest(request: SendTestRequest): Promise<SendTestResponse> | Observable<SendTestResponse> | SendTestResponse;
+    /** Які змінні реально передає система в шаблон із цим ключем + приклад значень. */
+    getTemplateVariables(request: GetTemplateVariablesRequest): Promise<TemplateVariablesResponse> | Observable<TemplateVariablesResponse> | TemplateVariablesResponse;
+    /** Копія шаблону під новим ключем і/або мовою (з тілом, блоками й темою). */
+    duplicateTemplate(request: DuplicateTemplateRequest): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
+    /** Видалення — лише для листів, створених адміном; системні ключі не видаляються. */
+    deleteTemplate(request: DeleteTemplateRequest): Promise<DeleteTemplateResponse> | Observable<DeleteTemplateResponse> | DeleteTemplateResponse;
     sendToCustomer(request: SendToCustomerRequest): Promise<SendToCustomerResponse> | Observable<SendToCustomerResponse> | SendToCustomerResponse;
 }
 export declare function NotificationTemplateServiceControllerMethods(): (constructor: Function) => void;

package/dist/gen/notification.js

@@ -71,6 +71,10 @@ var NotificationStatus;
     NotificationStatus[NotificationStatus["FAILED"] = 3] = "FAILED";
     NotificationStatus[NotificationStatus["SIMULATED"] = 4] = "SIMULATED";
     NotificationStatus[NotificationStatus["SUPPRESSED"] = 5] = "SUPPRESSED";
+    /** DUPLICATE - Не надіслано: таке саме повідомлення вже пішло раніше (повтор події). */
+    NotificationStatus[NotificationStatus["DUPLICATE"] = 6] = "DUPLICATE";
+    /** DISABLED - Не надіслано: адмін вимкнув шаблон цього листа. */
+    NotificationStatus[NotificationStatus["DISABLED"] = 7] = "DISABLED";
     NotificationStatus[NotificationStatus["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
 })(NotificationStatus || (exports.NotificationStatus = NotificationStatus = {}));
 var TelegramTopic;
@@ -100,6 +104,9 @@ function NotificationTemplateServiceControllerMethods() {
             "restoreVersion",
             "renderPreview",
             "sendTest",
+            "getTemplateVariables",
+            "duplicateTemplate",
+            "deleteTemplate",
             "sendToCustomer",
         ];
         for (const method of grpcMethods) {

package/dist/gen/order.d.ts

@@ -198,6 +198,8 @@ export interface Order {
     saleRecordedAt: number;
     oneCOrderNumber: string;
     oneCOrderDate: string;
+    /** Подію purchase уже відправлено в GA4 (дедуплікація, ТЗ GA4 розділ 8). */
+    analyticsSent: boolean;
 }
 export interface CreateOrderRequest {
     idempotencyKey: string;
@@ -205,6 +207,8 @@ export interface CreateOrderRequest {
     guestId: string;
     source: string;
     cartId: string;
+    /** Мова сайту на момент оформлення (uk | ru) — нею йдуть листи й SMS про замовлення. */
+    locale?: string | undefined;
 }
 export interface CreateManualOrderRequest {
     idempotencyKey: string;
@@ -217,6 +221,8 @@ export interface CreateManualOrderRequest {
     payment: OrderPayment | undefined;
     promoCode: string;
     comment: string;
+    /** Мова листів покупцю (uk | ru); порожньо — українська. */
+    locale?: string | undefined;
 }
 export interface OrderItemInput {
     productId: string;
@@ -282,6 +288,15 @@ export interface SetCrmOrderIdRequest {
     id: string;
     crmOrderId: string;
 }
+export interface MarkAnalyticsSentRequest {
+    id: string;
+}
+export interface MarkAnalyticsSentResponse {
+    ok: boolean;
+    /** Саме цей виклик поставив прапорець. false — його вже було поставлено раніше. */
+    claimed: boolean;
+    errorMessage: string;
+}
 export interface MoneyAdjustment {
     id: string;
     orderId: string;
@@ -501,6 +516,11 @@ export interface OrderServiceClient {
     setTrackingNumber(request: SetTrackingNumberRequest): Observable<OrderResponse>;
     applyRecalculation(request: ApplyRecalculationRequest): Observable<OrderResponse>;
     setCrmOrderId(request: SetCrmOrderIdRequest): Observable<OrderResponse>;
+    /**
+     * GA4 (ТЗ KIPLAR, розділ 8): покупку в аналітику відправлено. Ідемпотентно:
+     * `claimed` = true лише для того виклику, що перевів прапорець false → true.
+     */
+    markAnalyticsSent(request: MarkAnalyticsSentRequest): Observable<MarkAnalyticsSentResponse>;
     setOneCOrderRef(request: SetOneCOrderRefRequest): Observable<OrderResponse>;
     applyOneCStatus(request: ApplyOneCStatusRequest): Observable<OrderResponse>;
     /** Врегулювання грошей після перерахунку (доплата / повернення). */
@@ -548,6 +568,11 @@ export interface OrderServiceController {
     setTrackingNumber(request: SetTrackingNumberRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
     applyRecalculation(request: ApplyRecalculationRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
     setCrmOrderId(request: SetCrmOrderIdRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
+    /**
+     * GA4 (ТЗ KIPLAR, розділ 8): покупку в аналітику відправлено. Ідемпотентно:
+     * `claimed` = true лише для того виклику, що перевів прапорець false → true.
+     */
+    markAnalyticsSent(request: MarkAnalyticsSentRequest): Promise<MarkAnalyticsSentResponse> | Observable<MarkAnalyticsSentResponse> | MarkAnalyticsSentResponse;
     setOneCOrderRef(request: SetOneCOrderRefRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
     applyOneCStatus(request: ApplyOneCStatusRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
     /** Врегулювання грошей після перерахунку (доплата / повернення). */

package/dist/gen/order.js

@@ -33,6 +33,7 @@ function OrderServiceControllerMethods() {
             "setTrackingNumber",
             "applyRecalculation",
             "setCrmOrderId",
+            "markAnalyticsSent",
             "setOneCOrderRef",
             "applyOneCStatus",
             "listMoneyAdjustments",

package/dist/proto/auth.proto

@@ -25,6 +25,8 @@ message LogoutResponse {
 message SendOtpRequest {
   string identifier = 1;
   string type = 2;
+  // Мова сайту (uk | ru) — нею прийде лист/SMS із кодом.
+  optional string locale = 3;
 }
 
 message SendOtpResponse {
@@ -55,6 +57,7 @@ message RegisterRequest {
 message RequestPasswordResetRequest {
   string identifier = 1;
   string type = 2;
+  optional string locale = 3;
 }
 
 message RequestPasswordResetResponse {

package/dist/proto/bonus_settings.proto

@@ -8,7 +8,19 @@ service BonusSettingsService {
 }
 
 message BonusSettingsResponse {
-  double earn_rate = 1;
+  // Формула нарахування (п.17 переліку): кожні `earn_step_uah` гривень ціни
+  // товару дають `earn_per_step_uah` гривень бонусів, і лише для товарів не
+  // дешевших за `earn_min_price_uah`. Ціна береться ПІСЛЯ знижки.
+  //
+  // Поле 1 (`earn_rate`, відсоткова ставка) прибране: формула не відсоткова,
+  // а поле показувало 2% і тим вводило в оману. Номер зарезервовано, щоб його
+  // ніколи не перевикористали під інше значення.
+  reserved 1;
+  reserved "earn_rate";
+
+  double earn_step_uah = 6;
+  double earn_per_step_uah = 7;
+  double earn_min_price_uah = 8;
 
   double redeem_rate = 2;
 
@@ -22,7 +34,12 @@ message BonusSettingsResponse {
 message GetBonusSettingsRequest {}
 
 message UpdateBonusSettingsRequest {
-  optional double earn_rate = 1;
+  reserved 1;
+  reserved "earn_rate";
+
+  optional double earn_step_uah = 6;
+  optional double earn_per_step_uah = 7;
+  optional double earn_min_price_uah = 8;
   optional double redeem_rate = 2;
   optional double min_order_for_earn = 3;
   optional double max_redeem_share = 4;

package/dist/proto/notification.proto

@@ -13,6 +13,13 @@ service NotificationTemplateService {
   rpc RenderPreview(RenderPreviewRequest) returns (RenderPreviewResponse);
   rpc SendTest(SendTestRequest) returns (SendTestResponse);
 
+  // Які змінні реально передає система в шаблон із цим ключем + приклад значень.
+  rpc GetTemplateVariables(GetTemplateVariablesRequest) returns (TemplateVariablesResponse);
+  // Копія шаблону під новим ключем і/або мовою (з тілом, блоками й темою).
+  rpc DuplicateTemplate(DuplicateTemplateRequest) returns (TemplateResponse);
+  // Видалення — лише для листів, створених адміном; системні ключі не видаляються.
+  rpc DeleteTemplate(DeleteTemplateRequest) returns (DeleteTemplateResponse);
+
   rpc SendToCustomer(SendToCustomerRequest) returns (SendToCustomerResponse);
 }
 
@@ -341,6 +348,12 @@ message BrandingProfile {
   string resolved_support_email = 11;
 
   string header_html = 12;
+
+  // Оформлення листа за замовчуванням (JSON EmailTheme) і глобальні шапка й
+  // підвал блоками (JSON EmailBlock[]). Порожній рядок — «як у коді».
+  string theme_json = 13;
+  string header_blocks_json = 14;
+  string footer_blocks_json = 15;
 }
 
 message UpdateBrandingRequest {
@@ -351,6 +364,9 @@ message UpdateBrandingRequest {
   optional string footer_html = 5;
   string actor_id = 6;
   optional string header_html = 7;
+  optional string theme_json = 8;
+  optional string header_blocks_json = 9;
+  optional string footer_blocks_json = 10;
 }
 
 enum NotificationChannel {
@@ -382,6 +398,10 @@ enum NotificationStatus {
   FAILED = 3;
   SIMULATED = 4;
   SUPPRESSED = 5;
+  // Не надіслано: таке саме повідомлення вже пішло раніше (повтор події).
+  DUPLICATE = 6;
+  // Не надіслано: адмін вимкнув шаблон цього листа.
+  DISABLED = 7;
 }
 
 enum TelegramTopic {
@@ -509,11 +529,24 @@ message RenderPreviewRequest {
   optional string subject = 3;
 
   optional string branding_json = 4;
+
+  // Блоковий лист (JSON EmailDocument). Якщо заданий — рендеримо його, а
+  // body_html лише запасний шлях, як і при відправці.
+  optional string content_json = 5;
+  // Категорія впливає на лист: у масових є посилання «Відписатися».
+  optional NotificationCategory category = 6;
+  optional NotificationLocale locale = 7;
+  // Ключ листа — щоб попередити про змінні, яких цей лист не отримає.
+  optional string template_key = 8;
 }
 
 message RenderPreviewResponse {
   string html = 1;
   string subject = 2;
+  // Плейн-текстова версія — саме та, що піде в листі.
+  string text = 3;
+  // Попередження (невідома змінна, порожній alt, зламана розмітка тощо).
+  repeated string warnings = 4;
 }
 
 message SendTestRequest {
@@ -522,6 +555,51 @@ message SendTestRequest {
   string recipient = 2;
 
   string variables_json = 3;
+
+  // Незбережений стан редактора. Задані поля замінюють збережені — тестовий
+  // лист показує те, що адмін бачить зараз, а не останнє збереження.
+  optional string subject = 4;
+  optional string content_json = 5;
+  optional string body_html = 6;
+  optional string body_text = 7;
+}
+
+message GetTemplateVariablesRequest {
+  string key = 1;
+}
+
+message TemplateVariable {
+  string path = 1;
+  string label = 2;
+  string example = 3;
+  bool is_list = 4;
+}
+
+message TemplateVariablesResponse {
+  // event — лист шле система за подією; campaign — лист розсилки.
+  string source = 1;
+  string trigger = 2;
+  repeated TemplateVariable variables = 3;
+  // Приклад значень (JSON) — для попереднього перегляду.
+  string sample_json = 4;
+}
+
+message DuplicateTemplateRequest {
+  string id = 1;
+  string new_key = 2;
+  optional NotificationLocale locale = 3;
+  optional string title = 4;
+  optional string actor_id = 5;
+}
+
+message DeleteTemplateRequest {
+  string id = 1;
+  optional string actor_id = 2;
+}
+
+message DeleteTemplateResponse {
+  bool ok = 1;
+  string error_message = 2;
 }
 
 message SendTestResponse {

package/dist/proto/order.proto

@@ -30,6 +30,10 @@ service OrderService {
 
   rpc SetCrmOrderId(SetCrmOrderIdRequest) returns (OrderResponse);
 
+  // GA4 (ТЗ KIPLAR, розділ 8): покупку в аналітику відправлено. Ідемпотентно:
+  // `claimed` = true лише для того виклику, що перевів прапорець false → true.
+  rpc MarkAnalyticsSent(MarkAnalyticsSentRequest) returns (MarkAnalyticsSentResponse);
+
 
   rpc SetOneCOrderRef(SetOneCOrderRefRequest) returns (OrderResponse);
 
@@ -308,6 +312,9 @@ message Order {
   string one_c_order_number = 28;
 
   string one_c_order_date = 29;
+
+  // Подію purchase уже відправлено в GA4 (дедуплікація, ТЗ GA4 розділ 8).
+  bool analytics_sent = 30;
 }
 
 message CreateOrderRequest {
@@ -316,6 +323,8 @@ message CreateOrderRequest {
   string guest_id = 3;
   string source = 4;
   string cart_id = 5;
+  // Мова сайту на момент оформлення (uk | ru) — нею йдуть листи й SMS про замовлення.
+  optional string locale = 6;
 }
 
 message CreateManualOrderRequest {
@@ -331,6 +340,8 @@ message CreateManualOrderRequest {
 
   string promo_code = 9;
   string comment = 10;
+  // Мова листів покупцю (uk | ru); порожньо — українська.
+  optional string locale = 11;
 }
 
 message OrderItemInput {
@@ -414,6 +425,17 @@ message SetCrmOrderIdRequest {
   string crm_order_id = 2;
 }
 
+message MarkAnalyticsSentRequest {
+  string id = 1;
+}
+
+message MarkAnalyticsSentResponse {
+  bool ok = 1;
+  // Саме цей виклик поставив прапорець. false — його вже було поставлено раніше.
+  bool claimed = 2;
+  string error_message = 3;
+}
+
 
 
 message MoneyAdjustment {

package/events/auth/otp-requested.interface.ts

@@ -9,4 +9,10 @@ export interface OtpRequestedEvent {
 
 	identifier?: string
 	type?: string
+
+	/**
+	 * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+	 * Необов'язкове: старі продюсери поле не шлють.
+	 */
+	locale?: 'UK' | 'RU'
 }

package/events/orders/order-cancelled.interface.ts

@@ -17,4 +17,10 @@ export interface OrderCancelledEvent {
 		email: string
 		phone: string
 	}
+
+	/**
+	 * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+	 * Необов'язкове: старі продюсери поле не шлють.
+	 */
+	locale?: 'UK' | 'RU'
 }

package/events/orders/order-created.interface.ts

@@ -15,6 +15,11 @@ export interface OrderCreatedEvent {
 		sku: string
 		quantity: number
 		price: string
+		/** Знімок назви, фото й підсумку рядка — для таблиці товарів у листі. */
+		name?: string
+		imageUrl?: string
+		size?: string
+		lineTotal?: string
 	}>
 	delivery: {
 		method: string
@@ -34,4 +39,10 @@ export interface OrderCreatedEvent {
 		email: string
 	}
 	createdAt: number
+
+	/**
+	 * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+	 * Необов'язкове: старі продюсери поле не шлють.
+	 */
+	locale?: 'UK' | 'RU'
 }

package/events/orders/order-money.interface.ts

@@ -27,4 +27,10 @@ export interface OrderSurchargeRequestedEvent {
 		email: string
 		phone: string
 	}
+
+	/**
+	 * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+	 * Необов'язкове: старі продюсери поле не шлють.
+	 */
+	locale?: 'UK' | 'RU'
 }

package/events/orders/order-status-changed.interface.ts

@@ -20,4 +20,10 @@ export interface OrderStatusChangedEvent {
 
 	trackingNumber?: string
 	trackingUrl?: string
+
+	/**
+	 * Мова покупця (`UK` | `RU`) — нею йдуть листи й SMS. Порожньо — `UK`.
+	 * Необов'язкове: старі продюсери поле не шлють.
+	 */
+	locale?: 'UK' | 'RU'
 }

package/gen/auth.ts

@@ -21,6 +21,8 @@ export interface LogoutResponse {
 export interface SendOtpRequest {
   identifier: string;
   type: string;
+  /** Мова сайту (uk | ru) — нею прийде лист/SMS із кодом. */
+  locale?: string | undefined;
 }
 
 export interface SendOtpResponse {
@@ -51,6 +53,7 @@ export interface RegisterRequest {
 export interface RequestPasswordResetRequest {
   identifier: string;
   type: string;
+  locale?: string | undefined;
 }
 
 export interface RequestPasswordResetResponse {

package/gen/bonus_settings.ts

@@ -11,7 +11,9 @@ import { Observable } from "rxjs";
 export const protobufPackage = "promo.v1";
 
 export interface BonusSettingsResponse {
-  earnRate: number;
+  earnStepUah: number;
+  earnPerStepUah: number;
+  earnMinPriceUah: number;
   redeemRate: number;
   minOrderForEarn: number;
   maxRedeemShare: number;
@@ -22,7 +24,9 @@ export interface GetBonusSettingsRequest {
 }
 
 export interface UpdateBonusSettingsRequest {
-  earnRate?: number | undefined;
+  earnStepUah?: number | undefined;
+  earnPerStepUah?: number | undefined;
+  earnMinPriceUah?: number | undefined;
   redeemRate?: number | undefined;
   minOrderForEarn?: number | undefined;
   maxRedeemShare?: number | undefined;

package/gen/notification.ts

@@ -64,6 +64,10 @@ export enum NotificationStatus {
   FAILED = 3,
   SIMULATED = 4,
   SUPPRESSED = 5,
+  /** DUPLICATE - Не надіслано: таке саме повідомлення вже пішло раніше (повтор події). */
+  DUPLICATE = 6,
+  /** DISABLED - Не надіслано: адмін вимкнув шаблон цього листа. */
+  DISABLED = 7,
   UNRECOGNIZED = -1,
 }
 
@@ -325,6 +329,13 @@ export interface BrandingProfile {
   resolvedBrandUrl: string;
   resolvedSupportEmail: string;
   headerHtml: string;
+  /**
+   * Оформлення листа за замовчуванням (JSON EmailTheme) і глобальні шапка й
+   * підвал блоками (JSON EmailBlock[]). Порожній рядок — «як у коді».
+   */
+  themeJson: string;
+  headerBlocksJson: string;
+  footerBlocksJson: string;
 }
 
 export interface UpdateBrandingRequest {
@@ -335,6 +346,9 @@ export interface UpdateBrandingRequest {
   footerHtml?: string | undefined;
   actorId: string;
   headerHtml?: string | undefined;
+  themeJson?: string | undefined;
+  headerBlocksJson?: string | undefined;
+  footerBlocksJson?: string | undefined;
 }
 
 export interface NotificationTemplate {
@@ -439,18 +453,84 @@ export interface RenderPreviewRequest {
   bodyHtml: string;
   variablesJson: string;
   subject?: string | undefined;
-  brandingJson?: string | undefined;
+  brandingJson?:
+    | string
+    | undefined;
+  /**
+   * Блоковий лист (JSON EmailDocument). Якщо заданий — рендеримо його, а
+   * body_html лише запасний шлях, як і при відправці.
+   */
+  contentJson?:
+    | string
+    | undefined;
+  /** Категорія впливає на лист: у масових є посилання «Відписатися». */
+  category?: NotificationCategory | undefined;
+  locale?:
+    | NotificationLocale
+    | undefined;
+  /** Ключ листа — щоб попередити про змінні, яких цей лист не отримає. */
+  templateKey?: string | undefined;
 }
 
 export interface RenderPreviewResponse {
   html: string;
   subject: string;
+  /** Плейн-текстова версія — саме та, що піде в листі. */
+  text: string;
+  /** Попередження (невідома змінна, порожній alt, зламана розмітка тощо). */
+  warnings: string[];
 }
 
 export interface SendTestRequest {
   templateId: string;
   recipient: string;
   variablesJson: string;
+  /**
+   * Незбережений стан редактора. Задані поля замінюють збережені — тестовий
+   * лист показує те, що адмін бачить зараз, а не останнє збереження.
+   */
+  subject?: string | undefined;
+  contentJson?: string | undefined;
+  bodyHtml?: string | undefined;
+  bodyText?: string | undefined;
+}
+
+export interface GetTemplateVariablesRequest {
+  key: string;
+}
+
+export interface TemplateVariable {
+  path: string;
+  label: string;
+  example: string;
+  isList: boolean;
+}
+
+export interface TemplateVariablesResponse {
+  /** event — лист шле система за подією; campaign — лист розсилки. */
+  source: string;
+  trigger: string;
+  variables: TemplateVariable[];
+  /** Приклад значень (JSON) — для попереднього перегляду. */
+  sampleJson: string;
+}
+
+export interface DuplicateTemplateRequest {
+  id: string;
+  newKey: string;
+  locale?: NotificationLocale | undefined;
+  title?: string | undefined;
+  actorId?: string | undefined;
+}
+
+export interface DeleteTemplateRequest {
+  id: string;
+  actorId?: string | undefined;
+}
+
+export interface DeleteTemplateResponse {
+  ok: boolean;
+  errorMessage: string;
 }
 
 export interface SendTestResponse {
@@ -565,6 +645,18 @@ export interface NotificationTemplateServiceClient {
 
   sendTest(request: SendTestRequest): Observable<SendTestResponse>;
 
+  /** Які змінні реально передає система в шаблон із цим ключем + приклад значень. */
+
+  getTemplateVariables(request: GetTemplateVariablesRequest): Observable<TemplateVariablesResponse>;
+
+  /** Копія шаблону під новим ключем і/або мовою (з тілом, блоками й темою). */
+
+  duplicateTemplate(request: DuplicateTemplateRequest): Observable<TemplateResponse>;
+
+  /** Видалення — лише для листів, створених адміном; системні ключі не видаляються. */
+
+  deleteTemplate(request: DeleteTemplateRequest): Observable<DeleteTemplateResponse>;
+
   sendToCustomer(request: SendToCustomerRequest): Observable<SendToCustomerResponse>;
 }
 
@@ -601,6 +693,24 @@ export interface NotificationTemplateServiceController {
 
   sendTest(request: SendTestRequest): Promise<SendTestResponse> | Observable<SendTestResponse> | SendTestResponse;
 
+  /** Які змінні реально передає система в шаблон із цим ключем + приклад значень. */
+
+  getTemplateVariables(
+    request: GetTemplateVariablesRequest,
+  ): Promise<TemplateVariablesResponse> | Observable<TemplateVariablesResponse> | TemplateVariablesResponse;
+
+  /** Копія шаблону під новим ключем і/або мовою (з тілом, блоками й темою). */
+
+  duplicateTemplate(
+    request: DuplicateTemplateRequest,
+  ): Promise<TemplateResponse> | Observable<TemplateResponse> | TemplateResponse;
+
+  /** Видалення — лише для листів, створених адміном; системні ключі не видаляються. */
+
+  deleteTemplate(
+    request: DeleteTemplateRequest,
+  ): Promise<DeleteTemplateResponse> | Observable<DeleteTemplateResponse> | DeleteTemplateResponse;
+
   sendToCustomer(
     request: SendToCustomerRequest,
   ): Promise<SendToCustomerResponse> | Observable<SendToCustomerResponse> | SendToCustomerResponse;
@@ -618,6 +728,9 @@ export function NotificationTemplateServiceControllerMethods() {
       "restoreVersion",
       "renderPreview",
       "sendTest",
+      "getTemplateVariables",
+      "duplicateTemplate",
+      "deleteTemplate",
       "sendToCustomer",
     ];
     for (const method of grpcMethods) {

package/gen/order.ts

@@ -231,6 +231,8 @@ export interface Order {
   saleRecordedAt: number;
   oneCOrderNumber: string;
   oneCOrderDate: string;
+  /** Подію purchase уже відправлено в GA4 (дедуплікація, ТЗ GA4 розділ 8). */
+  analyticsSent: boolean;
 }
 
 export interface CreateOrderRequest {
@@ -239,6 +241,8 @@ export interface CreateOrderRequest {
   guestId: string;
   source: string;
   cartId: string;
+  /** Мова сайту на момент оформлення (uk | ru) — нею йдуть листи й SMS про замовлення. */
+  locale?: string | undefined;
 }
 
 export interface CreateManualOrderRequest {
@@ -252,6 +256,8 @@ export interface CreateManualOrderRequest {
   payment: OrderPayment | undefined;
   promoCode: string;
   comment: string;
+  /** Мова листів покупцю (uk | ru); порожньо — українська. */
+  locale?: string | undefined;
 }
 
 export interface OrderItemInput {
@@ -327,6 +333,17 @@ export interface SetCrmOrderIdRequest {
   crmOrderId: string;
 }
 
+export interface MarkAnalyticsSentRequest {
+  id: string;
+}
+
+export interface MarkAnalyticsSentResponse {
+  ok: boolean;
+  /** Саме цей виклик поставив прапорець. false — його вже було поставлено раніше. */
+  claimed: boolean;
+  errorMessage: string;
+}
+
 export interface MoneyAdjustment {
   id: string;
   orderId: string;
@@ -600,6 +617,13 @@ export interface OrderServiceClient {
 
   setCrmOrderId(request: SetCrmOrderIdRequest): Observable<OrderResponse>;
 
+  /**
+   * GA4 (ТЗ KIPLAR, розділ 8): покупку в аналітику відправлено. Ідемпотентно:
+   * `claimed` = true лише для того виклику, що перевів прапорець false → true.
+   */
+
+  markAnalyticsSent(request: MarkAnalyticsSentRequest): Observable<MarkAnalyticsSentResponse>;
+
   setOneCOrderRef(request: SetOneCOrderRefRequest): Observable<OrderResponse>;
 
   applyOneCStatus(request: ApplyOneCStatusRequest): Observable<OrderResponse>;
@@ -699,6 +723,15 @@ export interface OrderServiceController {
 
   setCrmOrderId(request: SetCrmOrderIdRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
 
+  /**
+   * GA4 (ТЗ KIPLAR, розділ 8): покупку в аналітику відправлено. Ідемпотентно:
+   * `claimed` = true лише для того виклику, що перевів прапорець false → true.
+   */
+
+  markAnalyticsSent(
+    request: MarkAnalyticsSentRequest,
+  ): Promise<MarkAnalyticsSentResponse> | Observable<MarkAnalyticsSentResponse> | MarkAnalyticsSentResponse;
+
   setOneCOrderRef(request: SetOneCOrderRefRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
 
   applyOneCStatus(request: ApplyOneCStatusRequest): Promise<OrderResponse> | Observable<OrderResponse> | OrderResponse;
@@ -789,6 +822,7 @@ export function OrderServiceControllerMethods() {
       "setTrackingNumber",
       "applyRecalculation",
       "setCrmOrderId",
+      "markAnalyticsSent",
       "setOneCOrderRef",
       "applyOneCStatus",
       "listMoneyAdjustments",

package/package.json

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

package/proto/auth.proto

@@ -25,6 +25,8 @@ message LogoutResponse {
 message SendOtpRequest {
   string identifier = 1;
   string type = 2;
+  // Мова сайту (uk | ru) — нею прийде лист/SMS із кодом.
+  optional string locale = 3;
 }
 
 message SendOtpResponse {
@@ -55,6 +57,7 @@ message RegisterRequest {
 message RequestPasswordResetRequest {
   string identifier = 1;
   string type = 2;
+  optional string locale = 3;
 }
 
 message RequestPasswordResetResponse {

package/proto/bonus_settings.proto

@@ -8,7 +8,19 @@ service BonusSettingsService {
 }
 
 message BonusSettingsResponse {
-  double earn_rate = 1;
+  // Формула нарахування (п.17 переліку): кожні `earn_step_uah` гривень ціни
+  // товару дають `earn_per_step_uah` гривень бонусів, і лише для товарів не
+  // дешевших за `earn_min_price_uah`. Ціна береться ПІСЛЯ знижки.
+  //
+  // Поле 1 (`earn_rate`, відсоткова ставка) прибране: формула не відсоткова,
+  // а поле показувало 2% і тим вводило в оману. Номер зарезервовано, щоб його
+  // ніколи не перевикористали під інше значення.
+  reserved 1;
+  reserved "earn_rate";
+
+  double earn_step_uah = 6;
+  double earn_per_step_uah = 7;
+  double earn_min_price_uah = 8;
 
   double redeem_rate = 2;
 
@@ -22,7 +34,12 @@ message BonusSettingsResponse {
 message GetBonusSettingsRequest {}
 
 message UpdateBonusSettingsRequest {
-  optional double earn_rate = 1;
+  reserved 1;
+  reserved "earn_rate";
+
+  optional double earn_step_uah = 6;
+  optional double earn_per_step_uah = 7;
+  optional double earn_min_price_uah = 8;
   optional double redeem_rate = 2;
   optional double min_order_for_earn = 3;
   optional double max_redeem_share = 4;

package/proto/notification.proto

@@ -13,6 +13,13 @@ service NotificationTemplateService {
   rpc RenderPreview(RenderPreviewRequest) returns (RenderPreviewResponse);
   rpc SendTest(SendTestRequest) returns (SendTestResponse);
 
+  // Які змінні реально передає система в шаблон із цим ключем + приклад значень.
+  rpc GetTemplateVariables(GetTemplateVariablesRequest) returns (TemplateVariablesResponse);
+  // Копія шаблону під новим ключем і/або мовою (з тілом, блоками й темою).
+  rpc DuplicateTemplate(DuplicateTemplateRequest) returns (TemplateResponse);
+  // Видалення — лише для листів, створених адміном; системні ключі не видаляються.
+  rpc DeleteTemplate(DeleteTemplateRequest) returns (DeleteTemplateResponse);
+
   rpc SendToCustomer(SendToCustomerRequest) returns (SendToCustomerResponse);
 }
 
@@ -341,6 +348,12 @@ message BrandingProfile {
   string resolved_support_email = 11;
 
   string header_html = 12;
+
+  // Оформлення листа за замовчуванням (JSON EmailTheme) і глобальні шапка й
+  // підвал блоками (JSON EmailBlock[]). Порожній рядок — «як у коді».
+  string theme_json = 13;
+  string header_blocks_json = 14;
+  string footer_blocks_json = 15;
 }
 
 message UpdateBrandingRequest {
@@ -351,6 +364,9 @@ message UpdateBrandingRequest {
   optional string footer_html = 5;
   string actor_id = 6;
   optional string header_html = 7;
+  optional string theme_json = 8;
+  optional string header_blocks_json = 9;
+  optional string footer_blocks_json = 10;
 }
 
 enum NotificationChannel {
@@ -382,6 +398,10 @@ enum NotificationStatus {
   FAILED = 3;
   SIMULATED = 4;
   SUPPRESSED = 5;
+  // Не надіслано: таке саме повідомлення вже пішло раніше (повтор події).
+  DUPLICATE = 6;
+  // Не надіслано: адмін вимкнув шаблон цього листа.
+  DISABLED = 7;
 }
 
 enum TelegramTopic {
@@ -509,11 +529,24 @@ message RenderPreviewRequest {
   optional string subject = 3;
 
   optional string branding_json = 4;
+
+  // Блоковий лист (JSON EmailDocument). Якщо заданий — рендеримо його, а
+  // body_html лише запасний шлях, як і при відправці.
+  optional string content_json = 5;
+  // Категорія впливає на лист: у масових є посилання «Відписатися».
+  optional NotificationCategory category = 6;
+  optional NotificationLocale locale = 7;
+  // Ключ листа — щоб попередити про змінні, яких цей лист не отримає.
+  optional string template_key = 8;
 }
 
 message RenderPreviewResponse {
   string html = 1;
   string subject = 2;
+  // Плейн-текстова версія — саме та, що піде в листі.
+  string text = 3;
+  // Попередження (невідома змінна, порожній alt, зламана розмітка тощо).
+  repeated string warnings = 4;
 }
 
 message SendTestRequest {
@@ -522,6 +555,51 @@ message SendTestRequest {
   string recipient = 2;
 
   string variables_json = 3;
+
+  // Незбережений стан редактора. Задані поля замінюють збережені — тестовий
+  // лист показує те, що адмін бачить зараз, а не останнє збереження.
+  optional string subject = 4;
+  optional string content_json = 5;
+  optional string body_html = 6;
+  optional string body_text = 7;
+}
+
+message GetTemplateVariablesRequest {
+  string key = 1;
+}
+
+message TemplateVariable {
+  string path = 1;
+  string label = 2;
+  string example = 3;
+  bool is_list = 4;
+}
+
+message TemplateVariablesResponse {
+  // event — лист шле система за подією; campaign — лист розсилки.
+  string source = 1;
+  string trigger = 2;
+  repeated TemplateVariable variables = 3;
+  // Приклад значень (JSON) — для попереднього перегляду.
+  string sample_json = 4;
+}
+
+message DuplicateTemplateRequest {
+  string id = 1;
+  string new_key = 2;
+  optional NotificationLocale locale = 3;
+  optional string title = 4;
+  optional string actor_id = 5;
+}
+
+message DeleteTemplateRequest {
+  string id = 1;
+  optional string actor_id = 2;
+}
+
+message DeleteTemplateResponse {
+  bool ok = 1;
+  string error_message = 2;
 }
 
 message SendTestResponse {

package/proto/order.proto

@@ -30,6 +30,10 @@ service OrderService {
 
   rpc SetCrmOrderId(SetCrmOrderIdRequest) returns (OrderResponse);
 
+  // GA4 (ТЗ KIPLAR, розділ 8): покупку в аналітику відправлено. Ідемпотентно:
+  // `claimed` = true лише для того виклику, що перевів прапорець false → true.
+  rpc MarkAnalyticsSent(MarkAnalyticsSentRequest) returns (MarkAnalyticsSentResponse);
+
 
   rpc SetOneCOrderRef(SetOneCOrderRefRequest) returns (OrderResponse);
 
@@ -308,6 +312,9 @@ message Order {
   string one_c_order_number = 28;
 
   string one_c_order_date = 29;
+
+  // Подію purchase уже відправлено в GA4 (дедуплікація, ТЗ GA4 розділ 8).
+  bool analytics_sent = 30;
 }
 
 message CreateOrderRequest {
@@ -316,6 +323,8 @@ message CreateOrderRequest {
   string guest_id = 3;
   string source = 4;
   string cart_id = 5;
+  // Мова сайту на момент оформлення (uk | ru) — нею йдуть листи й SMS про замовлення.
+  optional string locale = 6;
 }
 
 message CreateManualOrderRequest {
@@ -331,6 +340,8 @@ message CreateManualOrderRequest {
 
   string promo_code = 9;
   string comment = 10;
+  // Мова листів покупцю (uk | ru); порожньо — українська.
+  optional string locale = 11;
 }
 
 message OrderItemInput {
@@ -414,6 +425,17 @@ message SetCrmOrderIdRequest {
   string crm_order_id = 2;
 }
 
+message MarkAnalyticsSentRequest {
+  string id = 1;
+}
+
+message MarkAnalyticsSentResponse {
+  bool ok = 1;
+  // Саме цей виклик поставив прапорець. false — його вже було поставлено раніше.
+  bool claimed = 2;
+  string error_message = 3;
+}
+
 
 
 message MoneyAdjustment {