feat: 初始化雄戈商城服务端代码与Webhook自动部署配置

plan/chat-backup/subagents/1cafd55b-280d-43cf-9d7b-851f96642038/73c0b49f-67f4-4de9-a80a-aba99742e130.jsonl

@@ -0,0 +1,2 @@
+{"role":"user","message":{"content":[{"type":"text","text":"<timestamp>Friday, Sep 11, 2026, 9:55 AM (UTC+8)</timestamp>\n<user_query>\nExplore the codebase at f:\\修改的项目\\贵州宥川商贸有限公司\\chufang.gynhc.com\\chufang.gynhc.com for distribution/commission (推广员/分销) application and onboarding flows.\n\nFind:\n1. API controllers for commission apply (Agent apply)\n2. Database tables for commission agents\n3. Mini-program pages related to commission apply at f:\\修改的项目\\贵州宥川商贸有限公司\\chufang.gynhc.com\\xgsc.gynhc.com_wx\n4. Any existing huifu_id or split receiver binding for promoters\n5. Admin views for commission agent management\n\nReturn: file paths, key methods, table names, current apply form fields, and what's missing for Huifu onboarding integration.\n</user_query>"}]}}
+{"role":"assistant","message":{"content":[{"type":"text","text":"Searching both codebases for commission/agent apply flows, related tables, and Huifu integration points.\n\n[REDACTED]"},{"type":"tool_use","name":"UpdateCurrentStep","input":{"current_step":"Searching commission apply flows","final_summary":"placeholder","completed_subtitle":"placeholder"}},{"type":"tool_use","name":"Grep","input":{"pattern":"Agent|agent|commission|推广|分销","path":"f:\\修改的项目\\贵州宥川商贸有限公司\\chufang.gynhc.com\\chufang.gynhc.com","glob":"**/*Controller*","output_mode":"files_with_matches","head_limit":50}},{"type":"tool_use","name":"Grep","input":{"pattern":"huifu_id|split.*receiver|分账|汇付","path":"f:\\修改的项目\\贵州宥川商贸有限公司\\chufang.gynhc.com\\chufang.gynhc.com","output_mode":"files_with_matches","head_limit":50}},{"type":"tool_use","name":"Grep","input":{"pattern":"推广|分销|commission|agent|apply","path":"f:\\修改的项目\\贵州宥川商贸有限公司\\chufang.gynhc.com\\xgsc.gynhc.com_wx","glob":"**/*.{vue,js,ts,json}","output_mode":"files_with_matches","head_limit":50}},{"type":"tool_use","name":"Glob","input":{"target_directory":"f:\\修改的项目\\贵州宥川商贸有限公司\\chufang.gynhc.com\\chufang.gynhc.com","glob_pattern":"**/*Agent*"}},{"type":"tool_use","name":"Glob","input":{"target_directory":"f:\\修改的项目\\贵州宥川商贸有限公司\\chufang.gynhc.com\\chufang.gynhc.com","glob_pattern":"**/*Commission*"}}]}}

plan/chat-backup/对话摘要-2026-09-12打包.md

@@ -0,0 +1,156 @@
+# 对话摘要汇总（2026-09-04 ~ 2026-09-12）
+
+- **项目**：chufang.gynhc.com / xgsc.gynhc.com（厨房/宥川商城）
+- **备份时间**：2026-09-12
+- **说明**：「飞天」系列为另一独立酒类项目，与本项目无关
+
+---
+
+## 会话索引
+
+| 日期 | 主题 | 会话 ID | 摘要 |
+|------|------|---------|------|
+| 09-04 | 区域代理功能实施 | `1fc9746b` | [对话摘要-区域代理实施.md](./对话摘要-区域代理实施.md) |
+| 09-08~09 | 汇付支付 + 延时分账插件 | `a5138654` | 见下文 §1 |
+| 09-10 | 首页布局改版 E-Final | `45ebfacd` | 见下文 §2 |
+| 09-10~11 | 微信发货信息同步 | `553f50fe` | 见下文 §3 |
+| 09-10~11 | 阿里云快递查询插件 | `909afd5e` | 见下文 §4 |
+| 09-11 | 汇付个人进件（推广员/区域代理） | `1cafd55b` | 见下文 §5 |
+| 09-11 | 敏感文案 + 提现进件 + 图片压缩 | `c58fb120` | 见下文 §6 |
+
+原始 JSONL 文件均位于 [`chat-backup/`](./) 目录。
+
+---
+
+## §1 汇付支付 + 延时分账（a5138654）
+
+**计划**：[汇付小程序支付对接_c945b5d0.plan.md](../汇付小程序支付对接_c945b5d0.plan.md)
+
+| 时间 | 用户诉求 | 处理结果 |
+|------|----------|----------|
+| 09-09 | 判断支付产品线和接入方案 | 分析汇付斗拱聚合支付 + 延时分账 |
+| 09-09 | huifu_id 查看、AppID 绑定、sub_openid 链路 | 文档说明 + 后台配置指引 |
+| 09-09 | 检查方案遗漏、分账后台可配置 | 补充方案：分账时机可选、插件化 |
+| 09-09 | 支付做成可卸载插件 | 设计 `shopro_huifu` 插件架构 |
+| 09-09 | 实施汇付对接方案 | 完成插件开发、Hook 接入、后台配置 |
+| 09-09 | 插件中心看不到 / 安装验证失败 | 修复 install 流程、verify 脚本、菜单注册 |
+| 09-10 | 支付联调、配置参数 | 逐步修复 notify、pay_type、分账配置 |
+
+**交付物**：
+- 插件 `addons/shopro_huifu/`（支付、分账、后台配置、verify/install 命令）
+- SQL：`upgrade_huifu_pay_type.sql`、`upgrade_huifu_split.sql`
+- 后台：汇付配置、分账接收方、分账记录
+
+---
+
+## §2 首页布局改版（45ebfacd）
+
+**计划**：[首页布局方案_29cd28e2.plan.md](../首页布局方案_29cd28e2.plan.md)
+
+| 时间 | 用户诉求 | 处理结果 |
+|------|----------|----------|
+| 09-10 | 参考参考图出首页布局方案 + 预览图 | 生成 A~E 多套预览 |
+| 09-10 | 选 E 方案，优化红框区域和底部导航 | 生成 E-Final 预览 |
+| 09-10 | 按 E-Final 实现 | 改造 `pages/index/index.vue` 及组件 |
+| 09-10 | WXML 编译错误 | 修复 `sh-grid-swiper` style 语法 |
+| 09-10 | 图标配色优化、立体化 | 优化分类图标、配色统一 |
+
+**交付物**：
+- 小程序首页 E-Final 布局
+- 预览图：`xgsc.gynhc.com_wx/docs/homepage-previews/`
+- 组件：`sh-grid-swiper`、分类网格等
+
+---
+
+## §3 微信发货信息同步（553f50fe）
+
+**计划**：[微信发货信息同步_b8fd57f1.plan.md](../微信发货信息同步_b8fd57f1.plan.md)
+
+| 时间 | 用户诉求 | 处理结果 |
+|------|----------|----------|
+| 09-10 | 接入微信购物订单 / 发货信息同步 | 设计并实现 `shopro_wechat_trade` 插件 |
+| 09-10 | 经营类目超出开放范围 | 说明需在微信后台申请接入 |
+| 09-10 | install 后订单详情路径配置失败 | 需先签署订单中心授权协议 |
+| 09-10 | init-path 无效路径 10060035 | 排查 path 格式、小程序版本要求 |
+| 09-10 | 订单中心 path 怎么填 | 配置 `pages/order/detail` |
+| 09-10 | 支付成功验证 | 确认支付链路正常 |
+| 09-11 | 分析个人进件流程是否接好 | 分析结论：分账执行已接，个人进件未接 |
+
+**交付物**：
+- 插件 `addons/shopro_wechat_trade/`（发货同步、配置、verify 命令）
+- 后台：微信交易组件配置
+
+---
+
+## §4 阿里云快递查询（909afd5e）
+
+**计划**：[阿里云快递查询插件_b22bbd2a.plan.md](../阿里云快递查询插件_b22bbd2a.plan.md)
+
+| 时间 | 用户诉求 | 处理结果 |
+|------|----------|----------|
+| 09-10 | 对接阿里云全国快递查询 API | 设计并实现 `shopro_aliyun_express` 插件 |
+| 09-11 | install 命令不存在 | 修复命令注册、InstallFull |
+| 09-11 | AppCode vs AppKey 混淆 | 澄清阿里云市场鉴权方式 |
+| 09-11 | 选阿里云时隐藏 ExpressBird 配置 | 后台 UI 条件显示 |
+| 09-11 | 测试查询 404 / 格式错误 | 修复 API 端点、响应解析 |
+| 09-11 | 刷新轨迹非法参数 | 修复单号空格 trim、编码映射 |
+
+**交付物**：
+- 插件 `addons/shopro_aliyun_express/`
+- 后台：快递 provider 切换、AppCode 配置
+
+---
+
+## §5 汇付个人进件（1cafd55b）
+
+**计划**：[汇付个人进件对接_e1144173.plan.md](../汇付个人进件对接_e1144173.plan.md)
+
+| 时间 | 用户诉求 | 处理结果 |
+|------|----------|----------|
+| 09-11 | 分销/代理必须走汇付进件 | 细化实施计划并开始开发 |
+| 09-11 | install-full 命令未定义 | 补充 InstallFull 命令 |
+| 09-11 | Agent.php 207 引用传参错误 | 修复 Hook 参数传递 |
+| 09-11 | Config::isHuifuMode() 未定义 | 补全 SplitConfig 方法 |
+| 09-11 | 找不到小程序进件页面 | 定位 `pages/app/commission/apply` |
+| 09-11 | 进件页无法填资料、区域代理秒过 | 修复表单交互、审核流程 |
+| 09-11 | 审核中但内容空白 | 修复状态展示与数据回填 |
+| 09-11 | 「您暂时不能申请」 | 解释门槛条件（分销等级/状态） |
+
+**交付物**：
+- 进件表、API、Hook 对接
+- 小程序：`pages/app/commission/apply` 进件表单
+- 后台：进件审核管理
+- 命令：`shopro_huifu:install-full`、`shopro_huifu:onboard-poll`
+
+---
+
+## §6 敏感文案 + 提现进件 + 包体积（c58fb120）
+
+**计划**：[敏感文案替换_1357718d.plan.md](../敏感文案替换_1357718d.plan.md)
+
+| 时间 | 用户诉求 | 处理结果 |
+|------|----------|----------|
+| 09-11 | 代理→公司、佣金→差价 | 小程序 + 后台敏感文案批量替换 |
+| 09-11 | 补充提现页面 | 完善提现 UI 与逻辑 |
+| 09-11 | 进件资料绑定到提现页 | 分销商/区域角色才显示 |
+| 09-11 | 绑定页应为提现子页面 | 拆分为 `withdraw/bind` 子页 |
+| 09-11 | home 图片太大超包限制 | 压缩 static/images/home |
+| 09-11 | 删除未引用图片 | 清理无用资源 |
+
+**交付物**：
+- 文案替换（小程序 + 后台视图/JS）
+- 提现页 + 进件绑定子页
+- 首页图片压缩与清理
+
+---
+
+## 关联计划文档（plan 目录）
+
+完整列表见 [README.md](../README.md)，新增计划：
+
+- 汇付小程序支付对接
+- 汇付个人进件对接
+- 微信发货信息同步
+- 阿里云快递查询插件
+- 敏感文案替换
+- 首页布局方案

plan/chat-backup/对话摘要-区域代理实施.md

@@ -0,0 +1,86 @@
+# 对话摘要：区域代理功能实施
+
+- **项目**：chufang.gynhc.com（厨房/宥川商城）
+- **会话 ID**：`1fc9746b-419a-426b-98a2-35182ed827b5`
+- **备份时间**：2026-09-04
+- **原始记录**：[`1fc9746b-419a-426b-98a2-35182ed827b5.jsonl`](./1fc9746b-419a-426b-98a2-35182ed827b5.jsonl)
+
+> 说明：「飞天」系列为另一独立酒类项目，与本会话无关。
+
+---
+
+## 对话时间线
+
+| 时间 | 用户诉求 | 处理结果 |
+|------|----------|----------|
+| 12:08 | 核对区域代理与需求图出入，拆分细化 | 生成对照计划，确认分佣模式可配置、运营优先 |
+| 12:26 | 代理佣金需后台可配置 | 计划补充 P0：代理设置页 + 代理等级 CRUD |
+| 13:10 | 开始实施 | 完成 P0：佣金配置、等级管理、菜单、编辑/添加、小程序提现等 |
+| 13:31 | 继续 P2 | 完成看板、筛选导出、商品开关、审核通知、动态等级匹配 |
+| 13:40 | PDO 2031 报错 | 修复 `(clone $query)` 与 `FROM_UNIXTIME` `%` 占位符问题 |
+| 13:47 | 继续未完成 | 补全菜单 SQL、通知注册、Order/Reward 格式整理 |
+| 14:01 | 单个代理可设专属佣金，优先于等级通用 | 新增字段 + 表单 + `Commission.php` 优先逻辑 |
+| 14:06 | 「跟随等级」是什么意思 | 解释：未自定义时用等级通用配置 |
+| 14:09 | 开关文案易误导 | 改为单选：「使用等级通用配置 / 单独设置佣金」 |
+| 14:37 | 编写区域代理测试脚本 | 新增 setup/cleanup/verify 脚本 + 910001~910009 测试账号 |
+| 14:44 | 计划复制到 plan 目录 | 复制 21 份计划 + README + 实施进度汇总 |
+| 14:49 | 飞天是另一项目，不要搞混 | 删除 plan 中 3 份飞天相关计划 |
+| 15:33 | 对话备份到 plan | 本备份 |
+
+---
+
+## 已确认业务口径
+
+- **固定佣金**：按每单计，不按件 × 数量
+- **分佣模式**：后台可配（叠加 / 独占 / 级差）
+- **单个代理佣金**：有专属配置时优先，否则跟随代理等级
+- **比例基数**：订单商品实付金额 `pay_price`
+
+---
+
+## 主要交付物
+
+### 后台
+
+- 区域代理：设置、等级、代理列表、订单、佣金、业绩看板
+- 代理添加/编辑：用户搜索、省市区级联、佣金设置（等级通用 / 单独设置）
+- 菜单 SQL：`upgrade_regional_agent_menu.sql` 等
+
+### 引擎
+
+- `addons/shopro/library/regional_agent/Commission.php` — 三种分佣模式、按单固定、代理优先
+- `upgrade_regional_agent_commission.sql` — 单代理自定义佣金字段
+
+### 小程序
+
+- `xgsc.gynhc.com_wx/pages/app/regional-agent/` — stats、筛选、待结算、提现入口
+
+### 测试
+
+```bash
+php addons/shopro/tests/regional_agent_setup_test_users.php
+php addons/shopro/tests/regional_agent_verify.php list-agents
+php addons/shopro/tests/regional_agent_verify.php verify-order {订单ID}
+```
+
+**测试密码**：`Test@123456`  
+**主测买家**：19900000014（910004）
+
+---
+
+## 部署 Checklist
+
+1. 执行 `upgrade_distribution_features.sql`
+2. 执行 `upgrade_regional_agent_menu.sql`
+3. 执行 `upgrade_regional_agent_commission.sql`
+4. 后台分配区域代理权限
+5. 商品开启 `regional_enable`
+6. 运行测试脚本验证
+
+---
+
+## 相关文档
+
+- [实施进度汇总.md](../实施进度汇总.md)
+- [区域代理需求对照](../区域代理需求对照_060fc1ce.plan.md)
+- [README.md](../README.md)