zlwu
b220298f89
为减少仓库噪声和重复规则，整理当前开发入口并移除已废弃资料。 - 精简根 AGENTS，补充四个应用规则与 README，统一规范入口 - 归整部署文件、SOP 原稿和参考资源，修正迁移后的脚本路径 - 取消虚拟环境、工具状态、业务导出及备份的跟踪，本机所需原件保留 - 移除停用的 graphify 配置、脚本与产物 - 删除历史业务文档、执行计划、OpenSpec 业务变更和移动 UI 原型 - 清理失效引用，历史细胞产品导入改为必须显式指定 --file 验证：git diff --cached --check、OpenSpec 严格校验、导入参数隔离检查 3/3 通过； 迁移文件完整性和现行链接已核对。未执行部署、业务数据导入或服务启停。
27 lines
2.0 KiB
Markdown
27 lines
2.0 KiB
Markdown
# 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 本地配置不提交；不修改真实环境配置来完成测试。
|