🚀 多城市"安居资格"系统设计 v0.4
从"建库存规则"到"活起来、引流量、出内容" · 计算器H5 / 房价联动 / 内容闭环 / 难度指数 / 采集巡检
承接：v0.3 已拍板库归属+城市序+5表结构 v0.4 = 应用层与增长层
状态：设计稿，待马哥查看讨论后再执行，暂未建表
v0.4 一句话：v0.3 解决了"把规则存进库、能算分"（地基）；v0.4 解决"让读者用起来、让内容长出来、让数据壁垒变现"（地上建筑）。
版本演进：
v0.1 上海单城 jifen，3表 → v0.2 多城市 settle，4表+compare → v0.3 5表+字典+版本+calc/check 计算器内核 → v0.4 计算器做成手机H5 + 打通70城房价库 + 内容自动产出 + API商业化。
一、为什么是 v0.4：全国库的独有壁垒
市面上的"上海积分计算器"（积分网/本地宝）只会算分，算完就结束。我们手里有它们没有的东西——全国70城房价库（monthly 5.6万行价格指数、annual 年度、上海日度网签、政策库、土地）。
所以 v0.4 的核心不是"再做一个积分工具"，而是打这张别人抄不走的牌：
资格（settle） ＋ 房价（housing 全国库） ＝
能回答："我在上海差10分，要不要先去成都/重庆上车？那边限购吗、房价在涨还是跌、房产税怎么收？"
纯积分工具答不了"换个城市值不值"，纯房价工具答不了"我够不够格"。两者打通 = 独家选题 + 引流钩子 + API 卖点。
二、五大模块（按优先级）
P0积分计算器 · 手机 H5（落地 v0.3 的 calc/check）
是什么：v0.3 的 calc/check 从命令行变成读者手机能点开的网页，挂在 nav.aobo.xyz/housing/ 下，和房产看板同域。
读者路径：
打开 settle_calc.html → 选城市（首版仅上海）→ 勾年龄/学历/职称/社保年限/基数 →
① 出总分 + 对标120（✅达标 / ❌差X分）
② 一键判定"我想买房/退税/孩子中考，够不够格"（check）
③ 达标 → 列出解锁的权益清单；不达标 → 告诉差什么、补哪项最快
为什么最先做：这是最强引流钩子，也是 v0.3 待拍板项②的落地形态。可反复用于公众号/小红书/抖音评论区"自测入口"。
首版刻意收窄（控工作量+控风险）：
- 城市：只做上海（成都重庆等后续）。
- 判定：只算住房相关资格（购房资格、房产税免征/退税），不碰中高考/医保/绿牌等全用途积分——那些数字敏感、官方口径分散，留二期。
- 规则全部来自 settle_rules 表，规则驱动不写死，制度换版只改数据不改代码。
# 页面（静态H5，调 hdb_api）
GET /housing/settle_calc.html
# 后端端点（加进 hdb_api.js）
GET /api/settle/calc?city=shanghai&age=32&edu=本科学士&skill=中级&social_years=6&base=1.0
→ { total:125, pass:true, gap:0, unlocked:[...购房退税...], tips:[] }
GET /api/settle/check?city=shanghai&want=购房退税&居住证年限=2&积分=0
→ { pass:false, need:"居住证满3年 或 积分120", current:"2年", gap:"差1年" }
数据依赖：settle_rules / settle_benefits 必须先填上海官方细则（见 P4）。工作量：中（内核 v0.3 已设计，主要是 H5 交互 + 官方细则核数）。
P1安居资格 × 房价数据联动（独家壁垒）
是什么：把 settle 与 monthly / annual / daily / policies 打通，做"资格 + 行情"一张图。
| 场景 | 联动数据 | 输出 |
|---|
| "上海差10分，去哪上车？" | settle compare 各城门槛 + monthly 新房/二手同比环比 + purchase_status 限购 | 多城"上车难度卡"：资格难度 + 当前房价涨跌 + 限购状态 |
| "够格了，现在是买点吗？" | check 判购房资格 + monthly 价格信号/signals 企稳 | 资格✅ + 该城房价当前处于涨/跌/企稳 |
| "退税能退多少？" | settle 房产税规则 + 上海 daily 单价/面积 | 按沪型公式 面积×单价×70%×税率 估算具体可免/退金额 |
GET /api/settle/compare?cities=shanghai,chengdu,chongqing
→ 每城 { 制度类型, 购房门槛, 房产税模型, 限购状态,
新房同比, 二手同比, 近14月企稳信号 } ← 后三项直接取 housing 库
价值：这是纯积分工具和纯房价看板都做不到的交叉视图，是全国库的护城河。工作量：中（端点拼接现有 /api/compare、/api/signals）。
P2内容生产闭环（喂公众号/小红书/抖音）
是什么：calc / compare / 退税金额的结果，一键结构化输出成选题素材，接进现有公众号选题 workflow。
- 对比类爆款："上海要120分，成都0门槛直接落户买房，差的不止是分数"（compare 自动出各城门槛+房价）。
- 金额冲击类："居住证满3年，这套房房产税能退 X 万"（P1 退税估算给具体数字）。
- 自测引流类："30秒测你在上海够不够买房资格"（挂 P0 的 H5 链接）。
- 沪渝对照类：独家——"同样是房产税试点，上海重庆玩法完全不同"（v0.3 第六节）。
落地：settle 结果导出成选题卡（标题+核心数据+官方来源），进 data/wechat_topics/ 选题池，复用现有 scanner/workflow。工作量：小（主要是模板）。
P3多城"上车难度"对比 · 三步走（马哥已拍板：先难度卡，数据齐了再升级指数）
先认清数据家底：70城涨跌趋势（同比环比指数）齐全；但绝对房价（均价多少钱/㎡）和居民收入目前只有上海/全库缺失——monthly 存的是"涨跌%"不是"均价"。所以"买不买得起"这个维度现在答不了，合成"上车难度指数"会名不副实。故拆三步、数据到位再升级：
第一步 · 多城难度卡（现在就能做，零数据缺口）
不打分、不排名，把每城并排摆成一张卡，读者自己判断：
成都｜已取消限购·无需社保直接买｜学历落户(宽松)｜无房产税｜新房同比+2.1%｜二手-1.3%｜企稳
上海｜居住证满5年/积分120｜落户严｜沪型房产税｜新房+3.0%｜二手-2.0%
数据：全部现成（settle + 70城涨跌指数 + signals），不用补任何数据。复杂度低（compare 端点拼卡片，1~2天）。零主观、零争议，不会被杠"野鸡排名"。
第二步 · 资格难度指数（settle 填完顺手做）
只用落户 + 限购 + 房产税三个纯政策维度打分排名，客观可查证、settle 填完就有。名字必须叫"落户/购房资格难度榜"，不掺房价，名副其实。代码不难（归一化+加权求和，百行级）。
第三步 · 真正"上车难度指数"（补数据后做）
先补两类 S 级公开数据：①各城商品房均价（统计局"销售额/销售面积"反推，年度）②城镇居民人均可支配收入（统计局年度）。补完算出"房价收入比"，再合成含"买不买得起"的完整指数。权重我先给方案 + 公开方法论和数据来源，你拍板，不拍脑袋。
✅ 已拍板：第一步难度卡现在做；第二、三步数据齐了再升级。合成指数代码不复杂，难在补房价+收入数据和权重公信力。
P4数据地基：官方采集器 + 巡检补源
是什么：P0~P3 全都依赖 settle 表里有准确的官方规则。这是地基，必须先做上海。
- 上海官方细则采集：人社局《居住证积分管理办法》及积分细则（计分分值）、税务局（房产税免征/退税）、住建/房管（购房资格、临港特殊政策）。照抄原文 + source三件套 + effective 区间。
- 巡检补两个源（v0.3 第七节已埋点）：给
hdb_policy_watch.js 加人社局（积分/落户政策变更）和公安局（户籍/居住证），现在只监控住建/房管/央行/住建部。
- 纪律不变：营销号（积分网/本地宝/中介）只当线索不采信数字；查不到留空标"待核"，不推算不编造不拿A城数字顶B城；写库备份 + INSERT OR IGNORE 幂等。
⚠️ 数字红线：积分分值、社保年限、房产税门槛是会被读者拿去做买房决策的，必须逐条核官方原文，H5 上也要标"以官方最新细则为准 + 来源链接"，不做绝对承诺。
三、分期路线图（建议）
1
地基（v0.3 收尾 + P4）：建 settle 5表+字典 → 采上海官方细则填实（购房/房产税相关）→ 巡检补人社/公安源。
2
钩子上线（P0）：上海住房资格计算器 H5 + /api/settle/calc|check，先跑通"能算、准、手机能点"。
3
壁垒成型（P1）：打通房价库，compare 出"上车难度卡"、退税估金额。
4
内容放量（P2 + P3）：选题卡进 workflow；多城难度卡先上线（零数据缺口）；资格难度指数等 settle 填完做，完整上车指数等补房价+收入数据后升级。
5
扩城 + 商业化：成都/重庆填实（重庆做沪渝对照）；/api/settle/* 对接 API_BUSINESS_PLAN。
四、API 与文件规划
| 项 | 规划 |
|---|
| CLI/模块 | scripts/hdb_settle.js：overview/benefits/rules/apply/housing/compare/query + calc/check，全带 --city |
| HTTP 端点 | 加进现有 hdb_api.js（127.0.0.1:7272）：/api/settle/calc /api/settle/check /api/settle/compare /api/settle/benefits |
| H5 页面 | data/housing_db/settle_calc.html（计算器）、后续 settle_compare.html（多城难度卡）→ 同域 nav.aobo.xyz/housing/ 实时生效 |
| 建表脚本 | scripts/hdb_init_settle.js（5表 + settle_dict 字典 + 触发器护 city_code） |
| 采集 | scripts/hdb_fetch_settle_sh.js（上海官方细则）；巡检 hdb_policy_watch 补源 |
全部放 housing.db 独立 settle_ 域（你已拍板），city_code 关联 cities，复用现有 city_code 触发器护栏。
五、请马哥拍板（讨论点）
① v0.4 方向对不对：P0计算器H5 → P1房价联动 → P2内容 → P3难度榜 → P4地基，这个优先级和"先上海、先住房资格"的收窄策略，认可吗？有没有要砍/要加的模块？
② 承接 v0.3 遗留项：计算器第一版我们建议做（但只做上海+住房资格，不做全用途积分）——你同意这个"做但收窄"的折中吗？
③ 上车难度对比（P3）· 已拍板：分三步——先做多城难度卡（不打分不排名、零数据缺口、零争议）→ settle 填完做"资格难度榜"（纯政策维度）→ 补完各城均价+居民收入数据后再升级成含"买不买得起"的完整上车难度指数。合成指数代码不复杂，难在补数据和权重公信力。此方案确认。
④ 落地节奏：确认设计后，第一步是"建 settle 表 + 采上海官方细则"。官方细则要逐条核原文、数字敏感，建议安排在白天整块时间做，不赶夜工。你定启动时间。
— cogniClaw 🦞 · v0.4 设计讨论稿，所有分值/门槛以官方原文为准 · 讨论定稿后再执行 —