feat: P0-1 价格脚本引擎(安全公式解析+脚本CRUD+试算+报价集成)

doc/API.md

@@ -333,7 +333,6 @@
 **响应式适配**：侧边栏 <900px 自动折叠为图标栏；<700px 主区边距收窄；表格列横向滚动。
 
 ### 12.14 平台扩展模块（v1.0，`/api`）
-
 | 接口名称 | 方式 | URL 路径 | 请求参数 | 说明 |
 |---|---|---|---|---|
 | 渲染设置 + AI 风格 | GET/POST | `/api/rendering-info` | `{wall_color, scene, glass_tint, ai_style, ai_time}` | 存公司参数；风格: modern/chinese/european/nordic，时间: day/dusk/night |
@@ -363,3 +362,24 @@ uv run uvicorn huamenchuang.main:app --reload   # 启动，http://localhost:8000
 
 管理员账号：`13800000000 / 123456`（开发用，生产必须修改）。
 默认 SQLite（`HMC_DATABASE_URL` 可切 MySQL），JWT 密钥 `HMC_JWT_SECRET` 生产必须设置。
+
+### 12.15 价格脚本模块 `/api/scripts`（v2.20 新增，P0-报价真实化）
+
+对齐目标站 `script`/`product-script`/`product-test` 语义：按系列为各计价项配置**定价公式**，报价时启用即按脚本计价。
+
+公式引擎：安全表达式（递归下降解析，无 eval）。支持 `+ - * / ( )` 与函数 `min/max/round/abs/ceil/floor/sqrt`。
+
+变量表：`w`/`h`(窗宽高mm)、`area`(㎡)、`perimeter`(m)、`glass_area`(㎡)、`sashes`(扇)、`meters_frame`/`meters_mullion`/`meters_sash`(各类型材米数)、`length`(作用项对应量：型材=米数、玻璃=面积、五金=扇数)。
+
+公式语义：结果 = 该作用项**单价**（元/米、元/㎡、元/扇）；`target=total` 时结果直接作为**总价**。
+
+| 接口名称 | 方式 | URL 路径 | 请求参数 | 说明 |
+|---|---|---|---|---|
+| 脚本列表 | GET | `/api/scripts` | — | 公司全部脚本 |
+| 新增脚本 | POST | `/api/scripts` | `{name(系列名), target, formula, note?, enabled?}` | target ∈ frame/mullion/sash/glass/hardware/total；公式后端白名单+语法校验，非法返回 code=0 |
+| 编辑脚本 | PUT | `/api/scripts/{id}` | 同新增 | |
+| 删除脚本 | DELETE | `/api/scripts/{id}` | 路径 | |
+| **脚本试算** | POST | `/api/scripts/preview` | `{formula, target?, w?, h?, glass_area?, sashes?, meters_*?}` | 对齐目标站 product-test；返回 `{result, vars}` |
+| 报价启用脚本 | POST | `/api/offer-price` | 增加 `use_scripts: true` 或 `scripts: {target: formula}` | 响应加 `scripted[]`(被脚本覆盖的项)、`script_total`(总价是否被脚本直取)；行级 `scripted` 标记 |
+
+种子示例脚本 5 条：断桥铝-55系列（frame/mullion/sash）、双层中空玻璃（glass）、标准五金（hardware）。