Open
[站群 M1] 站点基座:sites 表 + site_id 列 + 迁移 0010 + 站点解析器 #5
凤城老人Add on  Oct 17
凤城老人
凤城老人Collaborators
Oct 17 Create

站群模式 M1:站点基座(sites 表 + site_id 列 + 迁移 0010 + 解析器)

设计依据:docs/SITE_GROUP.md(已提交至 main)。本 issue 为站群模式四阶段落地的第一阶段(基座)。
目标:引入「站点」维度并保证默认站点(site_id=0)行为与现网完全一致(零回归)。

范围

  1. 新增 sites 表(app/models/site.py)

    • 字段:id(默认站点固定为 0)、name、slug(unique)、domain(全量域名,unique)、subdomain(子域标签,index)、status(open/closed)、theme、is_default、seo_title/seo_keywords/seo_description、sort_order、is_deleted、created_at/updated_at。
    • 提供 SiteScopedMixin(site_id 列:Integer, nullable=False, default=0, server_default='0', index=True + site relationship),供核心表与插件表统一挂载。
  2. site_id 列挂载

    • columns(权威来源)、articles(冗余,由 column 同步)、fragments、settings、members 各加 site_id。
    • audit 加 site_id(默认 0,仅溯源用)。
    • 不加列:builder_pages((scope,column_id) 已站点内唯一)、column_fields/column_field_values(经 column 继承)、uploaded_files(跨站共享决策)、users/roles/permissions、member_oauths/member_sms_codes(经 member 继承)。
  3. 唯一约束改造

    • columns.slug:全局 unique → (site_id, slug) 复合唯一。
    • fragments.slug:同上。
    • settings.key:全局 unique → (key, site_id) 复合唯一。
    • members.username:全局 unique → (site_id, username) 复合唯一(共享模式恒为 0,等价全局唯一)。
  4. Alembic 迁移 0010_v3_2_0_sites.py(沿用幂等 _table_exists 守卫 + ensure_* 回填范式)

    • 建 sites 表并显式插入 id=0(is_default=True,name 取现 Setting.site_name)。MySQL 需会话级 NO_AUTO_VALUE_ON_ZERO。
    • 各表加 site_id(NOT NULL, server_default='0'),存量行自动归 0。
    • articles.site_id 由 columns.site_id join 回填。
    • 唯一约束改造(SQLite 走「建新表→拷数据→删旧表→改名」,MySQL/PG 走 ALTER ... DROP/ADD CONSTRAINT,按 db_type 分支)。
    • 建索引:columns(site_id,slug)、fragments(site_id,slug)、articles(site_id)、settings(key,site_id)、members(site_id,username)。
    • audit 加 site_id。
    • 插入全局 Setting 行 member_scope='shared'(site_id=0)。
    • downgrade() 对称回滚。
  5. 站点解析层 app/sites.py(镜像 app/i18n.py 的 select_locale 范式)

    • select_site():每请求首调,结果缓存 g.current_site_id,返回 int(0=默认)。
    • current_site_id():无应用上下文兜底 0。
    • _resolve_site_id() 优先级:① 后台/预览 ?site=(写 session['admin_site_id']);② request.host 精确匹配 sites.domain;③ 子域首标签匹配 sites.subdomain;④ 兜底默认站点 0。
    • create_app() 中前台 frontend_bp.before_request 挂载(置于 check_site_status 之前),后台蓝图同步挂载。
    • 本阶段解析器对现网恒返回 0(唯一域名/主域 → 默认站点),即恒等变换,零行为变化。
  6. 查询过滤

    • 前台内容查询(column_detail/article_detail/_build_nav/_home_section_data/首页/侧栏/上下篇)追加 site_id=current_site_id()。
    • 后台列表按 session['admin_site_id'](默认 0)过滤。

验收标准

不做(留给后续阶段)

  • 后台站点 CRUD / 切换器 / RBAC → M2
  • 站点化 settings/theme/sitemap/search/缓存命名空间 / 会员 member_scope 开关 → M3
  • 插件 SDK / 内置插件改造 → M4

关联

  • 设计文档:docs/SITE_GROUP.md
  • 后续:M2(后台+RBAC)、M3(站点化子系统+会员)、M4(插件 SDK)
likedislike