dachui/hfb_sys
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
777 Commits 3 Branches 0 Tags
2e1344380567daf60f98d08bfbb5d668d0c366cb
Commit Graph
52 Commits
Author SHA1 Message Date
yml2213 2e13443805 feat(distribution): 站点归属兜底——未带站点编码时按访问域名识别分站 
- 新增 middleware.SiteDomainFallback：显式头/query 优先，两者都为空时用 Request.Host / X-Forwarded-Host 反查 distribution_sites.domain，并回填 X-Distribution-Site-Code 供后续 sitecode.FromRequest 使用
- 新增 distribution.Repository.ResolveSiteCodeByDomain（仅取 status=active 的站点）
- 路由层在所有业务路由之前注册；域名到站点映射走 1 分钟进程内缓存（含负缓存）；查库异常不阻断请求、退化为按主站处理；回环/本地地址跳过查询
- 背景：站点归属此前完全依赖前端注入头，首屏探测失败或漏带就会把分站写入记成主站（2026-10-10 前已因此丢失一批分站注册归属）
- 新增单测：中间件（显式优先、域名解析、本地地址跳过、转发域兜底、缓存与容错）与仓储域名查询边界（大小写/空白/主站域名/停用站点）
 2026-10-13 17:33:16 +08:00
yml2213 4a9e5f9d66 feat(announcement): 新增首页弹窗公告功能并完成弹窗UI视觉重构 
- 数据库与后端：announcements 表增加 is_popup 字段及迁移脚本，提供前台弹窗接口与多公告优先级选取，补全选优单测
- 管理后台：总后台与分销后台公告编辑新增「弹窗公告」开关与列表标签展示
- 前台交互：前台 PC/移动端首页引入 AnnouncementPopup，支持同一用户同一天同一公告仅弹一次的关闭记录
- 视觉优化：重构弹窗结构，顶栏镶嵌品牌橙流光细条与浅暖橙通知徽标，中间内嵌浅灰舒适阅读卡片，底部搭配大锤橙实心主操作按钮
- 验证方式：后端 announcement 单测通过，前端 npm run build 编译无报错，浏览器实机截图验证
 2026-10-12 18:33:44 +08:00
yml2213 cb8aceb433 fix(distribution): 支持客服在主站后台查看与管理分站二维码 
- 路由权限支持：新增 RequireAnyPermission 中间件，允许持有 qrcode:view 或 distribution:site_view 的管理员调用 GET /admin/distribution/sites 获取分站列表
- 服务层站点穿透：ListSitesForAdmin 允许持有 qrcode:view 权限的管理员（客服）获取全部可用分销站点用于码池维护；站长/分销商等站点成员仍按其绑定站点收窄
- 前端交互与权限分组：分站二维码池 loadSites 补充异常捕获，分配权限弹窗补充「分销管理」分组展示名
- 权限来源：cs 角色的 qrcode:view/manage 由既有迁移 000016 提供，故本次不新增数据库迁移
- 权限边界：不采用 distribution:all_view 实现该需求——它是跨站写操作的总开关（改站/删站/重置站长密码），而该权限依赖的 ops 角色同时是分站站长，授予后会击穿多租户隔离；并补充回归断言锁定该边界
- 验证方式：全量门禁 ./scripts/check.sh 通过（SQL 约束检查、Go 单测与覆盖率、路由测试、前端类型检查、单测与生产构建）
 2026-10-11 17:11:46 +08:00
yml2213 95435faf46 perf(distribution): 优化分销订单全量与分站慢查询，消除全表扫描与每行EXISTS子查询 
- 数据库迁移：新增 000083 迁移，为 distribution_order_parties 添加 (site_id, order_id) 联合覆盖索引；
- 查询优化：重构 ListOrders，利用覆盖索引派生表预收敛分销订单候选集，替代在 3.7 万行 rental_orders 上的 OR EXISTS 逐行子查询全表扫描；
- 边界修复：超管全量分销订单（site_id = 0）增加分销范围收敛，防止全平台普通非分销订单混杂和 5 表级联扫表；
- 统计优化：同步改造 GetDashboardAnalytics 与 ListDistributionUsers，彻底消除大盘统计与客户画像聚合的慢查询；
- 验证方式：新增 TestListOrdersPerformanceAndScoping 单元测试，全量运行 ./scripts/check.sh 门禁验证通过。
 2026-10-10 15:17:25 +08:00
yml2213 4ea08e355b feat(distribution): 分销站点增加用户数量统计与用户信息展示模块 
- 数据模型与迁移: 新增 000082 迁移在 users 表追加 distribution_site_id 并建索引，用户首次在分销站点注册/短信登录时自动绑定站点归属
- 分销管理接口: 新增 GET /admin/distribution/users 接口，聚合本站注册用户与下单客户，返回完整11位手机号、累计消费金额、订单数及来源标签
- 统计与大盘扩展: GET /admin/distribution/sites/:id/analytics 补全今日注册、累计用户、成交客户指标，主站分销商列表追加用户体量展示
- 分销后台前端: 新增「客户与用户」页面 (Users.tsx) 支持一键复制手机号与订单穿透，大盘 (Dashboard.tsx) 增加用户规模核心卡片
- 自动化测试与门禁: 新增 TestListDistributionUsersAndAnalytics 单元测试，通过全量 Go 后端集成测试及前后端构建检查
 2026-10-10 14:58:33 +08:00
yml2213 6d34f86765 fix(distribution): 分销后台展示完整用户手机号信息 
- 后端 ListReceivedListings 移除 owner_phone 脱敏，向分销商返回完整卖家手机号
- 前端 Orders.tsx 移除 maskPhone 遮蔽逻辑，订单列表与收号货架均直接展示真实完整手机号
- 手机号文本支持一键复制，方便分销管理员日常履约联系
- 验证方式：go test 运行通过，npm run build（tsc + vite build）通过
 2026-10-10 14:18:27 +08:00
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
yml2213andCursor 7833e90eee feat(distribution): 分站品牌装修可配置首页入口并上传图片 
分站可单独配置回收、合作反馈和客服二维码，未配置时继承主站；Logo、图标和轮播支持直接上传。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-25 17:44:56 +08:00
yml2213 1c3a75eef0 feat(distribution): 分销站点管理支持完整 CRUD、安全删除保护与管理员密码重置 
- 后端支持分销站点编辑（域名唯一性校验、收号压价点位及税率更新）
- 后端支持分销站点安全删除校验（阻断存在业务订单、财务流水、结算批次或钱包余额的站点删除；对干净站点连带清理分成规则、展示账号绑定、支付通道配置及专有站长账号）
- 后端支持站长账号展示与超级管理员重置站长密码
- 主管理后台与分销后台前端全面支持筛选搜索、编辑模态窗、状态快捷切换、站长密码重置与安全删除确认
- 补充后端 CRUD、删除保护与密码重置覆盖率测试用例
 2026-09-17 19:35:52 +08:00
yml2213 22fcaa5945 feat(distribution): 分站收号压价解耦买家价（方案 B 新口径） 
核心语义反转：receive_cost_delta 为压价点数，收号比例 = 主站参考比例 R + 点数，
点数越大号主收号价越低；买家售价锚定主站参考比例推导，不再随收号价联动。

- 迁移 000072：distribution_sites 新增 receive_cost_delta（旧 receive_ratio_delta 保留只读）
- receive_pricing：新增 Normalize/ApplySiteReceiveCostDelta；分站定价买家侧改用
  R 锚点（referenceSellerCoinBasePrice），快照写入 site_receive_cost_delta 与 pricing_model 标记
- site_receive：新增 resolveSiteReceiveCostDelta 读取链路，旧 ResolveReceiveRatioDelta 保留
- 分成不变：压价差经结算层 profit 自动进入 35/40/25 三方分成池；
  货架自主加价仍 100% 归分站，两条边界均以主站为锚
- 权限对齐旧字段：主站全局管理员与分站操作员均可设置
- 前端三端同步：主站 pricing.ts/usePricingCalculator 买卖解耦试算、
  主站后台弹窗改「收号压价」价格语义文案、分销后台 SiteSettings 同步
- 测试：单测锚定 R=43 时 cost_delta=3 → 收号 217.4 / 卖价 263.2 不变 / markup 池 30.6→54.9
 2026-09-17 15:54:56 +08:00
yml2213 8dc21d2757 refactor(sitecode): 统一各模块分销站点编码解析为公共包 
- 新增 internal/sitecode 包：FromRequest 头优先解析、FromQueryThenHeader
  探测接口专用、ExtractHost/IsLocalHost 提取 Host 域名
- 替换 auth/order/listing/chat/notification/withdrawal/wallet/distribution
  八模块 17 处各自内联的解析逻辑，统一优先级与 TrimSpace 行为
- 修复 notification 漏 TrimSpace、探测接口会话头压过显式 query、
  GetPublicSiteInfo 把 localhost Host 当站点域名查库等不一致
- 顺手清理 auth 中无引用的 extractHost 死代码
- gofmt 修复 withdrawal/presenter、chat/file/payment 测试四个历史遗留格式问题
 2026-09-17 14:54:38 +08:00
yml2213 3465475756 feat(caddy): 支持分销站点独立域名 On-Demand TLS 自动签发 SSL 证书 
- 后端新增 GET /api/distribution/check-domain 作为 Caddy on_demand_tls ask 白名单端点
- 补充 CheckDomain 相关场景自动化测试
- Caddyfile 启用 on_demand_tls 并配置动态分销前台入口
 2026-09-16 14:20:44 +08:00
yml2213 dc13b5dc82 feat(distribution): 支持分站独立短信验证码通道 
- 新增分销站点独立短信服务商配置（阿里云），登录验证码按 site_code/domain
  解析专属通道，未启用或解析失败时回退主站默认通道
- 密钥经 crypto.Encryptor 加密落库，模型字段 json 序列化隔离，DTO 仅回传掩码
- provider 白名单校验，mock 仅在非生产环境放行；启用时强制校验必填凭据
- 配置读写/测试接口限管理员权限，测试发送增加 60s 频控（Redis，缺省进程内）
- 解密失败记告警并优雅回退主站，避免把密文当明文密钥使用
- 两套前端新增短信配置入口、必填与手机号校验、发送冷却
- 新增迁移 000071 及加解密、白名单、频控、解析回退等单测
 2026-09-16 14:06:01 +08:00
yml2213 d3d571357a refactor(order): 结账单状态常量化并锁定仲裁结单统计口径 
仲裁结案会把结账单置为终态 settled，但该状态一直是裸字符串；同时 adminfinance 按日结算聚合只按
accepted 过滤，容易被误读成"仲裁单掉出统计"。本次只做卫生与口径固化，不改任何行为：
- order 新增 CheckoutStatus{Submitted,Countered,Accepted,Disputed,Settled}，包内沿用非导出别名
- dispute 的仲裁结案与争议取消分支改用常量；distribution 不能反向依赖 order，本地声明同名常量
- adminfinance 聚合里的 oc.status = 'accepted' 改为常量绑定，并注释说明仲裁单不计入是有意口径
- 新增 distribution 结账单退款重算用例（该分支原先无覆盖）：accepted/settled 按结账单实际租金，
  submitted 不被采用；dashboard 用例补一张 settled 结账单，钉住"不计入已结算订单数"
 2026-09-16 12:49:21 +08:00
yml2213andCursor c9d9160ff4 feat(distribution): 分站可下调收号比例且不超过主站上限 
让分销站能按自身能力下调收号比例扩大利润，同时把主站回收比例作为硬边界，避免分站把比例加得比主站更高。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 20:35:30 +08:00
yml2213andCursor 1c86bef765 feat(distribution): 支持分站发布群固定二维码 
主站分销配置可为每个站点绑定可复用企微码，号主在该站上传账号后发到对应发布群，不再消耗主站码池。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 19:02:10 +08:00
yml2213 3508608a8f feat(distribution): 优化货架批量操作、结算大事务、大盘与前台多端解析缓存及货架分页 2026-09-11 12:59:33 +08:00
yml2213 9ae6d5eaea feat(distribution): 优化一键同步主站商品功能（并发防重、分批入库、失效商品联动下架与初始加价） 
- 后端优化：
  - 引入 Redis + 内存 sync.Map 双重互斥锁，避免并发/连击导致唯一索引冲突 (ErrSyncInProgress)
  - 使用 CreateInBatches(500) 进行大数据量批量插入，杜绝超长 SQL 与锁表超时
  - 增加 CleanStaleListings 支持，自动排查并联动下架主站非在售的货架商品，清理历史幽灵数据
  - 增加 DefaultShelfRatioDelta 支持，新同步商品直接继承初始加价比例，免除二次手动改价
- 前端优化：
  - distribution-admin 货架管理新增一键同步配置弹窗（可勾选自动下架失效商品、配置初始加价）
  - 同步完成后展示结构化统计弹窗（新增、保持、联动下架、主站在售总量）
  - 前后端类型定义与 API 客户端对齐升级
- 测试覆盖：
  - 补充 TestSyncSiteAccountsOptimizations 单元测试与 handler 集成测试
  - 全工程测试与门禁 check.sh 100% 通过
 2026-09-11 12:47:59 +08:00
yml2213 ef91b24bf2 test(distribution): 补齐分销全场景E2E与HTTP接口全链路集成测试 
- 新增端到端测试场景：
  - 场景 1: 主站收号分站加价售卖与批次结算全链路
  - 场景 2: 分站收号主站售卖、独立鉴权、大盘统计与提现全流程
  - 场景 3: 三方模式跨站流转、专属支付通道自动路由与双站批次独立结算
  - 场景 4: 分站自收自售、3天冷却期自动释放及幂等防护
  - 场景 5: 结算后退款回冲金库钱包、掏空后透支扣减与仲裁风险隔离
  - 场景 6: 一键开站、成员JWT鉴权、品牌个性化、三模解析与货架同步加价
- 新增 distribution/handler_integration_test.go：覆盖 30+ 分销 HTTP 接口（前台公开端点、分站管理员登录/信息端点、站长运营端点及总台管理端点）
- 修复并对齐底层逻辑：
  - FindOrder & ListOrders：多参与方按 PartyID 准确隔离各站收益与提价统计
  - SnapshotPaidOrderTx：规范多方模式下 PartyTypeSite 的 SiteID/PartyID
  - 增加 ErrInsufficientBalance 哨兵错误并在 handler 映射为 400
 2026-09-11 11:20:07 +08:00
yml2213 9ae763dee6 fix(distribution): 修复收号站订单详情权限、专属支付通道路由、大盘统计与仲裁积分隔离 
- 修复 FindOrder 在收号站模式(two_party_distributor_receive / three_party)下的 403 权限判定，放行参与方站点成员并精准计算收益
- 串联 distribution_site_payment_channels 至 payment.Start 核心支付发起流程，分销订单优先使用绑定的专属商户通道
- 修复数据大盘 GetDashboardAnalytics 趋势中 ReceivedCount 恒为 0 的问题，并对齐今日订单与 GMV 统计
- 修复 dispute/arbitration.go 仲裁完成时向分销租客发放成长积分的泄漏风险
- 提现管理新增 distribution_site_name/distribution_site_code 字段并在后台列表与详情弹窗中区分展示分销站
- GetPublicSiteInfo 增加 X-Distribution-Site-Code 请求头兜底支持
 2026-09-11 10:31:14 +08:00
yml2213 fa49505239 chore(migration): 顺延分销迁移序号至 000066-000068，为 main 分支 000065 让路 2026-09-11 09:35:51 +08:00
yml2213 403d20cabd refactor(migration): 整合分销迁移至终态定义并清理零散改表与测试种子数据 2026-09-10 19:45:00 +08:00
yml2213 140c538d4f fix(distribution): 人工批次窗口期防退款穿透与退款中途金额单调性加固 2026-09-10 19:39:27 +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
yml2213andCursor 768902f2f7 feat(distribution): 补齐退款加价回退、本站自卖与开通默认规则 
退款时压缩卖方加价，人工/自动批次仅完结单可入账，号主收入进主站钱包；仲裁后重算释放并支持作废未入账 DS。开通时四种模式按默认生效，对外口径合并为 35/40/25，不再单独展示通道费。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-10 18:13:46 +08:00
yml2213andCursor e621722218 fix(admin): 主站分销管理按最新分成与释放口径改展示 
规则页按模式展示收号/卖出/服务费，通道费标明主站承担；订单改为释放状态筛选；结算区分自动与人工批次。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-10 17:36:49 +08:00
yml2213andCursor 647fdc0b4a feat(distribution): 通道费改主站承担，并按冷却期自动释放结算 
利润不再扣支付通道费；站点可配置结算冷却期，到期自动入账，已释放后退款从收款站钱包回冲。同时修复当日自动批次无法追加、三方回冲打错钱包，以及测试库自增重置被 MySQL 统计缓存跳过的问题。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-10 17:11:58 +08:00
yml2213 cbd5412315 test: 后端测试从 SQLite 全面切换到 MySQL，与生产环境对齐 
测试库不再使用 SQLite 内存库，改为每个测试包独立的 MySQL 库，
表结构由 backend/migrations 的真实迁移建立。

基础设施
- 新增 internal/database/testdb.go：NewTestDB() 保持原签名（28 处调用零改动），
  内部连接 MySQL 测试库，首次调用重建库并执行全部真实迁移，之后每次调用清空全表
- 库名 = 测试库基础名 + 包目录名，同包共享、跨包隔离，使 go test ./... 可并发执行
  （共用一库时各包会互相 DROP/CREATE 导致 database exists）
- 新增 NewDryRunDB()：MySQL 方言 + DryRun，供断言 SQL 形态的 5 处测试使用
- 新增 AutoMigrateIfMissing()：只对不存在的表 AutoMigrate，
  避免改动迁移定义的索引与约束
- 新增 scripts/prepare-test-db.sh：建库与通配授权，可重复执行
- 33 处 sqlite.Open 全部替换，26 个测试文件改用 MySQL
- 删除 46 处手写 SQLite 方言 DDL（AUTOINCREMENT / INTEGER PRIMARY KEY / TEXT），
  表统一由真实迁移建立
- go.mod 移除 gorm.io/driver/sqlite 与 mattn/go-sqlite3
- 删除生产代码里 distribution/repository.go 的 sqlite 方言分支（strftime）

对齐环境后暴露并修复的真实问题
- DATE(col) 在 MySQL 返回 DATE 类型，使 Date string 字段变成 RFC3339 时间串，
  大盘日期会带出时间部分；28 处改为 DATE_FORMAT(col, '%Y-%m-%d')
- 系统自动创建分销结算批次时 created_by 写入 0，违反指向 admin_users 的外键，
  生产会直接插入失败；改为写 NULL（新增 adminRef helper）
- MySQL DATETIME 仅到秒，静默截断 Go 侧写入的时间，
  导致租用时长计算与结算时点回读比对偏差；
  rental_orders 的 9 个业务时间列提到 DATETIME(6)
- 测试数据补齐严格模式要求的 NOT NULL 列、修正超出列长的取值、补齐外键父记录

迁移
- 000065 的 ALTER TABLE rental_orders 一并完成业务时间列精度调整，
  feature 侧不再单开迁移文件

脚本与文档
- check.sh / check-backend-coverage.sh 去掉 -p 1 串行与 SQLite 相关注释
- 更新 docs/Repository层测试补充总结.md 的测试运行说明
 2026-09-10 14:34:01 +08:00
yml2213 b16c45ce6f fix(distribution): 修复分销结账退款分成计算逻辑与利润统计，优化分销订单表格列宽与展示体验 2026-09-09 19:34:04 +08:00
yml2213 02d091434e fix(order): 修复分销收号商品在主站租用后报订单不存在的问题 2026-09-09 15:24:56 +08:00
yml2213 f6ad7c34ee feat(distribution): 重构分销后台为SaaS商户工作台并全面商业化优化 
- 商品货架 (Accounts.tsx): 支持期望售价/固定金额/百分比多模式实时联动加价与批量调价，高亮100%独享溢价
- 订单中心 (Orders.tsx): 透传账号游戏租客信息，新增收益对账抽屉透明拆解底价、手续费、分成与自主溢价
- 结算与规则 (Settlements.tsx & Rules.tsx): 纠正角色倒错，商户视角展现周期对账单与分成合作政策
- 店铺装修 (SiteSettings.tsx): 废除手写JSON，提供横幅/公告/页脚可视化列表编辑器与前台实时模拟器
- 数据大盘 (Dashboard.tsx): 对齐最新订单字段，大字展示分销商净收益
- 后端数据层 (dto.go, repository.go, handler.go): 聚合计算分销商订单收益，支持商品与租客搜索
 2026-09-09 14:44:02 +08:00
yml2213 9452cf608e feat(distribution): 支持一键同步主站商品池并在货架区分货源归属 2026-09-09 13:44:50 +08:00
yml2213 cf4bea9b6d test(distribution): add e2e scenario 1 test and fix tx deadlock in MarkSettlementBatch 2026-09-09 13:34:35 +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 48a2961245 fix(distribution): 收紧分销权限与货架状态，开通时创建站点金库 
无站点成员不再视为超管；分站下架只改展示状态；装修、批量加价与提现参数对齐。
 2026-09-08 17:45:05 +08:00
yml2213 31bf6dd3b6 fix(distribution): 修正商品归属回填、禁止全站灌货并拒绝无效站点头 
用货架写入时间与上传来源回滚误标产地，不再依赖绝对时间戳；同步仅收本站上传与显式勾选。
 2026-09-08 17:30:12 +08:00
yml2213 96bc6a4db6 fix(distribution): 货架加价打通前台、下单与卖方分成 
分站公开列表和详情展示当前货架加价；下单写入 base_price / shelf_markup / markup_site_id 快照并计入实付。
支付分账改用快照加价，不再误用 PlatformFeeCent；结账不退加价，事后改价不影响历史订单。
 2026-09-08 17:07:17 +08:00
yml2213 8521bf4753 fix(distribution): 修正分销模式判定与结算入账，冻结未确认分成 
按买卖站点纯函数判定五种模式，分站卖主站货命中 two_party_platform_receive。
结算批次只收本站 site party，平台分成不再进入分销钱包；生产环境冻结结算入账与站点提现。
 2026-09-08 16:52:09 +08:00
yml2213 2c4e87475a feat(distribution): 完善分销收号资产双视图、商户提现、自主加价、品牌装修与数据大盘 2026-09-08 16:05:30 +08:00
yml2213 0fcb6a513f feat(distribution): 支持分销上传来源追踪、主站审核展示与收售结算模式自动判定 2026-09-08 15:00:35 +08:00
yml2213 ecaf15417b feat(distribution): 独立分销前台商城多租户体系、货源与订单数据严格隔离 2026-09-07 17:18:14 +08:00
yml2213 550b42eb22 feat(distribution): 独立分销后台账号体系、多租户隔离与主站后台分销管理GUI 
- 独立账号鉴权：分销后台支持独立登录页面、Bearer+Cookie 双模鉴权与租户资料接口
- 多租户隔离：分销商成员强制锁定自身站点数据范围，防止横向越权；平台超管享有全局视界
- 一键开通分销商：平台端支持一键录入站点、管理员账号、分配角色并原子化初始化佣金规则
- 主后台分销分组：在主站后台增加「分销管理」导航分组，提供站点管理、规则配置、订单监控与结算管理 GUI
- 门禁与联调：补充完整单测，全量代码门禁 check.sh 100% 通过，dev.sh 支持前后端与分销后台一键同启
 2026-09-07 15:45:53 +08:00
yml2213 369b0647bb 合并 main 分支并融合订单列表最小化与 SQL 治理 
- Auth/权限中间件取 main 演进版（错误细分、token 来源），保留 dev 的用户 cookie 与登出撤销语义
- 后台订单列表：融合 main 的首页免 COUNT 优化与关键词索引路由，保留 dev 的最小化 AdminOrderListItemDTO（结账明细仍由详情接口返回，同步调整对应集成测试）
- 保留 dev 的 token_version 冻结/解冻递增与 main 的状态变化判断及通知
- 前端：保留 dev 登出接口与 main 的 fetchMe silent 参数、SSE 登录跳转；后台订单表按 dev 最小化 DTO 移除号主到手列
 2026-09-05 11:43:13 +08:00
yml2213 3162d15425 分销后台前端对接与结算明细接口 
- 新增 GET /admin/distribution/settlement-batches/:id/items 明细查询
- distribution-admin 重构为 react-router 多页面：仪表盘/网站/规则(启停)/订单(筛选分页)/结算(创建/明细/结算)/支付通道(绑定解绑)/账号展示(上下架)
- axios 统一 401 提示，引导回主站后台登录；金额统一整数分格式化
- npm run build(tsc 严格模式) 通过
 2026-09-05 11:17:43 +08:00
yml2213 ac777f5b16 补全分销分账结算闭环并修复站点越权 
- 权限落库：新增 000066 迁移，注册 11 个 distribution:* 权限并授权 super_admin/ops/finance
- 越权修复：siteAccessAllowed 校验贯穿站点/规则/订单/展示/支付通道/结算全部按 ID 操作
- 分账闭环：SplitSettlement 按比例拆分分成基数，销售加价归卖出方，尾差记入 rounding_adjustment_cent 归平台；支付快照与退款重算均按拆分写入参与方金额
- 结算批次：创建时聚合周期内待结算订单生成明细并汇总金额，结算时校验明细与总额一致后联动置位财务快照
- 手工补数接口禁止覆盖已有快照并写入审计日志
- 杂项：二维码池校验站点启用状态且不吞真实 DB 错误；绑定支付通道校验商户配置存在；表探测改为 sync.Once 缓存
 2026-09-05 11:12:44 +08:00