软件公司源代码管理制度

1、源代码管理制度(讨论稿)一、总则为了加强公司产品、项目开发源代码及相关技术文档的管理，进 而确保项目实施的效率和质量，特制定本办法。二、适用范围产品、项目开发技术人员及项目实施负责人。三、定义项是指通过公司立项确定需要按期实施的项目。项目实施：是指为完成立项项目进行的阶段性或特定领域的实施过程，主要包括研发实施和部署实施。源代码：是指产品、项目研发过程中所产生的程序源代码。技术文档：是指产品、项目配套的各类设计文档、操作手册等技术性 文档。版本管理服务器：指公司架设供所有开发人员使用的Subversion(SVN) 服务器。源代码提交：指开发人员通过客户端程序将所编写源代码上传至版本 管理服务

2、器的操作过程。四、源代码日常管理流程源代码管理是技术研发过程的日常管理.，上要包括源代码提交、 源代码审阅、异常协调等儿个环节。准备五、源代码结构设定源代码结构是指源代码在版本管理服务器上存放的文件夹结构。源代吗结构的设定由项目实施负责人决定。源代码结构设定有几项基本要求：必须设置文档文件夹：每一个独立项目或子项目源代码文件内， 至少设定一个docs或doc文件夹以存放仅与该项目相关技术文档 和参考资料；必须考虑支持库：源代码结构中，应考虑具体项目所引用的非标 第三方支持库或框架的存放位置；必须可以直接编译：源代码结构必须是可宜接编译结构。即任何 一台新装计算机，在安装了必要的开发环境软件以后

3、，通过从版 本管理服务器上签出整套源代码后，应该可以直接完成编译。六、500提交500提交是指项R实施期间,所有参与开发的技术人员,每日5:00 必须将当日所编制的源码或技术文档提交至版本管理服务器。源代码及技术文档提交有如下几项要求：任何一次提交都必须对所提交内容进行注释；提交注释必须包含的信息项包括：所属模块或功能（必须与项目 实施进度计划一致）、性质（正常开发、修改BUG、扩展功能）、 状态（编码中（x%）、调试通过、独测通过、联测通过）、更新说 明（本次提交所涉及修改部分的简要说明）。提交注释必须以下图示例格式为准。Message:（ Recent messagesI质显一拄忒功应废如

4、法充题隹想.正知线然杰微硬勺（80+）更至说理。己经买羽毯咬条仔趣苦亘以懑过五谷专魂运三金品.龙三? 黑！I的舞E暴兼基融二爱溟整J所提交源码必须是编译无错版本。七、530审阅530审阅是指项目实施负责人，每II下班前审阅版本服务器上所有下属技术人员所提交的源代码和技术文档。源代码审阅布以下儿点审阅标准：下属技术人员必须全员按时提交；所7T提交必须附rr符合要求的提交注释；各人所提交的内容必须与既定的项H实施进度计划安排一致；审阅过程中，凡不符合上述任一条标准的，则表示当日源码提交 出现异常。项目实施负责人应立即进行协调，未按时提交者督促其即 刻提交；没有附提交注释或注释不符介要求者，补充提交

5、注释；提交 内容与既定项目实施进度计划安排不一致者，要进行沟通和协调，保 证参与实施人员的每H工作均按既定计划分步实施。八、进度计划更新项口实施负责人，通过53()审阅和必要的简短沟通，确认各在执 行子任务的真实进度，并以此为准更新进度计划文档。九、版本库布局版本库按项FI布局，每一个项目建立一个独立的版本库，项目版 本库下设置trunk和branches两个文件夹，分别用于存放原始项目 资料和起源于原始项目的分支项Ho每个项目分支都应该有含义明确的命名，并以分支名称在 branches文件夹下建立子文件夹。分支文件夹的结构与trunk文件 夹结构一致。trunk文件夹下设置working和l

6、ocked两个文件夹，其中 working为工作文件夹，参与项目的开发人员有改写权限。locked文 件夹为定版文件夹，项目开发人员无权访问，项目实施负责人有改写 权限，品监部有签出权限。working文件夹下设置docs和projects两个文件夹，其中docs 文件夹存放项目相关设计文档，projects文件夹存放各子项目工程 文件夹。docs和projects文件夹以下子文件夹结构不做限定，但对于C/S 类项目建议在projects文件夹下设置server和client两个文件夹, 分别存放服务端子项目资料和客户端子项n资料。十、项目定版项目定版是指项目研发实施到某个进度计划中设定的里程

7、碑状 态或其他特定状态时，整体提交的一个阶段性版本。一些既定的定版 包括：系统联机调试定版、内测定版、演示定版、实测定版、发布定 版、升级定版。对于项目定版有如下要求：项目所有子项目、子模块源码均编译无错;编译所成系统可联机运行；所有技术文档与实现源码一致；项目定版由项目实施负责人组织实施，实施过程在源代码库上面 体现为：working文件夹下最新版本的源码和文档被一次性完整的提 交到locked文件夹。项目定版操作建议：将locked文件夹检出(Checkout)一个副本到本地文件夹； 将 workingdocs 和 workingprojects 两个文件夹导出(Export)到locke

8、d副本文件夹，覆盖locked文件夹下的原文件； > 提交(Commit) locked 文件夹;项目定版提交必须附提交注释，注释内容必须包含的项目包括： 定版目的（联机调试、内测、演示、实测、发布、升级）、版本特性。 其中版本特性要进行详细说明。如果是笫一个定版，版本特性应详细 列举已经实现的功能，后续定版提交注释的版本特性说明则只需写明 新版本较上一-个版本的新特性。十一、项目既定定版说明既定定版是指在项目研发实施过程中的必须设定的儿个阶段性 版本。联机调试定版：是指项口整体设计中的所有子系统和子模块都已 经完成基础开发，在研发实施团队内部进行完整系统联机调试通 过以后的版本。联机调

9、试版本中的各个子系统和子模块不需要完 整实现了所有既定功能，也不需要达到既定设计性能，可以存在 BUG,其主要作用是为研发实施团队自身构建一个可供各功能模块 进行联机调试的系统环境，并确认系统整体设计的可实施性。联 机调试定版后，研发实施团队应撰写系统部署手册草案；内测定版：是指移交品监部进行系统测试的版本。内测版本应该 是通过若干次联机调试，并且已经解决了所有联机调试过程中所 发现问题以后的版本。内测定版不一定实现了所有的功能，但已 经实现的功能应该具备基本的稳定性；演示定版：是指通过若干次内测之后，不存在特别严重缺陷，可供商务人员向客户进行产品功能和性能演示的版本。演示定版不一定实现了所有的功能，也不一定达到系统既定设计性能。实测定版：是指通过若干次内测之后，不存在影响正常使用的缺 陷，可供在客户真实环境试用的版本。实测定版应该实现了所有 核心功能，允许少量存在不确定因素的功能缺失；发布定版：是指通过若干次内测和实测之后，已经实现了所有既 定