草庐IT

日常开发方案设计指北

编码砖家 2023-03-28 原文

互联网公司管理研发流程,常常使用TAPD一类的敏捷工具。一个需求从提出到上线要经历至少七个流程:

  • 1)需求评审:产品经理给出需求文档,邀请技术参与需求评审,目的是扫清需求疑点,排除无法实现的需求。
  • 2)技术评审:技术人员内部评审需求,确定详细的技术方案。
  • 3)开发排期:技术人员根据技术方案拆解任务,输出开发排期文档,并告知产品和测试,以便他们协调测试时间。
  • 4)开发阶段:技术人员用代码实现需求,如果有需求疑点,继续找产品核实。在开发尾声,技术团队内部审查代码。
  • 5)测试用例评审:测试人员根据需求文档拆分测试用例,并给出测试工作排期,确定需求最终上线日期。
  • 6)测试阶段:测试人员根据测试用例分别在测试、预发布、灰度、生产环境测试。
  • 7)产品验收:测试人员确认测试通过,邀请产品人员验收。

初级工程师往往做不好需求评审工作。要么被产品经理牵着鼻子走,让干什么就干什么;要么预估不到隐藏的工作量,在开发排期阶段给出不合理的排期,导致开发时间紧张,最后加班应付测试。

以下探讨的需求评审和技术方案设计等内容,都用电商的需求《优惠券管理平台》来举例说明。

需求标题:优惠券管理平台
需求背景:当前用户下单结算不支持任何优惠折扣活动,营销人员无法采用多样化的手段留存和获客。
需求内容:规划优惠券管理平台,运营人员申请营销预算,批量生成优惠券,赠送优惠券给不同画像的用户。购物车支持用户下单时使用优惠券。后台管理增加两大模块:1.营销预算管理;2.优惠券管理(配置优惠券模版、生成优惠券、赠送优惠券)。
详细设计:篇幅过长,略。

2.如何评审需求

2.1 三连追问

我们常常说研发人员也要有产品思维,并不是产品思维多么宝贵,而是没有产品思维,就不知道怎么拒绝产品经理的需求。面对任意一个需求,都要发起对产品经理的三连追问:

  • 需求的价值是什么?
  • 需求的后续规划是什么?
  • 这个需求是必须的吗?

十个产品九个抄,很多产品经理的需求缺乏后续规划。他们没有完成产品的闭环思考,先抄袭别人的创意试试水。产品需求文档里面可能会出现前后逻辑矛盾,研发人员要抓住这些矛盾,给予重重的嘲讽,帮助他们改善工作。

2.2 需求拆分

如果一个需求的目的,无法用简短的话说清楚,就是不内聚的,要拆分需求后再分析。研发人员可以将需求拆分为3类:

  • 必须实现:需求中价值最高的部分,上线后明显提升体验、提升获客能力或者增加客单量。
  • 延迟实现:需求中价值低的部分,比如界面微调、表单校验等。在开发时间不充裕的情况下,尽可能延迟到下一版本中。
  • 可以驳回:与本次需求没有关联、修复上个版本的BUG等等,考虑驳回。需求中参杂了没关联的功能,常常会增加沟通成本、代码审查的复杂度。

产品需要技术实现产品,研发需要产品展示价值,两者的利益是一致的。研发人员在质疑需求合理性时,措辞上要处在“为了产品更好”的基调上。如果需求被驳回,部分产品经理会抬出上一级领导压人,比如“这是李总要做的,你能怎么着”。如果需求确实荒谬,要上升到管理层去决定,否则产品经理会玩成惯性。

3.如何设计技术方案

拿到一个需求,尤其是周期长、功能多的需求,要考虑多个方面来设计技术方案,做到低成本、高性能、可维护。

3.1 适应变化

没有一劳永逸的方案,适应一定阶段的变化即可。要与产品经理沟通,基本确定未来几个月的变与不变。在《优惠券管理平台》里面,优惠券的产生、使用、核销三个状态的流转是确定的,而使用规则可能会变化,一开始可能随便用,后来演变成按商品分类、品牌划分。针对变的部分要考虑可扩展性,比如数据库字段类型采用JSON,或者设计规则扩展表。

3.2 避免耦合

以业务领域为界限,规划每个微服务工程的职责。在《优惠券管理平台》里面,优惠券是新业务,至少需要一个新微服务。营销预算与优惠券不是强关联的,未来可能赠送礼品卡或者实物纪念品,营销预算的代码不能写在优惠券的微服务里面。

3.3 估算资源消耗

根据接口访问次数或者前端埋点统计,预估业务产生的数据量,估值越具体越好。例如: 双十一活动中,预估发放优惠券100万个,购物车结算页面查询优惠券接口达到1000QPS。根据这些结论,才能更好的规划数据库表的分片设计、查询接口的性能设计。

3.4 安全问题
  • 1)数据安全

避免泄漏用户数据,将敏感信息如手机号、银行卡明文显示在页面中;暴露的链接是否包含敏感参数,比如营销短信内容的推广链接包含用户ID。

  • 2)接口安全

给前端使用的接口是否防刷;访问外部接口要设置访问超时时间。

3.5 输出文档

编写技术方案文档有两个作用,一是用于技术评审,二是方便接盘侠参考。文档至少包括6个要点:

  • 1)详细需求:把产品经理的需求文档搬过来。
  • 2)系统流程图:通常是业务流程图、系统泳道图、微服务调用图。
  • 3)数据表设计:涉及到新表的设计、旧表的改动。
  • 4)改造点清单:所有要改动的旧模块的Class等等。
  • 5)灰度计划:如果需求只针对符合规则的部分用户展现新的产品流程,必须注明灰度计划。
  • 6)业务配置项:通过动态配置项管理的业务规则。

有关日常开发方案设计指北的更多相关文章

  1. ruby-on-rails - Rails - 子类化模型的设计模式是什么? - 2

    我有一个模型:classItem项目有一个属性“商店”基于存储的值,我希望Item对象对特定方法具有不同的行为。Rails中是否有针对此的通用设计模式?如果方法中没有大的if-else语句,这是如何干净利落地完成的? 最佳答案 通常通过Single-TableInheritance. 关于ruby-on-rails-Rails-子类化模型的设计模式是什么?,我们在StackOverflow上找到一个类似的问题: https://stackoverflow.co

  2. ruby - 使用 C 扩展开发 ruby​​gem 时,如何使用 Rspec 在本地进行测试? - 2

    我正在编写一个包含C扩展的gem。通常当我写一个gem时,我会遵循TDD的过程,我会写一个失败的规范,然后处理代码直到它通过,等等......在“ext/mygem/mygem.c”中我的C扩展和在gemspec的“扩展”中配置的有效extconf.rb,如何运行我的规范并仍然加载我的C扩展?当我更改C代码时,我需要采取哪些步骤来重新编译代码?这可能是个愚蠢的问题,但是从我的gem的开发源代码树中输入“bundleinstall”不会构建任何native扩展。当我手动运行rubyext/mygem/extconf.rb时,我确实得到了一个Makefile(在整个项目的根目录中),然后当

  3. ruby - 在 jRuby 中使用 'fork' 生成进程的替代方案? - 2

    在MRIRuby中我可以这样做:deftransferinternal_server=self.init_serverpid=forkdointernal_server.runend#Maketheserverprocessrunindependently.Process.detach(pid)internal_client=self.init_client#Dootherstuffwithconnectingtointernal_server...internal_client.post('somedata')ensure#KillserverProcess.kill('KILL',

  4. ruby-on-rails - 使用 rails 4 设计而不更新用户 - 2

    我将应用程序升级到Rails4,一切正常。我可以登录并转到我的编辑页面。也更新了观点。使用标准View时,用户会更新。但是当我添加例如字段:name时,它​​不会在表单中更新。使用devise3.1.1和gem'protected_attributes'我需要在设备或数据库上运行某种更新命令吗?我也搜索过这个地方,找到了许多不同的解决方案,但没有一个会更新我的用户字段。我没有添加任何自定义字段。 最佳答案 如果您想允许额外的参数,您可以在ApplicationController中使用beforefilter,因为Rails4将参数

  5. Ruby Sinatra 配置用于生产和开发 - 2

    我已经在Sinatra上创建了应用程序,它代表了一个简单的API。我想在生产和开发上进行部署。我想在部署时选择,是开发还是生产,一些方法的逻辑应该改变,这取决于部署类型。是否有任何想法,如何完成以及解决此问题的一些示例。例子:我有代码get'/api/test'doreturn"Itisdev"end但是在部署到生产环境之后我想在运行/api/test之后看到ItisPROD如何实现? 最佳答案 根据SinatraDocumentation:EnvironmentscanbesetthroughtheRACK_ENVenvironm

  6. ruby - 是否可以覆盖 gemfile 进行本地开发? - 2

    我们的git存储库中目前有一个Gemfile。但是,有一个gem我只在我的环境中本地使用(我的团队不使用它)。为了使用它,我必须将它添加到我们的Gemfile中,但每次我checkout到我们的master/dev主分支时,由于与跟踪的gemfile冲突,我必须删除它。我想要的是类似Gemfile.local的东西,它将继承从Gemfile导入的gems,但也允许在那里导入新的gems以供使用只有我的机器。此文件将在.gitignore中被忽略。这可能吗? 最佳答案 设置BUNDLE_GEMFILE环境变量:BUNDLE_GEMFI

  7. ruby - 在 Windows 机器上使用 Ruby 进行开发是否会适得其反? - 2

    这似乎非常适得其反,因为太多的gem会在window上破裂。我一直在处理很多mysql和ruby​​-mysqlgem问题(gem本身发生段错误,一个名为UnixSocket的类显然在Windows机器上不能正常工作,等等)。我只是在浪费时间吗?我应该转向不同的脚本语言吗? 最佳答案 我在Windows上使用Ruby的经验很少,但是当我开始使用Ruby时,我是在Windows上,我的总体印象是它不是Windows原生系统。因此,在主要使用Windows多年之后,开始使用Ruby促使我切换回原来的系统Unix,这次是Linux。Rub

  8. ruby-on-rails - 在 Rails 开发环境中为 .ogv 文件设置 Mime 类型 - 2

    我正在玩HTML5视频并且在ERB中有以下片段:mp4视频从在我的开发环境中运行的服务器很好地流式传输到chrome。然而firefox显示带有海报图像的视频播放器,但带有一个大X。问题似乎是mongrel不确定ogv扩展的mime类型,并且只返回text/plain,如curl所示:$curl-Ihttp://0.0.0.0:3000/pr6.ogvHTTP/1.1200OKConnection:closeDate:Mon,19Apr201012:33:50GMTLast-Modified:Sun,18Apr201012:46:07GMTContent-Type:text/plain

  9. 世界前沿3D开发引擎HOOPS全面讲解——集3D数据读取、3D图形渲染、3D数据发布于一体的全新3D应用开发工具 - 2

    无论您是想搭建桌面端、WEB端或者移动端APP应用,HOOPSPlatform组件都可以为您提供弹性的3D集成架构,同时,由工业领域3D技术专家组成的HOOPS技术团队也能为您提供技术支持服务。如果您的客户期望有一种在多个平台(桌面/WEB/APP,而且某些客户端是“瘦”客户端)快速、方便地将数据接入到3D应用系统的解决方案,并且当访问数据时,在各个平台上的性能和用户体验保持一致,HOOPSPlatform将帮助您完成。利用HOOPSPlatform,您可以开发在任何环境下的3D基础应用架构。HOOPSPlatform可以帮您打造3D创新型产品,HOOPSSDK包含的技术有:快速且准确的CAD

  10. 【鸿蒙应用开发系列】- 获取系统设备信息以及版本API兼容调用方式 - 2

    在应用开发中,有时候我们需要获取系统的设备信息,用于数据上报和行为分析。那在鸿蒙系统中,我们应该怎么去获取设备的系统信息呢,比如说获取手机的系统版本号、手机的制造商、手机型号等数据。1、获取方式这里分为两种情况,一种是设备信息的获取,一种是系统信息的获取。1.1、获取设备信息获取设备信息,鸿蒙的SDK包为我们提供了DeviceInfo类,通过该类的一些静态方法,可以获取设备信息,DeviceInfo类的包路径为:ohos.system.DeviceInfo.具体的方法如下:ModifierandTypeMethodDescriptionstatic StringgetAbiList​()Obt

随机推荐