2.8 KiB
2.8 KiB
智能挂车AI-Box项目配置管理规范
1. 总体配置策略
双轨存储原则
- 飞书云文档: 主要设计文件、需求文档、项目管理资料
- Gitea (47.253.94.217:3000/zxu/its-gen1):
- 源代码主要存储位置
- 设计文件备份位置
- 所有技术资产的版本控制
访问信息
- Gitea地址: http://47.253.94.217:3000
- 仓库名称: zxu/its-gen1
- 账号: zxu / zxu123456
2. 仓库目录结构
its-gen1/
├── docs/ # 文档目录
│ ├── specs/ # 需求规格文档(已存在)
│ ├── architecture/ # 系统架构文档(已存在)
│ ├── design/ # 详细设计文档
│ └── project/ # 项目管理文档
│ └── CONFIGURATION_MANAGEMENT.md
├── design/ # 设计文档备份(已存在)
├── src/ # 源代码目录(待创建)
│ ├── drivers/ # 驱动层代码
│ ├── framework/ # 框架层代码
│ ├── applications/ # 应用层代码
│ └── utils/ # 工具类代码
├── scripts/ # 构建和部署脚本(待创建)
├── configs/ # 配置文件(待创建)
└── README.md # 项目说明(已存在)
3. 提交规范
文件命名规范
- 文档:
功能名_版本号.md或使用现有命名规范 - 代码: 遵循各语言的命名规范
- 配置:
环境_功能.conf
提交信息格式
[类型] 简要描述
详细说明(可选)
关联任务ID(可选)
类型包括: feat(新功能), fix(修复), docs(文档), style(格式), refactor(重构), test(测试), chore(构建)
4. 分支管理策略
主要分支
- main: 生产发布分支,受保护
- develop: 开发集成分支
- feature/: 功能开发分支
- hotfix/: 紧急修复分支
5. 角色职责
产品经理 (emb-system/猪小杰)
- 需求文档在飞书归档后,同步备份到Gitea
/docs/specs/ - 需求变更需同时更新两个位置
软件架构师 (emb-arch/孙大圣)
- 架构设计方案在飞书发布后,备份到Gitea
/docs/architecture/ - 提供详细的接口定义和模块说明
项目经理 (emb-pm/唐小僧)
- 维护配置管理规范
- 监督配置纪律执行
- 协调配置相关问题解决
开发团队
- 代码提交到对应src子目录
- 遵循分支管理和提交规范
- 及时更新相关设计文档
6. 同步机制
设计文档同步
- 飞书文档更新后24小时内同步到Gitea对应目录
- 以飞书为主版本,Gitea为备份版本
代码提交
- 所有代码必须通过Pull Request流程
- 重要功能必须有对应的文档更新