root
1f6d346f6a
- Add companies table enhancements (abbr, tenant_key, feishu_enabled) - Add users table enhancements (feishu fields, sn, report_to, etc.) - Create company_feishu_apps table for multi-app per company - Create user_sn_pool table for user number management - Update FeishuService to support multiple Feishu apps per company - Add data migration script (002_merge_old_data.sql) - Add import script (scripts/import_old_data.php) - Update User and Company models with new scopes and relationships - Add CompanyFeishuApp model - Add Git workflow documentation (GIT_WORKFLOW.md) This supports: - Multi-company architecture with Feishu integration - Multiple Feishu apps per company (X-Server, Ticket, CRM) - User number assignment system - Data migration from old project Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3.6 KiB
3.6 KiB
Git 工作流
分支策略
采用 Git Flow 简化版工作流：
主要分支
| 分支 | 用途 | 说明 |
|---|---|---|
master |
生产环境 | 保持稳定，只接受从 develop 合并的代码 |
develop |
开发环境 | 主开发分支，包含最新的开发功能 |
feature/* |
功能分支 | 从 develop 分支，开发完成后合并回 develop |
hotfix/* |
热修复分支 | 从 master 分支，修复后合并到 master 和 develop |
分支命名规范
功能分支
feature/功能名称
例如：feature/i18n-support
热修复分支
hotfix/问题描述
例如：hotfix/login-error
工作流程
1. 开发新功能
# 从 develop 创建功能分支
git checkout develop
git pull origin develop
git checkout -b feature/your-feature-name
# 开发并提交
git add .
git commit -m "feat: add your feature"
# 推送到远程
git push -u origin feature/your-feature-name
# 完成后合并到 develop
git checkout develop
git merge feature/your-feature-name
git push origin develop
# 删除功能分支（可选）
git branch -d feature/your-feature-name
2. 修复紧急问题
# 从 master 创建热修复分支
git checkout master
git pull origin master
git checkout -b hotfix/your-fix-name
# 修复并提交
git add .
git commit -m "fix: describe the fix"
# 推送到远程
git push -u origin hotfix/your-fix-name
# 合并到 master 和 develop
git checkout master
git merge hotfix/your-fix-name
git push origin master
git checkout develop
git merge hotfix/your-fix-name
git push origin develop
3. 发布到生产
# 将 develop 合并到 master
git checkout master
git merge develop
git push origin master
# 打标签
git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0
提交信息规范
使用 Conventional Commits 规范：
| 类型 | 说明 | 示例 |
|---|---|---|
feat |
新功能 | feat: add user login |
fix |
修复bug | fix: correct i18n loading |
docs |
文档变更 | docs: update README |
style |
代码格式 | style: format code |
refactor |
重构 | refactor: simplify API |
test |
测试 | test: add unit tests |
chore |
构建/工具 | chore: update dependencies |
格式：
<type>(<scope>): <subject>
<body>
<footer>
当前分支状态
| 分支 | 状态 | 说明 |
|---|---|---|
master |
✅ 稳定 | 生产代码（含5语言支持） |
develop |
✅ 活跃 | 主开发分支（含5语言支持） |
常用命令
# 查看所有分支
git branch -a
# 查看当前分支
git branch --show-current
# 切换分支
git checkout <branch-name>
# 创建并切换到新分支
git checkout -b <new-branch>
# 删除本地分支
git branch -d <branch-name>
# 删除远程分支
git push origin --delete <branch-name>
# 查看分支差异
git diff develop
# 查看分支树
git log --graph --oneline --all
发布流程
- 开发阶段：在
develop分支进行开发 - 测试阶段：创建
release分支进行测试 - 发布阶段：合并到
master并打标签 - 维护阶段：使用
hotfix分支修复紧急问题
注意事项
- 永远不要直接在 master 分支开发
- 功能分支必须从 develop 分支创建
- 提交前先拉取最新代码
- 保持提交信息清晰规范
- 及时删除已合并的功能分支
远程仓库
- 仓库地址：http://219.157.255.213:25311/xinyouhe/x-server-mobile.git
- 默认分支：develop（建议设置）
- Pull Request：http://219.157.255.213:25311/xinyouhe/x-server-mobile/compare/master...develop