# App 端业务页面开发要求 ## 总原则 - App 端页面必须参考 Web 端对应路径开发,字段、接口地址、请求方式、传参、业务按钮和权限码保持一致。 - Web 端的导入、导出、打印类能力不搬到 App 端。 - 列表搜索栏只保留一个最关键条件,一般优先保留名称或单号。 - 页面需要同时兼容 App 和微信小程序,避免使用 H5 专属 DOM、浏览器 API 或不兼容 CSS。 ## 样式规则 - 列表页沿用当前 App 已确认的白色卡片列表样式:顶部单搜索框、卡片标题、右上角胶囊状态、字段信息区、底部按钮区、右下角新增悬浮按钮。 - 每条数据右上角状态必须是固定高度胶囊标签,不能被标题区域高度撑成圆形或大块标签。 - 表单和详情页参考 `/pages/crm/clue/form` 风格:左侧字段名,右侧值或输入控件,整体右对齐,选择项文字和右侧箭头垂直居中。 - 所有必填项的 `*` 必须为红色。 - Web 端字段名带单位的,App 端也要带同样单位,例如 `金额(元)`、`面积(㎡)`。 ## 权限规则 - 页面查看权限使用 Web 端列表查询权限,例如 `xxx:query`。 - 新增、编辑、删除、提交、状态变更等按钮必须按 Web 端同名权限控制。 - 没有权限时不展示按钮;没有页面查询权限时展示无权限提示。 ## 当前已按此规则开发/调整的模块 - CRM:线索、客户、客户池、联系人、商机、合同、开票申请、回款管理、回款计划、销售报价、销售计划、销售订单、待办事项、客户公海配置、客户限制配置、商机状态配置、合同配置。 - 采购:采购申请、采购订单、采购来票、采购付款。 - 设备管理:设备类型、设备台账、点检保养项目、点检保养方案、点检记录、保养记录、维修单、计量器具、计量检测记录。 - 仓储/库存:库存事务流水、仓库设置、库存现有量、到货通知、采购入库、采购退货。 - 售后管理:售后工单、退货申请、问题库。 ## 本次仓储/库存模块对照 - `wls/transaction/index` -> `/pages/wls/transaction/index`,接口 `/mes/wm/transaction/page`,权限 `mes:wm-transaction:query`。 - `wls/warehouse/index` -> `/pages/wls/warehouse/index`,接口 `/mes/wm/warehouse/*`,权限 `mes:wm-warehouse:*`。 - `wls/materialstock/index` -> `/pages/wls/material-stock/index`,接口 `/mes/wm/material-stock/*`,权限 `mes:wm-material-stock:*`。 - `wls/arrivalnotice/index` -> `/pages/wls/arrival-notice/index`,接口 `/mes/wm/arrival-notice/*` 和 `/mes/wm/arrival-notice-line/*`,权限 `mes:wm-arrival-notice:*`。 - `wls/itemreceipt/index` -> `/pages/wls/item-receipt/index`,接口 `/mes/wm/item-receipt/*` 和 `/mes/wm/item-receipt-line/*`,权限 `mes:wm-item-receipt:*`。 - `wls/returnvendor/index` -> `/pages/wls/return-vendor/index`,接口 `/mes/wm/return-vendor/*` 和 `/mes/wm/return-vendor-line/*`,权限 `mes:wm-return-vendor:*`。