# 停车财务报表需求文档 (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）。