房脉（propulse）是一个面向刚需与改善用户的 换房决策助手。
它不做玄学房价预测，也不做泛房产资讯。它解决的是一个更具体的问题：
我想买房或换房，但不知道现在能不能买、买哪里、压力多大、什么时候出手。
房脉帮助用户：
- 算清自己的购房能力与换房压力
- 监测目标小区的挂牌、成交、降价与供应信号
- 判断当前更适合看房、等待、砍价还是出手
- 理解每个判断背后的房产方法论
- 建立一套可复盘、可迁移的换房决策系统
- 一个换房能力计算器
- 一个目标小区观察台
- 一个买方窗口判断器
- 一个带解释的房产决策工具
- 一个让用户边决策边学习的方法论系统
房脉不试图成为：
- 全国房价预测平台
- 房产资讯流
- 房产培训课
- 中介导流站
- 黑箱式买卖建议工具
- 换房测算：算清安全总价、月供压力、资金缺口和风险边界。
- 目标小区：跟踪用户关注小区的价格、供应、成交与降价信号。
- 出手窗口：给出“看 / 等 / 砍价 / 出手”的阶段性判断。
- 判断方法：解释为什么这么判断，帮助用户形成自己的大局观。
- 工具模板：提供监测表、预算表、周复盘表和谈价清单。
- 先解决决策焦虑，再讲方法论。
- 不预测涨跌，只判断信号和压力。
- 不替用户拍板，但必须给出明确建议。
- 每个结论都要能解释原因。
- 小区级、预算级、家庭现金流级，比宏观大盘更重要。
- 用户每次使用，都应该更会判断。
复制 .env.example 中需要的配置到本地环境，并至少替换 PROPULSE_ACCESS_TOKEN。PROPULSE_USER_ID 为必填项，未设置时服务会启动失败（fail-fast），不会静默回退到默认账号。
新测算从数据库中的版本化政策读取首付、利率和税费，迁移会写入天津的初始有效版本。以下变量仅用于迁移前旧计算路径的兼容回退，通常无需设置；若设置其中任意一项，则必须完整设置五项，且首付比例须在 (0,1)、日期须为不晚于当前日期的 ISO 日期：
PROPULSE_CAPACITY_POLICY_CITY
PROPULSE_CAPACITY_POLICY_NAME
PROPULSE_CAPACITY_POLICY_DOWN_PAYMENT_RATE
PROPULSE_CAPACITY_POLICY_EFFECTIVE_DATE
PROPULSE_CAPACITY_POLICY_SOURCE
migrate up 和 migrate down 只依赖数据库配置，不要求用户身份、访问令牌或兼容政策变量。后续政策版本通过管理员数据管理页追加，不覆盖历史规则。
安装前端依赖并运行完整前端校验：
pnpm --dir apps/web install --frozen-lockfile
pnpm --dir apps/web verify修改前端后，刷新 Go embed 使用的静态产物：
pnpm --dir apps/web build:web仓库会跟踪 apps/web/embed/static 中的导出结果，因此干净检出无需安装 Node.js 依赖即可构建包含前端的 Go 二进制：
go build ./cmd/propulse运行后端测试：
go test ./...也可以从仓库根目录执行完整校验。该命令会运行 Go race test、静态检查、前端校验和构建，并检查 OpenAPI 类型与 Go embed 静态产物是否漂移：
make verify使用 Docker Compose 启动集成服务：
sudo docker compose up --buildCompose 默认只把 HTTP、PostgreSQL 和 Redis 端口绑定到
127.0.0.1。可在 .env 中通过 PROPULSE_HTTP_PORT、
PROPULSE_POSTGRES_PORT 和 PROPULSE_REDIS_PORT 调整宿主机端口。
容器固定命名为 propulse、propulse-worker、
propulse-scheduler、propulse-migrate、propulse-postgres 和
propulse-redis，并统一加入 propulse-network。
服务启动后可分别检查进程健康状态和依赖就绪状态：
curl http://127.0.0.1:8317/healthz
curl http://127.0.0.1:8317/readyz未在 .env 中配置时，Compose 会为个人与管理 API 设置
PROPULSE_ACCESS_TOKEN=local-access-token。调用受保护接口时需要传入
实际生效的 bearer token，例如读取个人关注列表：
ACCESS_TOKEN="$(sudo docker compose exec -T propulse printenv PROPULSE_ACCESS_TOKEN)"
curl http://127.0.0.1:8317/api/v1/watchlist \
-H "Authorization: Bearer ${ACCESS_TOKEN}"PostgreSQL 和 Redis 数据分别保存在 propulse-postgres-data 和
propulse-redis-data 命名卷中。普通 sudo docker compose down 会保留数据；
需要彻底重置本地数据时执行 sudo docker compose down -v。
嵌入式网页不会把令牌编译进静态文件。打开网页后使用顶部的“解锁”入口输入令牌；令牌只保存在当前浏览器会话中。
新数据库默认没有市场数据，也不会自动写入演示小区或指标。完整数据链路为：创建目标小区、创建可信数据源、导入带来源和采集时间的批次，然后按该批次计算指标。
管理接口包括：
POST /admin/api/data-sources：创建或复用数据源。GET /admin/api/data-sources：列出数据源。POST /admin/api/imports/json：导入完整或部分覆盖的 JSON 批次。GET /admin/api/imports/{id}：查看规范化记录和 base64 编码的原始载荷。
导入请求示例，其中两个 ID 分别来自数据源和目标小区创建响应：
curl http://127.0.0.1:8317/admin/api/imports/json \
-H "Authorization: Bearer local-access-token" \
-H "Content-Type: application/json" \
--data '{
"dataSourceId": "11111111-1111-1111-1111-111111111111",
"neighborhoodId": "22222222-2222-2222-2222-222222222222",
"sourceRef": "weekly-2026-07-13",
"collectedAt": "2026-07-13T10:00:00Z",
"coverage": "full",
"records": [{
"recordType": "listing",
"sourceRecordId": "listing-1",
"layout": "三房",
"areaSqm": 89.5,
"listingPrice": 520,
"daysOnMarket": 12,
"status": "active"
}]
}'full 批次可更新当前挂牌库存；partial 批次只补充观测，不会冒充完整库存。指标响应会同时返回来源 ID、触发批次、覆盖范围、新鲜度、样本数和质量告警。
从数据库迁移版本 v2 升级到 v3 时，容量测算、小区和关注列表会保留；无法关联可信采集批次的旧快照与旧指标会被清理，需要通过上述接口重新导入。scheduler 只会扫描超过 5 分钟仍为 pending 或 failed 的采集批次，并携带准确的 collectionRunId 发起修复，不会按关注列表生成无来源指标。
房见双小区完整采集、100 条拆分规则、脱敏归档和原子导入说明见 docs/fangjian-api.md。凭证只从进程环境读取；采集鸣泉花园与亲和美园：
FANGJIAN_AUTHORIZATION='...' \
FANGJIAN_AK='...' \
FANGJIAN_VERSION='...' \
make collect-fangjian采集结果写入被 Git 忽略的 data/fangjian/<UTC时间>/<小区>/。管理员通过 POST /admin/api/community-market/imports/fangjian 显式绑定已有数据源与小区 UUID；完整行情、挂牌、成交和调价在同一事务中写入，相同来源引用与内容可幂等重放。旧聚合 CSV 接口继续兼容，但其快照不会冒充完整明细。
也可以运行本地集成冒烟脚本，完成 Compose 构建、健康与就绪检查、认证关注列表 API 和 E2E smoke test：
bash scripts/verify-stack.sh同一个 propulse Go 二进制支持以下运行模式：
propulse serve
propulse api
propulse worker
propulse scheduler
propulse migrate up
propulse migrate down先看：
docs/product-overview.mddocs/prd-v1.mddocs/information-architecture.md