HHY
d3e6de585c
- 后端分层架构: api(Controller)/services(业务)/repositories(数据)/models(ORM)
- 订单模块: 创建(契约对齐目标站{contract_id,drawing_data,pic_url})、搜索、
详情、更新、删除、状态机(意向单→正式单→生产中→完工/取消,非法迁移拒绝)、
7节点生产进度、审计日志
- 认证模块: JWT签发(HS256/24h)、PBKDF2密码、注册登录
- 样板库API: 分类树/模板搜索/模板详情, drawing_data 与采集样本同构
- 254张样板二维平面图全部采集并静态挂载 /static/windoor-images/
- 种子脚本: 管理员+分类树+254套样板入库
- 统一响应envelope与付费墙(code=10086)/权限(code=210)语义
- 端到端冒烟测试7/7通过, 更新API.md §12自研接口规范
42 lines
1.7 KiB
Markdown
42 lines
1.7 KiB
Markdown
# huamenchuang
|
||
|
||
门窗行业云平台（功能对标 windoorcraft.com，全部自研实现）。
|
||
|
||
## 当前进度
|
||
|
||
- ✅ 目标站逆向与数据采集（样板库 254 套全量 + 二维平面图 254 张 + 接口全量留档）
|
||
- ✅ 后端 v0.1：认证 / 订单模块（状态机+生产进度+审计日志）/ 样板库 API
|
||
- ⏳ 前端 Vue3 与画布编辑器（规划中，见方案 §3.3）
|
||
|
||
## 文档导航
|
||
|
||
- [克隆实施方案](doc/克隆实施方案.md) — 产品画像、架构设计、拖拽画布编辑器复刻方案、里程碑
|
||
- [API 接口文档](doc/API.md) — 目标站对照表 + 自研接口规范（§12）
|
||
- [变更日志](CHANGELOG)
|
||
|
||
## 目录
|
||
|
||
```
|
||
doc/ 设计文档
|
||
data/
|
||
├── api-endpoint-inventory.txt 目标站接口名清单（≈300 条）
|
||
├── api-samples/ 核心接口真实响应样本 + 样板库全量清单
|
||
├── windoor-drawings/ 254 套官方样板完整绘制数据 (drawing_data)
|
||
├── windoor-images/ 254 张样板二维平面图
|
||
└── full-site/ 整站接口全量扫描留档
|
||
src/huamenchuang/ 后端（FastAPI，分层: api/services/repositories/models）
|
||
frontend/ 前端（Vue3 + TS，规划中）
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
uv sync # 安装依赖
|
||
uv run python -m huamenchuang.scripts.seed # 管理员 + 254 套样板入库
|
||
uv run uvicorn huamenchuang.main:app --reload # 启动 → http://localhost:8000/docs
|
||
```
|
||
|
||
管理员账号（开发）：`13800000000 / 123456`。
|
||
|
||
环境变量（均可选）：`HMC_DATABASE_URL`（默认 SQLite，可切 MySQL）、`HMC_JWT_SECRET`（生产必设）、`HMC_ENABLED_MODULES`（套餐模块开关）。
|