HHY
f7a555dd6c
后端: - 客户模块 CRUD+搜索 (api/services/repositories 分层) - 合同模块: FG单号规则/意向单转正式单/订单创建自动快照客户信息 - 优化下料: FFD首递减装箱算法(利用率统计/余料/未排入清单) 前端 (Vue3+TS+Element Plus): - 7页面: 登录/工作台/订单中心/合同/客户/样板库/优化下料 - 自研二维窗型画布渲染器: 解析drawing_data渲染玻璃区域/外框/ 扇开向标记/尺寸标注, 支持缩放平移复位 - 样板库与订单联动(用此样板下单自动带图纸) - axios统一envelope拦截/登录守卫/付费墙提示 工程: - SPA history 回退路由, 构建产物挂载后端 - 全接口回归 6/6 通过
48 lines
2.3 KiB
Markdown
48 lines
2.3 KiB
Markdown
# huamenchuang
|
||
|
||
门窗行业云平台（功能对标 windoorcraft.com，全部自研实现）。
|
||
|
||
## 当前进度
|
||
|
||
- ✅ 目标站逆向与数据采集（样板库 254 套全量 + 二维平面图 254 张 + 接口全量留档）
|
||
- ✅ 后端 v0.2：认证 / 订单（状态机+生产进度+审计日志）/ 客户 / 合同（意向单→正式单）/ 样板库 / 优化下料(FFD)
|
||
- ✅ 前端 v0.2：Vue3 + Element Plus，7 个页面，自研二维窗型画布渲染器（可渲染全部 254 套样板）
|
||
- ⏳ 报价引擎 / 打印模板 / 微信生态（规划中，见方案 §6 里程碑）
|
||
|
||
## 文档导航
|
||
|
||
- [克隆实施方案](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 # 后端依赖
|
||
npm --prefix frontend install # 前端依赖
|
||
uv run python -m huamenchuang.scripts.seed # 管理员 + 254 套样板入库
|
||
npm --prefix frontend run build # 构建前端到 frontend/dist（后端自动挂载）
|
||
uv run uvicorn huamenchuang.main:app --reload # 启动 → http://localhost:8000
|
||
```
|
||
|
||
打开 http://localhost:8000 即为完整系统（SPA 由后端服务，深链接自动回退）。
|
||
前端开发热更新：`npm --prefix frontend run dev`（5173 端口，/api 代理到 8000）。
|
||
|
||
管理员账号（开发）：`13800000000 / 123456`。
|
||
|
||
环境变量（均可选）：`HMC_DATABASE_URL`（默认 SQLite，可切 MySQL）、`HMC_JWT_SECRET`（生产必设）、`HMC_ENABLED_MODULES`（套餐模块开关）。
|