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