HousingAI Methodology
HousingAI 社区情绪数据是如何计算和展示的？
HousingAI 当前前台页面已经统一读取标准数据层。我们把城市社区情绪、热力图、Gate 调查、有效讨论、官方市场信号和历史快照拆开处理，避免不同来源互相污染。
这些数据用于帮助用户理解社区讨论方向与样本结构，不构成买房、卖房、贷款、投资或法律建议。
当前城市页主数据
城市页当前主数据来自 City Sentiment Record。它是 HousingAI 对单个城市最近 30 天社区情绪样本的标准化记录，用于展示当前主情绪、Bearish / Neutral / Bullish 比例、valid votes、sample status、Net Sentiment、Sample Weight 和 Adjusted Sentiment。
当前城市页读取的是标准记录，不会在前台访问时自动 upsert，也不会因为缺记录而把旧 runtime 口径写回标准层。
Gate 调查、有效讨论、有效投票的区别
valid votes 是生成 City Sentiment Record 的核心社区情绪样本，只用于社区情绪本身的比例、dominant sentiment、Net Sentiment 与 Adjusted Sentiment。
Gate 调查来自用户主动提交的轻量级入口反馈。它会单独显示为 Gate 调查，不会写入 valid votes，也不会代替 discussion_count。
discussion_count 代表论坛观察与论坛讨论的独立统计，用来辅助理解社区活跃度。它不等于 valid votes，也不等于 Gate 调查样本。
如果城市已有真实有效讨论，就显示数字；如果还在积累，页面会诚实显示“统计中”，不会用 valid votes 或 Gate 调查去代填。
热力图当前口径
50-city heatmap 当前主数据来自 City Sentiment Record + BBS Activity Snapshot。默认房型是 独立屋，可切换 联排 / 公寓 / 租房，不再显示“全部房型”作为前台入口。
热力图用于看不同城市在不同房型下的情绪热度分布；它不是把 all / 全部房型样本复制给 detached、townhouse、condo 或 rental。
Official Market Signal 为什么独立显示
Official Market Signal 来自经过验证的官方月报记录，只展示 parsed_status 为 verified 的最新有效结果。它会单独显示在城市页中，用于补充官方市场背景。
Official Market Signal 不参与 Community Sentiment，不会改写 dominant sentiment、Net Sentiment 或 Adjusted Sentiment。
Daily Snapshot 的用途
Daily Snapshot 用于固化每天的标准记录结果，服务于未来的历史趋势页和时间序列图表。它不是当前城市页和当前热力图的主读取口径。
当前页面会展示哪些情绪字段
- dominant sentiment：当前样本里占比最高的主情绪标签。
- Net Sentiment：社区情绪的净方向读数，通常更适合横向比较方向。
- Sample Weight：样本权重，用于表达样本规模对可比性的影响。
- Adjusted Sentiment：结合样本权重后的方向读数，用来降低低样本城市的误导性。
这些字段都属于社区情绪层，不等同于官方月报，不等同于 Gate 调查，也不等同于讨论条数。
我们当前没有做什么
- 没有把 Gate 调查直接并入当前情绪算法。
- 没有把 Official Market Signal 混入 Community Sentiment。
- 没有让历史快照反过来覆盖当前城市页主记录。
- 没有用 valid votes 代填 discussion_count。
English Summary
Current city pages read from the standardized City Sentiment Record. Gate survey counts, discussion counts, official market signals, and historical snapshots are displayed as separate layers and are not merged into the community sentiment score.
Official Market Signal is verified-only and read-only. Daily Snapshot is for historical storage, not for the current city page primary read path. Gate survey counts do not overwrite valid votes or discussion_count.