Open
[站群 M3] 站点化 settings/theme/sitemap/search/缓存 + 会员 member_scope 开关 #7
凤城老人Add on  Oct 17
凤城老人
凤城老人Collaborators
Oct 17 Create

站群模式 M3:站点化子系统(settings/theme/sitemap/search/缓存)+ 会员 member_scope 开关

设计依据:docs/SITE_GROUP.md。依赖 M1(site_id 列 + 解析器);建议在 M2(站点管理后台)之后做,以便在后台直接配置各站参数。
目标:让每个站点拥有独立的配置、主题、SEO、搜索与缓存;前台会员支持「共享 / 独立」可切换。

前置条件

  • M1 完成:settings/members 已有 site_id 列,settings(key,site_id) / members(site_id,username) 复合唯一已建。
  • M2 完成(建议):后台可创建站点、切换站点,便于逐项配置验证。

范围

A. 站点化 settings

  1. Setting.get/set 引入全局键集合 GLOBAL_KEYS(每实例一份、与站点无关):
    redis_*、oss_*/storage_*、api_*/jwt_*、i18n_*、search_*、login_*、upload_*(安全策略)、audit_*/backup_*、member_scope。
    • 全局键:恒取 site_id=0(无论当前站点)。
    • 其余「站点键」(site_name/seo_*/site_theme/site_status/site_close_reason/footer_copyright/analytics_*/cache_*/form_notify_*/notify_* 等):取当前站点 site_id。
    • 默认站点(0)读取 (key,0) = 迁移后的现有行 → 行为不变。
  2. 请求级缓存 _settings_map 键改为 _settings_map_{sid};set() 按对应 sid 失效。
  3. 站点键缺失时 fallback 到 (key,0)(默认站点值)→ 新站点未配置时沿用默认站点的配置,避免空站。

B. 站点主题

  • get_active_theme():「当前站点 sites.theme → 全局 Setting('site_theme')(site_id=0)」fallback。
  • theme_template() 随之取站点主题;主题文件仍磁盘共享,仅选择器变化。
  • 后台主题管理页显示「当前站点主题」。

C. sitemap / robots

  • collect_sitemap_urls 按当前站点生成;各子域/域名各自 /sitemap.xml 仅含本站栏目/文章。
  • robots.txt 同理按站点输出。

D. 搜索站点隔离

  • 索引文档写入 site_id 字段;查询按当前站点过滤:
    • Meilisearch:filterable attribute + filter;
    • Whoosh:存 site_id 字段过滤;
    • SQL 兜底:加 site_id 条件。
  • 单引擎、结果按站隔离;索引重建/增量按站点。

E. 缓存命名空间

  • _try_cache 键加站点前缀 f'site{sid}:<key>'。
  • 浏览量缓存(_incr_view/_flush_view_counts)按站点隔离(article id 全局唯一,键天然隔离,但视图计数 flush 需确认不跨站混淆)。
  • Setting 请求缓存按 sid(见 A.2)。
  • TTL 取站点化 cache_ttl_*。

F. 前台会员 member_scope(决策 2:超管可选共享/独立)

  1. 全局 Setting member_scope ∈ shared(默认,向后兼容)/ isolated。超管在后台切换(全局键,恒 site_id=0)。
  2. members.site_id(M1 已加列):
    • 共享模式:注册/登录一律 site_id=0;username 复合唯一 (0, username) = 全局唯一,与现网一致。
    • 独立模式:注册时写 current_site_id();username 各站独立唯一。
  3. 登录/会话查询改造(plugins/member/frontend_routes.py 等):
    • 独立模式:Member.query.filter_by(username=...) / 按 phone / 短信验证码追加 site_id=current_site_id();
    • 共享模式:行为不变。
  4. 切换语义(数据操作而非纯开关):
    • shared → isolated:存量会员保留 site_id=0(归默认站点),新注册按当前站落;
    • isolated → shared:可选提供「归一化」脚本把所有 site_id 置 0(需处理 username 冲突,冲突则报错提示)。
    • 后台切换开关需提示影响。
  5. member_oauths / member_sms_codes 经 member_id 继承,无需加列;phone/email 非唯一索引,独立模式天然可跨站共存。
  6. member_only 栏目判定、前台会员会话归属按模式追加站点过滤。

验收标准

    • member_scope=isolated:两站可注册同用户名(各自独立);登录/短信按站隔离。

不做(留给后续阶段)

  • 插件 SDK / 内置插件改造 → M4
  • 按站点备份导出(增强项)

关联

  • 设计文档:docs/SITE_GROUP.md §4.3/§4.4/§9
  • 依赖:M1(必需)、M2(建议)
  • 后续:M4
likedislike