🏙️ 多城市"安居资格"数据模型 & API 设计
v0.2 · 2026-08-29 · 覆盖 居住证积分 / 积分落户 / 购房资格 / 房产税 · 上海·成都·北京·广州·深圳…
状态：设计讨论稿，待马哥拍板，暂未建表
一句话定位：非户籍人群在一座城市"能不能买房、能不能落户、孩子能不能上学、能不能上车牌"的结构化资格知识库。对内做房产内容/客户答疑，对外可接问答。住房是核心（关联房产库 policies），但制度因城而异，所以框架必须先做多城市抽象，上海是第一个填实的城市。
一、关键认知：各地制度根本不是一回事
不能用"上海居住证积分"一张表套全国。先要抽象出制度类型，再各城填数据：
| 城市 | 核心制度模式 | 非户籍购房门槛（框架，数字待核官方） | 积分/落户体系 |
|---|
| 上海 | 居住证积分制标准分值120 | 社保/个税年限；或居住证满5年可购1套；外环内外有别 | 居住证积分120 → 子女中高考/医保/房产税退税；居转户 |
| 成都 | 已全面取消限购 + 宽松落户 | 2024-04 起取消住房限购、取消公证摇号 | 学历落户 / 居住社保落户 / 积分入户；无房产税 |
| 北京 | 连续社保/个税 + 工作居住证 | 连续5年社保或个税；工作居住证视同京籍 | 积分落户（门槛高、名额少）；车牌摇号也看资格 |
| 广州 | 积分入户 + 限购放松 | 购房社保年限（已大幅放松） | 积分入户制度成熟 |
| 深圳 | 积分/核准入户 + 社保购房 | 非户籍1年社保可购（2024放松后） | 核准制入户（学历/技能）+ 积分入户 |
⚠️ 上表门槛为框架性概括，仅说明"制度类型不同"；所有年限/分值/条件采集时逐条以官方原文为准，设计稿不填死数字。
二、数据模型（4 张表，独立 settle_ 表域）
表名用 settle_*（安居/落户），比 jifen 更通用——能同时装"积分、落户、购房资格"。放 housing.db，city_code 关联 cities 字典。
① settle_cities —— 各城安居制度概览（一城市一行）
| 字段 | 说明 |
|---|
city_code | 关联 cities（shanghai/chengdu/beijing…），主键 |
system_type | 制度类型：居住证积分 / 积分落户 / 社保购房资格 / 限购取消 等（可多值） |
system_name | 本地制度名，如"上海市居住证积分管理办法" |
threshold_summary | 一句话核心门槛（如"积分标准分值120分"） |
has_property_tax | 是否有个人住房房产税试点（仅上海/重庆） |
purchase_status | 限购状态：限购/部分放松/全面取消 |
authority | 主管部门（人社局/住建委/发改委…） |
| source/source_url/confidence/updated_year | 来源三件套 + 适用年份 |
② settle_benefits —— "满足资格能享受什么"（权益/用途，核心表）
| 字段 | 说明 |
|---|
city_code | 城市 |
domain | 领域：住房/落户/子女教育/医疗/车牌/证照/职业 |
benefit_name | 权益名，如"购房免征个人住房房产税" |
requirement | 门槛：积分120 / 居住证满3年 / 社保连续5年 / 学历落户… |
benefit_desc | 具体待遇（照抄官方口径） |
housing_related | 1=房产强相关（房产内容筛选开关） |
related_policy_id | 关联房产库 policies.id（如房产税→上海 id87、购房资格→id53） |
| source/source_url/confidence/effective_year/note | 来源三件套 + 年份 + 口径备注 |
| UNIQUE(city_code, domain, benefit_name) 幂等 |
③ settle_rules —— "怎么达到门槛"（积分/落户计分规则，因城而异）
| 字段 | 说明 |
|---|
city_code | 城市（上海规则≠广州规则，必须分城） |
rule_system | 所属体系：居住证积分 / 积分落户 / 落户条件 |
category | 年龄/学历学位/职称技能/社保基数年限/紧缺专业/投资纳税/配偶户籍/减分项 |
item | 计分项，如"本科学历+学士学位" |
score / score_max | 分值 / 该类上限（官方为准，可空待核） |
rule_type | add加分 / minus减分 / veto一票否决 / gate硬门槛 |
condition | 计分条件（社保连续N年、基数倍数等） |
| source/source_url/confidence/effective_year | 来源三件套 |
| UNIQUE(city_code, rule_system, category, item) 幂等 |
④ settle_apply —— "怎么办"（申请/材料/流程/续签/查询）
| 字段 | 说明 |
|---|
city_code + topic | 城市 + 主题：申请条件/所需材料/办理流程/续签/官方查询渠道 |
step_order / content | 步骤序号 / 内容 |
official_channel | 官方渠道：一网通办 / 人社APP / 各区人才中心 / 12333 等 |
| source/source_url/confidence | 来源三件套 |
| UNIQUE(city_code, topic, step_order) 幂等 |
三、API 设计（scripts/hdb_settle.js，CLI + 可 require）
# 按城市查（默认上海）
node hdb_settle.js overview --city shanghai # 该城制度概览(类型/限购/房产税)
node hdb_settle.js benefits --city shanghai [--domain 住房] [--housing]
node hdb_settle.js rules --city shanghai # 积分/落户计分规则
node hdb_settle.js apply --city shanghai # 办理条件/材料/流程
node hdb_settle.js housing --city shanghai # 住房一键包:购房资格+房产税+保障房
node hdb_settle.js compare --city shanghai,chengdu,beijing # 多城横向对比
node hdb_settle.js query <关键词> --city shanghai # 全文检索(中考/绿牌/退税/落户)
# 导出模块（供选题 workflow / 未来问答机器人调用）
module.exports = {
getOverview(city), getBenefits(city,domain), getHousingPack(city),
getRules(city), getApply(city,topic), compareCities([...]), search(city,kw)
};
✅ 多城对比是这个框架的独有价值：一张表回答"我在上海要120积分，在成都是不是直接能落户买房？"——房产内容引流的强选题。
四、用途覆盖矩阵（先列框架，逐城逐项核官方）
| 领域 | 上海 | 成都 | 北京/广州/深圳 |
|---|
| 住房·购房资格 | 社保年限 / 居住证满5年 | 已取消限购 | 社保年限（穗深放松、京5年） |
| 住房·房产税 | 有试点，积分/满3年可免可退 | 无 | 无（仅沪渝试点） |
| 住房·保障房 | 公租房/共有产权房（积分优先） | 待核 | 待核 |
| 落户 | 居转户/人才引进 | 学历/居住社保/积分落户（宽松） | 京积分落户严；穗深核准+积分 |
| 子女教育 | 积分120 → 中考/高考资格 | 随迁子女入学政策待核 | 各区"五证/积分"待核 |
| 医疗 | 子女居民医保（积分） | 待核 | 待核 |
| 车牌 | 绿牌（积分+社保）/ 拍牌 | 待核 | 北京摇号看资格 |
五、数据来源与纪律
- 官方源优先：积分/落户→人社局/公安局；购房→住建委/房管局；房产税→税务局；中高考→教委；车牌→发改委/交通委；医保→医保局。
- 营销号（积分网/本地宝/中介）只当采集线索，不采信数字。
- 分值/年限/门槛照抄官方原文，标 source_url + confidence + effective_year；制度会修订（如积分办法换版），必须带年份。
- 查不到留空标"待核"，不推算、不编造、不用A城数字顶替B城。
- 写库前备份 + INSERT OR IGNORE 幂等；房产相关权益强制关联 policies.id。
六、请马哥拍板
决策1 · 城市范围与优先级：先填实上海（数据最全、房产内容主战场），第二批上成都（你有业务/已取消限购，对比反差强），北上广深作为框架占位后补？还是你想先上哪几个城？
决策2 · 用途广度：上海第一版先做住房+落户+子女教育（房产人群最痛），医疗/车牌/证照第二批？还是一次做全？
决策3 · 表域命名：用 settle_*（安居/落户，最通用，推荐）还是你更想要别的名字（如 city_access_* / jifen_*）？
决策4 · 落地节奏：设计你确认后，我再建表 + 逐项核官方细则填数（落地时会等你通知）。
— cogniClaw 🦞 · 本页为设计讨论稿，数字均以官方原文为准 —