编辑 | blame | 历史 | 原始文档

App 页面开发要求

基本原则

  • 以 D:\newcode\mom-pro2-before 的 web 端页面为功能基准,按 web 路径找到对应 views、api、data.ts、modules 后再开发。
  • app 端字段、接口路径、请求方法、请求参数、状态流转和按钮权限要与 web 端保持一致。
  • app 和微信小程序都要兼容,避免只适用于 H5 的 DOM、window、document 写法。
  • 搜索栏只保留一个最关键搜索条件,一般为编号或名称。
  • 不开发导入、导出、打印功能。

样式规则

  • 列表页沿用现有移动端卡片风格:顶部单搜索框、白色卡片、右上角胶囊状态标签、底部右对齐操作按钮。
  • 右上角状态标签必须是固定高度胶囊,外层容器不要被 .head 撑高。
  • 表单页参考 /pages/crm/clue/form 及已开发页面:标签在左、值和选择箭头居右,必填 * 为红色。
  • picker 文案和右侧箭头要垂直居中,避免文字和箭头上下错位。
  • 列表里状态、类型、数量正负等有业务含义的标签或数字要区分颜色。

功能核查步骤

  1. 入口核查:根据 xxx.json 的 component 对齐 web 路径,并在 src/pages/workbench/index.vue 建立 app 路由映射。
  2. 页面注册:在 src/pages.json 注册列表页和详情/编辑页。
  3. 权限核查:逐个对照 web 的 auth 和 ifShow,页面权限、按钮权限都要落到 app。
  4. 字段核查:对照 web 的列表列、主表单、单行表单、库存明细表单,app 可移动端展示但字段不能漏。
  5. 下拉核查:所有 Select、树选择、物料/客户/供应商/仓库/库区/库位/批次等选择器,必须对照 web 组件的数据源、筛选参数、自动带出字段和禁用条件;字典项必须走 /system/dict-data/simple-list,不能写死中文选项。
  6. 流程核查:保存、提交、审核后动作、自动生成明细、数量校验、二次确认等小功能也属于“功能一致”,不能只实现主接口。
  7. 接口核查:对照 web API 的路径、方法、参数名,避免 app 自造接口或参数。
  8. 构建核查:开发完成后至少执行 npm run build:h5 和 npm run build:mp-weixin。