feat: 订单模块 v0.1 实现与样板二维平面图全量采集
- 后端分层架构: 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自研接口规范
This commit is contained in:
@@ -2,10 +2,16 @@
|
||||
|
||||
门窗行业云平台(功能对标 windoorcraft.com,全部自研实现)。
|
||||
|
||||
## 当前进度
|
||||
|
||||
- ✅ 目标站逆向与数据采集(样板库 254 套全量 + 二维平面图 254 张 + 接口全量留档)
|
||||
- ✅ 后端 v0.1:认证 / 订单模块(状态机+生产进度+审计日志)/ 样板库 API
|
||||
- ⏳ 前端 Vue3 与画布编辑器(规划中,见方案 §3.3)
|
||||
|
||||
## 文档导航
|
||||
|
||||
- [克隆实施方案](doc/克隆实施方案.md) — 产品画像、架构设计、拖拽画布编辑器复刻方案、里程碑
|
||||
- [API 接口文档](doc/API.md) — 接口规范与目标站对照表
|
||||
- [API 接口文档](doc/API.md) — 目标站对照表 + 自研接口规范(§12)
|
||||
- [变更日志](CHANGELOG)
|
||||
|
||||
## 目录
|
||||
@@ -15,14 +21,21 @@ doc/ 设计文档
|
||||
data/
|
||||
├── api-endpoint-inventory.txt 目标站接口名清单(≈300 条)
|
||||
├── api-samples/ 核心接口真实响应样本 + 样板库全量清单
|
||||
└── windoor-drawings/ 254 套官方样板库完整绘制数据 (drawing_data)
|
||||
src/huamenchuang/ 后端(FastAPI,规划中)
|
||||
├── 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 uvicorn huamenchuang.main:app --reload
|
||||
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`(套餐模块开关)。
|
||||
|
||||
Reference in New Issue
Block a user