@mamindom/contracts 1.0.126 → 1.0.129

package/dist/gen/cart.d.ts

@@ -57,6 +57,11 @@ export interface DeliveryDraft {
     pickupPointId: string;
     cost: number;
     freeShipping: boolean;
+    /**
+     * Область з City.region — клієнт передає при виборі міста, щоб
+     * потім order-service зміг записати в snapshot замовлення.
+     */
+    region: string;
 }
 export interface PaymentDraft {
     provider: string;

package/dist/gen/manager.d.ts

@@ -28,6 +28,9 @@ export interface ListManagersResponse {
 export interface GetManagerRequest {
     id: string;
 }
+export interface GetManagerByAccountRequest {
+    accountId: string;
+}
 export interface CreateManagerRequest {
     accountId: string;
     displayName?: string | undefined;
@@ -77,6 +80,12 @@ export declare const MANAGER_V1_PACKAGE_NAME = "manager.v1";
 export interface ManagerServiceClient {
     listManagers(request: ListManagersRequest): Observable<ListManagersResponse>;
     getManager(request: GetManagerRequest): Observable<ManagerProfileDto>;
+    /**
+     * Резолв account_id (з auth-service) → ManagerProfile. Використовується
+     * у gateway щоб з'ясувати ManagerProfile.id для логіну-під-менеджером —
+     * order.managerId зберігає ManagerProfile.id, а не Account.id.
+     */
+    getManagerByAccount(request: GetManagerByAccountRequest): Observable<ManagerProfileDto>;
     createManager(request: CreateManagerRequest): Observable<ManagerProfileDto>;
     updateManager(request: UpdateManagerRequest): Observable<ManagerProfileDto>;
     setManagerActive(request: SetManagerActiveRequest): Observable<ManagerProfileDto>;
@@ -89,6 +98,12 @@ export interface ManagerServiceClient {
 export interface ManagerServiceController {
     listManagers(request: ListManagersRequest): Promise<ListManagersResponse> | Observable<ListManagersResponse> | ListManagersResponse;
     getManager(request: GetManagerRequest): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;
+    /**
+     * Резолв account_id (з auth-service) → ManagerProfile. Використовується
+     * у gateway щоб з'ясувати ManagerProfile.id для логіну-під-менеджером —
+     * order.managerId зберігає ManagerProfile.id, а не Account.id.
+     */
+    getManagerByAccount(request: GetManagerByAccountRequest): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;
     createManager(request: CreateManagerRequest): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;
     updateManager(request: UpdateManagerRequest): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;
     setManagerActive(request: SetManagerActiveRequest): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;

package/dist/gen/manager.js

@@ -16,6 +16,7 @@ function ManagerServiceControllerMethods() {
         const grpcMethods = [
             "listManagers",
             "getManager",
+            "getManagerByAccount",
             "createManager",
             "updateManager",
             "setManagerActive",

package/dist/gen/notification.d.ts

@@ -44,6 +44,38 @@ export declare enum TelegramTopic {
     GENERAL = 9,
     UNRECOGNIZED = -1
 }
+export interface BrandingEmpty {
+}
+/**
+ * Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
+ * "взяти fallback з env" при наступному GET.
+ */
+export interface BrandingProfile {
+    logoUrl: string;
+    brandName: string;
+    brandUrl: string;
+    supportEmail: string;
+    footerHtml: string;
+    updatedAt: number;
+    updatedBy: string;
+    /**
+     * resolved: остаточні значення, що використовуються wrapper'ом
+     * (DB override → env fallback). Для UI щоб показати "поточне значення".
+     */
+    resolvedLogoUrl: string;
+    resolvedBrandName: string;
+    resolvedBrandUrl: string;
+    resolvedSupportEmail: string;
+}
+export interface UpdateBrandingRequest {
+    /** optional: відсутність → не оновлювати; порожній рядок → скинути до NULL у БД. */
+    logoUrl?: string | undefined;
+    brandName?: string | undefined;
+    brandUrl?: string | undefined;
+    supportEmail?: string | undefined;
+    footerHtml?: string | undefined;
+    actorId: string;
+}
 export interface NotificationTemplate {
     id: string;
     key: string;
@@ -277,3 +309,15 @@ export interface TelegramChatsServiceController {
 }
 export declare function TelegramChatsServiceControllerMethods(): (constructor: Function) => void;
 export declare const TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
+/** Брендинг email-шаблонів — singleton редагується адміном. */
+export interface BrandingServiceClient {
+    getBranding(request: BrandingEmpty): Observable<BrandingProfile>;
+    updateBranding(request: UpdateBrandingRequest): Observable<BrandingProfile>;
+}
+/** Брендинг email-шаблонів — singleton редагується адміном. */
+export interface BrandingServiceController {
+    getBranding(request: BrandingEmpty): Promise<BrandingProfile> | Observable<BrandingProfile> | BrandingProfile;
+    updateBranding(request: UpdateBrandingRequest): Promise<BrandingProfile> | Observable<BrandingProfile> | BrandingProfile;
+}
+export declare function BrandingServiceControllerMethods(): (constructor: Function) => void;
+export declare const BRANDING_SERVICE_NAME = "BrandingService";

package/dist/gen/notification.js

@@ -5,10 +5,11 @@
 //   protoc               v3.21.12
 // source: notification.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TELEGRAM_CHATS_SERVICE_NAME = exports.NOTIFICATION_LOGS_SERVICE_NAME = exports.NOTIFICATION_TEMPLATE_SERVICE_NAME = exports.NOTIFICATION_V1_PACKAGE_NAME = exports.TelegramTopic = exports.NotificationStatus = exports.NotificationCategory = exports.NotificationLocale = exports.NotificationChannel = exports.protobufPackage = void 0;
+exports.BRANDING_SERVICE_NAME = exports.TELEGRAM_CHATS_SERVICE_NAME = exports.NOTIFICATION_LOGS_SERVICE_NAME = exports.NOTIFICATION_TEMPLATE_SERVICE_NAME = exports.NOTIFICATION_V1_PACKAGE_NAME = exports.TelegramTopic = exports.NotificationStatus = exports.NotificationCategory = exports.NotificationLocale = exports.NotificationChannel = exports.protobufPackage = void 0;
 exports.NotificationTemplateServiceControllerMethods = NotificationTemplateServiceControllerMethods;
 exports.NotificationLogsServiceControllerMethods = NotificationLogsServiceControllerMethods;
 exports.TelegramChatsServiceControllerMethods = TelegramChatsServiceControllerMethods;
+exports.BrandingServiceControllerMethods = BrandingServiceControllerMethods;
 /* eslint-disable */
 const microservices_1 = require("@nestjs/microservices");
 exports.protobufPackage = "notification.v1";
@@ -117,3 +118,18 @@ function TelegramChatsServiceControllerMethods() {
     };
 }
 exports.TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
+function BrandingServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = ["getBranding", "updateBranding"];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("BrandingService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("BrandingService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.BRANDING_SERVICE_NAME = "BrandingService";

package/dist/gen/order.d.ts

@@ -33,6 +33,11 @@ export interface OrderDelivery {
     trackingUrl: string;
     estimatedDate: string;
     shipmentStatus: string;
+    /**
+     * Адмін-облік: область/регіон з City.region від delivery-service.
+     * Старі замовлення можуть мати порожнє значення.
+     */
+    region: string;
 }
 export interface OrderPayment {
     provider: string;
@@ -45,6 +50,12 @@ export interface OrderPayment {
     capturedAt: number;
     cancelledAt: number;
     refundedAt: number;
+    /**
+     * Денормалізовано з payment-service для відображення в адмінці
+     * без додаткового gRPC дзвінка. Оновлюється з payment-events listener.
+     */
+    capturedAmount: number;
+    refundedAmount: number;
 }
 export interface OrderNote {
     id: string;
@@ -106,6 +117,11 @@ export interface Order {
     tags: string[];
     createdAt: number;
     updatedAt: number;
+    /**
+     * Внутрішні нотатки менеджерів (видимі тільки в адмінці).
+     * Сортуються від новіших до старіших — server-side.
+     */
+    notes: OrderNote[];
 }
 export interface CreateOrderRequest {
     idempotencyKey: string;

package/dist/gen/payment.d.ts

@@ -87,6 +87,10 @@ export interface RefundRequest {
 export interface SyncStatusRequest {
     id: string;
 }
+export interface RegenerateInvoiceRequest {
+    id: string;
+    actorId: string;
+}
 export interface ListProvidersRequest {
     onlyEnabled: boolean;
 }
@@ -122,6 +126,12 @@ export interface PaymentServiceClient {
     refund(request: RefundRequest): Observable<PaymentResponse>;
     /** SyncStatus — підтягує актуальний статус від провайдера (manual reconciliation). */
     syncStatus(request: SyncStatusRequest): Observable<PaymentResponse>;
+    /**
+     * RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
+     * Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
+     * загубив SMS — менеджер ділиться новим лінком через адмін UI.
+     */
+    regenerateInvoice(request: RegenerateInvoiceRequest): Observable<PaymentResponse>;
     listProviders(request: ListProvidersRequest): Observable<ListProvidersResponse>;
     toggleProvider(request: ToggleProviderRequest): Observable<ToggleProviderResponse>;
 }
@@ -139,6 +149,12 @@ export interface PaymentServiceController {
     refund(request: RefundRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
     /** SyncStatus — підтягує актуальний статус від провайдера (manual reconciliation). */
     syncStatus(request: SyncStatusRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
+    /**
+     * RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
+     * Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
+     * загубив SMS — менеджер ділиться новим лінком через адмін UI.
+     */
+    regenerateInvoice(request: RegenerateInvoiceRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
     listProviders(request: ListProvidersRequest): Promise<ListProvidersResponse> | Observable<ListProvidersResponse> | ListProvidersResponse;
     toggleProvider(request: ToggleProviderRequest): Promise<ToggleProviderResponse> | Observable<ToggleProviderResponse> | ToggleProviderResponse;
 }

package/dist/gen/payment.js

@@ -22,6 +22,7 @@ function PaymentServiceControllerMethods() {
             "cancel",
             "refund",
             "syncStatus",
+            "regenerateInvoice",
             "listProviders",
             "toggleProvider",
         ];

package/dist/proto/cart.proto

@@ -100,6 +100,9 @@ message DeliveryDraft {
   string pickup_point_id = 7;
   double cost          = 8;
   bool   free_shipping = 9;
+  // Область з City.region — клієнт передає при виборі міста, щоб
+  // потім order-service зміг записати в snapshot замовлення.
+  string region        = 10;
 }
 
 message PaymentDraft {

package/dist/proto/manager.proto

@@ -5,6 +5,10 @@ package manager.v1;
 service ManagerService {
   rpc ListManagers(ListManagersRequest) returns (ListManagersResponse);
   rpc GetManager(GetManagerRequest) returns (ManagerProfileDto);
+  // Резолв account_id (з auth-service) → ManagerProfile. Використовується
+  // у gateway щоб з'ясувати ManagerProfile.id для логіну-під-менеджером —
+  // order.managerId зберігає ManagerProfile.id, а не Account.id.
+  rpc GetManagerByAccount(GetManagerByAccountRequest) returns (ManagerProfileDto);
   rpc CreateManager(CreateManagerRequest) returns (ManagerProfileDto);
   rpc UpdateManager(UpdateManagerRequest) returns (ManagerProfileDto);
   rpc SetManagerActive(SetManagerActiveRequest) returns (ManagerProfileDto);
@@ -44,6 +48,8 @@ message ListManagersResponse {
 
 message GetManagerRequest { string id = 1; }
 
+message GetManagerByAccountRequest { string account_id = 1; }
+
 message CreateManagerRequest {
   string account_id                     = 1;
   optional string display_name          = 2;

package/dist/proto/notification.proto

@@ -29,6 +29,42 @@ service TelegramChatsService {
   rpc TestSendTelegram (TestSendTelegramRequest) returns (TestSendTelegramResponse);
 }
 
+// Брендинг email-шаблонів — singleton редагується адміном.
+service BrandingService {
+  rpc GetBranding    (BrandingEmpty)         returns (BrandingProfile);
+  rpc UpdateBranding (UpdateBrandingRequest) returns (BrandingProfile);
+}
+
+message BrandingEmpty {}
+
+// Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
+// "взяти fallback з env" при наступному GET.
+message BrandingProfile {
+  string logo_url      = 1;
+  string brand_name    = 2;
+  string brand_url     = 3;
+  string support_email = 4;
+  string footer_html   = 5;
+  int64  updated_at    = 6;
+  string updated_by    = 7;
+  // resolved: остаточні значення, що використовуються wrapper'ом
+  // (DB override → env fallback). Для UI щоб показати "поточне значення".
+  string resolved_logo_url      = 8;
+  string resolved_brand_name    = 9;
+  string resolved_brand_url     = 10;
+  string resolved_support_email = 11;
+}
+
+message UpdateBrandingRequest {
+  // optional: відсутність → не оновлювати; порожній рядок → скинути до NULL у БД.
+  optional string logo_url      = 1;
+  optional string brand_name    = 2;
+  optional string brand_url     = 3;
+  optional string support_email = 4;
+  optional string footer_html   = 5;
+  string actor_id               = 6;
+}
+
 
 enum NotificationChannel {
   NOTIFICATION_CHANNEL_UNSPECIFIED = 0;

package/dist/proto/order.proto

@@ -69,6 +69,9 @@ message OrderDelivery {
   string tracking_url    = 10;
   string estimated_date  = 11;
   string shipment_status = 12;
+  // Адмін-облік: область/регіон з City.region від delivery-service.
+  // Старі замовлення можуть мати порожнє значення.
+  string region          = 13;
 }
 
 message OrderPayment {
@@ -82,6 +85,10 @@ message OrderPayment {
   int64  captured_at          = 8;
   int64  cancelled_at         = 9;
   int64  refunded_at          = 10;
+  // Денормалізовано з payment-service для відображення в адмінці
+  // без додаткового gRPC дзвінка. Оновлюється з payment-events listener.
+  double captured_amount      = 11;
+  double refunded_amount      = 12;
 }
 
 message OrderNote {
@@ -153,6 +160,10 @@ message Order {
 
   int64  created_at = 20;
   int64  updated_at = 21;
+
+  // Внутрішні нотатки менеджерів (видимі тільки в адмінці).
+  // Сортуються від новіших до старіших — server-side.
+  repeated OrderNote notes = 22;
 }
 
 // ─── Requests ──────────────────────────────────────────────────

package/dist/proto/payment.proto

@@ -20,6 +20,11 @@ service PaymentService {
   // SyncStatus — підтягує актуальний статус від провайдера (manual reconciliation).
   rpc SyncStatus(SyncStatusRequest) returns (PaymentResponse);
 
+  // RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
+  // Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
+  // загубив SMS — менеджер ділиться новим лінком через адмін UI.
+  rpc RegenerateInvoice(RegenerateInvoiceRequest) returns (PaymentResponse);
+
   rpc ListProviders(ListProvidersRequest) returns (ListProvidersResponse);
   rpc ToggleProvider(ToggleProviderRequest) returns (ToggleProviderResponse);
 }
@@ -127,6 +132,11 @@ message SyncStatusRequest {
   string id = 1;
 }
 
+message RegenerateInvoiceRequest {
+  string id       = 1;
+  string actor_id = 2;
+}
+
 message ListProvidersRequest {
   bool only_enabled = 1;
 }

package/gen/cart.ts

@@ -73,6 +73,11 @@ export interface DeliveryDraft {
   pickupPointId: string;
   cost: number;
   freeShipping: boolean;
+  /**
+   * Область з City.region — клієнт передає при виборі міста, щоб
+   * потім order-service зміг записати в snapshot замовлення.
+   */
+  region: string;
 }
 
 export interface PaymentDraft {

package/gen/manager.ts

@@ -43,6 +43,10 @@ export interface GetManagerRequest {
   id: string;
 }
 
+export interface GetManagerByAccountRequest {
+  accountId: string;
+}
+
 export interface CreateManagerRequest {
   accountId: string;
   displayName?: string | undefined;
@@ -108,6 +112,14 @@ export interface ManagerServiceClient {
 
   getManager(request: GetManagerRequest): Observable<ManagerProfileDto>;
 
+  /**
+   * Резолв account_id (з auth-service) → ManagerProfile. Використовується
+   * у gateway щоб з'ясувати ManagerProfile.id для логіну-під-менеджером —
+   * order.managerId зберігає ManagerProfile.id, а не Account.id.
+   */
+
+  getManagerByAccount(request: GetManagerByAccountRequest): Observable<ManagerProfileDto>;
+
   createManager(request: CreateManagerRequest): Observable<ManagerProfileDto>;
 
   updateManager(request: UpdateManagerRequest): Observable<ManagerProfileDto>;
@@ -134,6 +146,16 @@ export interface ManagerServiceController {
     request: GetManagerRequest,
   ): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;
 
+  /**
+   * Резолв account_id (з auth-service) → ManagerProfile. Використовується
+   * у gateway щоб з'ясувати ManagerProfile.id для логіну-під-менеджером —
+   * order.managerId зберігає ManagerProfile.id, а не Account.id.
+   */
+
+  getManagerByAccount(
+    request: GetManagerByAccountRequest,
+  ): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;
+
   createManager(
     request: CreateManagerRequest,
   ): Promise<ManagerProfileDto> | Observable<ManagerProfileDto> | ManagerProfileDto;
@@ -168,6 +190,7 @@ export function ManagerServiceControllerMethods() {
     const grpcMethods: string[] = [
       "listManagers",
       "getManager",
+      "getManagerByAccount",
       "createManager",
       "updateManager",
       "setManagerActive",

package/gen/notification.ts

@@ -59,6 +59,41 @@ export enum TelegramTopic {
   UNRECOGNIZED = -1,
 }
 
+export interface BrandingEmpty {
+}
+
+/**
+ * Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
+ * "взяти fallback з env" при наступному GET.
+ */
+export interface BrandingProfile {
+  logoUrl: string;
+  brandName: string;
+  brandUrl: string;
+  supportEmail: string;
+  footerHtml: string;
+  updatedAt: number;
+  updatedBy: string;
+  /**
+   * resolved: остаточні значення, що використовуються wrapper'ом
+   * (DB override → env fallback). Для UI щоб показати "поточне значення".
+   */
+  resolvedLogoUrl: string;
+  resolvedBrandName: string;
+  resolvedBrandUrl: string;
+  resolvedSupportEmail: string;
+}
+
+export interface UpdateBrandingRequest {
+  /** optional: відсутність → не оновлювати; порожній рядок → скинути до NULL у БД. */
+  logoUrl?: string | undefined;
+  brandName?: string | undefined;
+  brandUrl?: string | undefined;
+  supportEmail?: string | undefined;
+  footerHtml?: string | undefined;
+  actorId: string;
+}
+
 export interface NotificationTemplate {
   id: string;
   key: string;
@@ -425,3 +460,38 @@ export function TelegramChatsServiceControllerMethods() {
 }
 
 export const TELEGRAM_CHATS_SERVICE_NAME = "TelegramChatsService";
+
+/** Брендинг email-шаблонів — singleton редагується адміном. */
+
+export interface BrandingServiceClient {
+  getBranding(request: BrandingEmpty): Observable<BrandingProfile>;
+
+  updateBranding(request: UpdateBrandingRequest): Observable<BrandingProfile>;
+}
+
+/** Брендинг email-шаблонів — singleton редагується адміном. */
+
+export interface BrandingServiceController {
+  getBranding(request: BrandingEmpty): Promise<BrandingProfile> | Observable<BrandingProfile> | BrandingProfile;
+
+  updateBranding(
+    request: UpdateBrandingRequest,
+  ): Promise<BrandingProfile> | Observable<BrandingProfile> | BrandingProfile;
+}
+
+export function BrandingServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["getBranding", "updateBranding"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("BrandingService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("BrandingService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const BRANDING_SERVICE_NAME = "BrandingService";

package/gen/order.ts

@@ -45,6 +45,11 @@ export interface OrderDelivery {
   trackingUrl: string;
   estimatedDate: string;
   shipmentStatus: string;
+  /**
+   * Адмін-облік: область/регіон з City.region від delivery-service.
+   * Старі замовлення можуть мати порожнє значення.
+   */
+  region: string;
 }
 
 export interface OrderPayment {
@@ -58,6 +63,12 @@ export interface OrderPayment {
   capturedAt: number;
   cancelledAt: number;
   refundedAt: number;
+  /**
+   * Денормалізовано з payment-service для відображення в адмінці
+   * без додаткового gRPC дзвінка. Оновлюється з payment-events listener.
+   */
+  capturedAmount: number;
+  refundedAmount: number;
 }
 
 export interface OrderNote {
@@ -125,6 +136,11 @@ export interface Order {
   tags: string[];
   createdAt: number;
   updatedAt: number;
+  /**
+   * Внутрішні нотатки менеджерів (видимі тільки в адмінці).
+   * Сортуються від новіших до старіших — server-side.
+   */
+  notes: OrderNote[];
 }
 
 export interface CreateOrderRequest {

package/gen/payment.ts

@@ -109,6 +109,11 @@ export interface SyncStatusRequest {
   id: string;
 }
 
+export interface RegenerateInvoiceRequest {
+  id: string;
+  actorId: string;
+}
+
 export interface ListProvidersRequest {
   onlyEnabled: boolean;
 }
@@ -163,6 +168,14 @@ export interface PaymentServiceClient {
 
   syncStatus(request: SyncStatusRequest): Observable<PaymentResponse>;
 
+  /**
+   * RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
+   * Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
+   * загубив SMS — менеджер ділиться новим лінком через адмін UI.
+   */
+
+  regenerateInvoice(request: RegenerateInvoiceRequest): Observable<PaymentResponse>;
+
   listProviders(request: ListProvidersRequest): Observable<ListProvidersResponse>;
 
   toggleProvider(request: ToggleProviderRequest): Observable<ToggleProviderResponse>;
@@ -201,6 +214,16 @@ export interface PaymentServiceController {
 
   syncStatus(request: SyncStatusRequest): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
 
+  /**
+   * RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
+   * Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
+   * загубив SMS — менеджер ділиться новим лінком через адмін UI.
+   */
+
+  regenerateInvoice(
+    request: RegenerateInvoiceRequest,
+  ): Promise<PaymentResponse> | Observable<PaymentResponse> | PaymentResponse;
+
   listProviders(
     request: ListProvidersRequest,
   ): Promise<ListProvidersResponse> | Observable<ListProvidersResponse> | ListProvidersResponse;
@@ -221,6 +244,7 @@ export function PaymentServiceControllerMethods() {
       "cancel",
       "refund",
       "syncStatus",
+      "regenerateInvoice",
       "listProviders",
       "toggleProvider",
     ];

package/package.json

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

package/proto/cart.proto

@@ -100,6 +100,9 @@ message DeliveryDraft {
   string pickup_point_id = 7;
   double cost          = 8;
   bool   free_shipping = 9;
+  // Область з City.region — клієнт передає при виборі міста, щоб
+  // потім order-service зміг записати в snapshot замовлення.
+  string region        = 10;
 }
 
 message PaymentDraft {

package/proto/manager.proto

@@ -5,6 +5,10 @@ package manager.v1;
 service ManagerService {
   rpc ListManagers(ListManagersRequest) returns (ListManagersResponse);
   rpc GetManager(GetManagerRequest) returns (ManagerProfileDto);
+  // Резолв account_id (з auth-service) → ManagerProfile. Використовується
+  // у gateway щоб з'ясувати ManagerProfile.id для логіну-під-менеджером —
+  // order.managerId зберігає ManagerProfile.id, а не Account.id.
+  rpc GetManagerByAccount(GetManagerByAccountRequest) returns (ManagerProfileDto);
   rpc CreateManager(CreateManagerRequest) returns (ManagerProfileDto);
   rpc UpdateManager(UpdateManagerRequest) returns (ManagerProfileDto);
   rpc SetManagerActive(SetManagerActiveRequest) returns (ManagerProfileDto);
@@ -44,6 +48,8 @@ message ListManagersResponse {
 
 message GetManagerRequest { string id = 1; }
 
+message GetManagerByAccountRequest { string account_id = 1; }
+
 message CreateManagerRequest {
   string account_id                     = 1;
   optional string display_name          = 2;

package/proto/notification.proto

@@ -29,6 +29,42 @@ service TelegramChatsService {
   rpc TestSendTelegram (TestSendTelegramRequest) returns (TestSendTelegramResponse);
 }
 
+// Брендинг email-шаблонів — singleton редагується адміном.
+service BrandingService {
+  rpc GetBranding    (BrandingEmpty)         returns (BrandingProfile);
+  rpc UpdateBranding (UpdateBrandingRequest) returns (BrandingProfile);
+}
+
+message BrandingEmpty {}
+
+// Поля що поверталися з resolved-merge (DB ∪ env). Порожні рядки означають
+// "взяти fallback з env" при наступному GET.
+message BrandingProfile {
+  string logo_url      = 1;
+  string brand_name    = 2;
+  string brand_url     = 3;
+  string support_email = 4;
+  string footer_html   = 5;
+  int64  updated_at    = 6;
+  string updated_by    = 7;
+  // resolved: остаточні значення, що використовуються wrapper'ом
+  // (DB override → env fallback). Для UI щоб показати "поточне значення".
+  string resolved_logo_url      = 8;
+  string resolved_brand_name    = 9;
+  string resolved_brand_url     = 10;
+  string resolved_support_email = 11;
+}
+
+message UpdateBrandingRequest {
+  // optional: відсутність → не оновлювати; порожній рядок → скинути до NULL у БД.
+  optional string logo_url      = 1;
+  optional string brand_name    = 2;
+  optional string brand_url     = 3;
+  optional string support_email = 4;
+  optional string footer_html   = 5;
+  string actor_id               = 6;
+}
+
 
 enum NotificationChannel {
   NOTIFICATION_CHANNEL_UNSPECIFIED = 0;

package/proto/order.proto

@@ -69,6 +69,9 @@ message OrderDelivery {
   string tracking_url    = 10;
   string estimated_date  = 11;
   string shipment_status = 12;
+  // Адмін-облік: область/регіон з City.region від delivery-service.
+  // Старі замовлення можуть мати порожнє значення.
+  string region          = 13;
 }
 
 message OrderPayment {
@@ -82,6 +85,10 @@ message OrderPayment {
   int64  captured_at          = 8;
   int64  cancelled_at         = 9;
   int64  refunded_at          = 10;
+  // Денормалізовано з payment-service для відображення в адмінці
+  // без додаткового gRPC дзвінка. Оновлюється з payment-events listener.
+  double captured_amount      = 11;
+  double refunded_amount      = 12;
 }
 
 message OrderNote {
@@ -153,6 +160,10 @@ message Order {
 
   int64  created_at = 20;
   int64  updated_at = 21;
+
+  // Внутрішні нотатки менеджерів (видимі тільки в адмінці).
+  // Сортуються від новіших до старіших — server-side.
+  repeated OrderNote notes = 22;
 }
 
 // ─── Requests ──────────────────────────────────────────────────

package/proto/payment.proto

@@ -20,6 +20,11 @@ service PaymentService {
   // SyncStatus — підтягує актуальний статус від провайдера (manual reconciliation).
   rpc SyncStatus(SyncStatusRequest) returns (PaymentResponse);
 
+  // RegenerateInvoice — створює новий invoice у провайдера для існуючого Payment.
+  // Використовується коли paymentUrl застарів (TTL у Mono ≈ 24г) або клієнт
+  // загубив SMS — менеджер ділиться новим лінком через адмін UI.
+  rpc RegenerateInvoice(RegenerateInvoiceRequest) returns (PaymentResponse);
+
   rpc ListProviders(ListProvidersRequest) returns (ListProvidersResponse);
   rpc ToggleProvider(ToggleProviderRequest) returns (ToggleProviderResponse);
 }
@@ -127,6 +132,11 @@ message SyncStatusRequest {
   string id = 1;
 }
 
+message RegenerateInvoiceRequest {
+  string id       = 1;
+  string actor_id = 2;
+}
+
 message ListProvidersRequest {
   bool only_enabled = 1;
 }