# 解忧商行（JIEYOU TRADING HOUSE）

以 `hfb_sys` 的后端能力为基座、前端整体重建的账号租赁与交易平台。

## 当前状态

**Phase 0 已完成。** 后端已复制并跑通空库迁移、构建、健康检查与全量测试；前端已搭好 React 19 + Ant Design 5 壳，完成品牌首页、登录页、商品列表和后台占位。

- 前端：`http://localhost:5289/`
- 后端：`http://localhost:18089/`
- 健康检查：`http://localhost:18089/health/ready`

## 本地启动

```bash
# 1. 启动 MySQL / Redis / MinIO
docker compose -f deploy/docker-compose.dev.yml up -d

# 2. 启动后端（自动按 dotenv 规则加载 backend/.env）
./scripts/run-backend.sh

# 3. 启动前端
cd frontend && npm install && npm run dev
```

开发测试账号：`13800138000 / Jieyou123`（仅开发库）。

## 已定配置

- 主域名：`zuhaoc.com`
- 管理后台：环境变量 `VITE_ADMIN_BASE_PATH`，默认 `/console-jy8k3m`
- 分销后台：`distribution.zuhaoc.com`（沿用现有 React + AntD 应用，仅做品牌轻改）
- 数据库：全新数据库 `hfb_jysh`，保留全部 89 个迁移
- 支付 / 短信 / 实名：先留空，开发环境使用 mock
- Logo：无矢量源文件，按现有 PNG 重绘 SVG

## 技术方向

- 后端：Go + Gin + GORM + MySQL + Redis（业务逻辑复用）
- 主前端：React 19 + TypeScript + Vite + Ant Design 5
- 移动端：Ant Design Mobile 5
- 分销后台：React 19 + Ant Design 5
- 部署：Caddy + Docker Compose

## 文档

- [项目实施计划](docs/项目计划.md)
- [品牌与 UI 规范](docs/品牌与UI规范.md)
- [Phase 0 验收报告](docs/Phase0-验收报告.md)
- [后端数据库设计](docs/backend/database.md)
- [后端业务规则](docs/backend/business-rules.md)

## 视觉关键词

东方商行 · 墨绿 · 朱砂印章 · 米白纸感 · 可信、温润、克制