设计依据:docs/SITE_GROUP.md(已提交至 main)。本 issue 为站群模式四阶段落地的第一阶段(基座)。 目标:引入「站点」维度并保证默认站点(site_id=0)行为与现网完全一致(零回归)。
docs/SITE_GROUP.md
新增 sites 表(app/models/site.py)
sites
app/models/site.py
id
name
slug
domain
subdomain
status
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
site_id 列挂载
columns
articles
fragments
settings
members
audit
builder_pages
(scope,column_id)
column_fields
column_field_values
uploaded_files
users/roles/permissions
member_oauths
member_sms_codes
唯一约束改造
columns.slug
(site_id, slug)
fragments.slug
settings.key
(key, site_id)
members.username
(site_id, username)
Alembic 迁移 0010_v3_2_0_sites.py(沿用幂等 _table_exists 守卫 + ensure_* 回填范式)
0010_v3_2_0_sites.py
_table_exists
ensure_*
is_default=True
Setting.site_name
NO_AUTO_VALUE_ON_ZERO
NOT NULL, server_default='0'
articles.site_id
columns.site_id
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)
member_scope='shared'
downgrade()
站点解析层 app/sites.py(镜像 app/i18n.py 的 select_locale 范式)
app/sites.py
app/i18n.py
select_locale
select_site()
g.current_site_id
current_site_id()
_resolve_site_id()
?site=
session['admin_site_id']
request.host
sites.domain
sites.subdomain
create_app()
frontend_bp.before_request
check_site_status
查询过滤
column_detail
article_detail
_build_nav
_home_section_data
site_id=current_site_id()
0010
site_id=0
member_scope
站群模式 M1:站点基座(sites 表 + site_id 列 + 迁移 0010 + 解析器)
范围
新增
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+siterelationship),供核心表与插件表统一挂载。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 继承)。唯一约束改造
columns.slug:全局 unique →(site_id, slug)复合唯一。fragments.slug:同上。settings.key:全局 unique →(key, site_id)复合唯一。members.username:全局 unique →(site_id, username)复合唯一(共享模式恒为 0,等价全局唯一)。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_idjoin 回填。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。member_scope='shared'(site_id=0)。downgrade()对称回滚。站点解析层
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之前),后台蓝图同步挂载。查询过滤
column_detail/article_detail/_build_nav/_home_section_data/首页/侧栏/上下篇)追加site_id=current_site_id()。session['admin_site_id'](默认 0)过滤。验收标准
不做(留给后续阶段)
member_scope开关 → M3关联
docs/SITE_GROUP.md