Files
hfb_sys/README.md
T

2.2 KiB

HFB Sys

哈夫币租号平台,面向《三角洲行动》账号租赁场景。

开发方式

  • 后端:Go + Gin + GORM + MySQL + Redis
  • 前端:Vue 3 + TypeScript + Vite + Element Plus
  • 开发依赖:Docker Compose 启动 MySQL、Redis、MinIO

快速开始

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

开发态短信与实名

  • 短信验证码使用 mock 适配器,验证码会打印在后端日志中。
  • 实名认证使用 mock 适配器,登录后请求 POST /api/realname/start,提交合法姓名和 18 位身份证号会直接通过。
  • 实名状态可通过 GET /api/realname/status 查询。
  • 租号发布需要登录并完成实名认证;POST /api/listings/{id}/submit-review 会进入待审核,后台通过后才上架。
  • 订单创建需要登录;开发态会直接锁定账号并进入待交接,暂不接真实支付和押金冻结。
  • 账号交接已支持号主提交说明、租客确认收号,确认后订单进入租赁中。
  • 归还流程已支持租客提交归还、号主确认归还,完成后账号重新上架。
  • 钱包账务当前为开发态模拟流水,可通过 GET /api/wallet/balanceGET /api/wallet/ledger 查看。
  • 站内信已支持订单关键节点自动写入,可通过 GET /api/notifications 查看。
  • 申诉仲裁已支持订单双方发起申诉、开发态后台处理,后台页面为 http://localhost:5173/admin/disputes
  • 系统配置已支持默认配置初始化和后台编辑,页面为 http://localhost:5173/admin/system-configs,更新会写入审计日志。
  • 后台已使用独立登录,页面为 http://localhost:5173/admin/login;开发态默认管理员为 admin / admin123456
  • 后台仪表盘已接入真实统计数据,页面为 http://localhost:5173/admin/dashboard
  • 商品审核后台已接入,页面为 http://localhost:5173/admin/listings/review

文档