KasyKredit App 首页优化方案
1. 文档目的与范围
本方案定义首页最终版的页面层级、显示内容、出现/消失逻辑、跳转规则、服务端数据下发与加载机制。首页负责呈现用户当前最需要处理的事项；借款、还款、账户和客服的完整操作由详情页承接。
- 适用范围：登录及未登录用户首页。
- 设计基线：Figma「0907 · KasyKredit Home States FINAL · Full Pages」（节点 1378:408）。
- 截图中的姓名、金额、日期和账号均为示例数据。
- 首页不得以本地规则、缓存金额或前端拼接文案替代可信业务结果；所有业务展示内容均由首页服务端快照下发。
2. 页面总体结构
页面由上至下为：全局栏 → 主卡 → Banner 占位 → 还款虚拟账号卡 → 重要信息卡 → 四个快捷入口 → 底部导航。主卡始终存在；Banner、还款账号卡和信息卡依据服务端快照独立展示或折叠。首页不再提供 Restriction details、Eligibility、Documents、Application 四个快捷入口，也不再设置状态摘要卡。
3. 页面区块说明
3.1 全局栏
| 内容 | 出现与消失逻辑 | 数据来源与交互 |
|---|---|---|
| KasyKredit 标识、页面背景、安全区 | 全部首页状态始终展示 | 固定客户端视觉资源 |
| 消息入口及未读提示 | 消息入口始终展示；未读提示按服务端下发的未读数出现或消失 | 点击进入站内消息页 |
3.2 主卡：状态、优先级与操作
| 内容 | 出现与消失逻辑 | 数据来源与交互 |
|---|---|---|
| 状态标识、任务标题 | 每次刷新由首页快照选择唯一主状态 | 服务端下发的主卡状态与文案 |
| 金额、到期日、审批/处理进度、冻结说明或可借额度 | 随主状态切换；不可同时显示两个主任务 | 服务端下发的状态字段 |
| 单一主操作 | 有可执行任务时显示，与主状态一致 | 服务端下发 action 文案与目标标识；客户端按白名单执行跳转 |
主卡只切换，不消失。业务主状态按以下优先级选择：M02 → M03 → M04 → M05 → M06 → M08 → M09/M10/M11 → M12 → M13 → M14。即未结清订单优先于其他资格、申请或限制状态。原 M01 已移除；原 M06（放款处理中）与 M07（借款审批中）合并为 M06 Loan processing，原 M07 不再单独存在。网络异常 N01 是加载异常覆盖态，不参与业务状态优先级。
| 状态 | 触发条件 | 必填展示字段 | 主操作 |
|---|---|---|---|
| M02 Payment overdue | 存在逾期未结清订单 | 应还金额、逾期天数/说明、到期日、订单标识 | 立即还款 |
| M03 Due today | 今日到期且未逾期 | 今日应还金额、到期时间、订单标识 | 立即还款 |
| M04 Due soon | 临近到期且未逾期 | 下一笔应还金额、到期日、订单标识 | 查看或还款 |
| M05 Active loan | 有未结清订单，但不属于上述状态 | 当前借款金额、下一还款金额和日期、订单标识 | 查看详情 |
| M06 Loan processing | 借款审批中或已通过并放款处理中，且无未结清订单 | 当前处理阶段、阶段说明、提交时间、预计处理时间（如有） | 查看处理进度 |
| M08 Credit approval | 授信审批中，无未结清订单 | 当前状态、提交时间、预计处理时间（如有） | 查看进度 |
| M09 Permanent restriction | 永久限制，无未结清订单 | 服务可用性说明、帮助引导 | 账户或帮助 |
| M10 Restriction without date | 限制中、无确定恢复时间，无未结清订单 | 服务可用性说明、帮助引导 | 账户或帮助 |
| M11 Temporary restriction | 短期限制、有明确恢复时间，无未结清订单 | 服务可用性说明、明确恢复日期/时间 | 查看说明 |
| M12 Ready to borrow | 有可用资格、无进行中任务 | 可借额度、额度有效期（如有） | 开始借款 |
| M13 Application draft | 有未完成草稿、无进行中任务 | 草稿名称/步骤、保存时间（如有） | 继续申请 |
| M14 Guest | 未登录 | 产品引导文案 | Get started |
| N01 Network unavailable | 核心首页快照请求失败，且无可用的已确认快照 | title：Couldn’t load your information；description：Please try again.；不展示金额、账号、订单或业务状态 | Retry，重新请求核心快照 |
用户有在贷订单后又被冻结时，保持 M02–M05 的还款主卡；冻结只通过 Banner 或重要信息卡补充，不能覆盖还款主卡或阻断还款。N01 仅在无法得到当前可信快照时覆盖主卡；若已有最近一次成功、且仍在有效期内的快照，则保留原主卡内容并显示页面级刷新反馈，不切换到 N01。
3.3 Banner 占位
Banner 位于主卡下方、还款虚拟账号卡之前，用于服务端运营通知、活动或与当前状态不重复的轻量提醒。该区域仅预留一个卡位，避免与主卡争夺注意力。
| 内容 | 出现与消失逻辑 | 数据来源与交互 |
|---|---|---|
| Banner 图片/色块、标题、简短说明、按钮（可选） | 服务端下发有效 Banner 时展示；无有效内容时整块折叠，不留空白 | 服务端下发内容、有效期、排序和目标标识；点击按白名单跳转 |
| 优先级 | 仅展示优先级最高的一条 | 不展示与主卡、还款账号卡或重要信息卡表达同一业务事件的 Banner |
| 降级 | 图片加载失败时保留标题、说明与按钮的纯色样式 | 不使用本地兜底业务文案，不影响后续区块加载 |
3.4 还款虚拟账号卡：展示与详情承接
| 内容 | 出现与消失逻辑 | 数据来源与交互 |
|---|---|---|
| Repayment account、完整虚拟账号、收款银行、收款账户名 | M02–M05 且账号有效、归属当前用户时展示 | 服务端下发；点击进入还款账号详情，详情展示完整账号、收款行、账户名、关联订单、应还金额、复制状态和使用说明 |
| Copy | 展示账号时始终可用；复制成功后提示 Account number copied | 客户端复制服务端下发账号；复制不代表还款成功 |
无未结清订单、账号失效或账号不属于当前用户时，整卡消失。多笔未结清订单时，首页展示最紧急应还订单对应账号；详情页须供用户核对订单与账号关系。不考虑支付确认提示或账号准备中提示。
3.5 重要信息卡：字段、排序与跳转
重要信息卡仅保留 I03 和 I04。每张卡由服务端完整下发，不由客户端根据支付点击、金额或本地缓存推断。首页最多展示两张；同类型仅保留最新一条，已过期、被更新或与主卡同一事项重复时消失。
| 编号 | 类型 | 出现条件 | 卡片字段及显示规则 | 跳转目标 | 默认有效期 |
|---|---|---|---|---|---|
| I03 | Repayment received | 可信还款入账已落账，且不被当前主卡覆盖 | title：Repayment received；description：Your latest payment has been applied to your loan.；meta：Received {relative_date}，如 Received today；action_text：View receipt；occurred_at：入账时间；amount：已入账金额；currency：币种；loan_reference：关联借款展示号；receipt_id：回单标识；target：回单页目标标识。金额、时间、关联订单缺一不可展示 I03。 | 还款回单 | 6 天 |
| I04 | Funds sent | 可信放款成功已落账，且不被当前主卡覆盖 | title：Funds sent；description：Your loan funds have been sent to your account.；meta：Sent {relative_date}，如 Sent today；action_text：View loan；occurred_at：放款时间；amount：实际放款金额；currency：币种；loan_reference：关联借款展示号；target：借款详情目标标识。金额、时间、关联订单缺一不可展示 I04。 | 借款详情 | 6 天 |
排序为 I03 → I04。I03 的 View receipt 只在可信入账后出现；支付中、支付失败、待确认、放款失败、冻结、额度变化或其他通知均不在首页重要信息卡展示。
3.6 四个快捷入口：状态与目标页
| 适用状态 | 快捷入口 | 跳转页面与展示重点 |
|---|---|---|
| M02–M05 | Loan details / Repayment plan / Payment methods / Contact us | 借款详情（金额、还款计划、状态时间线）/ 还款计划 / 支付方式 / 邮箱联系 |
| M06 | Loan history / Cards / Help Centre / Contact us | 借款记录 / 卡券 / 帮助中心 / 邮箱联系 |
| M08、M13 | Loan history / Cards / Help Centre / Contact us | 借款记录 / 卡券 / 帮助中心 / 邮箱联系 |
| M09–M11 | Loan history / Cards / Help Centre / Contact us | 借款记录 / 卡券 / 帮助中心 / 邮箱联系 |
| M12 | Loan History / Cards / Coupons / Bank Account | 借款记录 / 卡券 / 优惠券 / 银行账户 |
| M14 | Product information / FAQs / Loan guide / Help Centre | 产品说明 / 常见问题 / 借款指南 / 帮助中心 |
快捷入口随状态整体切换，始终保持四个；同名入口必须跳转同一页面。帮助中心解决“如何操作、规则是什么”的通用问题；Contact us 进入人工客服，承接“我的具体订单或账户仍未解决”的个案，两者不可复用同一内容页。
借款指南（Loan guide）落地页
入口标题为 Loan guide，进入页标题为 Borrowing guide。页面按“开始借款 → 还款 → 获取帮助”组织：
- How to apply：完成申请、提交所需信息、等待处理结果。
- Before you borrow：提示用户确认可承受的还款金额和到期日。
- How repayment works：说明还款账号、还款计划和到账确认。
- Need help?：进入帮助中心。
页面底部主操作为 Check eligibility；未登录用户点击后进入登录/开始借款流程，已登录用户进入借款流程。页面不展示用户个人金额、账号或订单信息。
产品说明（Product information）落地页
入口标题为 Product information，进入页标题为 About KasyKredit。页面展示产品通用信息，不展示个性化授信结论：
- How KasyKredit works：申请、处理、放款、还款的简短说明。
- What you need：基础申请条件与所需信息提示。
- Repayment：说明按还款计划和还款账号完成支付。
- Questions?：进入常见问题或帮助中心。
页面底部主操作为 Get started。具体费用、期限、资格与可借额度均以用户进入借款流程后服务端下发的结果为准。
4. 服务端数据下发、加载与弱网降级
4.1 服务端首页快照
首页业务内容统一由服务端首页快照下发，客户端只负责按照下发的模块、顺序和白名单目标渲染。快照至少包含：snapshot_version、generated_at、main_card、banner、repayment_account、information_cards、quick_entries、message_badge。每一模块应带有 module_status（ready / empty / unavailable）、更新时间和可安全使用的展示字段。
- main_card、repayment_account 与 information_cards 的业务结果必须来自可信订单、还款、放款、授信结果。
- 服务端须在下发前完成状态优先级、信息卡去重、Banner 冲突过滤和敏感信息脱敏边界；客户端不得自行改写业务状态。
- 主操作、Banner、信息卡和快捷入口仅下发受控的 target_key；客户端按 target_key 白名单路由，禁止直接执行任意链接。
- 若模块状态为 empty，客户端折叠该模块；若为 unavailable，客户端只展示通用重试态，不展示推测性业务信息。
4.2 分步骤加载与骨架屏
| 阶段 | 加载内容 | 首屏表现 | 完成或失败后的处理 |
|---|---|---|---|
| 0. 本地壳层 | 全局栏、页面背景、底部导航、模块骨架 | 立即显示；主卡、Banner、账号卡、信息卡、快捷入口使用与最终尺寸一致的骨架 | 不展示本地缓存的金额、还款状态或账号 |
| 1. 核心快照 | main_card、message_badge、quick_entries | 核心快照返回后立即替换对应骨架；主卡先可用 | 失败时主卡展示通用加载失败与重试，不展示旧业务结论 |
| 2. 还款模块 | repayment_account | 仅在主卡判定为 M02–M05 时加载对应骨架 | ready 时替换；empty 时折叠；unavailable 时展示账号暂不可用与重试入口 |
| 3. 非核心模块 | banner、information_cards | 各自独立替换骨架，不阻塞主卡、账号卡或快捷入口 | empty 时折叠；unavailable 时静默折叠，不影响首屏主任务 |
骨架屏不包含真实金额、账号、姓名、订单号或状态文案；首屏仅在对应模块收到 ready 数据后显示真实内容。下拉刷新按同样分步骤执行，并以一次成功的核心快照作为页面当前状态基线。
4.3 慢网与降级规则
| 场景 | 页面行为 |
|---|---|
| 核心快照慢 | 保持主卡与快捷入口骨架；其余模块可独立完成，不得因 Banner 或信息卡阻塞首屏 |
| 还款模块慢 | M02–M05 保持账号卡骨架；主卡仍可进入还款详情，不展示虚构账号或旧账号 |
| Banner 或信息卡慢/失败 | 不阻塞其他区域；超过客户端等待阈值后折叠其骨架，后续成功可无感补入 |
| 网络中断且无已确认快照 | 主卡切换为 N01，展示 Couldn’t load your information / Please try again. / Retry；Banner、账号卡、信息卡和快捷入口全部折叠，不显示可能过期的业务状态、金额或虚拟账号 |
| 网络中断但有有效已确认快照 | 保留当前页面及内容，在全局栏或页面顶部提示刷新未完成；不改变当前主卡，不更新金额、账号、状态或信息卡 |
| 刷新中 | 保留上一份已确认快照的结构与内容，并显示局部刷新反馈；新快照成功后整体原子替换主状态与相关模块 |
| 快照版本异常/字段不完整 | 视为 unavailable；客户端折叠受影响模块或显示通用重试态，不自行补全业务字段 |
5. 前端埋点要求
页面归属 Android Native home_main；详情页独立记录自己的进入、浏览和结果。事件名与页面名稳定，不拼接金额、账号、订单号或错误原文。
| 事件名 | 类型 | 唯一触发时机 | 属性 | 用途 |
|---|---|---|---|---|
| home_view | 曝光 | 首页可见且核心快照确定 | main_state、has_unsettled_loan、info_card_count、snapshot_version | 状态分布与进入量 |
| home_module_load_result | 结果 | 每个业务模块首次得到 ready、empty 或 unavailable 结果 | module_name、module_status、load_stage | 分步骤加载质量与降级覆盖 |
| home_banner_view / home_banner_click | 曝光/点击 | Banner 首曝 / 点击 | banner_type、target_key、main_state | Banner 触达与转化 |
| home_info_card_view / home_info_card_click | 曝光/点击 | 信息卡首曝 / 点击卡片或文案 | card_type、card_rank、main_state、target_key | 信息触达与详情转化 |
| home_primary_action_click | 点击 | 点击主卡主操作 | main_state、action_type、target_key | 主任务转化 |
| home_quick_action_click | 点击 | 点击快捷入口 | quick_entry、main_state、target_key | 入口使用情况 |
| home_repayment_account_view / home_repayment_account_copy | 曝光/点击 | 账号卡首曝 / 成功触发复制 | account_card_state、main_state | 账号触达与复制需求 |
| home_network_error_view | 曝光 | N01 主卡首次进入可视区 | refresh_source、error_category | 网络异常覆盖范围 |
| home_network_retry_click | 点击 | 用户点击 Retry | refresh_source | 重试意愿与恢复漏斗 |
| home_refresh_result | 结果 | 首页刷新结束 | refresh_source、result、snapshot_version | 刷新成功率与一致性 |
不得采集完整虚拟账号、金额明细、订单号、客户姓名、银行账户名或错误原文。成功/失败以可信业务结果为准，不能以点击或复制替代。
6. 验收标准
- 主卡不再存在 M01；原 M06 与 M07 合并为 M06 Loan processing，原 M07 不再单独展示。
- 主卡仅命中一个状态，并遵循第 3.2 节优先级；有未结清订单时优先展示 M02–M05。
- 还款账号卡仅在 M02–M05 且账号有效时展示；不展示支付确认或账号准备中提示。
- 页面不再存在状态摘要卡；Banner 仅在服务端下发有效内容时展示。
- 重要信息卡仅保留 I03、I04，字段完整且仅在可信入账/放款成功后显示。
- 页面所有业务内容均来自服务端快照；客户端不得推断或补全业务状态。
- 首屏支持壳层和模块骨架；核心、还款、非核心模块独立加载，弱网不会阻塞还款主任务。
- 模块 unavailable、字段不完整或快照版本异常时，按规则折叠或展示通用重试，不展示旧账号或虚构信息。
- 快捷入口不包含已移除的四类入口，并按第 3.6 节跳转。
- 所有互动区块均按第 5 节记录稳定、非敏感埋点。
- 核心快照失败且无有效已确认快照时，主卡必须切换为 N01，且页面不得展示旧金额、虚拟账号、订单或业务结论；点击 Retry 后重新按分步骤加载规则请求首页。