fix: improve h5 payment return flow

docs/development/branch-workflow.md

@@ -4,6 +4,8 @@
 
 `releases/` 和 `releases_dev/` 下的 zip、apk、校验文件等发布产物只作为本地交付物管理，不纳入 Git 分支管理范围，也不要提交或推送到远程仓库。正式包放 `releases/`，测试包放 `releases_dev/`。
 
+本地开发环境和测试服共用测试数据库连接，测试库名为 `test_anxinyan`。真实的数据库 host、用户名和密码只允许放在被忽略的 `server-api/.env` 或服务器环境变量中，不写入 README、规范文档、Skill、`.env.example` 或其他可提交模板。
+
 ## 长期分支
 
 | 分支 | 用途 | 维护规则 |
@@ -44,13 +46,41 @@ git switch -c feature/admin-report-export
 ```bash
 git status -sb
 git diff --check
-npx gitnexus detect-changes --scope all
+npx gitnexus detect-changes --scope all --repo anxinyan
 ```
 
 如果修改了 PHP 后端文件，补充运行相关 PHP 语法检查或项目脚本；如果修改了前端，按影响端运行对应的类型检查或构建。正式包发版前按上线检查清单执行 `server-api/tools/release_audit.php`、`server-api/tools/smoke_check.php` 和相关客户端构建；测试包构建前确认各端测试环境配置指向 `https://test.api.anxinjianyan.com`。
 
 正式包生成后保留在本地 `releases/` 目录，测试包生成后保留在本地 `releases_dev/` 目录，并按需另行交付；Git 提交中不包含这些产物。
 
+涉及本地或测试服数据库配置时，提交前确认 `server-api/.env` 仍被 Git 忽略，并检查 README、docs、`.claude` 和 `.env.example` 等可提交文件中没有真实数据库密码：
+
+```bash
+git check-ignore -v server-api/.env
+```
+
+## GitNexus 索引协同
+
+Git 分支负责协作路径，GitNexus 负责改动影响面。推荐节奏：
+
+1. 开发前在 `develop` 上创建 `feature/<scope>-<name>`。
+2. 不熟悉代码时先用 GitNexus query/context 找入口和流程。
+3. 修改函数、类或方法前先做 upstream impact analysis。
+4. 提交前运行 `npx gitnexus detect-changes --scope all --repo anxinyan`。
+5. 提交、合并、切换分支或 rebase 后，由本地 hook 异步刷新 GitNexus 索引。
+
+团队成员首次 clone 后执行一次：
+
+```bash
+git config core.hooksPath scripts/git-hooks
+```
+
+自动刷新只执行 `npx gitnexus analyze --index-only --name anxinyan .`，不会更新 `AGENTS.md`、`CLAUDE.md` 或 GitNexus skills。它不替代提交前的 detect-changes 检查。需要临时关闭时，在 Git 命令前加 `GITNEXUS_AUTO_REFRESH=0`；需要手动刷新时运行：
+
+```bash
+./scripts/gitnexus-refresh.sh
+```
+
 ## 发版流程
 
 1. 从最新 `develop` 创建 `release/<version-or-date>`。