3.5 KiB
数据源接入架构与 TDX PoC 规划
方案结论
当前采用“平台先行、采集器后置”。Mac 本地开发以固定样本回放为默认 Provider；需要验证真实字段时，通过 Tailscale + SSH 隧道访问家中 Windows 的 TDX 127.0.0.1:17709。不在当前阶段实现 Windows 常驻采集程序、GUI 或公网推送。
固定样本 / Mac TDX 隧道
↓
DataProvider 端口
↓
标准化市场事件 → 市场概览业务
未来公网模式：采集器 → 多目标隔离推送 → 平台接收 API
方案比较
- 本地样本回放（当前采用）：不引入 Windows/公网依赖，测试稳定可重复，适合先开发市场概览；缺点是不能代表实时数据质量。
- Mac 通过 Tailscale SSH 隧道调用 TDX（当前联调）：可以验证真实字段，但依赖家中 Windows 在线和人工维护。
- Windows 常驻采集器（延期）：未来可选 Node、Python、Go、Rust、Electron、Tauri 或系统服务，必须按部署规模、资源、自动更新和安全能力重新评估。
当前组件边界
当前只新增/维护平台侧 Provider 端口和固定样本。样本 Provider 与真实 TDX Provider 使用同一标准化契约，市场概览不感知来源差异。未来采集器应作为独立项目或 workspace，不反向污染 NestJS 业务模块；公网接收 API、目标队列、签名握手和 GUI 另立功能档案。
Provider 与事件模型
Provider 生成不可变标准化事件，包含 eventId、source、capturedAt、tradeDate、schemaVersion、traceId 和数据新鲜度。TDX 原始字段只能存在于 Adapter 内，规则分析、AI 分析、API 和页面只依赖内部模型。
安全策略与评估
- Mac 本地样本和 TDX 隧道均不接触生产配置、生产数据库或公网接收 API。
- 真实 TDX 只读调用使用 SSH 密钥隧道，
17709、SSH 和 RDP 不做公网端口映射。 - 样本删除凭据、家庭地址和无关原始字段；日志只保存统一错误分类和性能摘要。
- 未来采集器的密钥存储、目标认证、IPC 和自动更新不在当前方案中预设，必须重新安全评估。
- 数据再分发许可属于外部合规风险。PoC 只用于个人开发验证，不宣称获得商业展示或再分发授权。
性能目标与评估
- 固定样本回放必须确定性、可重复且不访问网络；Provider 标准化耗时纳入单元测试与基准记录。
- 真实 TDX 请求目标超时 5 秒并记录响应耗时和字段完整性。
- 公网上传并发、队列容量、心跳周期和 GUI 资源目标延期到采集器立项，不在当前阶段作容量承诺。
失败恢复
TDX 请求失败返回统一错误分类和陈旧状态；本地平台可切回固定样本继续开发，不能把样本伪装为实时行情。上传重试、补传、熔断和备用免费源切换属于后续公网功能。
测试边界
单元测试使用固定 TDX 响应验证 Provider、标准化和错误映射；通过 Tailscale SSH 隧道做真实只读冒烟。Electron/Tauri 安装、托盘、开机启动、操作系统密钥存储、目标队列和公网接收测试延期，不能在当前阶段宣称通过。
依赖与退出方案
当前不新增 Electron、Python、Go、Rust 或其他采集器运行时依赖。未来采集器实现前重新比较语言、部署形态、许可证、资源、自动更新和安全边界；只要遵循 Provider/上传契约，采集器可替换而不改市场概览。