feat: 前后端全量开发 v0.2

后端:
- 客户模块 CRUD+搜索 (api/services/repositories 分层)
- 合同模块: FG单号规则/意向单转正式单/订单创建自动快照客户信息
- 优化下料: FFD首递减装箱算法(利用率统计/余料/未排入清单)
前端 (Vue3+TS+Element Plus):
- 7页面: 登录/工作台/订单中心/合同/客户/样板库/优化下料
- 自研二维窗型画布渲染器: 解析drawing_data渲染玻璃区域/外框/
  扇开向标记/尺寸标注, 支持缩放平移复位
- 样板库与订单联动(用此样板下单自动带图纸)
- axios统一envelope拦截/登录守卫/付费墙提示
工程:
- SPA history 回退路由, 构建产物挂载后端
- 全接口回归 6/6 通过

README.md

@@ -5,8 +5,9 @@
 ## 当前进度
 
 - ✅ 目标站逆向与数据采集（样板库 254 套全量 + 二维平面图 254 张 + 接口全量留档）
-- ✅ 后端 v0.1：认证 / 订单模块（状态机+生产进度+审计日志）/ 样板库 API
-- ⏳ 前端 Vue3 与画布编辑器（规划中，见方案 §3.3）
+- ✅ 后端 v0.2：认证 / 订单（状态机+生产进度+审计日志）/ 客户 / 合同（意向单→正式单）/ 样板库 / 优化下料(FFD)
+- ✅ 前端 v0.2：Vue3 + Element Plus，7 个页面，自研二维窗型画布渲染器（可渲染全部 254 套样板）
+- ⏳ 报价引擎 / 打印模板 / 微信生态（规划中，见方案 §6 里程碑）
 
 ## 文档导航
 
@@ -31,11 +32,16 @@ frontend/              前端（Vue3 + TS，规划中）
 ## 快速开始
 
 ```bash
-uv sync                                        # 安装依赖
+uv sync                                        # 后端依赖
+npm --prefix frontend install                  # 前端依赖
 uv run python -m huamenchuang.scripts.seed     # 管理员 + 254 套样板入库
-uv run uvicorn huamenchuang.main:app --reload  # 启动 → http://localhost:8000/docs
+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`（套餐模块开关）。