现金贷用户信息分步提交 — 迭代需求

需求名称:现金贷用户录入信息按步骤提交。目标是将授信前用户资料从“一次性在一个接口提交全部信息”改为“每一步填写完成后独立保存”,最终提交授信申请仍由单独动作触发。

1. 背景

当前现金贷授信资料采集存在一次性提交的实现口径:客户在前端依次填写个人信息、工作收入、紧急联系人等信息后,最终通过保存基础信息接口提交较多字段。该模式会带来以下问题:

  • 客户中途退出、网络异常或 App 被关闭时,已填写资料容易丢失。
  • 某一步字段校验失败时,后端难以准确返回当前步骤的错误和恢复位置。
  • 后续埋点、漏斗分析和客服排查只能看到最终提交结果,无法定位客户卡在哪一步。
  • 单接口字段过多,前后端联调、兼容和回归范围大,任何一步改动都会影响整体提交。

本需求要求按步骤保存用户录入信息,降低单次提交风险,并为草稿恢复、步骤级校验和转化分析提供基础。

2. 范围与边界

2.1 本期范围

本期覆盖现金贷授信前资料采集链路:

步骤范围保存要求
个人信息DOB、教育、婚姻、地址、居住信息等按个人信息步骤独立提交
工作收入信息职业、行业、收入、发薪日、借款用途等按工作信息步骤独立提交
紧急联系人联系人关系、姓名、手机号等按联系人步骤独立提交,支持分联系人保存或整步保存
人脸 / 活体状态活体会话、上传结果、人脸接口结果保存活体/人脸结果快照,不把活体结果等同于最终 KYC 通过
最终提交确认所有必填步骤完成后发起授信申请单独接口触发,不再承载全部录入字段

3. 目标流程

核心原则:

  1. 每个步骤只提交本步骤字段,不携带其他步骤的完整资料。
  2. 每个步骤保存成功后,服务端返回当前步骤状态、下一步建议和整体完成度。
  3. 最终提交前,服务端必须重新校验所有必填步骤是否完整。
  4. 最终提交接口只触发授信申请,不再接收全量用户资料。

4. 埋点与监控

本需求需要配套步骤级埋点和监控,用于观察资料采集漏斗:

事件触发时机
apply_personal_info_submit_result个人信息步骤保存返回
apply_work_info_submit_result工作收入步骤保存返回
apply_emergency_contact_submit_result紧急联系人步骤保存返回
apply_face_submit_result活体/人脸步骤保存返回
apply_profile_progress_result完成度查询返回
apply_credit_submit_result最终授信提交返回