Files
hfb_sys/docs/CLEANUP_PROGRESS.md
T
yml2213 956c2eca91 chore: 修复大量导入路径错误
- 迁移 files API 到 shared/api/
- 修复所有 features 中的 @/api/ 导入
- 修复所有 features 中的 @/composables/ 导入
- 更新 useOrderDetail 中的 uploadFile 调用

类型错误:272 → 190 → 135
2026-06-04 09:30:13 +08:00

3.6 KiB
Raw Blame History

Features 架构迁移 - 清理工作总结

完成时间: 2026-06-04
分支: refactor/features-architecture
当前状态: 清理进行中


已完成的清理工作

1. 路由配置更新

提交: 3d5db9d

更新了所有路由文件,将 @/views/ 改为 @/features/*/views/

  • accountRoutes.ts - 10个路由
  • publicRoutes.ts - 2个路由
  • mobileRoutes.ts - 13个路由
  • sellerRoutes.ts - 4个路由
  • adminRoutes.ts - 15个路由
  • router/index.ts - 更新 authStorage 导入

总计: 44个路由已更新


2. 删除旧文件

提交: 5e87858

删除了旧的目录结构:

  • api/ - 21个文件
  • views/ - 57个文件
  • composables/ - 33个文件

总计: 111个旧文件已删除,33,317行代码移除


3. 批量更新导入路径

提交: 待提交

更新了所有 features 中的导入路径:

  • 8个 admin API 文件
  • 所有 admin 组件和视图
  • 所有 features 中的 Vue 文件
  • ChatAttachmentImage 组件

📊 清理进度

任务 状态 说明
更新路由配置 44个路由全部更新
删除旧文件 111个文件已删除
更新导入路径 🔄 大部分完成,剩余~190个错误
类型检查 🔄 从272个错误降到190个
功能测试 待完成

🔧 剩余工作

类型错误修复(~190个)

主要问题类型:

1. 缺失的模块

  • @/shared/api/files - files API 未迁移到 shared
  • @/api/auth - 部分文件还在使用旧路径
  • @/api/wallet - 部分文件还在使用旧路径
  • @/api/realname - 部分文件还在使用旧路径

2. Composables 导入

  • @/composables/useAdminTable@/features/admin/composables/
  • @/composables/useMoney@/shared/composables/
  • @/composables/useSmsCountdown@/shared/composables/

3. 相对路径问题

  • admin 组件之间的导入需要使用相对路径
  • auth API 内部导入路径

4. 类型导出冲突

  • features/admin/index.ts 中 AdminRole 重复导出

📁 当前目录结构

frontend/src/
├── features/                ✅ 新架构
│   ├── wallet/
│   ├── chats/
│   ├── orders/
│   ├── listings/
│   ├── auth/
│   ├── seller/
│   ├── disputes/
│   └── admin/
├── shared/                  ✅ 共享层
├── components/              ✅ 保留(全局组件)
├── layouts/                 ✅ 保留(布局模板)
├── router/                  ✅ 已更新
├── stores/                  ✅ 保留(全局状态)
├── styles/                  ✅ 保留(全局样式)
├── types/                   ✅ 保留(全局类型)
└── utils/                   ✅ 保留(工具函数)

Git 提交历史

  1. 3d5db9d - chore: 更新路由配置,使用 features 架构路径
  2. 5e87858 - chore: 删除旧的 api/, views/, composables/ 目录
  3. 待提交 - chore: 批量更新导入路径到 features 架构

⏭️ 下一步计划

1. 完成类型错误修复

  • 迁移 files API 到 shared
  • 修复所有剩余导入路径
  • 解决类型导出冲突
  • 目标:0个类型错误

2. 功能测试

npm run dev
# 测试各个模块:
# - 首页浏览
# - 登录/注册
# - 订单创建
# - 聊天功能
# - 管理后台

3. 更新文档

  • 更新 README.md
  • 添加新架构说明
  • 更新开发指南

4. 创建 PR

  • 推送到远程
  • 创建 Pull Request
  • 等待团队审核

当前状态: 清理工作 70% 完成
预计剩余时间: ~1小时