# 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` 会自动审核通过并上架。
- 订单创建需要登录；开发态会直接锁定账号并进入待交接，暂不接真实支付和押金冻结。
- 账号交接已支持号主提交说明、租客确认收号，确认后订单进入租赁中。

## 文档

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