Initial commit

2025-11-18 03:36:49 +08:00
commit d17c7efb3c
7078 changed files with 831480 additions and 0 deletions
--- a/文档/UserTicketCategoryService.md
+++ b/文档/UserTicketCategoryService.md
@@ -0,0 +1,214 @@
+# UserTicketCategoryService
+> 工单分类服务
+
+---
+
+## createUserTicketCategory
+> 创建分类
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketCategoryService/createUserTicketCategory`
+- RPC：`rpc createUserTicketCategory(CreateUserTicketCategoryRequest) returns (CreateUserTicketCategoryResponse);`
+
+**请求对象 (`CreateUserTicketCategoryRequest`)**
+
+```json
+{
+  "name": "string // 名称"
+}
+```
+
+**响应对象 (`CreateUserTicketCategoryResponse`)**
+
+```json
+{
+  "userTicketCategoryId": "int64"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketCategoryService/createUserTicketCategory" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## deleteUserTicketCategory
+> 删除分类
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketCategoryService/deleteUserTicketCategory`
+- RPC：`rpc deleteUserTicketCategory(DeleteUserTicketCategoryRequest) returns (RPCSuccess);`
+
+**请求对象 (`DeleteUserTicketCategoryRequest`)**
+
+```json
+{
+  "userTicketCategoryId": "int64"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketCategoryService/deleteUserTicketCategory" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findAllAvailableUserTicketCategories
+> 查找所有启用中的分类
+
+- 角色：`admin`, `user`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketCategoryService/findAllAvailableUserTicketCategories`
+- RPC：`rpc findAllAvailableUserTicketCategories(FindAllAvailableUserTicketCategoriesRequest) returns (FindAllAvailableUserTicketCategoriesResponse);`
+
+**请求对象 (`FindAllAvailableUserTicketCategoriesRequest`)**
+
+```json
+{}
+```
+
+**响应对象 (`FindAllAvailableUserTicketCategoriesResponse`)**
+
+```json
+{
+  "userTicketCategories": "[]UserTicketCategory"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketCategoryService/findAllAvailableUserTicketCategories" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findAllUserTicketCategories
+> 查找所有分类
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketCategoryService/findAllUserTicketCategories`
+- RPC：`rpc findAllUserTicketCategories(FindAllUserTicketCategoriesRequest) returns (FindAllUserTicketCategoriesResponse);`
+
+**请求对象 (`FindAllUserTicketCategoriesRequest`)**
+
+```json
+{}
+```
+
+**响应对象 (`FindAllUserTicketCategoriesResponse`)**
+
+```json
+{
+  "userTicketCategories": "[]UserTicketCategory"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketCategoryService/findAllUserTicketCategories" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findUserTicketCategory
+> 查询单个分类
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketCategoryService/findUserTicketCategory`
+- RPC：`rpc findUserTicketCategory(FindUserTicketCategoryRequest) returns (FindUserTicketCategoryResponse);`
+
+**请求对象 (`FindUserTicketCategoryRequest`)**
+
+```json
+{
+  "userTicketCategoryId": "int64"
+}
+```
+
+**响应对象 (`FindUserTicketCategoryResponse`)**
+
+```json
+{
+  "userTicketCategory": "UserTicketCategory"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketCategoryService/findUserTicketCategory" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## updateUserTicketCategory
+> 修改分类
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/UserTicketCategoryService/updateUserTicketCategory`
+- RPC：`rpc updateUserTicketCategory(UpdateUserTicketCategoryRequest) returns (RPCSuccess);`
+
+**请求对象 (`UpdateUserTicketCategoryRequest`)**
+
+```json
+{
+  "userTicketCategoryId": "int64",
+  "name": "string // 名称",
+  "isOn": "bool // 是否启用"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserTicketCategoryService/updateUserTicketCategory" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---