保持逻辑和物理架构图的更新


12

在任何涉及具有多个开发人员的分布式系统的软件开发项目中,拥有逻辑和物理体系结构图是最佳实践,但是以我的经验,这些图总是在项目开始时就得到很好的维护,但是在项目发布时不会得到更新维护阶段就开始了。

对于具有很多分布式过程的复杂项目,由于没有人知道所有的知识,因此即使在最初发布之前,这些图也往往会很快变得过时或不准确。

在这种背景下,我想向社区提出以下问题:

  1. 拥有准确且最新的逻辑和物理架构图有多重要?
  2. 是否有任何工具和流程可以帮助他们保持最新状态?
  3. 谁应该负责使它们保持最新状态?系统管理员,开发人员和质量检查团队如何贡献力量?


文章建议这些应成为“可交付文档”的一部分,因此它具有重要意义。这些项目是否应作为积压的一部分创建并作为可交付成果的一部分?
ARau

Answers:


5

我生活在有时间限制和资源问题的现实世界中,所以我理解为什么大多数软件文档要么被忽略要么被淘汰,但是即使在那种情况下,我也绝对坚持要创建数据库图并保持最新。如果它不是通常的关系模型,并且由具有文档,键值对或JSON / XML结构的实体组成,则还应该创建和维护这些项目的对象模型。如果在项目的文档编制工作中所有其他方法都失败了,则至少可以使用数据库图和/或对象模型来追溯到前端,以了解发生了什么。

创建和维护软件文档有很多选项,但是我最喜欢的之一是Enterprise Architect。它是全面的,并结合在一起使用案例,序列图,类图等。

至于谁负责,我认为这是团队的努力。很少有人完全喜欢这样做,但是必须做到。项目的架构师或技术负责人最终应对此负责,并适当地委派任务。

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.