真实业务环境-需求分析思路(一)

智联-我的待办页面增加查询字段

写本篇文章的目的是记录一下我真实业务下的第一个需求,其次是分享我的实现思路和优化过程。文章的目的是帮助自己和其他开发人员在面对新需求时,更加系统地思考和执行,从而避免由于缺乏全局视角而带来的潜在问题。

举个例子:

数据流向:明确前端需要展示的数据及其来源。后端需要提供哪些接口?数据如何传递?
接口设计:如何设计 API 接口,以确保前端能方便地获取数据,同时保证数据的完整性和安全性?
交互逻辑:用户操作后的交互效果是什么?如何处理用户的异常操作?

注意:本篇文章的需求实现并不难,如果是学代码技术不建议看

需求分析

(智联)我的待办 ---> 查询条件新增创建人省份
image-20240717110303118

思路:

(1) 在前端添加一个输入下拉框,这个下拉框中的数据和省份内容一致就可以(数据的获取可复用)

  • 在点击查询时,需要根据创建人省份去查询我需要处理的工单(待办工单)
  • 修改后端list接口的查询条件

(2) 工单不同状态的数量统计需要修改

  • 在进行数量统计时,也要对创建人省份字段进行判断
  • 修改queryCount接口的查询条件

(3) 重置按钮

  • 在我们点击重置时,新添加的这个字段需要置为null
  • 修改前端数据

具体实现

添加前端按钮

如果对项目不熟悉,可以通过系统中的菜单管理定位到前端组件路径 workOrderSl/toDoOrder/index,然后根据该路径找到代码中的 index 组件。

看下图:
image-20240718110907803

el-row 表示行
el-col 表示列
el-form-item 一个表单项
el-select 表示这里是一个可选的输入框 v-model 绑定对象中的数据
el-option 表示el-select中的选项 里面使用v-for表示循环

创建人省份、省份等都是一列,即。 这里可以思考一下,创建人省份和省份中的数据是一致的,都是省份地市数据,所以这里我们可以复用省份的代码逻辑。
image-20240718100132534

不同状态的工单数量统计

image-20240718105249736

在queryPro中存在queryCount方法

在这个方法中有四个状态下的数量的统计,但是请求的都是后端的同一个接口

image-20240718105452629

在formData请求属性中添加新的字段属性createPro

在后端这个数量统计的接口上需要加上creatorPro字段的判断,如下:
image-20240718110106970

查询按钮

和上面的接口实现一样,在原有的基础上扩充一个字段,只需要在后端sql的 where 后面加一个条件

image-20240718110106970

重置按钮

image-20240718110359558

当我们点击重置按钮时就会触发resetFormData方法将 所有的属性 置为null ,所以这里需要添加新的字段,否则重置对新的字段没有作用

随后调用queryPro()重新查询数据

resetFormData() {
  this.formData = {
    creatorPro: null
  }
  this.queryPro()
}

后台-工单受理组人员姓名的模糊查询

记录该需求是因为在该需求在测试时发现了代码bug,并且该bug很有意思

本文用于学习实际项目bug的排查思路,顺带学一点PageHelper知识!!!

需求分析

将姓名字段的精准查询优化为模糊查询

  • 在后端SQL查询条件where处将姓名字段的判断变成模糊查询 --- 入门级别

image-20240718143938409

代码Bug分析

原始代码产生分页相关的bug

  • 如果有比较好的排查问题的思路,可以很快的找到问题 ---- 中简单级别

问题展示

在无条件的情况下查询出所有的添加成员,共8000多条

image-20240718165926983

查询 "运维001" 无数据回显(优化模糊查询前后均存在这个bug)

这个在知道时分页的原因之后,发现只有第一页的数据可以查找到,后面的所有的数据均无法找到

image-20240718144141353

问题排查

思路:

后端查询时,根据name查询的逻辑有问题?

  • 这里部分数据可以查询到的就说明name查询逻辑没有问题
  • 这里我去分析了后端的代码发现是没有问题的,所以问题不是在这里

刚开始并不清楚只有第一页能查到,所以就想到为什么只有一部分数据不可以查询,难道是因为某些 用户对象数据 是无法被查到的?

这个仔细一想就不可能。

  • 因为当时认为只有一部分数据不可以查询,所以我就想可能是数据的问题?
  • 然后在debug的时候看到sql在查询的时候有一个 not in ("id","id","id") 然后就印证了自己的这个想法
  • 但是后续添加一个人员后发现这个id多了一个正是添加的那个人的id,发现这里的这个ids是 已添加人员(刚熟悉这个项目,业务不熟悉,然后前后端项目中又没有excludeids的注释),所以并不是数据的问题,所以问题不在这里
  • image-20240718180106519

初始思路就是这样的,但是在debug的过程中发现问题都不是这些。

debug发现数据获取都是没有问题的

image-20240718190056428

这里查询到一个数据,说明后端是存在这个数据

image-20240718190513631

但是这里没有查到数据

image-20240718190610976

说明问题肯定是出在这里!!!

然后我去控制台看了sql代码

SELECT p.id, p.province, p.city, p.employee_code, p.employee_name, p.org_id, (SELECT INSERT(p.employee_phone, 4, 4, '****')) AS employee_phone, p.type, p.state, p.isValid, p.creator_id, p.creator, p.create_time, p.update_time FROM employee_pro_10096 p WHERE 1 = 1 AND p.employee_name LIKE concat('%', '运维01', '%') LIMIT 10, 10;

拉到navicat中运行,发现确实没有任何数据

image-20240719110927568

发现limit 参数起始数据直接从第10条开始查询?

如果查询的数据没有10条,那查询的结果集就会为空

所以这里的分页的参数计算肯定是有问题的

image-20240719111300224

这里的计算是有问题的!!!

比如:当我们在前端界面第二页进行查询 "运维01" ,那么传到后端的pageNo = 2 ,那么这里计算的startRow = (2 - 1) * 10 这样就导致了问题。

image-20240719111327700

然后补齐思路

image-20240719141919069

继续测试:

这里刘的模糊查询出来有280条数据

然后我这里去30页查询,出现了bug

image-20240719143629510

image-20240719143810557

debug解决:

这里发现我们的startRow成功设置,但是我们的pageNo并没有成功设置(记得前端接收pageNo)

所以将if判断从里面移出来,同时也避免了其他代码复用这个类时造成意外的冲突!!!

image-20240719144206375

image-20240719143350970

修改代码如下:

image-20240719150709318

继续测试:

发现忘记思考一个点,就是当我们的当前页数和itemCount相同时

比如说当前页为29页,if条件就会变成 (29-1)*10 > 280

  • 所以修改判断条件为 >=

最后测试:

站在用户的角度去思考!!!

我们去搜索某个名字的时候,不需要 当前页在第几页就把数据显示到第几页,而是默认第一页就可以了(这个你可以试试,作为用户正常的逻辑思维是这样的)

所以当(pageNo * pageSize) > itemCount 直接将页码置为1,防止出现最开始讨论的问题

image-20240719161612590

到这里需求及bug就完成了。

这里因为项目耦合性太强了,所以这里没法使用PageHelper。这里建议学一下pageHelper的原理,看看和这个项目中的逻辑的差别,学习一下。

posted @ 2024-07-23 22:57  柳~  阅读(103)  评论(1编辑  收藏  举报