征求意见编写功能要求

Question

我继承了一个我已经维持了大约一年的项目。该项目主要围绕着为最终用户执行各种财务计算。它大约有10万行意大利面代码，再加上胶带和拼图。我一直在缓慢地进行代码重构，因为我必须对代码进行更改，并在有帮助的地方添加内联注释，但是没有正式的文档。

我一直在我们公司的新平台上重写软件(我知道，一个人所能做出的最糟糕的决定就是彻底重写，但在这种情况下，这是必要的，因为所涉及的整个架构和框架正在发生变化)。作为第一步，我需要提出一组功能需求。然而，我有点不知所措，不知从哪里开始，如何去做。它的范围太大了，我甚至不知道从哪里开始。

其他人也有过类似的经历吗？新项目的文档是从哪里开始的？有什么我可以咨询的资源吗？今天，我可以在没有问题的情况下编写它的技术规范，但我以前从未编写过功能需求。

我知道编写功能需求通常不是开发人员的职责之一--业务部门的人员应该这样做。然而，我显然被认为是最适合这份工作的人，就像我们的商业部门的大多数人一样，它的工作方式就是“神奇的”。

Answer 1

你的应用程序有多老了？

差不多两年前，我在一个5年前的应用程序中继承了类似的情况，我们保持冷静并继续进行，小规模的持续改进。

如果可以的话，我将从客户端和最终用户开始。我将以与新项目相同的方式收集需求。用户/客户端的需求可能发生了变化，或者他们有了新的想法。该应用程序很可能失败的功能，我不需要重新实现。我会用它作为一个“模型”的例子。

通过这种方式，我的优势是向已经知道问题的人展示产品。理解代码，我可以问正确的问题，关于行为。

技术也得到了改进，它可能为你的应用程序的意义提供另一种可能的观点。

如果我有幸有机会从头开始的话，我就会这么做。

Answer 2

我从1999年开始编程，从2009年开始作为自己的业务提供软件外包服务。在此期间，我为不同国家的100多个客户参加了300多个软件工程项目。

好消息是，我所见过的唯一一家拥有良好规格的公司是NASA。其他的通常有一个规范，总比没有好。

首先，在软件开发生命周期中涉及几种类型的文档：

• 业务计划--本文档解释了软件将带来(或节省)多少，需要创建多少资源，拥有多少成本。
• 功能需求--这是一个更特殊的文档，详细描述了软件应该能够解决哪些问题。这份文件通常是由一个非常熟悉业务的人创建的，在你的情况下，应该是一个熟悉财务计算的人。
• 技术规范-由CTO或架构师或资深IT人员等创建的文档。它描述了解决问题的方法，并回答了“我们将如何制造它”的问题。

注意:这不是完整的列表，它更接近最小要求集。

所以，我想你是在尝试在没有前两个的情况下制作最后一个文档。我建议您首先获得至少一个功能需求，并且基于这个文档，您将能够为基于新平台的解决方案制定一个技术规范。

Answer 3

实用软件需求已经过时了，但是如果你能找到它，你可能会发现它很有用。它并不是从您的问题的角度编写的，但是它确实提出了一些方法，这些方法会导致具有非常高的信噪比的功能需求，并且从下到下开始到一定程度。

此外，伏雷还提供各种资源--模板、文档和咨询--以帮助记录和理解需求。我发现他们的模板非常有用，尽管在模板的选择上需要一些区别。

所有通常的免责声明都适用:我没有参与上述任何一个来源，但发现它们有用。