# uni-app 移动端开发约束

适用 `mobile-h5/`，与[根规则](../AGENTS.md)同时生效。工程方式见 [README](README.md)。

## 工程边界

- 当前移动小程序目录是 `mobile-h5/`，使用 HBuilderX、uni-app Vue 3、Vant；不要创建假定存在的 `miniprogram/` 路径。
- `pages.json` 注册页面，`manifest.json` 保存平台配置；页面在 `pages/`，共享逻辑在 `utils/`，样式在 `styles/`。
- OA 及市场表单通过 WebView 打开 `mobile-oa-h5/`；修改跳转、Token、返回路径或消息事件时，同时核对 H5 端，不把两端当成重复工程合并。
- 保留 `#ifdef` 平台分支；浏览器可用不等于微信真机可用。保持鉴权、权限菜单和跨端返回行为。

## UI 约束

- 参照[移动端 UI 规范](../docs/miniprogram-ui-spec-sanqiang.md)和其中的工作台说明；`pages/demo/` 是样板资源。
- 规范品牌绿为 `#0a9f6d`，禁止把 Web `#10b981` 用作移动主色。
- 已知差异：`styles/tokens.scss` 当前采用 `#22c55e`，与规范不同。此记录不构成色板变更批准；涉及改色时查明已批准设计依据，不能在目录清理中覆盖 Token 或删除规范要求。
- 缩略图 1:1 `aspectFill`；轮播 4:3 `aspectFill`；详情图片 `widthFix`，最小点击目标 44×44px。
- 按既有 375px 基线、414px 兼容与平台安全区处理布局；状态色保持 success/warning/danger 的业务语义。
- 树选项显示本级名称，选中值、列表和详情使用 ` / ` 分隔的完整路径；字段及权限契约与后端一致。
- 购物、供应、配送等旧规范章节需核实适用范围，不据此新增已不属于本项目的业务。

## 验证

- 逻辑改动运行相关 `utils/*.test.js`/`*.test.mjs`；页面与平台改动需 HBuilderX 编译及对应平台检查。
- npm 管理此目录的依赖，保留 `package-lock.json`；没有 `npm run build`，不要套用 Web 的 pnpm/Vite 命令。
- `node_modules/`、`unpackage/`、HBuilderX 本地配置不提交；不修改真实环境配置来完成测试。