dachui/hfb_sys
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
760 Commits 3 Branches 0 Tags
180a21c048469537f3b2cb4db646bf1bb987a6a3
Commit Graph
11 Commits
Author SHA1 Message Date
yml2213 2a76d59a30 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 与跨站防护、公告来源开关校验与非法值容错
 2026-10-01 10:02:31 +08:00
yml2213 329d0f75bb feat(distribution): 分站前台按独立商城呈现并支持首页文案自定义 
分站前台原本对顾客暴露分销身份，且登录等页面写死了主站品牌，
与「一手独立商城」的定位不符；同时首页文案全部硬编码，站长无法按自己口径调整。

去分销身份（顾客可见处）：
- 头部品牌区、首页主视觉、移动端认证卡去掉「官方分销/官方分销认证/官方分销站」标识
- 会员徽标「分销专享」→「会员专享」，「所属商城」兜底「专属分销站/商城」→「官方商城」
- 订单页说明改为「当前为【X】商城，仅展示在本站产生的订单记录」，保留订单按站隔离的必要说明
- 无公告时的兜底跑马灯、轮播角标去掉分销措辞
- 清理随之失效的 pc-brand-badge / mobile-brand-badge 样式

品牌跟随站点配置（即可自定义）：
- PC/移动登录页、移动注册页、加桌面引导页的品牌改为 站点名称 + Logo（无 Logo 取站名首字），
  不再写死主站「大锤商行」；主站行为不变（新增 store getter brandMark：分站取站名首字，主站仍为「锤」）

首页文案可配置：
- 新增迁移 000076 与 distribution_sites.storefront_text_json
  （tagline 头部副标题 / hero_badge 主视觉徽标 / hero_desc 主视觉描述 / card_sub 移动端卡片副标题）
- 分销后台「品牌装修 → 首页文案」可编辑，占位提示即默认值，留空或整段清空回落内置默认
- 贯通 UpdateSiteBranding → 公开站点信息接口（含 Redis 缓存失效）→ 前台 store 逐字段合并默认值
- 装修预览同步展示站长填写的副标题与徽标

测试：
- 后端补装修字段写入/公开接口透出/清空回落断言
- 前端新增 storefrontText 单测（默认合并、覆盖、空白与非法类型回落）
 2026-10-01 09:24:56 +08:00
yml2213 766c923a6a fix(distribution): 修复分站搜不到已审核商品并实现审核通过自动铺货 
问题：分站上架商品审核通过后主站能搜到、分站看不到，且没有自动同步。

根因：分站前台/搜索只认 distribution_site_accounts 中 display_status='enabled'
的货架行，而主站前台不按站点过滤。货架行此前只由「号主在该站上架」或站长手动
「一键同步主站商品」写入，审核通过不回写；同时一键同步的失效清理把「非
published+approved」的货架行一律置为 disabled，商品重新在售后也不会恢复。

- 新增 EnsureListingShelvedTx：商品变为 published+approved 时自动铺到所有
  display_account_enabled=true 的站点货架（缺行新增、系统下架恢复、人工下架不动），
  经 ListingShelfSyncer 接口注入，避免 listing 反向依赖 distribution
- 新增 distribution_site_accounts.display_disabled_by（operator/system/空）区分下架
  来源；人工上下架各入口写入来源标记
- 一键同步的失效清理收紧为只清理「货源记录已删除」的孤儿行，并支持恢复系统下架行，
  结果新增 reenabled_count
- 新增迁移 000074 回填存量缺失货架行，部署后无需逐站手动同步
- 修复 CreateSite 显式传 false/0 的配置（不允许自动展示、结算冷却 0 天）被 GORM
  default 标签忽略而静默回落默认值
- 前端：去掉会跨站串扰的 localStorage 站点码回退，站点探测完成后再挂载应用，
  避免分站发布因缺少站点码被记成主站商品；同步弹窗文案与统计项同步更新
- 补充分销货架自动铺货、清理口径、建站零值落库与审核铺货回归测试
 2026-09-30 21:11:09 +08:00
yml2213 0eff43ad52 docs(distribution): 统一通道手续费口径至 v0.8 
代码侧 647fdc0 已把通道手续费改为主站承担、不再从分成基数中扣除，但设计文档多处仍写"扣除通道手续费"，
7.8 的结算恒等式还把通道手续费列为实付的一项，与实现互不兼容。按代码口径统一文档：

- 7.1 / 7.5 公式改为 有效加价 = min(shelf_markup_cent, max(净支付额 - 号主底价, 0))，
  提价利润基数 = max(净支付额 - 号主底价 - 有效加价, 0)
- 7.8 恒等式左端改为净支付租金，通道手续费移出等式单独说明，平台收益行去掉" + 通道手续费"
- 14 验收标准、16 实现基线同步，文档头升级 v0.8 并记录变更点
 2026-09-16 12:49:21 +08:00
yml2213 36ebe7a5f1 fix(distribution): 结算幂等与退款口径加固，补关单释放与回归测试 
- 结算明细加唯一键 (order_id, party_id)：自动释放与手工批次并发时以唯一键冲突为准跳过该参与方，不再重复入账
- 自动释放先无锁筛出本站未入账参与方，收敛加锁范围；手工批次建批次后先锁周期内财务快照，与自动释放串行化
- 累计退款额改为「本次回调金额与已退款成功流水合计取较大值」，多笔退款与退款结果重复回调不再把口径写小
- 关单三路径（AdminClose / AdminRejectRefund 的 close 分支 / AdminSeal）补写 release_at，接线原死代码 EnsureCompletedReleaseAtTx
- 仲裁分销重算改用实际退款额（扣除押金暂扣），避免站点被多扣
- 订单列表与详情的提价分成取 min(收入, 货架加价)，退款压缩加价后不再显示负数
- 新增迁移 000070（结算明细唯一键）、000071（补回填 closed 订单释放时间）
- 新增 5 个测试文件：结算幂等与展示钳制、结算 job 幂等、累计退款、关单补写释放时间、仲裁押金暂扣口径
 2026-09-10 19:13:39 +08:00
yml2213 e3a75fb2d7 feat(distribution): 默认结算冷却天数改为系统配置驱动 
新建站点的默认冷却期原先硬编码 7 天（OnboardSite 字面量、DB 列默认、两套前端表单），
改一处要同时动三处。现统一到系统配置键 distribution.default_settlement_hold_days：

- systemconfig 注册该键（默认 7，0=立即释放，0-365 校验），纳入 admin 可见配置
- distribution 建站两条路径（CreateSite 未传值、OnboardSite 缺省）读取该配置，缺失或非法回落 7
- 新增 GET /admin/distribution/site-defaults 暴露当前有效默认值
- Vue / React 站点表单改为运行时拉取，拉取失败保持 7
- DB 列默认值保留作为兜底，站点级 settlement_hold_days 仍可单独覆盖
 2026-09-10 18:54:23 +08:00
yml2213 dbe9aaabfe feat(distribution): 移除生产环境资金冻结，测试与生产口径统一 
liveMoneyMovementEnabled 按 APP_ENV 在生产冻结结算入账、站点提现与自动释放，
与测试环境行为不一致，且该开关在 APP_ENV 缺失时为 fail-open。本次整体移除：

- 删除 liveMoneyMovementEnabled 与 ErrLiveMoneyMovementFrozen
- MarkSettlementBatch / ApplySiteWithdrawal / AutoReleaseDueSettlements 去掉守卫
- handler 去掉 403 settlement_frozen 映射
- 测试改为断言生产环境结算入账与提现正常执行
 2026-09-10 18:44:52 +08:00
yml2213 4aab9e7e33 fix(distribution): 分成改为分主站提价利润，分站自主提价溢价全额归卖方 
- 文档：升级至 v0.7，固化号主保底、主站提价利润分账（35/40/25）与分站加价溢价独享逻辑
- 定价：修正货架兑换比例调价方向为调减比例提价（site_ratio = base_ratio - delta）
- 分账：分成基数剔除号主成本与分站加价，提价利润按规则切分，分站自主加价溢价 100% 归卖出方
- 前端：更新分销后台提价说明文案，提示调减比例提高售价且溢价归本站
 2026-09-08 19:45:05 +08:00
yml2213 d762b33f54 refactor(distribution): 重写分销迁移并落地利润百分比分成与货架比例 
将 000064-000078 合并为 064/065/066，默认规则改为收号 35%、卖出 40%、服务费 25%。
货架调价改为增加分站 1 元兑换哈夫币比例。sql-guard 仅保护 main 已发布迁移。
 2026-09-08 19:02:58 +08:00
yml2213 ac67a91438 接入分销订单支付退款与站点隔离 2026-09-05 10:52:36 +08:00
yml2213 2ffa7a89b1 实现分销网后台基础功能与独立前端 2026-09-05 10:52:36 +08:00