多项目报价对比看板（Multi-Project Quote Board）
把「一批同口径询价的多家回标」变成「一份可决策的双语看板 + 一张可存档的 Excel」。
本技能不含任何真实门店/供应商名称，全部由数据层驱动；换项目、换供应商数量、换货币、换工期门槛都不需要改渲染代码。模板自带可跑的脱敏示例（2 个项目 × 3 家供应商），python gen_board.py 即可出图。
1. 定位与边界
| 场景 | 用本技能 | 改用 |
|---|---|---|
| 同一批供应商、多个子项目横向比价（报价 + 工期 + 条款 + 定标建议） | ✅ | |
| 单项目、多供应商、需要「分部分项 + 单方造价 + 异常核查 + 历史门店对比」 | ➖ | bid-quote-cockpit |
| 只要一份轻量「双方案/多方案价格对比」可视化（成本构成堆叠条 / 周期时间轴 / tradeoff 结论卡） | ➖ | bilingual-price-compare |
| 某家澄清/修订后报价回灌既有对比表 | ➖ | bid-quote-clarification-sync |
| 两家 Excel/BOQ 逐行机械比对 | ➖ | excel-quote-compare |
与 bid-quote-cockpit 的关键区别（选型要点）：
| 维度 | multi-project-quote-board（本技能） | bid-quote-cockpit |
|---|---|---|
| 项目数 | 多项目并置（本项目核心） | 单项目为主 |
| 跨项目合计 | 明令禁止，分项目独立定标 | 不涉及 |
| 定标逻辑 | 内置工期门槛 + 最低价判定（7.1–7.5） | 侧重总价排名/异常核查，定标为可选模块 |
| 配置方式 | 直接改 Python 数据层（dict） | 填 config.json / quotes.json |
| 交付物 | HTML + 结构对齐的 Excel（6 sheet） | HTML（+ 可选） |
| 依赖 | 纯标准库出 HTML；Excel 需 openpyxl | 需内联 echarts |
> 共用红线：只用报价原文数字，禁止补全/估算/同口径估算；勾稽 生产 + 运输 + 安装 == Total 必须全通过。
2. 快速开始（3 步）
SK=~/.workbuddy/skills/multi-project-quote-board
# 1. 复制模板到工作目录
cp $SK/scripts/gen_board.py ./gen_board.py
cp $SK/scripts/gen_excel.py ./gen_excel.py
# 2. 改 gen_board.py 顶部 DATA LAYER（只改这一处！）—— 项目/供应商/报价/工期/条款/待澄清
# 然后出 HTML 看板
python gen_board.py # → board.html（自带中英切换）
# 3. 用同一数据层出 Excel（务必用带 Pillow 的解释器，若含图片）
python gen_excel.py # → board.xlsx（6 个 sheet）
运行成功标志（务必核对）：
=== RECON (Unit+Transport+Install==Total): ALL OK ===
WROTE board.html bytes=...
WROTE board.xlsx bytes=...
> RECON 不是 ALL OK → 先修数字，不要交付。每一条 prod+trans+inst != total 的明细都会打印 RECON FAIL: <key> <pid> {...}。
3. 核心架构（勿改）
gen_board.py
├── ① DATA LAYER （上半部，标 "DATA LAYER —— 唯一手工维护区"）
│ BOARD_TITLE / PROJECTS / SUPPLIERS / QUOTES / LEAD_* / TERMS / CLAR / TRANS_NOTE
│ ⋮
│ # ============================ DATA LAYER END ============================
└── ② RENDER LAYER （下半部，读数据层出 HTML，一般不动）
gen_excel.py
读 gen_board.py → split("DATA LAYER END")[0] → exec 复用同一数据层 → 出 6 sheet
为什么这样设计： HTML 与 Excel 是两份交付物，若各自硬编码数字，迟早「HTML 改了 Excel 没改」。把数据层做成唯一的真源、Excel 生成器 exec 复用，口径在物理上不可能发叉。改一个报价只需改 QUOTES 一处。
DATA LAYER END 这行标记是契约：gen_excel.py 靠它切分。删掉或改写这行，Excel 生成器会直接 SystemExit。
4. 数据层字段速查
| 变量 | 作用 | 修改要点 |
|---|---|---|
BOARD_TITLE |
(中文标题, English title) 二元组 | H1 与 Excel 标题、<title> 同步 |
TENDER_DATE / INVITED_COUNT |
发标日 / 邀请家数 | 只用于总览副标题，不参与计算 |
PROJECTS |
[{id,name,area,qty}] 子项目列表 |
id 是 QUOTES 的键，一旦定下不要改 |
SUPPLIERS |
[{key,name,color,status,date}] |
status: received / pending（顺序即条款表列序，见 §6 坑 1） |
QUOTES |
{key:{pid:{prod,trans,inst,total}}} |
四值须满足 prod+trans+inst==total；只有原文数字 |
TRANS_NOTE |
{(key,pid):"已含在运输费用中"} |
驱动明细表数字格的三态文案（见 §7） |
LEAD_START |
统一起算日（下单日） | 定标工期门槛的基准 |
LEAD_DEADLINE |
安装完成截止日 | 完成日 <= 此日 → 满足工期 |
LEAD_SPAN |
{key:{pid:天数}} 自起算至完成总天数 |
严格取自报价原文 |
LEAD_ABS_END |
{key:{pid:date}} 绝对日期排期者 |
绝对日期者不顺延（见 §8） |
LEAD_BASIS / LEAD_BASIS_PID |
工期依据原文（中英） | 进「7.1 工期满足性判定表」的依据列 |
TERMS |
[(中,英, 各供应商取值…)] |
每条取值个数 == SUPPLIERS 个数，顺序对齐 |
CLAR |
[(级别,中,英)]，级别 P0/P1/P2 |
自动按 P0→P1→P2 排序 |
扩容（团队最常问）
- 新增一家供应商：
SUPPLIERS加 dict +QUOTES补该项目条目 +TERMS每行补一列 +TRANS_NOTE/LEAD_SPAN/LEAD_BASIS补键。渲染层无需动。 - 某家尚未回标：
status保持"pending"，看板自动渲染「待回标」占位行，不影响任何计算（RECV_KEYS只含received）。 - 只更新报价：只改
QUOTES数值 → 最低标高亮、差额、排序、定标结论全部自动重算。
5. 看板八大板块
| # | 板块 | 内容 |
|---|---|---|
| 一 | 回标状态与总览 | KPI 卡（已回标家数 / 各项目「满足工期+报价最低」）+ 供应商状态表 |
| 二 | 逐项目明细对比 | 生产 / 运输 / 安装 / Total / vs 最低；数字格三态（见 §7） |
| 三 | 工期（Lead Time）对比 | 各家所报工期 + 起算推算完成日 + 是否满足 |
| 四 | 条款对比 | 材质工艺 / 运输口径 / VAT / 付款条件… |
| 五 | 待澄清清单 | 按 P0 > P1 > P2 排序 |
| 六 | 各项目价格排序 | 纯价格排序，每项目独立一行，绝不做跨项目合计 |
| 七 | 定标建议 | 工期判定 + 满足者按价排序 + 推荐结论 + 需澄清 + 前置条件 |
| 八 | 扩容说明 | 数据层改动指引（写进看板，便于团队自查） |
⛔ 铁律：不做跨项目合计
本节（及全板）禁止把两个项目的总价加总。理由（已写入看板第六节说明）：不同项目的工程量与交付条件不同，合并总价无决策意义。若要表达「打包」，只能单列 what-if，且必须明确标注为情景假设、不进排名。
对应地：KPI 按项目拆成独立卡片、第六节删掉「两项目合计」行、7.3 结论按项目独立定标。Excel 侧同样（01 回标状态 无合计列、06 定标建议 无合计行）。
6. 数据层三大坑（必读）
坑 1 — TERMS 取值顺序必须 == SUPPLIERS 顺序
TERMS 每行是 (中, 英, v1, v2, v3…)，v1…vn 按 SUPPLIERS 顺序一一对应。若顺序错一位，整列条款错位且不报错（静默错误，最危险）。
坑 2 — 用 % 格式化大段 HTML 会炸
渲染层把整页 HTML 拼成一个字符串。若正文里出现 width:100%、%s 等，与 Python 的 % 格式化冲突 → TypeError: not enough arguments for format string，且产物静默为空。
模板的解法：标题用 token 占位 @@TITLE@@ + .replace("@@TITLE@@", …)，不用 % 拼标题。你新增含 % 的文案时，沿用局部拼接或 .replace()，别整段 %。
坑 3 — 明细表数字格三态不可混
运输/安装列取值只有三种合法形态：数字 / 已包含在运输费用中 / 未报价待澄清。由 cell_state() 依据 QUOTES 值 + TRANS_NOTE 自动派生，不要在数据格里手写中文（会把数字列变成文本列，Excel 求和/排序失效）。
7. 定标模块：工期门槛 + 最低价（本技能灵魂）
判定三原则（看板第七节顶部固定文案）：
- 起算日统一：全部按
LEAD_START（下单日）起算。 - 工期门槛：所报工期自起算日推算，能在
LEAD_DEADLINE前完成安装 → 满足；不能 → 列入「需请对方澄清」（⚠️ 不是直接淘汰）。 - 定标原则：满足工期者中，报价最低优先（工期是门槛，价格是排序键）。
实现函数（渲染层，Excel 侧同样实现一份）：
def lead_result(k, pid):
# 绝对日期排期者不顺延；其余 = 起算日 + 总天数
est = LEAD_ABS_END[k][pid] if (k in LEAD_ABS_END and pid in LEAD_ABS_END[k]) \
else LEAD_START + dt.timedelta(days=LEAD_SPAN[k][pid])
return {"days": …, "est": est, "ok": est <= LEAD_DEADLINE, …}
def sched_lowest(pid):
cand = sorted([k for k in RECV_KEYS if satisfied(k, pid)],
key=lambda k: QUOTES[k][pid]["total"])
if not cand: # 无人满足 → 回退纯最低（并须在看板提示）
cand = sorted(RECV_KEYS, key=lambda k: QUOTES[k][pid]["total"])
return cand[0], QUOTES[cand[0]][pid]["total"], cand
第七节固定结构（老板认可的清晰版式，勿改顺序）：
7.0 判定规则三条（灰底 info 卡）
7.1 工期满足性判定表（项目 × 供应商：所报工期 / 依据原文 / 完成日 / 是否满足）
7.2 满足工期的候选 —— 按报价排序（首位绿底 rec-row）
7.3 定标推荐结论（逐项目卡片：推荐 + 报价 + 备选）
7.4 需请对方澄清（工期不满足）—— 列出超出天数
7.5 定标前置条件（P0 未闭环不按当前价定标；起算日需各家认可）
KPI / chip 口径必须与定标口径一致：项目卡右上角「✓ 当前报价最低（工期满足+报价最低）」、KPI 卡取值都走 sched_lowest，不能显示纯最低价那家（否则会出现「KPI 说 A 最低，第七节却推 B」的自相矛盾）。
绝对日期特例（LEAD_ABS_END）：某些供应商给的是绝对排期（如「X 月 X 日完成」），不随统一起算日顺延。这类必须放进 LEAD_ABS_END，否则会被错误地按「起算日 + 天数」平移。
8. 双语切换机制（CSS-only，禁用脚本也能用）
- 正文每段用
<span class="zh">中文</span><span class="en">English</span>（模板封装为Z()/E()/BI(zh,en)）。 - 有两个隐藏 radio
#lzh/#len+body:has(#lzh:checked) .en{display:none}等 CSS 规则实现切换。 - JS 只用于 localStorage 记忆语言偏好，不承担切换逻辑 —— 因此断网/禁脚本时切换仍可用。
- 默认中文。
自检：zh span 数应等于 en span 数（模板示例 134 = 134）。不等 → 有段落漏了英文或漏了中文。
9. 环境要求
| 用途 | 要求 |
|---|---|
| 出 HTML | 任意 Python 3（纯标准库：os / datetime / html，无第三方依赖） |
| 出 Excel | openpyxl |
| Excel 嵌图（可选） | 必须用带 Pillow 的解释器，否则图片静默跳过（产物 media=0） |
本机固定用 venv 解释器（Pillow 10.4.0 + openpyxl 3.1.5）：
C:/Users/admin/.workbuddy/binaries/python/envs/default/Scripts/python.exe gen_excel.py
> 托管的基础解释器 3.13.12 无 PIL：openpyxl.drawing.image.Image 会全部静默跳过，xlsx 体积明显偏小（如 18KB）且无图片。出图必须走上面这个 venv 解释器。
10. 交付前检查清单
- [ ] 运行日志
=== RECON … ALL OK ===（每条明细勾稽通过） - [ ]
board.html已生成，浏览器打开：中/英切换正常，两语字数相等 - [ ] 全板无跨项目合计（KPI 分项目、第六节无合计行、7.3 分项目独立、Excel 同）
- [ ] KPI/chip 的「最低」= 满足工期者中的最低（与第七节结论一致）
- [ ]
LEAD_START/LEAD_DEADLINE全文一致，无残留旧日期 - [ ] 待澄清 P0 项已在看板第五节列全
- [ ] 所有数字与报价原文逐条可对（禁止补全/估算）
- [ ]
board.xlsx6 个 sheet 齐全，条款表列顺序 == 供应商顺序
11. 参考
scripts/gen_board.py—— 数据层 + 渲染层模板（可直接改，含脱敏示例）scripts/gen_excel.py—— 复用数据层出 6 sheet Excelreferences/pitfalls.md—— 踩坑与修复记录（%格式化、条款错位、图片静默跳过、双语不等长等）
关联技能：bid-quote-cockpit（单项目重看板）、bilingual-price-compare（轻量双方案对比）、bid-quote-clarification-sync（澄清回灌）、excel-quote-compare（机械比对）、bid-price-analysis（商务标分析表）。
