yml2213andClaude Opus 4.7 c9397635e2 feat: P3阶段完成 - 全部模块迁移完成 🎉
## P3.1: 争议仲裁模块(disputes)
- API: disputes.ts
- 模块导出

## P3.2: 卖家中心模块(seller)
- Views: 4个页面
- Composables: usePublishForm, usePublishDraft
- 模块导出

## P3.3: 管理后台模块(admin)
- API: 8个文件(adminAuth, adminDashboard, adminUsers等)
- Views: 15个管理页面
- Composables: useAdminTable, useAdminPaginatedTable
- Components: 管理端组件
- 模块导出

---

## 🎉 Features 架构迁移全部完成!

### 最终统计
-  P0: shared(基础设施)- 22个文件
-  P1: wallet, chats, orders - 24个文件
-  P2: listings, auth - 35个文件
-  P3: seller, disputes, admin - 47个文件

**总计:** 9个模块,128个文件完成迁移

### 新架构
```
frontend/src/
├── features/          # 9个业务模块 
│   ├── wallet/       
│   ├── chats/        
│   ├── orders/        (已重构)
│   ├── listings/     
│   ├── auth/         
│   ├── seller/       
│   ├── disputes/     
│   └── admin/        
└── shared/           
```

下一步:清理旧文件、更新路由配置

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-04 09:05:34 +08:00
2026-06-03 23:05:57 +08:00
2026-06-02 21:28:09 +08:00
2026-06-04 08:58:53 +08:00
2026-06-03 12:21:23 +08:00
2026-06-01 08:40:49 +08:00
2026-06-02 20:37:00 +08:00

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_IDALIYUN_ACCESS_KEY_SECRETALIYUN_SMS_SIGN_NAMEALIYUN_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:9000MinIO 开发地址使用 http://localhost:9000
  • 钱包账务当前为开发态模拟流水,可通过 GET /api/wallet/balanceGET /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,支持查看高风险操作明细。

文档

S
Description
No description provided
Readme
52 MiB
Languages
Go 45.4%
Vue 41.1%
TypeScript 9%
CSS 2.4%
Shell 2%