从哪开始：按角色找到你的故事
全站 46 个主题、171 个故事，覆盖 AIP / Foundry / Apollo / Gotham / Swift 五条产品线与跨产品叙事。别从第一个主题慢慢翻——先选你的角色，从这里出发。每条路线都给你「先读 2~3 篇」建立全貌，再给「再深入」按需补课。
怎么用本页
每个角色小节都是独立路线，按「这个角色关心什么 → 先读哪几篇 → 再深入看哪几篇」组织。先读的 2~3 篇足够让你对该产品建立「能做什么、边界在哪」的准确认知；再深入的内容按需选读，不必一次看完。想直接上手操作，直接跳到最后的「想动手试」。
业务用户 / 老板
你不想碰 SQL 和技术细节，只关心一件事：想查的数据能不能用一句话问到，口径准不准，值不值得为它投入。这条线带你走「AIP 自然语言查数 → Foundry 语义口径 → 跨产品价值链」。
先读这 2~3 篇
再深入
- Foundry · 指标语义层：口径统一 —— 想知道 total_gmv、aov 这些口径是谁定、怎么对得上的，看这一篇。
- 跨产品 · 角色视角：四类角色的一天 —— 看看老板 / 分析师一天里如何消费各产品结论。
- 跨产品 · 限制综述 —— 决定投入前，先知道平台的共同底线在哪。
数据工程师
你负责把数据变成业务资产：接数据源、建对象、跑管道、管质量、走版本。这条线以 Foundry 为主，收尾补 AIP 的数据源接入，覆盖「建模 → 管道 → 血缘 → 质量 → 本体即代码」全链路。
先读这 2~3 篇
再深入
- Foundry · 数据血缘：来路与去向 —— 源表 → 管道 → 对象 → 指标四级链路，改表先评估影响。
- Foundry · 数据质量：规则与闭环 —— 把质量门槛前置到管道运行时，让坏数据进不了下游。
- Foundry · YAML 导入导出：本体即代码 —— 对象定义进 Git、跨环境迁移，像管代码一样管本体。
- Foundry · 版本治理 —— draft → review → merged 受控变更，改错可回滚。
- AIP · 数据源接入：注册、测试与导入元数据 —— 为 AIP 自然语言查数准备数据源与元数据。
运维 / SRE
你负责把软件与配置安全地分发到环境里，并保证环境不漂移、出问题能回退。这条线以 Apollo 为主：期望状态声明 → DAG 分批部署 → 漂移检测 → 回滚，最后了解 Spoke 拉取式部署的触角机制。
先读这 2~3 篇
再深入
- Apollo · 回滚与部署锁 —— 任意历史版本回滚、失败自动回滚、同一 Agent 部署锁串行化。
- Apollo · Spoke Agent 拉取式部署 —— Agent 出向拉取 / 上报，控制面永不主动连入客户环境。
- Apollo · 发布策略 —— auto_rollback、就绪超时、并发上限、漂移忽略路径等 policy-as-code。
- Apollo · Bundle 签名与验签 —— SM3 清单 + SM2 签名 + 信任锚，供应链安全的第一道闸。
分析师 / 风控 / 审计
你负责把「关系」查清楚：谁跟谁有关、钱流去哪、异常有没有人盯。这条线以 Gotham 为主：先看懂图谱，再做图分析、多源融合与实体解析，最后掌握模式识别与情报报告。
先读这 2~3 篇
再深入
- Gotham · 实体解析：把「同一个人」认出来 —— 四层流水线打分、union-find 聚类、三阈值分流，跨源同名同人自动归并。
- Gotham · 模式识别：让系统替你盯异常 —— 高频事件与异常资金自动命中告警，形成处置闭环。
- Gotham · 情报报告：从数据到可分发简报 —— 从数据生成简报并导出 PDF / DOCX / HTML。
- Gotham · 行业场景：五类实战打法 —— 反洗钱、竞品分析、内审反欺诈、经侦、决策简报五种套路。
- Gotham · 时空分析 —— 把事件放到地图和时间轴上，看区域聚合。
决策者
你不操作细节，但要对「这套平台值不值得投」做判断：价值链通不通、边界在哪、演示到底能看什么。这条线从跨产品视角给全貌，再以 Swift 愿景看未来。
先读这 2~3 篇
再深入
- Swift · 愿景篇：天地一体结算 —— P5 是设计愿景（暂无实现），看它如何把矩阵延伸到星基金融。
- 跨产品 · 迁移指南 —— 从 Excel / 手工 SQL / 旧流程迁移，估算落地工作量。
- Gotham · 情报报告 —— 决策者消费的情报简报怎么生成与分发。
想动手试
五个产品的演示后端都可用 admin / admin1 登录，前端统一走 Vite 5173（按产品前缀分流）。每款产品都有配套的「动手试一试」步骤写进故事里，最稳的入口是各产品落地页的快速上手。
常见问题
每个故事都长一样吗？
每个故事固定九要素：背景、传统做法对比、角色、操作步骤、系统响应、结果洞察、调整建议、动手试一试、限制提示。读法建议：先看「背景 + 结果洞察」了解大意，再按需看「操作步骤 + 系统响应」复现，最后一定看「限制提示」知道边界。
看完主题页就能上手操作吗？
大部分可以。每个故事的「动手试一试」都给了登录账号、页面路径、输入内容和预期结果，照着走即可。需要先启动对应产品的后端（AIP 18080 / Foundry 18081 / Apollo 18082 / Gotham 18083），或经前端 Vite 5173 按前缀访问。
先读全站 index 还是先看新手向导？
index 适合「有明确目标时搜索」，新手向导适合「不知道从哪开始」。建议第一次来先按角色走一遍本页；熟悉之后，用 index 的搜索 / 产品过滤按需找主题。
演示数据为什么总被重置？
各产品演示数据都是服务器启动时现场生成（SQLite / 内存库），重启即还原。这是有意为之：保证任何人都能反复练习同一套场景。平台侧的元数据、审计日志等会持久保存，不影响回看。
Swift 能体验吗？
不能。Swift 是设计愿景（P5，暂无实现），只能读架构、安全、路线图等主题页了解方向。涉及 Swift 的故事都会明确标注「设计愿景」，不会把愿景当已交付能力。