Commit 1e4a02d2 by pangchong

docs(rules): 更新业务组件调用规范说明

- 删除了关于业务组件禁止直接调用 apiService 或 ajax 的规定
- 明确了智能翻译相关接口允许直接在模块中发起请求的例外情况
- 规范了翻译类接口不属于外部宿主系统桥接接口的说明
parent 11828ef5
......@@ -296,4 +296,3 @@ export const COMPOSITE_CONTAINER_MAP: Record<string, string[]> = {
- 直接通过 `apiService` 向后端实体接口(例如 `/plugins/TD_JC_CEP_UPLOAD_IMG` 等)发起数据请求。对于上传等表单提交,**强制直接在 `apiService.postForm` 中传入含有 `file` 与参数的普通 JavaScript 对象**(底层服务已实现拦截自动转化为 `FormData` 包装),**严禁**在业务和桥接层手动进行 `new FormData()` 的实例化与 append 操作;同时,**禁止**在内部做任何针对外部宿主系统环境(例如 window、window.parent 等)的挂载检测与判断。
- **业务组件调用规范**:在任何 Vue 组件或 functionals 逻辑类中,**禁止**直接通过 `apiService` 或原生 ajax 方式编写特定的外部接口请求逻辑,**必须**`bridge.ts` 中导入对应的封装方法进行调用,实现视图层与接口传输层的彻底解耦。
- **翻译相关接口例外情况**:智能翻译相关的接口(如单句翻译 `/translate`、双语库检索 `/search`、翻译词条维护 `/data/insert_single``/data/delete` 以及 XML 翻译对照提取 `/xml/extract/process`、批量翻译接口等)属于本编辑器纯业务或数据处理功能接口,**不属于外部宿主系统的桥接接口**,因此**不需要**存放在 `bridge.ts` 中,允许直接在各自模块的 `functionals` 逻辑类或业务代码中发起网络请求(应使用系统自带的 `service``serviceManage` 实例)。
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment