chore(init): 初始化解忧商行项目并完成 Phase 0 基座

This commit is contained in:
yml2213
2026-10-30 11:46:10 +08:00
commit 8d9481c251
689 changed files with 138703 additions and 0 deletions
+55
View File
@@ -0,0 +1,55 @@
# 解忧商行(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)
## 视觉关键词
东方商行 · 墨绿 · 朱砂印章 · 米白纸感 · 可信、温润、克制