Initial commit

2025-11-18 03:36:49 +08:00
commit d17c7efb3c
7078 changed files with 831480 additions and 0 deletions
--- a/文档/TrafficPackagePeriodService.md
+++ b/文档/TrafficPackagePeriodService.md
@@ -0,0 +1,214 @@
+# TrafficPackagePeriodService
+> 流量包有效期服务
+
+---
+
+## createTrafficPackagePeriod
+> 创建有效期
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/TrafficPackagePeriodService/createTrafficPackagePeriod`
+- RPC：`rpc createTrafficPackagePeriod(CreateTrafficPackagePeriodRequest) returns (CreateTrafficPackagePeriodResponse);`
+
+**请求对象 (`CreateTrafficPackagePeriodRequest`)**
+
+```json
+{
+  "count": "int32 // 数量",
+  "unit": "string // month | year"
+}
+```
+
+**响应对象 (`CreateTrafficPackagePeriodResponse`)**
+
+```json
+{
+  "trafficPackagePeriodId": "int64"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/TrafficPackagePeriodService/createTrafficPackagePeriod" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## deleteTrafficPackagePeriod
+> 删除有效期
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/TrafficPackagePeriodService/deleteTrafficPackagePeriod`
+- RPC：`rpc deleteTrafficPackagePeriod(DeleteTrafficPackagePeriodRequest) returns (RPCSuccess);`
+
+**请求对象 (`DeleteTrafficPackagePeriodRequest`)**
+
+```json
+{
+  "trafficPackagePeriodId": "int64"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/TrafficPackagePeriodService/deleteTrafficPackagePeriod" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findAllAvailableTrafficPackagePeriods
+> 列出所有可用有效期
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/TrafficPackagePeriodService/findAllAvailableTrafficPackagePeriods`
+- RPC：`rpc findAllAvailableTrafficPackagePeriods(FindAllAvailableTrafficPackagePeriodsRequest) returns (FindAllAvailableTrafficPackagePeriodsResponse);`
+
+**请求对象 (`FindAllAvailableTrafficPackagePeriodsRequest`)**
+
+```json
+{}
+```
+
+**响应对象 (`FindAllAvailableTrafficPackagePeriodsResponse`)**
+
+```json
+{
+  "trafficPackagePeriods": "[]TrafficPackagePeriod"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/TrafficPackagePeriodService/findAllAvailableTrafficPackagePeriods" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findAllTrafficPackagePeriods
+> 列出所有有效期
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/TrafficPackagePeriodService/findAllTrafficPackagePeriods`
+- RPC：`rpc findAllTrafficPackagePeriods(FindAllTrafficPackagePeriodsRequest) returns (FindAllTrafficPackagePeriodsResponse);`
+
+**请求对象 (`FindAllTrafficPackagePeriodsRequest`)**
+
+```json
+{}
+```
+
+**响应对象 (`FindAllTrafficPackagePeriodsResponse`)**
+
+```json
+{
+  "trafficPackagePeriods": "[]TrafficPackagePeriod"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/TrafficPackagePeriodService/findAllTrafficPackagePeriods" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findTrafficPackagePeriod
+> 查找有效期
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/TrafficPackagePeriodService/findTrafficPackagePeriod`
+- RPC：`rpc findTrafficPackagePeriod(FindTrafficPackagePeriodRequest) returns (FindTrafficPackagePeriodResponse);`
+
+**请求对象 (`FindTrafficPackagePeriodRequest`)**
+
+```json
+{
+  "trafficPackagePeriodId": "int64"
+}
+```
+
+**响应对象 (`FindTrafficPackagePeriodResponse`)**
+
+```json
+{
+  "trafficPackagePeriod": "TrafficPackagePeriod"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/TrafficPackagePeriodService/findTrafficPackagePeriod" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## updateTrafficPackagePeriod
+> 修改有效期
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/TrafficPackagePeriodService/updateTrafficPackagePeriod`
+- RPC：`rpc updateTrafficPackagePeriod(UpdateTrafficPackagePeriodRequest) returns (RPCSuccess);`
+
+**请求对象 (`UpdateTrafficPackagePeriodRequest`)**
+
+```json
+{
+  "trafficPackagePeriodId": "int64",
+  "isOn": "bool // 是否启用"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/TrafficPackagePeriodService/updateTrafficPackagePeriod" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---