Technical Discovery（技术调研）
知识库位置：
FDE Knowledge Base/07 Playbooks/04-Technical-Discovery.md
Playbook Metadata（手册元数据）
Section titled “Playbook Metadata（手册元数据）”Playbook ID: PB-004
Stage（所属阶段）:Discovery / Solution Design（客户调研 / 方案设计）
Primary Goal（主要目标）:Remove technical unknowns before solution design.（在方案设计前消除技术未知数。）
Typical Duration（典型时长）:60–120 minutes（可多场）
Primary Audience（主要使用者）:FDE + Customer IT / Data / Security
Difficulty（难度）:Intermediate（进阶）
Status: CoreVersion: v0.1Objective（目标）
Section titled “Objective（目标）”确认业务 Use Case（用例）在客户真实技术环境中：
能不能做、怎么接、有哪些风险。
Technical Discovery 不是完整 Solution Design（方案设计）。
它的任务是：
去掉技术上的未知数。
Focus Areas（关注领域）
Section titled “Focus Areas（关注领域）”Systems（系统）Data（数据）Integration（集成）Identity（身份）Security（安全）Infrastructure（基础设施）Operations（运营）Constraints（约束）Participants（参与者）
Section titled “Participants（参与者）”建议：
- FDE
- Customer Engineer（客户工程师）
- IT（信息技术部门）
- Data Team（数据团队）
- Security（安全团队）
- Infrastructure（基础设施团队）
- System Owners（系统责任人）
System Landscape（系统全景）
Section titled “System Landscape（系统全景）”首先画：
Users（用户）↓Applications（应用）↓APIs（接口）↓Databases（数据库）↓External Systems（外部系统）明确每个系统：
- Owner（责任人）
- Purpose（用途）
- API Availability（接口可用性）
- Authentication（认证方式）
- Environment（环境）
- Documentation（文档）
Enterprise System Inventory（企业系统盘点）
Section titled “Enterprise System Inventory（企业系统盘点）”第二十批 Enterprise Field Primer（企业环境入门页）落地后，Technical Discovery 应为每个企业系统登记：
System（系统）:Category（类别）:Business Purpose（业务用途）:Owner（责任人）:Criticality（关键性）:Source of Truth For（作为哪些数据的事实来源）:Read Interface（读接口）:Write Interface（写接口）:Auth（认证方式）:Freshness（数据新鲜度）:Production Constraints（生产约束）:Category（类别）取值：
CRM（客户关系管理）ERP（企业资源计划）MES（制造执行系统）Warehouse（数据仓库）Lake（数据湖）Event Platform（事件平台）Custom Application（自建应用）External SaaS（外部 SaaS 服务）System-of-Record Map（记录系统映射表）
Section titled “System-of-Record Map（记录系统映射表）”非常建议在 Technical Discovery 中增加业务实体级映射：
| Business Entity（业务实体） | Source of Truth（唯一事实来源） | Read Interface（读接口） | Write Interface（写接口） | Owner（责任人） |
|---|---|---|---|---|
| Customer（客户） | CRM | API | CRM API | Sales Ops（销售运营） |
| Invoice（发票） | ERP | API | ERP API | Finance（财务） |
| Production Order（生产工单） | MES / ERP | API | Controlled（受控） | Manufacturing（制造） |
| Historical Sales（历史销售） | Warehouse（数据仓库） | SQL | Pipeline only（仅管道） | Data（数据团队） |
| Raw Events（原始事件） | Lake（数据湖） | Query / files（查询/文件） | Pipeline（管道） | Data（数据团队） |
| Order Events（订单事件） | Kafka | Consumer（消费者） | Producer（生产者） | Platform（平台团队） |
这个表比单纯系统架构图更容易暴露：
Ownership（归属）和 Integration Boundary（集成边界）。
系统背景知识见 Engineering Knowledge Map（工程知识地图） 中的 Enterprise Field Primer 速查。
Data Discovery（数据调研）
Section titled “Data Discovery（数据调研）”对每个数据源记录：
Source（来源）Owner（责任人）Format（格式）Volume（数据量）Freshness（新鲜度）Quality（质量）Access Method（访问方式）PII?（是否含个人身份信息）Retention（保留策略）Integration Discovery（集成调研）
Section titled “Integration Discovery（集成调研）”问：
- REST API？
- Webhook（Web 回调）？
- Events（事件）？
- Database Access（数据库访问）？
- SFTP（安全文件传输协议）？
- Legacy Protocol（遗留协议）？
记录：
Authentication（认证）Rate Limit（速率限制）Latency（延迟）Sandbox（沙箱环境）Production Access（生产访问权限）Identity & Security（身份与安全）
Section titled “Identity & Security（身份与安全）”必须明确：
- SSO Provider（单点登录提供方）
- OAuth Availability（OAuth 可用性）
- RBAC（基于角色的访问控制）
- Group Mapping（组映射）
- User Identity Propagation（用户身份透传）
- Service Account（服务账号）
- Data Classification（数据分级）
Infrastructure（基础设施）
Section titled “Infrastructure（基础设施）”问：
- Cloud（云）？
- On-prem（本地部署）？
- Hybrid（混合）？
- Kubernetes（容器编排）？
- VM（虚拟机）？
- Serverless（无服务器）？
- Private Network（私有网络）？
- VPN？
- Proxy（代理）？
- Firewall（防火墙）？
AI-specific Questions（AI 特有问题）
Section titled “AI-specific Questions（AI 特有问题）”如果涉及 AI：
- 哪些数据允许发给模型？
- 是否允许外部 API？
- 模型区域要求？
- 是否需要 Self-hosted（自托管）？
- 是否允许日志记录 Prompt（提示词）？
- 是否存在敏感字段？
Technical Discovery Output（技术调研产出）
Section titled “Technical Discovery Output（技术调研产出）”建议形成：
System Landscape Diagram（系统全景图）
Section titled “System Landscape Diagram（系统全景图）”Enterprise System Inventory（企业系统盘点）
Section titled “Enterprise System Inventory（企业系统盘点）”System-of-Record Map（记录系统映射表）
Section titled “System-of-Record Map（记录系统映射表）”Integration Inventory（集成清单）
Section titled “Integration Inventory（集成清单）”Data Inventory（数据清单）
Section titled “Data Inventory（数据清单）”Identity Model（身份模型）
Section titled “Identity Model（身份模型）”Security Constraints（安全约束）
Section titled “Security Constraints（安全约束）”Environment Constraints（环境约束）
Section titled “Environment Constraints（环境约束）”Technical Risks（技术风险）
Section titled “Technical Risks（技术风险）”Unknowns（未知项）
Section titled “Unknowns（未知项）”Prototype Validation Plan（原型验证计划）
Section titled “Prototype Validation Plan（原型验证计划）”Red Flags（红旗信号）
Section titled “Red Flags（红旗信号）”- 没有 API 文档
- Production（生产）和 Sandbox（沙箱）差异巨大
- 权限 Owner（责任人）不清楚
- 数据实际不可访问
- Security 审批需要几个月
- 客户说「实时」，但没人定义实时
- 所有测试都使用管理员账号
Exit Criteria（退出条件）
Section titled “Exit Criteria（退出条件）”能够进入 Architecture Workshop（架构工作坊）时，至少应该知道：
主要系统是什么、数据在哪里、权限怎么工作、最关键风险是什么。