CaiWuXiTong/docs/team-collaboration.md
15061959991 1adf627c0d feat: 财务系统二次开发 - 营销账户账单功能
- 基础环境:Docker 部署配置,源码挂载实时同步
- 修复:super_admin 权限补全、登录重定向循环
- 开发:店铺营销账户账单 - 抖音账户(15字段汇总账单)
- 开发:店铺营销账户账单 - 淘系支付宝账户(8字段流水账单)
- 开发:店铺营销账户账单 - 拼多多账户(7字段流水账单)
- 业务页面导航集成:config/business_navigation.php + Business\Pages 控制器
- 各平台独立表结构和视图,互不影响
2026-07-21 18:43:52 +08:00

1.9 KiB
Raw Blame History

新人团队协作 SOP

这份说明适用于 DoDo、sumu、shanshi、wangshu、chenxi、renshen 等使用 Codex 或其他 AI 编程工具参与本项目的成员。

开始一项任务

每次都从最新主线创建新任务分支:

git switch main
git pull origin main
git switch -c feature/用户名-任务名

示例:

git switch -c feature/dodo-login

不要直接在 main 修改,也不要在上一个已完成任务的分支继续做新功能。

开发时

  1. 先把任务和边界告诉 Codex,要求先分析后修改。
  2. 每次修改后检查变更:
git status
git diff
  1. 做完最小测试:目标页面/接口能否使用,错误输入是否有合理提示。
  2. 不要提交 .env、密码、Token、真实财务数据、日志或构建产物。

提交与推送

git add <本次任务相关文件>
git commit -m "feat: 简短说明本次功能"
git push -u origin feature/用户名-任务名

提交信息只描述本次任务,例如:

feat: 增加店铺列表筛选
fix: 修正订单金额汇总

不要使用 update、test、修改一下 这类无法理解的提交说明。

发起 PR

在 Gitea 中发起从任务分支到 main 的 PR,并填写:

做了什么:
Codex 改了哪些文件:
我怎么测试的:
是否涉及金额、权限、数据库或配置:

另一位成员检查后批准。负责人使用 Squash merge 合并;合并后该任务分支会删除。

PR 显示“落后 main”或发生冲突

不要使用强推,也不要自己猜 rebase 命令。把下面这段交给 Codex:

我在 <当前任务分支>,PR 显示已落后 main/发生冲突。
请先只分析如何安全同步,禁止 force push 和 rebase。
请给出最小操作步骤,并说明每一步的作用和可能风险。

若仍不确定,停止操作并联系负责人。