停车财务报表需求文档 (Parking Financial Report) - v1.4.0
修订历史
版本号 | 修订日期 | 修订内容 | 修订人 | 状态 |
|---|---|---|---|---|
v1.0.0 | 2026-01-28 | 初始版本：建立基础收费报表框架 | Antigravity | 已发布 |
v1.1.0 | 2026-01-28 | 扩展版本：整合多模块维度（资产分析、异常审计、一车一账） | Antigravity | 已发布 |
v1.2.0 | 2026-01-28 | 交互优化：明确全模块“单页集成展示”架构，整合视图逻辑 | Antigravity | 已发布 |
v1.3.0 | 2026-01-28 | 逻辑确认：明确本月默认视图，暂不细化权限控制 | Antigravity | 已发布 |
v1.4.0 | 2026-01-29 | 功能增强：增加欠费名单穿透查询，实现欠费数据明细化统计 | Antigravity | 草稿 |
1. 模块目标
为小区物业提供全方位、多维度的停车财务分析门户。所有财务统计与分析内容必须在同一个页面内集成展示，通过合理的布局（看板+页签+列表）实现从宏观数据概览到微观流水明细的无缝穿透。
2. 单页展示架构规划 (Single-Page Architecture)
为了满足“同页面展示”的需求，报表页面采用以下纵向布局结构：
2.1 顶部：核心财务看板 (Financial Dashboard)
展示形式：关键指标卡片 (KPI Cards)。
默认视图：页面加载时，默认展示“本月” (当前自然月) 的财务数据汇总。
核心指标：
应收总额：统计周期内产生的总账单金额。
实收总额：实际已支付入账的金额。
欠费总额 (交互项)：目前仍处于“待支付”状态且在有效期内的金额。
点击行为：点击该数值或卡片，原地弹出**“欠费名单明细抽屉” (Arrears List Drawer)**。
退款总额：已执行退款的金额（作为减项展示）。
净收入：实收总额 - 退款总额。
2.2 中部：多维分析工作区 (Analysis Workspace)
展示形式：采用 Tab 页签切换 机制，在不离开页面的情况下切换分析维度。
页签 1：收入构成 (Revenue Analysis)
柱状图/饼图展示：按车辆类型分布。
环形图展示：按支付渠道占比。
页签 2：资产与区域收益 (Asset Yield)
按车场区域统计收益对比。
泊位平均收益率排行。
页签 3：异常与审计监控 (Audit & Risks)
作废账单汇总及原因分布。
0元出场记录摘要。
2.3 底部：财务明细流水 (Transaction Details)
展示形式：带高级筛选功能的动态数据列表。
功能特性：
穿透查询：点击车牌号可原地弹出该车辆的“一车一账”全量记录抽屉层。
3. 欠费名单明细功能说明 (Arrears Detail Functionality)
当用户点击看板中的“欠费总额”时，系统需展示以下内容的详情：
3.1 欠费统计维度
欠费车辆数：统计当前筛选条件下存在欠费账单的唯一车辆总数。
欠费账单数：统计处于“待支付”状态的总单据数量。
最长欠费周期：识别当前欠费车辆中最长的一笔欠费时长（天数）。
3.2 欠费列表字段 (Arrears List Fields)
字段名称 | 说明 |
|---|---|
车牌号 | 欠费车辆标识，点击可进一步下钻至该车一车一账 |
车辆类型 | 业主/长租/临时/临停 |
关联人员 | 车主姓名及联系方式 (由 77f0- 关联) |
欠费总额 | 该车辆项下所有待支付账单的金额总计 |
欠费笔数 | 待支付状态的账单数量 |
最早欠费时间 | 该车辆产生的最早一笔未支付账单时间 |
关联房屋 | 1栋1单元101等 (由审核/车辆模块关联) |
3.3 交互逻辑
原地操作：名单以侧边抽屉形式展示，不干扰主页面筛选状态。
催缴辅助：支持一键导出当前的“欠费清单”以便物业进行线下催缴。
4. 关键业务逻辑
4.1 一页式穿透 (In-place Drilling)
原则：避免页面跳转。
实现方式：对于需要查看明细的项（如退款明细、特定车辆记录、欠费名单），使用抽屉 (Drawer) 或 模态框 (Modal) 在当前页面上方覆盖展示。
4.2 数据版本与快照 (Data Versioning)
全量保存原则：快照需包含当时的计费因子、车辆标签状态。
4.3 状态联动及时性
同步要求：当发生欠费补缴（支付成功）或账单作废时，看板中的“欠费总额”及“欠费名单”需实时刷新（T+0）。