产品架构

产品研究链

产品不把研究人员的模型直接当作首页导航。首页以用户问题为入口，研究链是用户进入问题后的解释骨架，Evidence 是可信度系统，Research State 负责保存当前研究对象和后续观察。

Population → Cohort → Spatial / System → Impact

以下证据层贯穿整个过程：

Evidence · Source · Confidence · Data Gap

这不是一条只能从左到右点击的页面菜单，而是产品组织研究问题的方式：先确定人口变化，再明确是哪一代人、发生在哪些空间和系统，最后讨论可能的现实影响。

面向用户的简化表达是：

人从哪里来 → 人往哪里去 → 系统怎么调整 → 对你意味着什么

这条链路对应统一的 Research Chain Protocol v1。协议把节点分为 Population、Spatial、System、Outcome 和 Feedback，把每个节点的值区分为 Stock、Flow、Rate、Capacity、Constraint 或 State；关系上记录机制、Evidence / Source、Lag、Buffer、反向因素和 Data Gap。

全球参照是 Reference Context Layer

全球参照位于研究链旁边，而不是新增一个从 Population 直接跳到 Impact 的节点：

Population → Cohort → Spatial / System → Impact
                         ↑
              Global Reference Context

它通过 country registry 统一国家/地区实体与 ISO3，通过 indicator registry 统一指标定义、单位、来源、时间范围、数据状态和可比性说明。它回答“各国在同一个年份坐标上处于什么位置、历史如何移动”，不回答“某国一定会复制另一国的结果”。

运行时还受三份版本化治理对象约束：实体 crosswalk 负责 WPP 与 WDI 的显式 join，WDI provenance registry 负责区分数据集级与逐点审计，demographic-time registry 负责总人口、劳动年龄和家庭户时间锚点。三者都可以保留 under_review / data_gap，不能为了让页面完整而补成 Actual。

全球参照的四个视图分别解决：同年比较看不同国家的位置；历史变化看一个国家人口与经济指标的长期变化；发展路径看国家在 65+ 占比 × PPP 人均 GDP 坐标中的历史轨迹；数据表支持逐项核对与结构化导出。默认使用共同年份；“最新可用”必须同时显示每个数据点的年份。经济没有长期 Projection 时，路径不向未来延伸。

省级统计是 Reference Context Layer

中国大陆 31 个省级统计区域的 GDP、产业构成、人口构成与增速通过 /project/provincial-statistics 提供可查询的省级事实参考。该层保留 placeId、官方代码、年份、来源表和边界版本，并把产业占比、城镇化率、人口同比等派生值和计算输入一起展示。它服务于省级横截面与研究背景，不是城市选择评分层；省级事实不能替代城市/区县 exact-scope 证据，也不生成排名、预测或城市结论。

各层解决什么问题

Population

回答人口发生了什么变化：总量、年龄组、占比、年份、Actual / Projection 和数据轨道。

Cohort

回答具体是哪一代、哪一个年龄群体发生变化，以及它们进入不同生命周期研究窗口的大致时间。生命周期节点是研究年龄区间，不代表个体必然发生对应行为。

Spatial

回答人口向哪里迁移、集中或流失。当前产品已有国家和跨国参照基础，但空间机制和县域级判断仍受数据粒度限制，独立的 Spatial 模型属于下一阶段。

System

回答学校、医院、住房、财政、公共服务等系统的需求和存量如何发生错配。当前产品有相关研究边界和社会运行证据，但还没有统一的系统存量模型。

Impact

回答人口与 Cohort 变化可能通过哪些机制影响职业、行业、资产和公共服务。Impact 结论必须经过机制、反向因素、Evidence 和适用范围约束。

未来的地方研究还必须通过 Place Data Readiness Gate：Place 只提供稳定 identity、层级和边界版本；ResearchScope 记录观察/投影期间；Readiness 根据具体研究问题检查人口、空间迁移、系统存量、地方规则和调整滞后。它不输出安全分、风险分或综合排名。

结论阅读层提供 Stability / Prosperity 两个并列视角：前者解释系统连续性、可达性和调整能力，后者解释长期需求、生产率和机会空间。它们不改变结论可信度，也不对 Place 生成分数或排名。

Place Dossier 是研究组织层，不把地区选择直接塞进 Population、Cohort 或现有 runtime。与地区边界严格对齐的 Local Evidence 才能进入 Readiness；全国、省级或其他地区资料只能作为 Reference Evidence 解释机制和迁移条件；本阶段不生成 Local Conclusion。/project/place-dossier 使用合成县验证这条边界，不是正式 /place 产品。

证据层如何贯穿

• Evidence 说明一个事实或案例对当前问题提供了什么支持。
• Source 记录来源 ID、机构、数据集、统计口径、版本和原始链接。
• Confidence 区分人口底座、机制证据和本地适用性的不同不确定性。
• Data Gap 把没有足够数据回答的问题作为正式产品对象，而不是脚注。

因此，一个可发布结论的基本链路是：

人口事实 → 机制假设 → Evidence → Source → 结论边界

如果中间缺少本地数据或机制证据，应显示 Data Gap 或 under_review，而不是补一个看似精确的答案。

决策体验层：把研究带回真实问题

现有研究链不是被替代的后台，而是面向用户决策的解释基础设施。产品新增一层 Decision Experience：先从“我正在做什么长期选择”进入，再把人的阶段、时间跨度和关注重点映射到研究链。

Person × City × Time × Priorities
              ↓
      Decision Experience
              ↓
Population → Cohort → Spatial / System → Impact
              ↓
Evidence · Source · Confidence · Data Gap

当前双城页面以“事实比较”呈现：固定武汉与成都，按已有城市资料展示人口、住房、收入及财政背景，逐项保留统计时期、单位、来源与可比边界。尚缺岗位、服务可达性或同口径跨年证据的部分继续标明缺口；人口情景是独立的假设实验，不升级为城市事实。页面不输出赢家、评分、排名、推荐或短期房价预测。

城市选择长期采用五层数据架构，但五层不是五个孤立的栏目，也不是把所有指标压成一个总分：

1. 人口底盘 Population：总量、年龄结构、青年人口、家庭户与人口路径。
2. 人口流动 Migration / Attraction：自然变化、青年吸引、落户、都市圈集中与区县差异。
3. 工作与产业 Work / Economy：就业、收入、产业结构、岗位和职业适配。
4. 生活系统 Living System：住房、教育、医疗、养老、通勤与公共服务承载。
5. 财政与城市承载 Fiscal Sustainability：收入、支出、土地依赖、债务与维护能力。

每个优先事项都沿用五段解释：Current、Trend、Relative、Mechanism、Confidence。Current / Trend / Relative 只有在 exact-scope、同口径、可追溯来源齐备时才可用；Mechanism 可以借用全国或日韩参照解释机制，但不能升级为武汉或成都事实；Confidence 描述证据质量，不是城市吸引力。

这套边界已经落成机器可读契约：city_choice_mvp.json 以 priorityProfiles 让每个优先事项独立绑定五层引用；事实层区分未来的 localEvidenceIds 与机制层的 referenceEvidenceIds，在 Data Gap 状态下两者不会被混用。decisionContext 只接受既有 RESEARCH_WINDOWS 的窗口 ID 和 5 / 10 / 20 年观察跨度，用户切换上下文会进入 domain 层，而不只是改变标题文案。

产品的正式结论仍只有一套 ConclusionSchema。Conclusion v2 增加结论类型、机制 ID、Data Gap ID 和重新评审条件，避免页面摘要演化成第二套未经治理的结论系统。

当前已实现

• /：实际统计概览、可切换年龄组的人口预测趋势与专题入口。
• /population：人口结构与年龄组研究。
• /cohort：出生队列与生命周期研究窗口。
• /impact 及其领域页：人口影响链、结论、Evidence 与 Source。
• /compare：中日韩参照。
• /global：全球参照的横向坐标、国家时间线和历史发展路径；作为 Reference Context Layer，不替代中日韩深度参照。
• /project/provincial-statistics：中国大陆 31 省级 GDP、人口、构成与增速参考，公开来源与边界口径，不生成排名或城市推断。
• /methodology：数据、方法、置信度和 Data Gap 规则。
• /project：研究与产品手册入口，聚合产品定义、研究框架、架构、领域模型、来源、缺口和治理记录。
• /project/education-teacher-demand：第一份正式领域模型，使用共享 System contract；省级教育来源采用 source-gated manifest，没有真实数据支持时不生成地区结论。
• /project/population-model：Population Model 1.0 工作台，分开展示 WPP Projection baseline、cohort Simulation 与 residual Estimate。
• /project/scenario-analysis：Scenario Analysis 1.0 工作台，使用统一 Scenario Registry 对照国家 cohort 与武汉/成都城市情景。
• /project/sources、/project/data-gaps、/project/assumptions：来源注册表、Data Gap 和假设/可信度的正式对象入口。

• /project/research-chain-protocol：研究链、Stock / Flow、Lag / Buffer、Outcome 维度和标准结论输出的统一协议。
• /city-choice：武汉 / 成都双城事实比较；已有城市数据逐项显示时期、单位和来源，假设情景独立展开。缺少岗位、个人匹配等证据时保留缺口，不生成城市推荐或综合评分。

当前实现仍有明显边界：Spatial / System 已建立可复用的 typed contract，但教育省级数值仍需真实来源 capture 与人工评审；全球经济数据在本产品中统一标为 Estimate，点级统计来源尚未逐条审计。Population Model 与 Scenario Analysis 已由 Scenario Registry 统一治理，但不凭单一 Medium 数据生成官方 high/low 情景。ResearchContext、ResearchAnswer 和研究检索已形成共享运行契约，但它们只传递选择、组织阅读和定位规范对象，不能绕过 Evidence、Data Gap 或 Place Readiness。

Shared System runtime

src/domain/system 提供跨教育、医疗、住房、财政和劳动力可复用的 Stock / Flow / Capacity / Utilization / Accessibility / Rule / Lag / FiscalConstraint 记录合同，并将描述性比率单列为 descriptive_ratio。它只统一语义和证据闸门，不凭合同生成事实；每个领域仍需按 exact scope 接入来源，并区分 Observed Actual、Derived Estimate、Policy Reference、Simulation 和 Data Gap。

研究运行契约

页面之间通过 URL 传递 ResearchContext，保留研究问题、国家/年龄/世代、地点、边界版本、研究窗口、情景标识和观察跨度；无效枚举、标识符和数字会被丢弃，不做隐式纠正，也不使用全局客户端状态。

ResearchAnswer 是统一的阅读层，语义顺序固定为“现在知道什么、为什么/机制、什么不能确定、下一步看什么”。正式结论仍只有 ConclusionSchema；回答对象只是组装和验证引用，允许没有正式结论的机制探索，但不能冒充正式结论。

/project/research-index 是规范检索入口。它按稳定 ID 确定性检索研究问题、正式结论、Evidence、Data Gap 和 Watch Indicator，保留对象类型、状态和入口，不生成新结论、不修改置信度、不折叠 Actual / Projection / Simulation / Estimate，也不把 Reference Evidence 变成本地事实。

下一阶段

• 评审“教育与教师需求”模板，补充真实数据接入前的字段、时间滞后和情景校验。
• 让关键结论、证据、来源 ID、Confidence 和 Data Gap 形成更细粒度的可追溯链。
• 明确 Population、Cohort、Spatial / System 与 Impact 在页面上下文中的传递方式。
• 让每条影响链都能以统一顺序回答“当前知道什么、为什么会这样、什么还不能确定、下一步看什么”。
• 为全球参照补齐更细的来源点级追溯与国家/地区代码版本对齐。
• 将研究上下文继续扩展到已通过 Readiness Gate 的 Spatial / System 数据，但不以上下文传递替代数据接入和证据审计。

长期规划

• 建立 Spatial / System 的可解释模型，记录人口迁移、系统容量和调整机制。
• 在真实来源和对应数据注册后，才扩展新的官方 Projection 情景；当前不把产品 sensitivity 命名为高迁移、低迁移、高生育或低生育。
• 在证据和数据充分时再扩展医疗、住房、财政、养老和劳动力等领域模型，并为每个领域保留同样的假设、来源和 Data Gap 结构。

尚未实现的能力统一标记为“规划中”，不展示成当前已经存在。