# 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`（套餐模块开关）。