# HFB Sys

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

## 开发方式

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

## 快速开始

```bash
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/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/review`。

## 文档

- [项目计划](docs/project-plan.md)
- [数据库设计](docs/database.md)
- [接口规划](docs/api.md)
- [业务规则](docs/business-rules.md)