Initial commit

2025-11-18 03:36:49 +08:00
commit d17c7efb3c
7078 changed files with 831480 additions and 0 deletions
--- a/文档/UserTicketLogService.md
+++ b/文档/UserTicketLogService.md
@@ -0,0 +1,150 @@
+# UserTicketLogService
+> 工单日志服务
+
+---
+
+## countUserTicketLogs
+> 查询日志数量
+
+- 角色：`admin`, `user`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketLogService/countUserTicketLogs`
+- RPC：`rpc countUserTicketLogs(CountUserTicketLogsRequest) returns (RPCCountResponse);`
+
+**请求对象 (`CountUserTicketLogsRequest`)**
+
+```json
+{
+  "userTicketId": "int64"
+}
+```
+
+**响应对象 (`RPCCountResponse`)**
+
+```json
+{
+  "count": "int64 // 数量"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketLogService/countUserTicketLogs" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## createUserTicketLog
+> 创建日志
+
+- 角色：`admin`, `user`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketLogService/createUserTicketLog`
+- RPC：`rpc createUserTicketLog(CreateUserTicketLogRequest) returns (CreateUserTicketLogResponse);`
+
+**请求对象 (`CreateUserTicketLogRequest`)**
+
+```json
+{
+  "userTicketId": "int64",
+  "status": "string",
+  "comment": "string"
+}
+```
+
+**响应对象 (`CreateUserTicketLogResponse`)**
+
+```json
+{
+  "userTicketLogId": "int64"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketLogService/createUserTicketLog" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## deleteUserTicketLog
+> 删除日志
+
+- 角色：`admin`, `user`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketLogService/deleteUserTicketLog`
+- RPC：`rpc deleteUserTicketLog(DeleteUserTicketLogRequest) returns (RPCSuccess);`
+
+**请求对象 (`DeleteUserTicketLogRequest`)**
+
+```json
+{
+  "userTicketLogId": "int64"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketLogService/deleteUserTicketLog" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## listUserTicketLogs
+> 列出单页日志
+
+- 角色：`admin`, `user`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketLogService/listUserTicketLogs`
+- RPC：`rpc listUserTicketLogs(ListUserTicketLogsRequest) returns (ListUserTicketLogsResponse);`
+
+**请求对象 (`ListUserTicketLogsRequest`)**
+
+```json
+{
+  "userTicketId": "int64",
+  "offset": "int64 // 读取位置",
+  "size": "int64 // 数量，通常不能小于0"
+}
+```
+
+**响应对象 (`ListUserTicketLogsResponse`)**
+
+```json
+{
+  "userTicketLogs": "[]UserTicketLog"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketLogService/listUserTicketLogs" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---