OARS Docs

Appearance

移动端模块研发说明 ​

适用对象 ​

维护移动端路由、移动流程页、移动业务录入和移动入口数据的开发人员。

能力边界 ​

已落地：

  • /m 移动端根路由和 MobileUserLayout。
  • 移动工作台、发起、业务录入、待办、在途、已办、抄送、消息、处理、我的。
  • 移动流程列表使用通用分页搜索 composable。
  • 移动处理页复用 flowInstance/handle/index.vue。
  • 移动业务入口从 sys_mobile_entry 查询，按 authCode 过滤。
  • 运行时 DSL 移动表单从 /app/runtime-biz/{moduleKey}/meta 读取字段并提交数据。
  • supplier-system 插件提供移动表单示例。

边界：

  • 复杂移动列表、移动统计页、完整移动流程中心不是第一阶段默认生成内容。
  • 移动运行时表单没有完整复用表单设计器的复杂组件体系。
  • 扫码、定位、附件、离线、草稿等移动专属能力待确认。

入口路径 ​

路由：

  • /m/workspace
  • /m/start
  • /m/apps
  • /m/apps/runtime/:moduleKey
  • /m/todo
  • /m/doing
  • /m/done
  • /m/notify
  • /m/message
  • /m/handle
  • /m/mine
  • /m/biz/supplier/create
  • /m/biz/purchase-order/create
  • /m/biz/material/create

后端：

  • /app/mobile-entry/list
  • /app/runtime-biz/{moduleKey}/meta
  • /app/runtime-biz/{moduleKey}
  • 流程相关接口复用 /flow/template、/flow/instance、/flow/task

核心数据和接口 ​

核心表：

  • sys_mobile_entry
  • biz_runtime_module.mobileEntryId
  • biz_runtime_app
  • biz_runtime_module
  • biz_runtime_field
  • flow_task
  • flow_instance

接口：

  • GET /app/mobile-entry/list
  • GET /app/runtime-biz/{moduleKey}/meta
  • POST /app/runtime-biz/{moduleKey}
  • GET /flow/template/startable
  • POST /flow/instance/start
  • GET /flow/task/todo
  • POST /flow/task/{taskId}/sign
  • POST /flow/instance/{instanceId}/resume
  • POST /flow/instance/{instanceId}/unfreeze

权限或预留能力 ​

已落地：

  • 移动路由使用 dashboard:workspace、flow:start、flow:todo、flow:halfway、flow:completed、flow:notify、flow:message、flow:handle、domain:user。
  • 移动待办按钮使用 flow:todo:sign、flow:todo:resume、flow:todo:unfreeze、flow:handle。
  • 运行时业务模块使用 runtime-biz:{moduleKey}。
  • 插件示例使用 biz:*:create 和 biz:*:update。

预留：

  • mobile-form 是 ModuleSpec 的移动录入入口类型。
  • 模块生成器可根据勾选项或 entryPoints 写入 sys_mobile_entry 并绑定 mobileEntryId。

相关实现位置 ​

  • 移动路由：oars-web/apps/web-antd/src/router/routes/external/mobile-user.ts
  • 移动页面：oars-web/apps/web-antd/src/views/mobile/user
  • 移动布局：oars-web/apps/web-antd/src/components/app
  • 移动入口 API：oars-web/apps/web-antd/src/api/app/mobileEntry.ts
  • 运行时业务 API：oars-web/apps/web-antd/src/api/runtime/biz.ts
  • 移动入口控制器：oars-java/oars-app/src/main/java/com/oars/app/controller/app/MobileEntryController.java
  • 运行时业务控制器：oars-java/oars-app/src/main/java/com/oars/app/controller/app/RuntimeBizController.java
  • 模块生成器移动入口写入：oars-java/oars-app/src/main/java/com/oars/app/controller/app/DevModuleGeneratorController.java
  • supplier 示例：oars-web/apps/web-antd/src/plugins/supplier-system
  • 移动规则：docs/ai/skills/oars-mobile.md

待确认事项 ​

  • 移动端是否需要专用流程处理组件。
  • 移动运行时表单是否接入 generated-fields 或表单设计器组件。
  • sys_mobile_entry 的管理、排序、分组和权限授权界面。
  • 移动端扫码、定位、附件、草稿、离线能力优先级。