125d83f2f2f9831f4dde719c29fc143a6fdda8b0
## P1.3: 订单模块(orders)✅ ### 完整迁移 - 迁移 API: orders.ts - 迁移 Views: 5个页面(桌面3 + 移动2) - 迁移 Composables: useOrderSnapshot.ts - 更新所有导入路径到 shared/ ### 核心重构:拆分 useOrderDetail.ts 原始文件405行,混合了订单、支付、结算、争议等多个领域 **拆分为3个独立 composables:** 1. **usePaymentPolling.ts** - 支付轮询 - 职责:轮询查询支付状态直到完成 - 功能:开始/停止轮询、检查支付状态、自动重载 - 代码:~65行 2. **useSettlement.ts** - 结算流程 - 职责:处理订单结算完整流程 - 功能:提交/接受/反驳/确认结算、表单管理 - 代码:~170行 3. **useOrderDetail.ts** - 核心订单(重构后) - 职责:订单核心流程,组合使用上述composables - 功能:加载、取消、支付、交接、收货、争议 - 代码:~215行 **重构优势:** - 职责清晰,单一职责原则 - 可复用,支付和结算逻辑可独立使用 - 易测试,每个composable独立可测 - 易维护,从405行拆分为3个文件 ### 技术改进 - 建立清晰的模块边界和导出规范 - 避免循环依赖 - 提高代码可测试性和可维护性 ## 里程碑 🎉 **P1 阶段完成!** - ✅ P0: 基础设施(shared/)- 22个文件 - ✅ P1.1: 钱包模块 - 5个文件 - ✅ P1.2: 聊天模块 - 8个文件 - ✅ P1.3: 订单模块 - 11个文件 **总计:** 3个核心业务模块,46个文件完成迁移 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
HFB Sys
哈夫币租号平台,面向《三角洲行动》账号租赁场景。
开发方式
- 后端:Go + Gin + GORM + MySQL + Redis
- 前端:Vue 3 + TypeScript + Vite + Element Plus
- 开发依赖:Docker Compose 启动 MySQL、Redis、MinIO
快速开始
一键启动开发版本:
./scripts/dev.sh
脚本会自动启动 MySQL、Redis、MinIO,首次初始化数据库结构,并同时启动后端和前端。
前端地址:http://localhost:5173
后台地址:http://localhost:5173/admin/login,开发态默认管理员为 admin / admin123456。
如需拆分调试,可手动执行:
docker compose -f deploy/docker-compose.dev.yml up -d
docker exec -i hfb-mysql mysql -uhfb -psecret hfb_sys < backend/migrations/000001_init.sql
cd backend
cp .env.example .env
go run ./cmd/api
cd ../frontend
npm install
npm run dev
开发态短信与实名
- 后端日志默认同时输出到控制台和
backend/logs/app-YYYY-MM-DD.log,按北京时间自动按天切分;可通过LOG_LEVEL=debug|info|warn|error调整级别。 - 短信验证码默认使用 mock 适配器,验证码会打印在后端日志中;生产环境可通过
SMS_PROVIDER=aliyun接入阿里云短信。 - 阿里云短信需要配置
ALIYUN_ACCESS_KEY_ID、ALIYUN_ACCESS_KEY_SECRET、ALIYUN_SMS_SIGN_NAME和ALIYUN_SMS_LOGIN_TEMPLATE_CODE,模板变量名默认为code。 - 实名认证使用 mock 适配器,登录后请求
POST /api/realname/start,提交合法姓名和 18 位身份证号会直接通过。 - 实名状态可通过
GET /api/realname/status查询。 - 租号发布需要登录并完成实名认证;
POST /api/listings/{id}/submit-review会进入待审核,后台通过后才上架。 - 订单创建需要登录;开发态会直接锁定账号并进入待交接,暂不接真实支付和押金冻结。
- 账号交接已支持号主提交说明、租客确认收号,确认后订单进入租赁中。
- 归还流程已支持租客提交归还、号主确认归还,完成后账号重新上架。
- 后端已接入开发态订单超时扫描任务,会按系统配置处理交接超时、确认收号超时、逾期未归还和确认归还超时。
- 文件上传已接入 MinIO,发布账号资产截图和申诉证据可上传 JPG、PNG、WebP 或 PDF。
- 如果本机有代理工具占用
127.0.0.1:9000,MinIO 开发地址使用http://localhost:9000。 - 钱包账务当前为开发态模拟流水,可通过
GET /api/wallet/balance和GET /api/wallet/ledger查看。 - 后台资金流水已接入,页面为
http://localhost:5173/admin/wallet-ledger,支持按用户、订单和业务类型查询。 - 站内信已支持订单关键节点自动写入,可通过
GET /api/notifications查看。 - 订单群聊已支持支付成功后自动创建,租客、号主和客服可在移动端消息页进入会话。
- 申诉仲裁已支持订单双方发起申诉、开发态后台落账处理,后台页面为
http://localhost:5173/admin/disputes。 - 系统配置已支持默认配置初始化和后台编辑,页面为
http://localhost:5173/admin/system-configs,更新会写入审计日志。 - 后台已使用独立登录、图形验证码和独立管理 UI,页面为
http://localhost:5173/admin/login;开发态默认管理员为admin / admin123456。 - 后台仪表盘已接入真实统计数据,页面为
http://localhost:5173/admin/dashboard。 - 用户管理后台已接入,页面为
http://localhost:5173/admin/users,支持冻结和解冻用户。 - 订单管理后台已接入,页面为
http://localhost:5173/admin/orders,支持查看全量订单和交接记录。 - 商品管理后台已接入,页面为
http://localhost:5173/admin/listings,支持查看全量商品、商品详情、强制下架和标记异常。 - 订单详情后台已支持客服关闭和标记异常,相关操作会写入审计日志并通知双方。
- 商品审核后台已接入,页面为
http://localhost:5173/admin/listings/review,审核员可查看账号资产截图后通过或拒绝。 - 审计日志后台已接入,页面为
http://localhost:5173/admin/audit-logs,支持查看高风险操作明细。
文档
Languages
Go
45.4%
Vue
41.1%
TypeScript
9%
CSS
2.4%
Shell
2%