# customer 域设计总纲（客户与机会）

LLMS 索引： [llms.txt](/llms.txt)

---

> **源**：PRD「八、页面架构与关键页面设计」页面树 2「客户与机会」+「七、核心功能逐项需求」之「6.1 客户询价与多版本报价」（客户前置、询价登记与转报价链路、权限）+「6.9 发货、签收与差异」（地址变更审批边界）；调研「七、需求条目统一编号与优先级判定」——本域无专属 R 条目，地址边界承 PRD 6.9。P0 裁决见决策记录：44 问 triage §2/§5。
>
> **设计确认门：本稿产出即停点，用户确认后才进下一步（FSD 于 B5 完成后统一编制，2026-10-21 裁决）。**
>
> 状态：**已确认**（2026-10-21 用户确认 B3；后续修订追加登记于本行下方）
> 修订：2026-10-21 B3 定稿确认。（FSD `00-总则` 修订记录待 Phase 3 创建时补记本次定稿）
> 修订：2026-10-21 Phase 3 样板先行——FSD ID 冻结（F02.01~F02.03/m02），本表 FSD ID 列由册粒度占位细化为功能 ID（m02 册已建：`prd/fsd/m02-客户机会.md`）。
> 原型：`html/index.html` 导航 + 3 屏，零依赖静态 HTML；预览走文档站（相对链接以站点布局为准）。

## 页面清单

| 屏 | 原型文件 | 对应真实路由 | 交互点 | 覆盖的 FSD ID |
|----|----------|--------------|--------|----------------------------|
| 客户列表 | [customer-list.html](/poms/design/html/customer/customer-list.html) | `/customers` | 检索筛选（关键词/行业/状态/销售归属）；客户行=主联系人/在跟订单/最近成交；新建客户（**草稿可存**——6.1 前置「客户存在或草稿可存」）；链接详情；敏感列不进列表（应收台账归 settlement，财务可见——Q41） | F02.01（建档与档案） |
| 客户详情 | [customer-detail.html](/poms/design/html/customer/customer-detail.html) | `/customers/{customerId}` | 档案 kv（联系人/开票/付款条款/税率口径/销售归属）；发货地址卡**只读**——变更须销售申请、经订单域审批（PRD 6.9，与 shipping 域边界一致）；关联单据 tab（报价/订单/对账，跨域跳转）；主数据变更不回写已确认单据（Q18：快照在订单域冻结，本页提示行）；信用/收款策略由财务启用（6.2 注） | F02.01（档案维护）、F02.03（单据关联/信用策略） |
| 询价/商机详情 | [inquiry-detail.html](/poms/design/html/customer/inquiry-detail.html) | `/customers/{customerId}/inquiries/{inquiryId}` | 需求登记（品名/数量档/成品尺寸/材料意向/色数/表面处理/后道/交期/收货地/样品/特殊要求——6.1 字段要点）；商机阶段推进；沟通留痕；**转报价**入口（生成报价草稿，链接 quotation 域）；关联报价版本链回显；客户确认前不得占用库存承诺（6.1 异常） | F02.02（询价与商机） |

> 归并说明：询价列表不设独立屏——询价以客户详情 tab + 本屏承载（低频入口，与 B1「取消/恢复归并订单详情弹层」同思路）。

## 状态迁移（客户建档 + 询价商机链路，PRD 6.1）

```mermaid
stateDiagram-v2
    [*] --> 客户草稿: 快速建档（6.1 前置「草稿可存」）
    客户草稿 --> 启用: 补全档案必填项
    启用 --> 停用: 停用（历史单据与审计保留）
    [*] --> 询价登记
    询价登记 --> 需求确认: 补全需求要素
    需求确认 --> 已转报价: 生成报价草稿（链接 quotation 域）
    已转报价 --> 已成交: 报价客户确认+版本锁定+转订单（回链基线）
    已转报价 --> 已关闭: 流失/搁置（原因留痕）
    已成交 --> [*]
    已关闭 --> [*]
```

> 客户主数据（联系人/地址/付款条款）变更不回写已确认单据——报价/订单按确认时点冻结（Q18/R-008，快照承载在订单域）。

## 裁决引用（本域设计吸收的 Phase 0 裁决与假设标注）

| 裁决/问题 | 内容 | 落地点 |
|-----------|------|--------|
| **Q41**（已采纳） | 敏感数据三角色可见：成本/毛利仅厂长+财务+报价核价；报价对销售/客服可见；客户列表不放应收 | 客户列表敏感列不设 + 详情页可见性注 |
| **Q18**（已确认方向）/ R-008 | 已确认单据冻结快照，主数据变化默认不回写 | 客户详情「变更不回写」提示行（快照承载在订单域） |
| **Q8**（假设，待确认） | 合同/电子签章/样品确认：MVP 纸质留档+上传，电子签章 P1+ | 客户附件（合同/资质）留档注 |
| **PRD 6.9**（既有规则） | 收货地址变更须销售申请/订单域审批 | 客户详情发货地址卡只读小注 |

**假设标注约定**：原型页面内未裁决参数以「假设（Q<n>，待客户确认）」内联标注；访谈候选值（Q13/Q20/Q27/Q28/Q36）在本域不出现数值，凡页面出现的数字均为示例数据（页面内联 mock），禁预设入 FSD。

## 覆盖性对账

- 对应 FSD 册：**m02 客户机会**（样板先行批已建：`prd/fsd/m02-客户机会.md`，F02.01~F02.03）——双向关联两侧无空（2026-10-21 样板先行互挂）。
- 页面树 2「客户与机会」3 节点全覆盖（客户列表/客户详情/询价-商机详情）。

---

反链：

- [交互设计](/poms/design/)
- [FSD M2 · 客户机会](/poms/fsd/m02-%E5%AE%A2%E6%88%B7%E6%9C%BA%E4%BC%9A/)