zlwu
b220298f89
为减少仓库噪声和重复规则，整理当前开发入口并移除已废弃资料。 - 精简根 AGENTS，补充四个应用规则与 README，统一规范入口 - 归整部署文件、SOP 原稿和参考资源，修正迁移后的脚本路径 - 取消虚拟环境、工具状态、业务导出及备份的跟踪，本机所需原件保留 - 移除停用的 graphify 配置、脚本与产物 - 删除历史业务文档、执行计划、OpenSpec 业务变更和移动 UI 原型 - 清理失效引用，历史细胞产品导入改为必须显式指定 --file 验证：git diff --cached --check、OpenSpec 严格校验、导入参数隔离检查 3/3 通过； 迁移文件完整性和现行链接已核对。未执行部署、业务数据导入或服务启停。
2.0 KiB
2.0 KiB
移动 H5 开发约束
适用 mobile-oa-h5/，与根规则同时生效。命令见 README。
工程边界
- Vue 3、Vant、Vite、form-create；既有代码为 JavaScript。使用 npm 与
package-lock.json。 - 工程承载 OA 表单、审批详情和市场模块，不仅是 OA；入口
src/main.js，路由src/router.js，市场子路由src/market/routes.js。 vite.config.js的 base 为/oa-h5/，使用 History 路由。修改必须同时核对 Nginx、Docker 与 uni-app WebView URL，不能只改前端路径。- 宿主在
../mobile-h5/；Token、消息事件、关闭/返回、下载和平台差异需两端配套维护。 - 复用
src/utils/的请求与附件工具、src/market/的模块契约及表单逻辑、src/oa/的审批运行组件，不能为同类模块复制另一套请求和权限逻辑。
UI 与契约
- 移动端与 Web 管理端分别遵循各自规范，不照搬 Element Plus、Web 自动导入规则或主色。
- 移动端规范品牌绿为
#0a9f6d；src/styles/tokens.css当前为#22c55e，与 uni-app Token 对齐但与规范存在差异。涉及改色须先核对设计依据，本轮清理不改变色板。 - 保持 Vant 移动布局、安全区、44×44px 点击目标、附件与表单的既有交互；新增模式先明确移动规范，不使用 Web 弹窗规则替代。
- 字段、金额、状态、租户和数据权限与后端保持一致；隐藏控件不能替代后端鉴权。
- 样本编码及子行 ID 的稳定性遵循根规则，修改协议保存时核对跨端字段映射。
验证与交付
- 运行受影响的
src/**/*.test.js，涉及 UI/路由/构建时执行npm run build；单元测试不能替代 WebView 真机验收。 - Docker 会将此工程与 Web 管理端一起打包，通过
/oa-h5/提供访问；dist/为构建产物，不提交。 - 前端环境变量会进入客户端包，不放真实服务端密钥；测试不覆盖本地生产配置。