Files
zlwu b220298f89 chore: 清理历史资料并规范工程目录与开发规则
为减少仓库噪声和重复规则,整理当前开发入口并移除已废弃资料。

- 精简根 AGENTS,补充四个应用规则与 README,统一规范入口
- 归整部署文件、SOP 原稿和参考资源,修正迁移后的脚本路径
- 取消虚拟环境、工具状态、业务导出及备份的跟踪,本机所需原件保留
- 移除停用的 graphify 配置、脚本与产物
- 删除历史业务文档、执行计划、OpenSpec 业务变更和移动 UI 原型
- 清理失效引用,历史细胞产品导入改为必须显式指定 --file

验证:git diff --cached --check、OpenSpec 严格校验、导入参数隔离检查 3/3 通过;
迁移文件完整性和现行链接已核对。未执行部署、业务数据导入或服务启停。
2026-10-29 23:08:29 +08:00

2.0 KiB
Raw Permalink Blame History

uni-app 移动端开发约束

适用 mobile-h5/,与根规则同时生效。工程方式见 README。

工程边界

  • 当前移动小程序目录是 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 规范和其中的工作台说明;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 本地配置不提交;不修改真实环境配置来完成测试。