Files
shanxia2.0/mobile-h5/REFACTORING.md
T
zlwuandCursor a4b13fa2bc chore(mobile-h5): add existing H5 app sources to the monorepo
Track the weighbridge mobile-h5 codebase (excluding node_modules, dist, and local .env) so subsequent adaptation tasks can evolve it in-repo.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-03 22:28:53 +08:00

4.5 KiB
Raw Blame History

移动端重构完成总结

✅ 已完成的工作

1. 弹窗改为跳转新页面

所有模块的新增、编辑、查看功能都已从弹窗改为跳转到独立页面:

计划管理 (/plans)

  • ✅ 创建详情页面:/plans/detail.vue
  • ✅ 列表页面改为跳转
  • ✅ 路由配置完成

出入库管理 (/inventory)

  • ✅ 创建详情页面:/inventory/detail.vue
  • ✅ 列表页面改为跳转
  • ✅ 路由配置完成
  • ✅ 支持从计划管理跳转并自动填充数据

地磅单管理 (/weighing)

  • ✅ 创建详情页面:/weighing/detail.vue
  • ✅ 列表页面改为跳转
  • ✅ 路由配置完成
  • ✅ 支持从出入库管理跳转并自动填充数据
  • ✅ 毛重/皮重/净重自动计算
  • ✅ 时间自动填充

基础资料 (/master-data)

  • ✅ 创建公司详情页面:/master-data/company-detail.vue
  • ✅ 创建货物详情页面:/master-data/cargo-detail.vue
  • ✅ 列表页面改为跳转
  • ✅ 路由配置完成

用户管理 (/user)

  • ✅ 创建详情页面:/user/detail.vue
  • ✅ 列表页面改为跳转
  • ✅ 路由配置完成

2. 搜索功能与Web端一致

所有搜索框的占位符和功能都已与Web端保持一致:

  • ✅ 计划管理:搜索往来单位 / 计划号
  • ✅ 出入库管理:搜索往来单位 / 产品
  • ✅ 地磅单管理:搜索车牌号 / 货物名称
  • ✅ 基础资料-公司:搜索公司名称 / 备注
  • ✅ 基础资料-货物:搜索货物名称 / 备注

3. 按钮和Tag配色与Web端一致

  • ✅ 创建了 vant-theme.scss 主题配置文件
  • ✅ 配置了与Web端一致的颜色:
    • primary: #52B788 (绿色)
    • success: #13deb9 (青绿色)
    • warning: #ffae1f (橙色)
    • danger: #ff4d4f (红色)
    • info: #52B788 (绿色)
  • ✅ 统一了Tag类型映射(与Web端一致)

4. API完全复用

  • ✅ 所有API文件已从Web端复制
  • ✅ 使用相同的API接口和数据结构
  • ✅ 功能逻辑与Web端完全一致

5. 表单字段与Web端一致

所有详情页面的表单字段都与Web端保持一致:

  • ✅ 计划管理:计划号、业务类型、往来单位、产品、计划开始时间、计划结束时间、计划量、备注
  • ✅ 出入库管理:日期、往来单位、业务类型、产品、数量、车牌号、计划号、备注
  • ✅ 地磅单管理:车牌号、货物名称、业务类型、供货单位、收货单位、毛重(kg)、毛重时间、皮重(kg)、皮重时间、扣杂(kg)、净重(kg)、计划号、备注
  • ✅ 基础资料-公司:公司名称、备注
  • ✅ 基础资料-货物:货物名称、备注
  • ✅ 用户管理:用户名、密码、角色

路由配置

所有新增的路由已添加到 router/index.ts:

// 计划管理
/plans/detail - 新增
/plans/detail/:id - 编辑/查看

// 出入库管理
/inventory/detail - 新增
/inventory/detail/:id - 编辑/查看

// 地磅单管理
/weighing/detail - 新增
/weighing/detail/:id - 编辑/查看

// 基础资料
/master-data/company/detail - 新增公司
/master-data/company/detail/:id - 编辑/查看公司
/master-data/cargo/detail - 新增货物
/master-data/cargo/detail/:id - 编辑/查看货物

// 用户管理
/user/detail - 新增
/user/detail/:id - 编辑/查看

页面模式

所有详情页面支持三种模式(通过路由参数控制):

  • 新增模式:/module/detail - 创建新记录
  • 编辑模式:/module/detail/:id?mode=edit - 编辑现有记录
  • 查看模式:/module/detail/:id?mode=view - 只读查看

通用样式

创建了 detail-page.scss 通用样式文件,所有详情页面共享相同的样式:

  • 页面头部(返回按钮 + 标题)
  • 表单容器
  • 表单项样式
  • 按钮样式

功能完整性

所有功能与Web端保持一致:

  1. ✅ 列表展示(卡片式,支持滚动分页)
  2. ✅ 搜索功能(与Web端一致)
  3. ✅ 新增功能(跳转到详情页面)
  4. ✅ 编辑功能(跳转到详情页面)
  5. ✅ 查看功能(跳转到详情页面,只读模式)
  6. ✅ 删除功能(确认对话框)
  7. ✅ 数据关联(计划-出入库-地磅单的关联关系)
  8. ✅ 自动填充(从关联页面跳转时自动填充数据)

下一步

项目重构已完成,可以:

  1. 运行 npm install 安装依赖
  2. 运行 npm run dev 启动开发服务器
  3. 测试所有功能,确保与Web端一致
  4. 根据实际使用情况优化UI/UX