92 lines
2.8 KiB
Markdown
92 lines
2.8 KiB
Markdown
|
# 智能挂车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流程
|
|||
|
|
- 重要功能必须有对应的文档更新
|