feat(distribution): 公告中心支持分站自定义

公告中心(前台公告列表/详情)此前完全没有站点概念,分站访客只能看到主站公告。
本次按「默认继承主站、站长可切仅本站」的口径支持分站自定义。

数据与口径:
- 新增 announcements.distribution_site_id(0=主站),前台按站点隔离
- 新增 distribution_sites.announcement_mode:inherit(默认,主站+本站)/ own_only(仅本站)

后端:
- 公告模块新增 ResolvePublicSiteScope:主站 [0]、inherit [0, siteID]、own_only [siteID],
  站点编码无效/已停用回落主站;列表与详情都按该范围过滤,详情不再允许跨站按 ID 读取
- 管理端公告列表支持按站点筛选(site_id:不传=全部,0=主站,>0=分站)并带出站点名
- 分销模块新增本站公告 CRUD(distribution/announcement.go):强制 distribution_site_id=本站,
  先过 ensureSiteAccess,跨站更新/删除/上下架一律 ErrAnnouncementNotFound
- UpdateSiteBranding 支持 announcement_mode 切换(非法值报错,读侧非法历史值回落 inherit)
- 新增权限 distribution:announcement_view|manage 并授予 super_admin/ops/finance,
  站长开通时继承 ops 角色即自动获得
- 路由:站长侧 /api/distribution/announcements*,平台侧 /api/admin/distribution/announcements*

前端:
- 分销后台新增「公告中心」页:来源开关(继承主站+本站 / 仅本站)、本站公告列表与
  新建/编辑/发布/下架/归档/恢复/删除,空态按来源模式给出引导
- 平台后台公告页新增「站点」列与筛选,新建公告可选择归属站点(主站或指定分站代发)
- 前台 PC/移动无需改动:请求已带 X-Distribution-Site-Code,后端按站点隔离,页面已有空态

测试:
- 公告模块:主站/继承/仅本站三种可见范围、跨站详情拦截、无效站点回落、管理端站点筛选
- 分销模块:本站公告 CRUD 与跨站防护、公告来源开关校验与非法值容错
This commit is contained in:
yml2213
2026-10-01 10:02:31 +08:00
parent 329d0f75bb
commit 2a76d59a30
24 changed files with 1676 additions and 88 deletions
+18
View File
@@ -259,6 +259,22 @@ offline
具体分成口径由 `resolveDistributionMode` 按「买入站 × 货源站」判定
(同站自卖 / 主站收号分站卖 / 分站收号主站卖 / 三方跨站),避免重复出售与归因冲突。
#### 6.3.2 公告中心(分站可自定义)
公告中心(前台「公告」页的列表/详情)按站点隔离,不再无条件继承主站:
- `announcements.distribution_site_id` 标记归属站点(`0` = 主站)。
- `distribution_sites.announcement_mode` 决定分站来源:
`inherit`(默认)= 主站公告 + 本站公告;`own_only` = 仅本站公告。
- 前台可见范围由请求站点(`X-Distribution-Site-Code` / `?distribution_site_code`)解析:
主站 `[0]`、inherit `[0, siteID]`、own_only `[siteID]`;站点编码无效/已停用回落主站。
详情接口同样按该范围校验,避免跨站按 ID 读取。
- 维护方:**站长在分销后台「公告中心」自助维护**本站公告
(`/api/admin/distribution/announcements` + `distribution:announcement_view|manage`,
站点由 `?site_id=` 解析并校验成员权限,跨站 ID 一律视为不存在);
平台后台的公告管理可按站点筛选、并为指定分站代发。
- 权限:新站点开通时站长继承 `ops` 角色,自动获得上述权限;超管/财务同样授予,便于代管。
### 6.4 不纳入分销网的业务
以下业务不属于分销网正常订单,不进入分销订单分账:
@@ -869,6 +885,8 @@ distribution.hao858.com {
- `distribution-admin` 基于 React + TypeScript + Vite + Ant Design,覆盖经营大盘、双视图资产管理、选品货架、订单中心、品牌装修与钱包明细。
- 分站前台统一按「一手独立商城」呈现:不向顾客暴露分销身份(无「官方分销」标识),
登录/注册页与首页品牌区的站名、Logo 均取自站点配置。
- 公告中心按站点隔离并可自定义(详见 6.3.2):`announcements.distribution_site_id` + 站点 `announcement_mode`
(`inherit` 继承主站+本站 / `own_only` 仅本站),站长在分销后台自助维护本站公告。
- 首页文案支持站长自定义:`distribution_sites.storefront_text_json`
(`tagline` 头部副标题 / `hero_badge` 主视觉徽标 / `hero_desc` 主视觉描述 / `card_sub` 移动端卡片副标题),
在分销后台「品牌装修 → 首页文案」编辑;字段留空或整段为空时回落到前台内置默认文案。