🚀 Butler · Dev CI 看板

• 补全 JCU 小区的街景/外景图，覆盖 A/B/C 三种房型的前端展示位 • 补全 JCU 各户型的房型实拍图，前端房型详情页可直接展示 • 提供一键安装/转码脚本，把产品交付的原始图片归档并落位到前端公共目录，方便后续继续补充

• 补齐 JCU（詹姆斯库克大学）选校攻略初稿，覆盖三大片区与多个推荐社区及房型，使原本为占位的攻略内容可对用户呈现。 • 不同身份（独自来读 / 合租 / 家长 / 换房）现在各自带定位文案与差异化引导，攻略从通用模板转为可分发的初稿。 • 同步加入生成与回填该攻略的脚本，把内容生产链路固化下来，便于后续其他学校复用同一流程。 • 顺手微调 JCU 选校卡 logo 容器与图片尺寸约束，让 logo 在卡片里视觉更协调。

• 修复 JCU 校徽在页面上笔画发糊的问题，改用原图直接叠白底呈现，保留原始清晰度。 • 简化校徽重处理脚本，移除了 JCU 复杂笔画修复逻辑，只保留透明底叠白底，逻辑更轻、可维护性更好。 • 优化 JCU 校徽前端展示容器，使用居中布局与内边距，避免校徽贴边裁切，视觉更协调。

• 修复 JCU 校徽文字透明导致的缺笔问题，通过重建不透明字形并补齐笔画，确保 logo 完整可读。 • 修正 JCU 校徽在前端展示过大的问题，让其按比例适配容器，与 Curtin 校徽观感保持一致。 • 同步更新 Curtin 校徽的留白参数，使两所学校 logo 在卡片中的视觉比例更均衡统一。

• 统一所有校徽顶部图为同一规格的白底横幅，保证 NTU/SMU/NUS/JCU/Curtin 在选校大卡上展示一致、无需再逐校做特判 • 修正 JCU 与科廷校徽原图带黑边的问题，烘焙留白进 PNG，呈现更干净 • 身份选卡插画区改为正方形容器并按角色色调用底色填充，配图不再被强行拉伸变形

• 新增 JCU 与科廷两所学校的完整选校内容与校徽图片，覆盖从身份选卡到周边片区/房源的整套攻略数据。 • 把学校枚举与后端校验、汇总映射同步扩展到 JCU/科廷，确保新增学校在前后端链路里都能跑通。 • 收尾身份选卡样式：选卡改回 2 列网格、标题加大并启用均衡断行，呼应两行式卡面布局。

• 留资表单学校选项新增「其他」，用户可手动填写学校名称，覆盖非合作院校的留资需求。 • 选「其他」学校时免填意向片区，摘要中也按条件隐藏片区字段，避免无效必填项。 • 前后端对齐学校枚举与校验规则：选「其他」时必须填校名并限制长度，已知学校维持原校验逻辑。

• 修正了 leads 写入接口的占位符位置与参数类型不一致问题，确保新线索能够正常落库。 • 避免了因占位符错位导致写入失败或字段误写，恢复线索录入主流程可用性。

• 启动时数据库 migration 改为逐条执行，避免多语句拼接时部分驱动只跑前一条导致表结构残缺 • migration 跑完后回查 leads 表实际列结构，缺少关键字段时直接报错，确保核心表可用 • 未配置数据库连接地址时显式跳过并打日志，去掉原先静默吞掉异常的兜底逻辑，让配置问题更易被发现

• 留资表单新增必填的手机号字段，支持国内外号码输入与统一规范化校验。 • 后端数据链路完成升级：手机号入库、对外摘要和跟进话术同步带上联系方式，顾问可一键回拨。 • 同步调整前端隐私提示文案，明确说明收集的信息仅用于租房咨询跟进。

• 全站联系入口统一前置留资：首页、底部、服务页、攻略页头部、身份页“其他”分支都先走同一份需求表单，再看到顾问二维码，提升留资覆盖率。 • 表单新增“称呼”字段并贯通到后端：用户填写的称呼会写入需求库、对接顾问侧摘要，隐私文案同步说明仅收集称呼用于辨认，不收手机/微信。 • 顾问二维码与文案整体替换：站点企微二维码更新为新版，引导口径从“扫码加管家”统一调整为“添加顾问”，并修正页面内相关称谓。 • 表单智能化：未带攻略上下文时支持在弹窗内选择学校/身份并自动给出对应片区选项；携带上下文时则保留预填，体验更顺且字段更准确。

• 攻略主路径接入留资：用户在 §4/§5 点击联系后先填表（片区、预算、户型、房源类型、入住时间等），提交成功再展示顾问企微二维码，首页/页脚/顶栏/`other` 兜底仍直接出码 • 后端落地留资服务：新增 FastAPI `POST /api/leads`，负责写入 PostgreSQL `leads` 表并向企微群机器人 Webhook 推送结构化需求摘要，带 IP 限流、CORS 与失败降级策略 • 前端弹层改造为三态：扩展 `ContactContext` 与抽屉组件，新增「留资表单 → 提交 → 出码 + 复制需求摘要」流程，提交摘要可一键复制供用户加顾问后粘贴 • 文档与部署基线同步：完成阶段 7 PRD/技术方案/执行打卡，`.env.example`、docker-compose、env 维护规范补齐企微 Webhook、限流、API 基址等配置；明确 Agent 禁止自行部署，由人工并入并触发上线

• 在后端目录下补齐「打通壳子」文档，把这个临时 FastAPI + asyncpg + RDS 最小后端的目的、链路组成、3 个探针/示例接口和线上实测结果写清楚，让接手者一眼看明白它为什么存在。 • 明确说明 DB 连接来自受控的 `.env.test` 注入，库与受限角色由控制面仓统一供给，app 不持有高权账号——把连接来源、权限边界与控制面职责讲清。 • 给出两条后续路径：在此基础上开发（复用连接池、保留健康探针、按需加路由/迁移）和彻底移除该壳子的完整步骤，让团队能基于此决策扩展还是替换后端方案。

• 落地后端壳子：新增 FastAPI 服务，提供存活 / DB 连通 / passthrough 示例接口，作为后续业务后端的占位与链路验证基线。 • 打通 RDS 连接：端到端验证「前端 → nginx → 后端 → PostgreSQL」整条链路可用，未配置连接串时不阻塞容器启动。 • 接入统一容器编排：把后端纳入 docker-compose，与 web 同网，Nginx 动态解析后端地址反代 /api/，后端仅内网暴露、不开主机端口。