56 lines
3.0 KiB
Markdown
56 lines
3.0 KiB
Markdown
# 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`，支持查看全量商品、商品详情、强制下架和标记异常。
|
|
- 订单详情后台已支持客服关闭和标记异常，相关操作会写入审计日志并通知双方。
|
|
- 商品审核后台已接入，页面为 `http://localhost:5173/admin/listings/review`。
|
|
- 审计日志后台已接入，页面为 `http://localhost:5173/admin/audit-logs`，支持查看高风险操作明细。
|
|
|
|
## 文档
|
|
|
|
- [项目计划](docs/project-plan.md)
|
|
- [数据库设计](docs/database.md)
|
|
- [接口规划](docs/api.md)
|
|
- [业务规则](docs/business-rules.md)
|