@aepstore-dev/contracts 1.63.0 → 1.64.0

package/proto/support.proto

@@ -1,144 +1,170 @@
-syntax = "proto3";
-
-package support.v1;
-
-// Support ticket system (G1). Enums as strings matching the DB
-// (status OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED; category/priority).
-service SupportService {
-    rpc Ping(PingRequest) returns (PingResponse); // health
-
-    // user
-    rpc CreateTicket(CreateTicketRequest) returns (Ticket);
-    rpc GetTicket(GetTicketRequest) returns (TicketWithMessages);
-    rpc ListMyTickets(ListMyTicketsRequest) returns (TicketsListResponse);
-    rpc ReplyTicket(ReplyTicketRequest) returns (TicketMessage);
-    rpc CloseTicket(CloseTicketRequest) returns (Ticket);
-
-    // staff/admin
-    rpc ListTickets(ListTicketsRequest) returns (TicketsListResponse);
-    rpc AssignTicket(AssignTicketRequest) returns (Ticket);
-    rpc SetTicketStatus(SetTicketStatusRequest) returns (Ticket);
-    rpc DeleteTicket(DeleteTicketRequest) returns (Ticket);
-}
-
-message PingRequest { string message = 1; }
-message PingResponse { bool ok = 1; string message = 2; }
-
-message Ticket {
-    string id = 1;
-    string author_id = 2;
-    string subject = 3;
-    string category = 4;     // GENERAL|PAYMENT|WITHDRAWAL|PRODUCT|ACCOUNT|ABUSE|OTHER
-    string status = 5;       // OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED
-    string priority = 6;     // LOW|NORMAL|HIGH|URGENT
-    string purchase_id = 7;
-    string withdrawal_id = 8;
-    string assignee_id = 9;
-    string last_message_at = 10;
-    string created_at = 11;
-    string updated_at = 12;
-    int32 messages_count = 13;
-    string department = 14;          // GENERAL|TECHNICAL|SALES
-    string product_category_id = 15; // optional
-    string related_product_id = 16; // optional
-    string related_product_type = 17; // PURCHASED|SELLING
-    bool rules_accepted = 18;
-    string rules_accepted_at = 19;
-    string deleted_at = 20;
-}
-
-message TicketMessage {
-    string id = 1;
-    string ticket_id = 2;
-    string author_id = 3;
-    string body = 4;
-    bool is_staff = 5;
-    bool is_internal = 6;
-    string created_at = 7;
-}
-
-message TicketWithMessages {
-    Ticket ticket = 1;
-    repeated TicketMessage messages = 2;
-}
-
-message CreateTicketRequest {
-    string author_id = 1;
-    string subject = 2;
-    string category = 3;
-    string body = 4;            // first message
-    string purchase_id = 5;     // optional
-    string withdrawal_id = 6;   // optional
-    string priority = 7;        // LOW|NORMAL|HIGH|URGENT
-    string department = 8;      // GENERAL|TECHNICAL|SALES
-    string product_category_id = 9; // optional
-    string related_product_id = 10; // optional
-    string related_product_type = 11; // PURCHASED|SELLING
-    bool rules_accepted = 12;
-}
-
-message GetTicketRequest {
-    string id = 1;
-    string requester_id = 2;
-    bool is_staff = 3; // staff see internal notes + any ticket
-}
-
-message ListMyTicketsRequest {
-    string author_id = 1;
-    string status = 2;          // single value OR comma-separated (e.g. "OPEN,PENDING,IN_PROGRESS")
-    int32 page = 3;
-    int32 limit = 4;
-    string department = 5;      // GENERAL|TECHNICAL|SALES
-    string category = 6;        // GENERAL|PAYMENT|...
-    string search = 7;          // contains in subject OR in any message body
-    string date_from = 8;       // ISO; inclusive lower bound on createdAt
-    string date_to = 9;         // ISO; inclusive upper bound on createdAt
-}
-
-message ReplyTicketRequest {
-    string ticket_id = 1;
-    string author_id = 2;
-    string body = 3;
-    bool is_staff = 4;
-    bool is_internal = 5; // staff-only note
-}
-
-message CloseTicketRequest {
-    string ticket_id = 1;
-    string requester_id = 2;
-    bool is_staff = 3;
-}
-
-message ListTicketsRequest {
-    string status = 1;          // single value OR comma-separated
-    string category = 2;
-    string assignee_id = 3;
-    int32 page = 4;
-    int32 limit = 5;
-    string department = 6;
-    string search = 7;          // contains in subject OR in any message body
-    string date_from = 8;       // ISO; inclusive lower bound on createdAt
-    string date_to = 9;
-}
-
-message AssignTicketRequest {
-    string ticket_id = 1;
-    string assignee_id = 2; // empty = unassign
-    string admin_id = 3;
-}
-
-message SetTicketStatusRequest {
-    string ticket_id = 1;
-    string status = 2;
-    string admin_id = 3;
-}
-message DeleteTicketRequest {
-    string ticket_id = 1;
-    string admin_id = 2;
-}
-message TicketsListResponse {
-    repeated Ticket items = 1;
-    int32 total = 2;
-    int32 page = 3;
-    int32 limit = 4;
-}
+syntax = "proto3";
+
+package support.v1;
+
+// Support ticket system (G1). Enums as strings matching the DB
+// (status OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED; category/priority).
+service SupportService {
+    rpc Ping(PingRequest) returns (PingResponse); // health
+
+    // user
+    rpc CreateTicket(CreateTicketRequest) returns (Ticket);
+    rpc GetTicket(GetTicketRequest) returns (TicketWithMessages);
+    rpc ListMyTickets(ListMyTicketsRequest) returns (TicketsListResponse);
+    rpc ReplyTicket(ReplyTicketRequest) returns (TicketMessage);
+    rpc CloseTicket(CloseTicketRequest) returns (Ticket);
+
+    // staff/admin
+    rpc ListTickets(ListTicketsRequest) returns (TicketsListResponse);
+    rpc AssignTicket(AssignTicketRequest) returns (Ticket);
+    rpc SetTicketStatus(SetTicketStatusRequest) returns (Ticket);
+    rpc DeleteTicket(DeleteTicketRequest) returns (Ticket);
+    rpc UpdateTicketMessage(UpdateTicketMessageRequest) returns (TicketMessage);
+    rpc DeleteTicketMessage(DeleteTicketMessageRequest) returns (TicketMessage);
+}
+
+message PingRequest { string message = 1; }
+message PingResponse { bool ok = 1; string message = 2; }
+
+message Ticket {
+    string id = 1;
+    string author_id = 2;
+    string subject = 3;
+    string category = 4;     // GENERAL|PAYMENT|WITHDRAWAL|PRODUCT|ACCOUNT|ABUSE|OTHER
+    string status = 5;       // OPEN|PENDING|IN_PROGRESS|RESOLVED|CLOSED
+    string priority = 6;     // LOW|NORMAL|HIGH|URGENT
+    string purchase_id = 7;
+    string withdrawal_id = 8;
+    string assignee_id = 9;
+    string last_message_at = 10;
+    string created_at = 11;
+    string updated_at = 12;
+    int32 messages_count = 13;
+    string department = 14;          // GENERAL|TECHNICAL|SALES
+    string product_category_id = 15; // optional
+    string related_product_id = 16; // optional
+    string related_product_type = 17; // PURCHASED|SELLING
+    bool rules_accepted = 18;
+    string rules_accepted_at = 19;
+    string deleted_at = 20;
+}
+
+message TicketMessage {
+    string id = 1;
+    string ticket_id = 2;
+    string author_id = 3;
+    string body = 4;
+    bool is_staff = 5;
+    bool is_internal = 6;
+    string created_at = 7;
+    bool is_system = 8;                          // автосообщение платформы
+    repeated TicketAttachment attachments = 9;
+    string edited_at = 10;                       // '' если не редактировалось
+}
+
+message TicketAttachment {
+    string file_name = 1;
+    int64 file_size = 2;
+    string url = 3;          // presigned GET, короткоживущая; в запросах пусто
+    string storage_key = 4;  // только внутрь (reply), наружу не отдаётся
+}
+
+message UpdateTicketMessageRequest {
+    string message_id = 1;
+    string requester_id = 2;
+    bool is_staff = 3;
+    string body = 4;
+}
+
+message DeleteTicketMessageRequest {
+    string message_id = 1;
+    string requester_id = 2;
+    bool is_staff = 3;
+}
+
+message TicketWithMessages {
+    Ticket ticket = 1;
+    repeated TicketMessage messages = 2;
+}
+
+message CreateTicketRequest {
+    string author_id = 1;
+    string subject = 2;
+    string category = 3;
+    string body = 4;            // first message
+    string purchase_id = 5;     // optional
+    string withdrawal_id = 6;   // optional
+    string priority = 7;        // LOW|NORMAL|HIGH|URGENT
+    string department = 8;      // GENERAL|TECHNICAL|SALES
+    string product_category_id = 9; // optional
+    string related_product_id = 10; // optional
+    string related_product_type = 11; // PURCHASED|SELLING
+    bool rules_accepted = 12;
+}
+
+message GetTicketRequest {
+    string id = 1;
+    string requester_id = 2;
+    bool is_staff = 3; // staff see internal notes + any ticket
+}
+
+message ListMyTicketsRequest {
+    string author_id = 1;
+    string status = 2;          // single value OR comma-separated (e.g. "OPEN,PENDING,IN_PROGRESS")
+    int32 page = 3;
+    int32 limit = 4;
+    string department = 5;      // GENERAL|TECHNICAL|SALES
+    string category = 6;        // GENERAL|PAYMENT|...
+    string search = 7;          // contains in subject OR in any message body
+    string date_from = 8;       // ISO; inclusive lower bound on createdAt
+    string date_to = 9;         // ISO; inclusive upper bound on createdAt
+}
+
+message ReplyTicketRequest {
+    string ticket_id = 1;
+    string author_id = 2;
+    string body = 3;
+    bool is_staff = 4;
+    bool is_internal = 5; // staff-only note
+    repeated TicketAttachment attachments = 6; // storage_key+file_name+file_size
+}
+
+message CloseTicketRequest {
+    string ticket_id = 1;
+    string requester_id = 2;
+    bool is_staff = 3;
+}
+
+message ListTicketsRequest {
+    string status = 1;          // single value OR comma-separated
+    string category = 2;
+    string assignee_id = 3;
+    int32 page = 4;
+    int32 limit = 5;
+    string department = 6;
+    string search = 7;          // contains in subject OR in any message body
+    string date_from = 8;       // ISO; inclusive lower bound on createdAt
+    string date_to = 9;
+}
+
+message AssignTicketRequest {
+    string ticket_id = 1;
+    string assignee_id = 2; // empty = unassign
+    string admin_id = 3;
+}
+
+message SetTicketStatusRequest {
+    string ticket_id = 1;
+    string status = 2;
+    string admin_id = 3;
+}
+message DeleteTicketRequest {
+    string ticket_id = 1;
+    string admin_id = 2;
+}
+message TicketsListResponse {
+    repeated Ticket items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}

package/proto/taxonomy.proto

@@ -1,105 +1,105 @@
-syntax = "proto3";
-
-package taxonomy.v1;
-
-service TaxonomyService {
-    rpc FindAllCategories(Empty) returns (CategoriesListResponse);
-    rpc FindAllApplications(Empty) returns (ApplicationsListResponse);
-    rpc FindAllTags(QueryTagsRequest) returns (TagsListResponse);
-
-    rpc CreateCategory(CreateCategoryRequest) returns (CategoryResponse);
-    rpc CreateApplication(CreateApplicationRequest) returns (ApplicationResponse);
-    rpc UpdateApplication(UpdateApplicationRequest) returns (ApplicationResponse);
-
-    // Mint a presigned PUT URL for an application icon SVG (proxies upload-service,
-    // kind=ICON → public/icons/). Client PUTs the bytes to upload_url, then passes
-    // icon_url to Create/UpdateApplication.
-    rpc CreateIconUploadUrl(CreateIconUploadUrlRequest) returns (IconUploadUrlResponse);
-}
-
-message Category {
-    string id = 1;
-    string name = 2;
-    string description = 3;
-    string created_at = 4;
-    string updated_at = 5;
-}
-
-message Application {
-    string id = 1;
-    string name = 2;
-    string description = 3;
-    string created_at = 4;
-    string updated_at = 5;
-    string icon_url = 6; // public S3 URL to brand SVG (admin-set), empty if none
-}
-
-message Tag {
-    string id = 1;
-    string name = 2;
-}
-
-// =================================================================
-// Requests / responses
-// =================================================================
-
-message Empty {}
-
-message CategoriesListResponse {
-    repeated Category items = 1;
-}
-
-message ApplicationsListResponse {
-    repeated Application items = 1;
-}
-
-message QueryTagsRequest {
-    string search = 1;
-    int32 page = 2;
-    int32 limit = 3;
-}
-
-message TagsListResponse {
-    repeated Tag items = 1;
-    int32 total = 2;
-    int32 page = 3;
-    int32 limit = 4;
-}
-
-message CreateCategoryRequest {
-    string name = 1;
-    string description = 2;
-}
-
-message CategoryResponse {
-    Category category = 1;
-}
-
-message CreateApplicationRequest {
-    string name = 1;
-    string description = 2;
-    string icon_url = 3;
-}
-
-message UpdateApplicationRequest {
-    string id = 1;
-    string name = 2;        // optional — empty keeps current
-    string description = 3; // optional
-    string icon_url = 4;    // optional — empty keeps current
-}
-
-message ApplicationResponse {
-    Application application = 1;
-}
-
-message CreateIconUploadUrlRequest {
-    string file_name = 1;
-    string mime_type = 2; // e.g. image/svg+xml
-}
-
-message IconUploadUrlResponse {
-    string upload_url = 1; // presigned PUT URL — client uploads the SVG bytes here
-    string icon_url = 2;   // final public URL to store as Application.iconUrl
-    string file_key = 3;
-    int32 expires_in = 4;
-}
+syntax = "proto3";
+
+package taxonomy.v1;
+
+service TaxonomyService {
+    rpc FindAllCategories(Empty) returns (CategoriesListResponse);
+    rpc FindAllApplications(Empty) returns (ApplicationsListResponse);
+    rpc FindAllTags(QueryTagsRequest) returns (TagsListResponse);
+
+    rpc CreateCategory(CreateCategoryRequest) returns (CategoryResponse);
+    rpc CreateApplication(CreateApplicationRequest) returns (ApplicationResponse);
+    rpc UpdateApplication(UpdateApplicationRequest) returns (ApplicationResponse);
+
+    // Mint a presigned PUT URL for an application icon SVG (proxies upload-service,
+    // kind=ICON → public/icons/). Client PUTs the bytes to upload_url, then passes
+    // icon_url to Create/UpdateApplication.
+    rpc CreateIconUploadUrl(CreateIconUploadUrlRequest) returns (IconUploadUrlResponse);
+}
+
+message Category {
+    string id = 1;
+    string name = 2;
+    string description = 3;
+    string created_at = 4;
+    string updated_at = 5;
+}
+
+message Application {
+    string id = 1;
+    string name = 2;
+    string description = 3;
+    string created_at = 4;
+    string updated_at = 5;
+    string icon_url = 6; // public S3 URL to brand SVG (admin-set), empty if none
+}
+
+message Tag {
+    string id = 1;
+    string name = 2;
+}
+
+// =================================================================
+// Requests / responses
+// =================================================================
+
+message Empty {}
+
+message CategoriesListResponse {
+    repeated Category items = 1;
+}
+
+message ApplicationsListResponse {
+    repeated Application items = 1;
+}
+
+message QueryTagsRequest {
+    string search = 1;
+    int32 page = 2;
+    int32 limit = 3;
+}
+
+message TagsListResponse {
+    repeated Tag items = 1;
+    int32 total = 2;
+    int32 page = 3;
+    int32 limit = 4;
+}
+
+message CreateCategoryRequest {
+    string name = 1;
+    string description = 2;
+}
+
+message CategoryResponse {
+    Category category = 1;
+}
+
+message CreateApplicationRequest {
+    string name = 1;
+    string description = 2;
+    string icon_url = 3;
+}
+
+message UpdateApplicationRequest {
+    string id = 1;
+    string name = 2;        // optional — empty keeps current
+    string description = 3; // optional
+    string icon_url = 4;    // optional — empty keeps current
+}
+
+message ApplicationResponse {
+    Application application = 1;
+}
+
+message CreateIconUploadUrlRequest {
+    string file_name = 1;
+    string mime_type = 2; // e.g. image/svg+xml
+}
+
+message IconUploadUrlResponse {
+    string upload_url = 1; // presigned PUT URL — client uploads the SVG bytes here
+    string icon_url = 2;   // final public URL to store as Application.iconUrl
+    string file_key = 3;
+    int32 expires_in = 4;
+}