Repository navigation
v2.1 全新设计了网页 UI:房源浏览、账号设置和管理后台统一成收件箱式界面,公共页面
换成单独的外壳,并补齐手机端、键盘操作和中英文文案。另外区分了官方站点与自部署
副本,简化了本机自用的启动方式。监控、抓取与预订逻辑没有变化;OurDomain、
OurCampus 与 Xior 的预订验证移到 v2.2。
全新设计的网页 UI
-
收件箱式工作区(e52a89a)
收件箱、日历、地图和统计共用「侧栏 + 列表 + 详情」的外壳,首页就是收件箱,
未登录时以访客身份进入。普通用户可以在「我的匹配」和「全部房源」之间切换,
已读状态按用户单独保存。旧的/listings列表页已删除。 -
账号设置与管理后台(e52a89a)
账号设置按分组和条目编辑筛选、通知、账号与偏好。用户、公告、运行设置、客户端、
数据健康、日志、崩溃和系统信息页迁到同一外壳,公告管理拆成独立页面;运行设置
区分已保存、已应用、被环境变量覆盖和需要重启。 -
登录、分享、邮箱验证、错误页、帮助、法律、赞助和使用指南改用公共页外壳。
使用指南按新界面重写。字体、图标与 Chart.js 改为自托管,CSP 随之收紧。 -
手机端与可访问性(cb04487)
手机侧栏关闭时不再进入 Tab 顺序,展开时锁定焦点,Esc 关闭并回到菜单按钮;
房源和用户详情在刷新、返回时保持正确状态;日历窄屏完整显示「今天」,日期的
辅助名称标明今天;登录密码字段使用独立标签。 -
数据健康的原因说明、英文房源状态(
Book显示为 Available)、邮箱验证页、
登录失败与限流提示、用户管理提示都按界面语言显示。登录失败后保留原本要去的页面;
启停、调整用户优先级后继续选中该用户。分享页不再显示占位的入住日期。
自部署
-
不在
flatradar.app上运行的副本,会在品牌名和页面标题后标注「自部署版本」,
管理员首次进入时看到免责与禁止商用的提示。自部署副本不显示赞助入口(/donate
返回 404)和 App 推送设置;入站邮件转发按实际收件地址显示,不再写死官方邮箱。 -
本机一条命令启动(83588b6)
python launcher.py会在首次运行时生成.env、下载浏览器内核,并同时启动面板与
监控;关闭终端时一起停止。README 与使用指南的快速开始分成「在自己电脑上用」
(Python)和「公网部署」(Docker)两种。
条款与隐私
- 使用条款明确禁止商用和再分发房源数据,第 9 节限定为以商业目的修改、转售、再许可
或再分发;条款与隐私政策中的「收藏」改为「房源已读记录」。 - App 不再支持用 Holland2Stay 网站账号密码登录,只认本地 App 密码。
测试
升级注意
- 数据库迁移在启动时自动执行:新增
listing_reads表,删除user_configs的
allow_h2s_login列。 - API 契约升到 1.26.0:
/me/export增加listing_reads[],用户配置去掉
allow_h2s_login。曾用 Holland2Stay 账号登录 App 的用户需要先设置 App 密码。 - 条款文本在启动时读入,部署后需要重启 Web 进程(重建容器即可)。
- 官方站点按请求 Host 或
PUBLIC_BASE_URL识别;反代改写了 Host 的官方部署,
需要确认PUBLIC_BASE_URL设置正确。
已知限制
- Xior、OurDomain、OurCampus 的 RENTCafe 预订仍未开放,验证移到 v2.2。
- 新界面只在桌面与模拟手机视口的 Chromium 中验收过;Safari、Firefox、真实手机和
屏幕阅读器尚未验证。 - 英文数量文案仍有单复数问题(如
1 listings)。 - Holland2Stay 取消预留的路径尚未用真实操作验证;Plaza 的 DTH 房源不自动应征。
- 单机 SQLite,不支持多实例水平扩展。