最近的踩坑分享 | 技术文档和需求拆解

简介: 最近的踩坑分享 | 技术文档和需求拆解

技术文档


阅读理解


下图来自某平台的技术对接文档,请重点看一下红线的含义。


刷新token的场景说明:


微信图片_20221112225544.jpg


请大家理解一下,红线处的场景到底想表达什么?

文档中说的在 access_token 过期 1h 之内 是指token过期前1h之内?还是token过期后1h之内?

我们团队同学开始的理解是:token过期后1h之内。

(从正常人的阅读感受来说确实是这样的)


实际情况


但是我在接手这部分逻辑的时候感觉不对。

因为我当时并没有读这个对接文档,而是站在正常刷新token的角度去考虑:

如果让我来设计服务端无感刷新token,我的设计思路是:在token过期前1小时支持通过refresh_token来刷新token。

尤其是当我看到这段之前的代码逻辑时,感觉非常不科学。

(为了方便理解,用伪代码给大家演示)


if 过期时间 > 当前时间 - 1小时 {
   返回cache中的token
}else{
    刷新token的方法
}


比如:过期时间是4点,当前时间是4点半,正常来讲token过期了的;但是按照上面的逻辑:当前时间 - 1小时。4点半就变成了3点半,满足返回cache中token的条件。

显然这种处理方式是不对的,违反常识。


沟通


经过一番沟通确定之后,果然,文档中说的在 access_token 过期 1h 之内是指token过期前1h之内。

哎,这种文档真是坑人啊。


总结


写文档和写注释一定要想清楚,别坑队友。写的模棱两可还不如不写。

对接三方沟通非常重要,当有疑问的时候马上去沟通,不要迟疑。


需求拆解


背景


最近做的工作都没有明确的需求,都是参考之前的代码逻辑,实现新渠道商的对接,导致踩了不少坑。

碰到这种没有明确需求的工作怎么推进呢?


我的踩坑总结


  1. 需求拆解,尽量把需求拆的足够细,以方便评估时间,挖掘出深层次的需求
  2. 明确责任边界,比如碰到和本次需求没有直接关系,但是影响自己开发的bug,一定要及时沟通,尽量让bug的责任人去处理;而不是自己大包大揽都干了。
  3. 及时反馈进度,当做这种需求时,领导大概率也是没想清楚的,所以不知道真正的工作量,更没有一个明确的完成时间的deadline,这种情况下及时沟通进度非常重要。尤其是当意识到可能在规定时间内无法完成,一定要提前告知。
相关文章
|
JavaScript 前端开发 数据库
让你少踩坑的fastadmin教程(3)
让你少踩坑的fastadmin教程
1413 0
让你少踩坑的fastadmin教程(3)
|
5月前
|
JSON Java 程序员
马程序员2024最新SpringCloud微服务开发与实战 个人学习心得、踩坑、与bug记录Day1最快 最全(2)
马程序员2024最新SpringCloud微服务开发与实战 个人学习心得、踩坑、与bug记录Day1最快 最全(2)
58 3
|
5月前
|
SQL Java 程序员
马程序员2024最新SpringCloud微服务开发与实战 个人学习心得、踩坑、与bug记录Day1最快 最全(1)
马程序员2024最新SpringCloud微服务开发与实战 个人学习心得、踩坑、与bug记录Day1最快 最全(1)
221 1
|
6月前
|
存储 Java API
嵌入式工程师如何写好技术文档
嵌入式工程师如何写好技术文档
230 1
|
前端开发 JavaScript ice
flexiwan项目踩坑实践
flexiManage是以色列一家初创公司flexiWAN开源的基于SD-WAN平台的应用层的框架,包括flexiManage服务端框架以及硬件侧的flexiAgent框架,然而其并没有开源前端框架,为了验证其SD-WAN方案的可行性,需要快速搭建一个前端应用
271 0
|
SQL 自然语言处理 搜索推荐
搜索引擎项目开发过程以及重难点整理(二)
搜索引擎项目开发过程以及重难点整理(二)
145 0
搜索引擎项目开发过程以及重难点整理(二)
|
存储 SQL XML
搜索引擎项目开发过程以及重难点整理(一)
搜索引擎项目开发过程以及重难点整理(一)
554 0
搜索引擎项目开发过程以及重难点整理(一)
|
Java 数据库
开发踩坑之判等问题
开发过程中避免不了判等问题?你在判等的过程中有没有遇到过坑呢?那么你是怎么解决的?快来看看我们是不是一样。
110 1
开发踩坑之判等问题
|
存储 缓存 分布式计算
如何写出一篇好的技术方案?
在写某个项目的技术方案时,来来回回修改了许多版,很是苦恼。于是,将自己之前写的和别人写的技术方案都翻出来看了几遍,产生了一些思考,分享给大家。
779 0
如何写出一篇好的技术方案?
|
JSON JavaScript API
让你少踩坑的fastadmin教程(2)
让你少踩坑的fastadmin教程
1415 0
让你少踩坑的fastadmin教程(2)