KAM 千路文档标准

千路=询价管理+出入库/WMS(开发中)。本包权威=询价侧 Excel 表头/文件名(REFERENCE §1–10)、报价对比§12；问价单导出与报价单导入列对齐（含 MOQ/MPQ，无「状态」列）。术语/流程=naming+process。触发：表头命名、单据核验、报价对比矩阵、两子系统边界、filebrowser、采购单回传作用。

kam-qianlu-doc-standards（精简版，详表见 REFERENCE）

版本 version：与仓库 Git 带 v 前缀的语义化 tag 对齐（当前 v6.1.2）。打新 tag 时请同步更新本文件 frontmatter 中的 version，避免 skill 与线上/发布口径漂移。

1. 产品边界（必答清）

• 询价管理系统：询价/报价/回询/订货/采购/报价对比/可订等 — 本 SKILL + 同目录 REFERENCE.md 管表头与文件名。
• 出入库管理系统（WMS）：开发中；实收核销、库内表头 不在此包权威范围，答用户时单列说明。
• 易混：「订货单入库完整版」= 询价侧导出给仓库用的 Excel，≠ WMS 产品本体。

2. 同目录文档（勿在对话里复述长表）

文件	内容
REFERENCE.md	§1–10 各单据表头/别名/文件名；§11 术语索引；§12 报价对比（基准单/品牌矩阵，仅有效报价单）
naming-and-terminology.md	术语、UI 用词
process-and-rules.md	流程、校验（订货↔回询匹配等）；与 apps/inquiry-server/docs/functions/process-and-rules.md 宜对照维护

3. 行为约定

• 查标准：按用户单据类型打开 REFERENCE 对应节，摘要要点即可；完整列名/别名以 REFERENCE 为准。
• 核验 Excel：确认类型 → 先问是否核验表头与建议文件名 → 用 openpyxl 找表头行（含「品牌」或 brand 的首行，否则第 1 行）→ 对照 REFERENCE 别名 → 输出映射 + §1 文件名规则。
• 术语/流程：REFERENCE §11 → 打开 naming 或 process。
• 上传：若有 filebrowser-api / kam-filebrowser-operator 可代传；本 skill 只做表头/命名。

4. 单据类型 → REFERENCE 节号（速查）

二询价导入 · 三报价导入 · 四问价导出（§4：第 1 行说明合并整行；表头 9 列 — 品牌、零件号、替换号、中文名称、数量、报价含税、MOQ、MPQ、备注；与 §3 报价单可识别列一致，不含「状态」）· 五回询导出（§5：英文表头 8 列 — BRAND、PARTS、QTY、PRICE、MOQ、MPQ、Replace No、价差比例）· 六订货导入 · 七订货导出（§7.1 校对版 9 列 / §7.2 入库版 11 列）· 八采购导出 · 九采购单回传导入 · 十可订导入 · 十二报价对比

问价单（实现一句）：常量 QUOTE_REQUEST_HEADERS / build_quote_request_excel 见 apps/inquiry-server/server/services/rfq_quote_group_service.py；规范 §5.8 见 apps/inquiry-server/docs/requirements-0309-1122.md。

采购单回传（业务一句）：我方导出采购单 → 供应商填无效/替换号/备注 → 文件 校对-采购单-*.xlsx 再导入 → 按品牌+零件号更新订货行，与线下一致。

5. 与 apps/inquiry-* 实现锚点（写代码/对需求时优先查）

以下为 AI-CRM 询价子系统 中与「单据格式、导入导出、校对」最直接相关的路径；表头别名仍以 REFERENCE + 后端 ORDER_HEADER_ALIASES 为准，勿仅凭记忆改列名。

5.1 后端 apps/inquiry-server

主题	位置
问价单 Excel 导出（组 / ZIP）	server/services/rfq_quote_group_service.py → QUOTE_REQUEST_HEADERS、INSTRUCTION_ROW、build_quote_request_excel、build_batch_export_zip；路由 server/routers/rfq.py（/groups/{id}/export、batch-export）
订货单 Excel 列检测与别名	server/services/order_import_service.py → ORDER_HEADER_ALIASES、detect_order_columns
订货导入/校对版导出/订单校对 API 数据	同上 → import_order_excel、export_order_excel、get_order_verify、parse_order_feedback_excel 等
订货单列表（含「采购关联」统计）	server/routers/order.py → list_orders（matched_items = 订货明细与 confirmed_purchase 命中行数）
采购汇总、确认入库、已确认采购、导出	server/routers/purchase.py；业务实现多在 server/services/purchase_summary_service.py、purchase_feedback_service.py
待订单校对（推导、与订货基准比对）	server/services/confirmed_feedback_derive.py
报价对比导出	server/services/compare_service.py（矩阵/基准与 REFERENCE §12 一致）
可订库 / 替换号	server/services/availability_service.py 等
补充需求与历史说明	apps/inquiry-server/docs/、docs/requirements-*.md（仓库根目录）

5.2 前端 apps/inquiry-web

主题	位置
询价单操作总页（Tab：回询/订货匹配/采购单生成等）	src/pages/RfqOperatePage.tsx
问价单组、生成/打包下载	src/pages/RfqOperate/AskTab.tsx；API src/api/rfq.ts（exportQuoteRequest、exportQuoteRequestBatch）
订货单列表与切换	src/pages/RfqOperate/OrderListSection.tsx
订货单匹配 / 校对表格	src/pages/RfqOperate/OrderVerifySection.tsx、OrderFeedbackPanel.tsx
采购单生成工作台与已确认采购	src/pages/RfqOperate/PurchaseConfirmSection.tsx
API 类型与请求	src/api/order.ts、src/api/purchase.ts
采购工作台本地草稿	src/utils/workbenchStorage.ts

5.3 仓库级说明

• 工作区约定与 MySQL 本地配置摘要：仓库根目录 CLAUDE.md（与 skill 互补：skill 管单据标准，CLAUDE 管怎么跑项目）。

6. ClawHub / 嵌入

正文刻意缩短以防 8192 token 上限；任何「完整表头表」必须从 REFERENCE.md 读取，不要凭记忆编造列名。