6aspec 2.0.0-dev.10

package/.6aspec/rules/biz/api_rule.md

@@ -0,0 +1,578 @@
+# API 开发规范
+
+## 概述
+
+本规范定义了系统中各类 API 接口的开发标准，包括包结构、注解使用、命名规范等。
+
+---
+
+## 一、需用户登录的 API 接口
+
+### 1.1 按端分类
+
+**端的定义**：
+- **B端（Business端）**：企业内部业务人员使用，包括 PC 管理后台和移动 APP，使用统一的权限体系（`@ActionRight`）
+- **C端（Customer端）**：面向终端客户/用户，如 H5、小程序等，使用客户认证体系（`@IdentityUserPermission()`）
+
+#### 1.1.1 B端 PC API
+
+**适用场景**：PC 端管理后台使用的接口
+
+**包路径规范**：
+```
+**.controller.modeling.bizapi
+```
+
+**开发规范**：
+- **继承**：`extends Controller`
+- **类注解**：
+  - `@PubService(value = "/xxx", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.XXX)`
+  - `@Tag(name = "PC-{模块名称}")`
+- **方法注解**：
+  - `@PubAction(value = "/methodName", method = RequestMethod.POST)`
+  - `@Operation(summary = "方法描述", description = "详细说明")`
+  - `@ApiResponses(value = {@ApiResponse(responseCode = "200", description = "成功")})`
+  - **权限控制**（必需）：
+    - 单个权限：`@ActionRight(ActionCode = "权限码", ActionName = "权限名称", BusinessCode = BusinessUnitCodeConstant.XXX)`
+    - 多个权限：`@ActionRights({@ActionRight(...), @ActionRight(...)})`
+
+**参考示例**：
+```java
+@Tag(name = "PC-入住办理")
+@PubService(value = "/checkIn", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.RENTAL_CARETAKER)
+public class CheckInController extends Controller {
+    
+    @PubAction(value = "/deleteCheckIn", method = RequestMethod.POST)
+    @Operation(summary = "删除", description = "删除")
+    @ApiResponses(value = {@ApiResponse(responseCode = "200", description = "成功")})
+    @ActionRight(ActionCode = "0103", ActionName = "删除入住单", BusinessCode = BusinessUnitCodeConstant.RENTAL_CARETAKER)
+    public void deleteCheckIn(UUID checkInId) {
+        // 业务逻辑
+    }
+}
+```
+
+#### 1.1.2 B端移动 APP API
+
+**适用场景**：移动 APP 端管理使用的接口（B端业务人员使用）
+
+**包路径规范**：
+```
+**.controller.app.bizapi         # 普通业务接口
+**.controller.app.dataapi        # DataApi 接口
+**.controller.app.filter         # 资源过滤接口
+```
+
+**开发规范**：
+- **继承**：`extends Controller`
+- **类注解**：
+  - `@PubService(value = "/xxx", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.XXX)`
+  - `@Tag(name = "APP-{模块名称}")`
+- **方法注解**：
+  - `@PubAction(value = "/methodName", method = RequestMethod.POST)`
+  - `@Operation(summary = "方法描述", description = "详细说明")`
+  - `@ApiResponses(value = {@ApiResponse(responseCode = "200", description = "成功")})`
+  - **权限控制**（必需）：
+    - 单个权限：`@ActionRight(ActionCode = "权限码", ActionName = "权限名称", BusinessCode = BusinessUnitCodeConstant.XXX)`
+    - 多个权限：`@ActionRights({@ActionRight(...), @ActionRight(...)})`
+
+**特别说明**：
+- `app` 包下的接口虽然是给移动端调用，但属于 **B端管理系统**，供企业内部业务人员使用
+- 权限控制方式与 PC 端 B端 API 相同，使用 `@ActionRight` 注解
+- Tag 命名建议使用 "APP-xxx" 前缀，便于区分移动端和 PC 端
+
+---
+
+#### 1.1.3 C端 H5 API
+
+**适用场景**：H5 移动端、小程序等客户端使用的接口（面向终端用户/客户）
+
+**包路径规范**：
+```
+**.controller.h5.bizapi          # 普通业务接口
+**.controller.h5.dataapi         # DataApi 接口
+**.controller.h5.filter          # 资源过滤接口
+```
+
+**开发规范**：
+- **继承**：`extends Controller`
+- **类注解**：
+  - `@PubService(value = "/xxx", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.XXX)`
+  - `@Tag(name = "H5-{模块名称}")`
+  - `@AuthOpenApi(model = UserType.Customer)` - 标识客户端认证
+- **方法注解**：
+  - `@PubAction(value = "/methodName", method = RequestMethod.POST)`
+  - `@Operation(summary = "方法描述", description = "详细说明")`
+  - `@ApiResponses(value = {@ApiResponse(responseCode = "200", description = "成功", content = {...})})`
+  - **权限控制**（必需）：
+    - `@IdentityUserPermission()` - 身份用户权限验证
+
+**参考示例**：
+```java
+@Tag(name = "H5-入住")
+@PubService(value = "/h5CheckIn", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.RENTAL_CARETAKER)
+@AuthOpenApi(model = UserType.Customer)
+public class H5CheckInController extends Controller {
+    
+    @PubAction(value = "/getCheckInInfoById")
+    @Operation(summary = "根据入住单Id获取入住信息", description = "根据入住单Id获取入住信息")
+    @ApiResponses(value = {@ApiResponse(responseCode = "200", description = "成功", content = {@Content(mediaType = "application/json", schema = @Schema(implementation = CheckInDTO.class))})})
+    @IdentityUserPermission()
+    public CheckInDTO getCheckInInfoById(UUID checkInId){
+        // 业务逻辑
+    }
+}
+```
+
+---
+
+### 1.2 按类型分类
+
+#### 1.2.1 普通 BizApi 接口
+
+**适用场景**：标准的 CRUD 操作接口
+
+**包路径规范**（根据端选择）：
+```
+**.controller.modeling.bizapi    # B端 PC 端
+**.controller.app.bizapi         # B端移动 APP 端
+**.controller.h5.bizapi          # C端 H5 端
+```
+
+**开发规范**：
+- **B端（modeling/app）**：参考 [1.1.1 B端 PC API](#111-b端-pc-api) 和 [1.1.2 B端移动 APP API](#112-b端移动-app-api)
+- **C端（h5）**：参考 [1.1.3 C端 H5 API](#113-c端-h5-api)
+
+**命名规范**：
+- 类名：
+  - PC 端：`{模块名}Controller`
+  - APP 端：`{模块名}AppController`
+  - H5 端：`H5{模块名}Controller`
+- 方法名：动词开头，如 `create`, `update`, `delete`, `get`, `list`
+
+---
+
+#### 1.2.2 DataApi 接口
+
+**适用场景**：提供表格数据查询，支持分页、排序、字段定义等功能
+
+**包路径规范**（根据端选择）：
+```
+**.controller.modeling.dataapi   # B端 PC 端
+**.controller.app.dataapi        # B端移动 APP 端
+**.controller.h5.dataapi         # C端 H5 端
+```
+
+**开发规范**：
+- **继承**：`extends DataApiController`
+- **类注解**：
+  - `@PubService(value = "/xxxDataApi", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.XXX)`
+  - `@Tag(name = "PC-{模块名}-API")`
+- **必须实现的方法**：
+  - `projectFilter()` - 是否启用项目过滤
+  - `loadFields()` - 定义字段结构，返回 `FieldsSetting`
+  - `loadData(LoadDataParams options)` - 加载数据，返回 `ListDataResult`
+
+**字段类型**：`FieldType.String`, `FieldType.Int`, `FieldType.Decimal`, `FieldType.DateTime` 等
+
+**参考示例**：
+```java
+@PubService(value = "/checkInMeterReadingDataApi", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.RENTAL_CARETAKER)
+@Tag(name = "PC-房态入住抄表-API")
+public class CheckInMeterReadingDataApiController extends DataApiController {
+    
+    @Override
+    public boolean projectFilter() {
+        return false;
+    }
+
+    @Override
+    public FieldsSetting loadFields() {
+        FieldsSetting fieldsSetting = new FieldsSetting();
+        String groupName = "group_name";
+        fieldsSetting.setIdField("primaryKeyField");
+        fieldsSetting.setFields(new ArrayList<>());
+        
+        // 添加字段定义
+        fieldsSetting.getFields().add(new DataApiField("fieldName", groupName, "字段显示名", FieldType.String));
+        
+        return fieldsSetting;
+    }
+
+    @Override
+    public ListDataResult loadData(LoadDataParams options) {
+        ListDataResult listDataResult = new ListDataResult();
+        // 查询数据逻辑
+        listDataResult.setTotal(total);
+        listDataResult.setData(dataList);
+        return listDataResult;
+    }
+}
+```
+
+---
+
+#### 1.2.3 OptionDataApi 接口
+
+**适用场景**：提供下拉选项、枚举值等选项数据
+
+**包路径规范**（根据端选择）：
+```
+**.controller.modeling.dataapi   # B端 PC 端
+**.controller.app.dataapi        # B端移动 APP 端
+**.controller.h5.dataapi         # C端 H5 端
+```
+
+**说明**：OptionDataApi 也放在 `dataapi` 包下
+
+**开发规范**：
+- **继承**：`extends Controller`
+- **实现接口**：`implements OptionDataApi`
+- **类注解**：
+  - `@PubService(value = "/xxxOption", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.XXX)`
+  - `@Tag(name = "{模块名}-API")`
+- **必须实现的方法**：
+  - `load()` - 返回 `List<OptionItem>`
+
+**OptionItem 结构**：
+- `setText(String text)` - 显示文本
+- `setValue(Object value)` - 选项值
+- `setDefault(boolean isDefault)` - 是否默认选中
+
+**参考示例**：
+```java
+@Tag(name = "设备预警类型-API")
+@PubService(value = "/deviceAlarmTypeOption", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.RENTAL_DEVICE)
+public class DeviceAlarmTypeOptionDataApi extends Controller implements OptionDataApi {
+    
+    @Override
+    @Operation(summary = "设备预警类型", description = "设备预警类型")
+    public List<OptionItem> load() {
+        // 获取参数
+        String param = PageParameter.getPageParams().get("paramName");
+        
+        // 构建选项列表
+        return enumValues.stream().map(item -> {
+            OptionItem optionItem = new OptionItem();
+            optionItem.setText(item.getDesc());
+            optionItem.setValue(item.getCode());
+            optionItem.setDefault(false); // 可选
+            return optionItem;
+        }).collect(Collectors.toList());
+    }
+}
+```
+
+---
+
+#### 1.2.4 资源化过滤 API
+
+**适用场景**：提供基于用户权限的资源过滤功能
+
+**包路径规范**（根据端选择）：
+```
+**.controller.modeling.filter    # B端 PC 端资源过滤
+**.controller.app.filter         # B端移动 APP 端资源过滤
+**.controller.h5.filter          # C端 H5 端资源过滤
+```
+
+**特别说明**：
+- **modeling.filter**：PC 端的数据权限过滤
+- **app.filter**：移动 APP 端的数据权限过滤（B端业务人员）
+- **h5.filter**：H5 端的数据权限过滤（C端客户）
+- 不同端使用相应的权限控制注解
+
+**开发规范**：
+- **继承**：`extends BaseResourceFilterController`
+- **类注解**：
+  - `@PubService(value = "/xxxResourceFilterApp", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.XXX)`
+  - `@Tag(name = "{模块名}-APP-资源化过滤-API")`
+- **必须实现的方法**：
+  - `getMainTable()` - 返回主表名称
+  - `getWhereSql()` - 返回过滤 SQL 条件
+
+**参考示例**：
+```java
+@Tag(name = "设备-APP-资源化过滤-API")
+@PubService(value = "/deviceResourceFilterApp", prefix = RequestPrefix.API, businessCode = BusinessUnitCodeConstant.RENTAL_DEVICE_DOOR_LOCK_APP)
+public class DeviceResourceFilterAppController extends BaseResourceFilterController {
+    
+    @Autowired
+    private UserDataPermissionFacade userDataPermissionFacade;
+    
+    @Override
+    public String getMainTable() {
+        return TableUtils.getTableName(DeviceEntity.class);
+    }
+
+    @Override
+    public String getWhereSql() {
+        return userDataPermissionFacade.getUserResourceFilterSql(
+            UserDataPermissionFilterModeEnum.ORGANIZATION_AND_PROJECT,
+            null, 
+            "rental_Resource.BUGUID",
+            "rental_deviceroom.ProjGUID", 
+            Lists.newArrayList()
+        );
+    }
+}
+```
+
+---
+
+## 二、跨系统调用 API（Pub API）
+
+### 2.1 概述
+
+**适用场景**：系统间调用、第三方系统集成、无需用户登录的开放接口
+
+**包路径规范**：
+```
+**.controller.pub
+```
+
+### 2.2 开发规范
+
+- **继承**：`extends Controller`
+- **类注解**：
+  - `@PubService(value = "/xxxOpenRmi", prefix = RequestPrefix.SHARE, businessCode = BusinessUnitCodeConstant.XXX)`
+  - `@Tag(name = "{模块名}-openAPI")`
+- **方法注解**：
+  - `@PubAction(value = "/methodName", method = RequestMethod.POST)`
+  - `@Operation(summary = "方法描述", description = "详细说明")`
+  - `@ApiResponses(value = {...})`
+- **权限控制**：无需添加权限注解
+
+**注意事项**：
+- 使用 `RequestPrefix.SHARE` 而非 `RequestPrefix.API`
+- 命名建议使用 `{模块}ShareController` 或 `{模块}OpenRmiController`
+- 需做好接口安全校验（如签名验证、IP白名单等）
+
+### 2.3 参考示例
+
+```java
+@Tag(name = "设备管理-预充值-openAPI")
+@PubService(value = "/deviceRechargeOpenRmi", prefix = RequestPrefix.SHARE, businessCode = BusinessUnitCodeConstant.RENTAL_DEVICE)
+public class DeviceRechargeShareController extends Controller {
+    
+    @Operation(summary = "预充值回调接口", description = "预充值回调接口")
+    @ApiResponses(value = {@ApiResponse(responseCode = "200", description = "成功", content =
+            {@Content(mediaType = "application/json", schema = @Schema(implementation = void.class))})}
+    )
+    @PubAction(value = "/rechargeNotify", method = RequestMethod.POST)
+    public void rechargeNotify(@RequestBody @Validated DeviceRechargeNotifyCommand command) {
+        log.info("设备预充值回调参数:{}", command);
+        // 业务逻辑
+    }
+}
+```
+
+---
+
+## 三、通用规范
+
+### 3.1 命名规范
+
+| 类型 | 规范 | 示例 |
+|------|------|------|
+| B端 PC Controller | `{模块名}Controller` | `CheckInController` |
+| B端 APP Controller | `{模块名}AppController` | `CheckInAppController` |
+| C端 H5 Controller | `H5{模块名}Controller` | `H5CheckInController` |
+| DataApi Controller | `{模块名}DataApiController` | `CheckInMeterReadingDataApiController` |
+| OptionDataApi | `{模块名}OptionDataApi` | `DeviceAlarmTypeOptionDataApi` |
+| 资源过滤 Controller | `{模块名}ResourceFilterAppController` | `DeviceResourceFilterAppController` |
+| Share Controller | `{模块名}ShareController` | `DeviceRechargeShareController` |
+| Service 路径 | `/小驼峰模块名` | `/checkIn`, `/checkInApp`, `/h5CheckIn` |
+| Action 路径 | `/动词+名词` | `/deleteCheckIn`, `/getCheckInInfoById` |
+
+### 3.2 注解使用规范
+
+#### 必需注解：
+- **类级别**：`@PubService`, `@Tag`
+- **方法级别**：`@PubAction`, `@Operation`（建议）
+
+#### 权限注解（根据类型选择）：
+- **B端 PC API**：`@ActionRight` 或 `@ActionRights`
+- **B端移动 APP API**：`@ActionRight` 或 `@ActionRights`（与 PC 端相同）
+- **C端 H5 API**：`@IdentityUserPermission()` + `@AuthOpenApi(model = UserType.Customer)`
+- **Pub API**：无需权限注解
+
+#### 文档注解（建议）：
+- `@ApiResponses` - 响应说明
+- `@Schema` - 数据模型定义
+- `@Content` - 内容类型定义
+
+### 3.3 参数验证
+
+- 使用 `@Valid` 或 `@Validated` 进行参数校验
+- DTO/Command 类使用 JSR-303 注解（`@NotNull`, `@NotBlank`, `@Size` 等）
+
+### 3.4 日志规范
+
+- 重要操作需记录日志：`log.info("操作描述, 参数:{}", param)`
+- 异常需记录：`log.error("错误描述", exception)`
+
+### 3.5 返回值规范
+
+- 查询接口：返回具体的 DTO 对象或 List
+- 新增接口：返回主键 ID（UUID）
+- 修改/删除接口：可返回 void 或 Boolean
+- 分页查询：使用 `PagedResultDTO` 或 `ListDataResult`
+
+---
+
+## 四、包结构总览
+
+```
+com.mysoft.rental.{module}.controller
+├── modeling                      # B端 PC 端
+│   ├── bizapi                   # 普通业务 API
+│   ├── dataapi                  # DataApi 和 OptionDataApi
+│   └── filter                   # 资源化过滤 API
+├── app                          # B端移动 APP（企业内部业务人员）
+│   ├── bizapi                   # 普通业务 API
+│   ├── dataapi                  # DataApi 和 OptionDataApi
+│   └── filter                   # 资源化过滤 API
+├── h5                           # C端 H5/小程序（面向客户）
+│   ├── bizapi                   # 普通业务 API
+│   ├── dataapi                  # DataApi 和 OptionDataApi
+│   └── filter                   # 资源化过滤 API
+└── pub                          # 跨系统调用 API（无需登录）
+```
+
+### 4.1 包结构说明
+
+#### 按端划分（一级包）：
+
+| 包名 | 端类型 | 使用对象 | 权限体系 |
+|------|--------|----------|----------|
+| **modeling** | B端 PC | 企业内部业务人员（PC端） | `@ActionRight` |
+| **app** | B端 APP | 企业内部业务人员（移动端） | `@ActionRight` |
+| **h5** | C端 H5 | 终端客户/用户 | `@IdentityUserPermission()` + `@AuthOpenApi` |
+| **pub** | 开放接口 | 跨系统调用 | 无需权限注解 |
+
+#### 按类型划分（二级包）：
+
+| 包名 | 接口类型 | 说明 |
+|------|----------|------|
+| **bizapi** | 普通业务 API | 标准的 CRUD 操作接口 |
+| **dataapi** | DataApi / OptionDataApi | 表格数据展示、下拉选项等 |
+| **filter** | 资源化过滤 API | 基于用户权限的数据过滤 |
+
+### 4.2 包路径组合规范
+
+根据端和类型的组合，包路径如下：
+
+| 场景 | 包路径 | Tag 命名 | 示例 |
+|------|--------|----------|------|
+| B端 PC 业务接口 | `**.controller.modeling.bizapi` | `PC-{模块}` | `CheckInController` |
+| B端 PC DataApi | `**.controller.modeling.dataapi` | `PC-{模块}-API` | `CheckInDataApiController` |
+| B端 PC 资源过滤 | `**.controller.modeling.filter` | `PC-{模块}-资源化过滤-API` | `DeviceResourceFilterController` |
+| B端 APP 业务接口 | `**.controller.app.bizapi` | `APP-{模块}` | `CheckInAppController` |
+| B端 APP DataApi | `**.controller.app.dataapi` | `APP-{模块}-API` | `CheckInAppDataApiController` |
+| B端 APP 资源过滤 | `**.controller.app.filter` | `{模块}-APP-资源化过滤-API` | `DeviceResourceFilterAppController` |
+| C端 H5 业务接口 | `**.controller.h5.bizapi` | `H5-{模块}` | `H5CheckInController` |
+| C端 H5 DataApi | `**.controller.h5.dataapi` | `H5-{模块}-API` | `H5CheckInDataApiController` |
+| C端 H5 资源过滤 | `**.controller.h5.filter` | `H5-{模块}-资源化过滤-API` | `H5ResourceFilterController` |
+| 跨系统调用 | `**.controller.pub` | `{模块}-openAPI` | `DeviceRechargeShareController` |
+
+---
+
+## 五、检查清单
+
+在提交代码前，请确认：
+
+- [ ] 类和方法名称符合命名规范
+- [ ] 包路径正确
+- [ ] 继承了正确的父类或实现了正确的接口
+- [ ] 添加了必需的注解（@PubService, @Tag, @PubAction）
+- [ ] 权限控制注解正确添加
+- [ ] RequestPrefix 使用正确（API 或 SHARE）
+- [ ] 添加了 Swagger 文档注解（@Operation, @ApiResponses）
+- [ ] 参数校验注解完整
+- [ ] 关键操作添加了日志记录
+- [ ] 返回值类型符合规范
+
+---
+
+## 六、常见问题
+
+### Q1: 什么时候使用 RequestPrefix.API vs RequestPrefix.SHARE？
+- **API**：需要用户登录的接口（B端、C端）
+- **SHARE**：跨系统调用、无需登录的接口
+
+### Q2: DataApi 和普通 API 的区别？
+- **DataApi**：用于表格数据展示，支持字段配置、分页、排序等
+- **普通 API**：标准的业务接口，CRUD 操作
+
+### Q3: 多个权限如何配置？
+- 使用 `@ActionRights` 包含多个 `@ActionRight`
+
+### Q4: C端和B端权限控制的区别？
+- **B端**：使用 `@ActionRight` 进行功能权限控制
+- **C端**：使用 `@IdentityUserPermission()` 进行身份认证
+
+### Q5: modeling、app、h5 三个包的区别？
+- **modeling 包**：B端 PC 端接口，供企业内部业务人员在 PC 管理后台使用
+  - 权限体系：`@ActionRight`
+  - Tag 命名：`PC-xxx`
+  - 子包：`bizapi`、`dataapi`、`filter`
+  
+- **app 包**：B端移动 APP 接口，供企业内部业务人员在移动端使用（如管家、运营人员等）
+  - 权限体系：与 PC 端相同，使用 `@ActionRight`
+  - Tag 命名：`APP-xxx`
+  - 子包：`bizapi`、`dataapi`、`filter`
+  
+- **h5 包**：C端 H5/小程序接口，面向终端用户/客户
+  - 权限体系：客户认证体系，使用 `@IdentityUserPermission()`
+  - Tag 命名：`H5-xxx`
+  - 子包：`bizapi`、`dataapi`、`filter`
+  - 需添加：`@AuthOpenApi(model = UserType.Customer)`
+
+### Q6: bizapi、dataapi、filter 三个子包的区别？
+- **bizapi**：普通业务接口，如增删改查操作
+- **dataapi**：数据 API 接口，包括 DataApi（表格数据展示）和 OptionDataApi（下拉选项）
+- **filter**：资源化过滤接口，提供基于用户权限的数据过滤
+
+**注意**：这三个子包可以出现在 modeling、app、h5 任何一个端包下
+
+### Q7: 如何选择正确的包路径？
+按照"端（一级包）+ 类型（二级包）"的组合方式选择：
+
+**第一步：确定端（一级包）**
+- 问：谁来调用这个接口？
+  - PC 端管理后台 → `modeling`
+  - 移动 APP（业务人员）→ `app`
+  - H5/小程序（客户）→ `h5`
+  - 跨系统调用 → `pub`
+
+**第二步：确定类型（二级包）**
+- 问：这是什么类型的接口？
+  - 普通 CRUD 业务 → `bizapi`
+  - 表格/选项数据 → `dataapi`
+  - 资源权限过滤 → `filter`
+
+**示例**：
+- PC 端入住单管理接口 → `modeling.bizapi`
+- 移动 APP 设备资源过滤 → `app.filter`
+- H5 端订单列表数据 → `h5.dataapi`
+
+---
+
+## 七、相关文档
+
+- Spring MVC 文档
+- Swagger/OpenAPI 规范
+- 公司框架开发手册
+
+---
+
+**文档版本**：v1.2  
+**最后更新**：2026-01-11  
+**更新说明**：
+- v1.2: 完善包结构总览，明确 modeling/app/h5 三个端包下都可以有 bizapi/dataapi/filter 三个子包
+- v1.1: 补充 B端移动 APP API 相关规范，明确 app 包和 h5 包的区别
+- v1.0: 初始版本
+
+**维护人**：开发团队
+