03_需求预评审执行指南.md 4.02 KB

需求预评审执行指南

评审新增需求时,建议按下面顺序检查:

  1. 查产品主事实,看当前规则和版本演进。
  2. 查交互与测试补充,看页面表现、异常场景、边界条件。
  3. 查后台实现补充,看接口、枚举、约束、锁和异常。

模块级后台实现规模

AUTH / 认证

  • 接口:178
  • 枚举:40
  • 约束:60
  • 接口样例:GET /api/account/qr-code/auth-info;GET /api/account/qr-code/check-valid;GET /api/account/qr-code/get;POST /api/account/qr-code/save-auth-info
  • 枚举样例:AnalyticSumEnum;AppreciateOrderEventEnum;AppreciateOrderStatusEnum;AssistantInviteStatus
  • 约束样例:业务异常:不允许加入团队工作室,原因:不是新收入医生;业务异常:医师信息找不到;业务异常:医师工作室未开通,开通后可设置为「接诊中」;业务异常:医师有问诊未结束,请在问诊结束后再设置

INCOME / 收入提现

  • 接口:148
  • 枚举:27
  • 约束:82
  • 接口样例:POST /api/alipay/sh/account-book;GET /api/alipay/sh/account-book-balance;POST /api/alipay/sh/get-userinfo-by-code;POST /api/alipay/sh/merge-app-pay
  • 枚举样例:AlipayTransferStatus;ApprovalStatus;BusinessMonthStatus;CertificatesType
  • 约束样例:业务异常:不允许绑定银行卡;业务异常:不支持该类型;业务异常:交易单找不到;业务异常:公司不合法

INQUIRY / 问诊

  • 接口:339
  • 枚举:54
  • 约束:161
  • 接口样例:GET /api/chat/aggregation/chatting-doc/list;GET /api/chat/aggregation/chatting-doc/query;GET /api/chat/aggregation/v2/waiting-chat-count;GET /api/chat/aggregation/waiting-chat-count
  • 枚举样例:AcceptPushEnum;AclSearchClassicalType;AppraisalLevelEnum;AskOrderStatus
  • 约束样例:业务异常:PDF转图片流失败;业务异常:type not exist;业务异常:不支持该类型;业务异常:不支持该类型

CLINIC / 门诊

  • 接口:44
  • 枚举:5
  • 约束:50
  • 接口样例:DELETE /api/appointment-settings/;PUT /api/appointment-settings/;POST /api/appointment-settings/check;GET /api/appointment-settings/listByClinicIdAfterDate
  • 枚举样例:ChargeType;ClinicOperateType;CycleTypeEnum;PayTypeEnum
  • 约束样例:业务异常:可预约数设置过小;业务异常:可预约数设置过小;业务异常:坐诊更新失败;业务异常:坐诊机构不存在

PATIENT / 患者

  • 接口:128
  • 枚举:13
  • 约束:31
  • 接口样例:GET /api/followup/check-recent-followup;GET /api/followup/get-by-solution-code;GET /api/followup/get-recent-inquiry-corelationcode;GET /api/followup/internal/count
  • 枚举样例:AccountType;DiscountCardUsageTypeEnum;FollowStatus;FollowupPlanStatusEnum
  • 约束样例:业务异常:不允许;业务异常:关系非法;业务异常:团队工作室患者无法设置标签;业务异常:已存在该分组!

NOTIFICATION / 通知

  • 接口:59
  • 枚举:9
  • 约束:14
  • 接口样例:POST /api/netease/account/create-user;POST /api/netease/account/update-token;POST /api/netease/account/update-user-info;POST /api/netease/msg/del-msg
  • 枚举样例:CustomMsgType;InteractionType;MsgType;NotificationMsgType
  • 约束样例:业务异常:创建云信息用户失败;业务异常:发送次数已超上限;业务异常:手机号或验证码为空;业务异常:更新云信用户token失败

BACKSTAGE / 后台

  • 接口:0
  • 枚举:0
  • 约束:0

GENERAL / 通用

  • 接口:1764
  • 枚举:377
  • 约束:465
  • 接口样例:POST /aliyun/mts-notify;GET /api/activity/2024/detail;GET /api/activity/annual-report-2022/{doctorId};GET /api/activity/annual-report/2023/{doctorId}
  • 枚举样例:AITeachArticleStatus;AITeachBuyType;AITeachBuyType;AITeachCouponsType
  • 约束样例:业务异常:API Key不能为空;业务异常:GDYFFPharmacySystem.sendToSystem aes256ECBPkcs7PaddingEncrypt err;业务异常:Invalid X-API-Key;业务异常:JSON解析错误