@aepstore-dev/contracts 1.64.0 → 1.66.0

package/proto/support.proto

@@ -1,170 +1,227 @@
-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);
+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
+    rpc ReopenTicket(ReopenTicketRequest) returns (ReopenTicketResponse);
+    rpc ReportTicket(ReportTicketRequest) returns (SupportTicketComplaint);
+    rpc RateTicket(RateTicketRequest) returns (SupportTicketRating);
+
+    // 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), наружу не отдаётся
+    int32 rating = 21;          // 0 if the current user has not rated it
+    bool has_complaint = 22;    // true if the current user has already reported it
+}
+
+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;                       // '' если не редактировалось
+    // Отображаемое имя автора: агент — «Имя Ф.» из fullName (фолбэк username),
+    // клиент — username, системное — ''.
+    string author_name = 11;
+}
+
+message TicketAttachment {
+    string file_name = 1;
+    int64 file_size = 2;
+    string url = 3;          // presigned GET, короткоживущая; в запросах пусто
+    string storage_key = 4;  // только внутрь (reply), наружу не отдаётся
+    string mime_type = 5;
 }
 
 message UpdateTicketMessageRequest {
-    string message_id = 1;
+    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;
+    repeated TicketAttachment attachments = 13; // storage_key+file_name+file_size+mime_type
+}
+
+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;
-    string body = 4;
 }
 
-message DeleteTicketMessageRequest {
-    string message_id = 1;
+message ReopenTicketRequest {
+    string ticket_id = 1;
     string requester_id = 2;
-    bool is_staff = 3;
+    string body = 3;
+    repeated TicketAttachment attachments = 4;
 }
 
-message TicketWithMessages {
+message ReopenTicketResponse {
     Ticket ticket = 1;
-    repeated TicketMessage messages = 2;
+    TicketMessage message = 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;
+message ReportTicketRequest {
+    string ticket_id = 1;
     string requester_id = 2;
-    bool is_staff = 3; // staff see internal notes + any ticket
+    string reason = 3;
+    string message = 4;
 }
 
-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 SupportTicketComplaint {
+    string id = 1;
+    string ticket_id = 2;
+    string user_id = 3;
+    string operator_id = 4;
+    string reason = 5;
+    string message = 6;
+    string created_at = 7;
+    string updated_at = 8;
 }
 
-message CloseTicketRequest {
+message RateTicketRequest {
     string ticket_id = 1;
     string requester_id = 2;
-    bool is_staff = 3;
+    int32 rating = 3;
+    string message = 4;
 }
 
-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 SupportTicketRating {
+    string id = 1;
+    string ticket_id = 2;
+    string user_id = 3;
+    int32 rating = 4;
+    string message = 5;
+    string created_at = 6;
+    string updated_at = 7;
 }
 
-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;
-}
+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;
+}