某省某市研发中心委外项目验收标准指导说明书（知识研究或个人学习）

项目代码验收报告文档验收架构设计验收总体架构验收架构图此处需要附上架构图要求架构设计能够很清晰地描述系统内部的模块划分，与外部系统的边界关系例如：模块清单列表模块名称模块说明XXXX模块主要作用说明系统架构设计评估说明验收标准：能够深入了解系统架构清晰各子系统边界，如系统台与外部系统又关联则清晰理解外部系统与本项目系统台边界，边界定义一般为各个系统的。对于不清楚的地方，则需要求合作伙伴进行架构补充描述业务流程设计评估评估文档中是否包含又系统的主要业务流程各模块的交互时序图时序图是否交代清晰。台系统与外部边界评估评估与外界时间接口文档是否齐全接口文档质量接口定义是否合理总体架构小节对架构的合理性，规范性，文档质量进行总结。例如：合理性项目架构设计合理/不合理，其中XXXXXXX设计不合理XXXXXXX设计不合理XXXXXXX设计不合理规范性XXXX设计未包含主要的逻辑图/时序图，无法全局性描述系统xxxxxx业务场景XXXX未包含xxxxxxxx，导致xxxxxxxx文档质量文档质量较好/较差XXXXXX文档未能描述清楚XXXXXXXX缺少XXXXXXXXX技术架构验收技术架构图此处需要附上整体技术架构图（要求伙伴必须提供）例如：技术架构设计评估此处需附技术架构图该技术架构图需包含本项目中用到的所有技术文档中一定要包含技术架构图，即用了那些技术进行了系统的开发和应用，每种语言不一样，此处未文字性描述，例如：该项目使用了JAVA常用的技术栈，其中XXXXX项目模块使用了.net技术，XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX系统详细设计验收标准：文档中一定要有各子系统/模块的详细说明，需说明该模块的主要作用，说明中还需包含有那些模块调用该模块的服务，该模块调用了那些模块模块边界设计验收该项需要按以模块清单列表中的模块，以模块的维度进行评估必须查看所有模块的接口定义（接口文档）是否满足需求检查接口文档规范，描述是否清晰接口文档需包含接口协议描述，使用场景描述，所有入参描述，所有出参描述，数据结构描述，接口调用的样例接口字段中如有枚举，必须将枚举一一列出说明，比如：订单状态1，已下单2，待支付3，已支付4，已完成接口逻辑设计验收系统详细设计说明书/系统业务流程图及说明再这两个文档中，对于某个业务流程的系统梳理需要有系统交互时序流程设计及时序交互详细说明，时序图主要是描述某业务流程下，系统之间的交互情况例子：接口说明文档标准：每个接口需要有接口执行逻辑说明，不限文字，流程图，或者时序图进行说明描述。在接口执行逻辑说明中，如访问了外部资源，则需要有访问策略说明：如：进行数据内存存储保存再redis中，存储策略为保存24小时数据库设计验收检查数据库设计的规范，文档中需包含表明，作用描述，字段类型，字段说明，字段长度，如有枚举，必须将枚举一一列出说明系统详细设计验收小结对系统详细设计的验收情况进行小结描述代码走查验收整体代码结构合作伙伴对其代码工程目录结构以文档形式进行详细说明按照系统架构结合技术架构，核实清楚模块的代码，工程数量输出代码模块清单列表代码模块模块说明代码路径开发语言代码检查按照常规的代码编写规范检查，对于合作伙伴不能提供的源码，需要核实项目合同中是否有相应的条款规定（可直接找周东进行核实），需明确不提供的源码是在合同中明确规定的。如合作伙伴不能提供源码，且又不在项目合同中明确规定的，则需反馈项目经理及合作伙伴必须提供源代码如合作伙伴不能提供源码，且又不在项目合同中明确规定的，如是不涉及到业务层面的（即与业务实现有依赖关系的），则需要合作伙伴提供对应的详细API使用文档（含第三方应用包）检查注释，检查原则：所有的主要代码分支判断或者算法都要进行注释，注释必须清晰数据脚本检查该项检查提交上来的数据脚本与数据库设计文档中是否一致。代码安全扫描标准所有的代码必须进行内部的代码安全扫描（与运维余文进行联系，使用fortify进行静态代码扫描），扫描结果中的中，高风险问题必须进行修复，对扫描出来的结果发给合作伙伴进行整改，如其整改超过3次提交的代码还未解决，反馈项目经理，暂停验收。部署发布验收该项验收标准为合作伙伴提交上来的开发手册/部署手册需要在无合作伙伴的指导支撑下，开发及运维能够独立进行项目所有应用的编译及部署，及初始化数据库。使得交付给测试进行功能测试验收的环境能够运行正常。开发手册/部署手册