现金贷用户信息分步提交 — 迭代需求
需求名称:现金贷用户录入信息按步骤提交。目标是将授信前用户资料从“一次性在一个接口提交全部信息”改为“每一步填写完成后独立保存”,最终提交授信申请仍由单独动作触发。
1. 背景
当前现金贷授信资料采集存在一次性提交的实现口径:客户在前端依次填写个人信息、工作收入、紧急联系人等信息后,最终通过保存基础信息接口提交较多字段。该模式会带来以下问题:
- 客户中途退出、网络异常或 App 被关闭时,已填写资料容易丢失。
- 某一步字段校验失败时,后端难以准确返回当前步骤的错误和恢复位置。
- 后续埋点、漏斗分析和客服排查只能看到最终提交结果,无法定位客户卡在哪一步。
- 单接口字段过多,前后端联调、兼容和回归范围大,任何一步改动都会影响整体提交。
本需求要求按步骤保存用户录入信息,降低单次提交风险,并为草稿恢复、步骤级校验和转化分析提供基础。
2. 范围与边界
2.1 本期范围
本期覆盖现金贷授信前资料采集链路:
| 步骤 | 范围 | 保存要求 |
|---|---|---|
| 个人信息 | DOB、教育、婚姻、地址、居住信息等 | 按个人信息步骤独立提交 |
| 工作收入信息 | 职业、行业、收入、发薪日、借款用途等 | 按工作信息步骤独立提交 |
| 紧急联系人 | 联系人关系、姓名、手机号等 | 按联系人步骤独立提交,支持分联系人保存或整步保存 |
| 人脸 / 活体状态 | 活体会话、上传结果、人脸接口结果 | 保存活体/人脸结果快照,不把活体结果等同于最终 KYC 通过 |
| 最终提交 | 确认所有必填步骤完成后发起授信申请 | 单独接口触发,不再承载全部录入字段 |
3. 目标流程
核心原则:
- 每个步骤只提交本步骤字段,不携带其他步骤的完整资料。
- 每个步骤保存成功后,服务端返回当前步骤状态、下一步建议和整体完成度。
- 最终提交前,服务端必须重新校验所有必填步骤是否完整。
- 最终提交接口只触发授信申请,不再接收全量用户资料。
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 | 最终授信提交返回 |