Initial commit

2025-11-18 03:36:49 +08:00
commit d17c7efb3c
7078 changed files with 831480 additions and 0 deletions
--- a/文档/UserAccountService.md
+++ b/文档/UserAccountService.md
@@ -0,0 +1,188 @@
+# UserAccountService
+> 用户账户服务
+
+---
+
+## countUserAccounts
+> 计算账户数量
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/UserAccountService/countUserAccounts`
+- RPC：`rpc countUserAccounts(CountUserAccountsRequest) returns (RPCCountResponse);`
+
+**请求对象 (`CountUserAccountsRequest`)**
+
+```json
+{
+  "keyword": "string // 关键词"
+}
+```
+
+**响应对象 (`RPCCountResponse`)**
+
+```json
+{
+  "count": "int64 // 数量"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserAccountService/countUserAccounts" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findEnabledUserAccount
+> 查找单个账户
+
+- 角色：`admin`, `user`
+- HTTP：`POST https://backend.dooki.cloud/UserAccountService/findEnabledUserAccount`
+- RPC：`rpc findEnabledUserAccount(FindEnabledUserAccountRequest) returns (FindEnabledUserAccountResponse);`
+
+**请求对象 (`FindEnabledUserAccountRequest`)**
+
+```json
+{
+  "userAccountId": "int64 // 用户账户ID"
+}
+```
+
+**响应对象 (`FindEnabledUserAccountResponse`)**
+
+```json
+{
+  "userAccount": "UserAccount // 用户账户"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserAccountService/findEnabledUserAccount" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findEnabledUserAccountWithUserId
+> 根据用户ID查找单个账户
+
+- 角色：`admin`, `user`
+- HTTP：`POST https://backend.dooki.cloud/UserAccountService/findEnabledUserAccountWithUserId`
+- RPC：`rpc findEnabledUserAccountWithUserId(FindEnabledUserAccountWithUserIdRequest) returns (FindEnabledUserAccountWithUserIdResponse);`
+
+**请求对象 (`FindEnabledUserAccountWithUserIdRequest`)**
+
+```json
+{
+  "userId": "int64 // 用户ID"
+}
+```
+
+**响应对象 (`FindEnabledUserAccountWithUserIdResponse`)**
+
+```json
+{
+  "userAccount": "UserAccount // 用户账户"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserAccountService/findEnabledUserAccountWithUserId" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## listUserAccounts
+> 列出单页账户
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/UserAccountService/listUserAccounts`
+- RPC：`rpc listUserAccounts(ListUserAccountsRequest) returns (ListUserAccountsResponse);`
+
+**请求对象 (`ListUserAccountsRequest`)**
+
+```json
+{
+  "keyword": "string // 关键词",
+  "offset": "int64 // 读取位置",
+  "size": "int64 // 数量，通常不能小于0"
+}
+```
+
+**响应对象 (`ListUserAccountsResponse`)**
+
+```json
+{
+  "userAccounts": "[]UserAccount // 用户账户列表"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserAccountService/listUserAccounts" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## updateUserAccount
+> 修改用户账户
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/UserAccountService/updateUserAccount`
+- RPC：`rpc updateUserAccount(UpdateUserAccountRequest) returns (RPCSuccess);`
+
+**请求对象 (`UpdateUserAccountRequest`)**
+
+```json
+{
+  "userAccountId": "int64 // 用户账户ID（非用户ID）",
+  "delta": "double // 操作的数值，正值表示增加，负值表示减少",
+  "eventType": "string // 事件类型：charge, award, buyPlan, payBill, refund, withdraw, buyNSPlan, buyTrafficPackage, buyAntiDDoSPackage, renewAntiDDoSPackage",
+  "description": "string // 描述",
+  "paramsJSON": "bytes // 相关参数"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/UserAccountService/updateUserAccount" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---