# 停车系统总需求文档 (Parking System PRD)

## 文档修订历史

| 版本号 | 修订日期 | 修订内容 | 修订人 | 状态 |
| :--- | :--- | :--- | :--- | :--- |
| v1.0.0 | 2026-01-28 | 初始版本：整合9个模块形成停车系统总体需求 | Antigravity | 已发布 |
| v1.1.0 | 2026-01-29 | 评审更新：新增访客车与黑名单管理、优化换车与临时车逻辑、完善重复入场处理、增加收费标准变更规则 | Antigravity | 已发布 |
| v1.2.0 | 2026-01-29 | 深度优化：完善访客车生命周期、黑名单操作机制、临时车有效期、访客车收费规则、车牌唯一性约束、一车多账单支持 | Antigravity | 已发布 |
| v1.3.0 | 2026-01-29 | 评审修正：废除财务覆盖原则改为审核授权优先、优化访客车冲突提示、完善换车账单继承、临时车到期自动清理、黑名单强制追缴、异常数据处理、欠费名单明细、收费标准变更时机明确 | Antigravity | 已发布 |
| v1.4.0 | 2026-01-29 | 逻辑细化：明确已登记车辆准入规则、完善一位多车溢出计费、优化访客车计费一致性与扫码缴费、强化支付驱动续期与有效期滚动更新、修正临时车欠费保护删除、细化换车车位继承 | Antigravity | 已发布 |
| v1.5.0 | 2026-01-30 | 评审优化：细化访客有效期与道闸规则、锁定溢出计费逻辑、增加访客费用手动结清、明确访客准入豁免与道闸约束、优化有效期MAX算法与支付顺序、强化换车1换1原则 | Antigravity | 已发布 |
| v1.6.0 | 2026-02-04 | 模块整合：合并小程序停车系统PRD v1.2.0，将"小程序发起申请"模块升级为完整的"小程序停车系统"模块，涵盖业主小程序和物业小程序双端功能，新增访客帮付、岗亭保安登记、消息推送订阅等功能 | Antigravity | 已发布 |
| v1.7.0 | 2026-02-11 | 需求评审优化：完善合作方帮付双模式（开启/不开启帮付）、增加停车催交机制（7天/15天/30天）、明确一位多车溢出计费与名额释放规则、强化黑名单最高优先级约束、明确换车审核需原车无待支付账单、访客有效期改为多段独立（不合并）、增加作废账单备注类型（手动作废/冲突作废/合作方免除等） | Antigravity | 草稿 |

---

## 1. 停车系统整体概述

本停车系统是面向**小区物业管理**场景的一站式车辆与停车资源管理解决方案。系统覆盖从住户端申请到物业端管理、从资源配置到财务统计的完整业务闭环,实现车辆全生命周期的数字化管理。

### 1.1 系统目标

- **业务闭环**：实现"申请 → 审核 → 授权 → 通行 → 收费 → 报表"的完整业务流程
- **精细化管理**：建立车场、车位、车辆的三级资产管理体系
- **数据一致性**：通过边缘网关实现物业管理系统与硬件设备的数据同步
- **财务透明化**：提供多维度的收费分析与财务报表

### 1.2 适用场景

- 住宅小区物业停车管理
- 支持独立运营、场中场、多场协同等多种运营模式
- 兼容主流第三方停车管理系统(PMS)的集成

---

## 2. 10个核心模块功能摘要

### 2.1 小程序停车系统 (v1.2.0)

**模块定位**：面向住户和物业的移动端停车管理入口，包含业主小程序和物业小程序双端功能。

#### 2.1.1 业主小程序功能

**核心功能架构**：
```
业主小程序 - 停车
├── 停车首页
│   ├── 停车公共收入 (本日/本周/本月)
│   ├── 车场使用情况 (车位总数/已停车位/可用车位)
│   ├── 我的车辆 Tab (含待审核车辆、帮付访客车辆)
│   └── 我的车位 Tab
├── 车辆管理
│   ├── 新增车辆申请 (长租车/临时车/临时车转月卡)
│   ├── 车辆详情与操作
│   ├── 车辆信息变更申请
│   ├── 换车申请
│   ├── 车辆续费 (无欠费时预缴未来费用)
│   └── 车辆移除
├── 车位管理
│   ├── 车位列表与详情
│   └── 车位绑定/换绑车辆
├── 访客车辆管理
│   ├── 创建访客邀请 (支持停车费用帮付)
│   ├── 访客邀请记录与分享
│   └── 帮付访客车辆缴费
├── 停车缴费
│   ├── 临停缴费 (扫码)
│   ├── 欠费缴纳
│   └── 我的停车缴费记录
└── 审核状态管理
    ├── 待审核车辆展示
    └── 审核不通过重新编辑提交
```

**车辆申请类型**：
- **长租车申请**：包含停车场、收费类型、租赁时间、附件上传(居住证明、身份证、行驶证、驾驶证)
- **临时车申请**：简化版申请，不包含停车场和收费类型
- **临时车转月卡申请**：临时车升级为长租车，车牌号自动带入，审核通过后更新收费标准和车辆类型
- **车辆信息变更申请**：修正已审核通过车辆的基础信息
- **换车申请**：将原有租赁权益转移至新车辆

**车辆状态管理**：
- **待审核车辆**：显示审核中状态，支持缴费和删除申请，禁止修改信息、换车、续费
- **审核不通过车辆**：显示驳回原因，支持重新编辑或删除
- **帮付访客车辆**：显示在"我的车辆"Tab，访客离场后推送缴费通知，支付完成后从列表隐藏

**续费与缴费规则**：
- **续费操作**：仅长租车辆，必须无历史欠费，预缴未来费用，无需审核
- **欠费缴纳**：缴纳已生成账单的历史欠费，不支持部分缴费
- **车辆与车位续费统一**：固定车位长租车续费包含车辆授权费用和车位使用费用，不重复收取

**访客帮付功能**：
- 业主创建访客邀请时可开启"停车费用帮付"
- **道闸逻辑**：访客出场时道闸直接开启，不等待业主支付
- **后付机制**：业主在访客离场后任意时间完成支付
- **异常处理**：访客车辆出场时，系统向业主推送缴费消息提醒
- 通过服务号一次性推送向业主发送缴费通知
- 支付完成后从"我的车辆"列表中移除
- **帮付账单纳入催交**：业主帮付的访客车辆产生的欠费账单，纳入停车催交机制进行催缴

#### 2.1.2 物业小程序功能

**核心功能架构**：
```
物业小程序 - 停车
├── 小区信息 (首页)
│   ├── 共有资金展示
│   ├── 小区人数统计
│   ├── 登记车辆数 (长期/临时)
│   └── 停车场车辆数 (总车辆/业主车辆/临停车辆)
├── 合作方邀请
│   ├── 创建邀请 (支持车牌号/停车费用帮付)
│   ├── 有效/失效邀请列表
│   └── 邀请详情与分享
└── 岗亭保安现场登记
    ├── 选择住户
    ├── 填写访客信息
    └── 设置停车费用帮付
```

**合作方帮付功能**：
- 物业创建合作方邀请时可选择是否开启"停车费用帮付"
- **开启帮付模式**：
  - 合作方车辆出场时系统自动作废本次停车账单，道闸自动开启
  - 账单标记为"已作废"，备注类型为"合作方免除"
  - 已作废账单不计入收费统计
- **不开启帮付模式**：
  - 合作方车辆出场时按车场默认收费标准收取费用
  - 车辆缴费完成后才能出场
- **计费循环**：每次进出均按选择的模式执行，合作方车辆不存在欠费追缴情况

**岗亭保安现场登记**：
- 适用场景：住户未提前创建邀请，或访客无法自助填写
- 操作流程：搜索选择住户 → 填写访客信息 → 设置帮付开关 → 确认登记
- 支持车牌识别、短信通知住户
- 登记信息实时同步至后台系统和业主小程序

**统计口径说明**：
- **登记车辆数**：系统中有档案的车辆总数(存量数据)
- **停车场车辆数**：当前时刻在场内的车辆实时数(增量数据)

#### 2.1.3 消息推送订阅

**推送类型与机制**：

| 推送类型 | 订阅方式 | 触发时机 | 推送内容 |
| :--- | :--- | :--- | :--- |
| 审核结果通知 | 一次性订阅(提交申请时) | 审核通过/驳回时 | 小区名称、车牌号、审批类型、审批结果、备注 |
| 到期提醒通知 | 长期订阅(用户主动) | 到期前7天/3天/1天 | 车牌号、到期时间、剩余天数 |
| 欠费提醒通知 | 长期订阅(用户主动) | 欠费后1天/3天/7天 | 车牌号、欠费金额、欠费天数 |
| 访客停车缴费通知 | 一次性订阅(创建邀请时) | 访客车辆出场时 | 访客车牌号、停车费用、停车时长 |

**订阅入口**：
- 个人中心 → 关联应用 / 消息通知设置
- 功能触发入口(如车辆详情页、缴费页面)

**关键特性**：
- 支持附件上传(居住证明、身份证、行驶证、驾驶证)
- 自动带入房屋和住户信息
- 联动过滤：选择停车场后联动展示对应收费类型
- 支持一位多车和一车多位绑定
- 访客有效期管理(v1.7.0修订)：同一车牌被多人登记为访客车时，保持多段独立有效期，不合并为连续区间

---

### 2.2 车场管理 (v1.7.0)

**模块定位**：停车场基础设施的数字化建模与配置。

**核心功能**：
- **基础资料维护**：车场档案创建、层级架构定义、库存同步
- **运营模式配置**：支持独立运营、场中场运营、多场协同运营
- **第三方系统集成**：配置PMS厂商信息(捷顺、博斯高、富士、PP停车等)
- **访客车辆管理**：支持业主或物业对来访车辆进行预报备

**关键字段**：
- 车场名称、总泊位数
- 停车管理系统(PMS Provider)
- **外部车辆准入(v1.6.0→v1.7.0细化)**：
  - **系统已登记车辆**：业主车、租赁车、临时车（已登记）、访客车、白名单、黑名单
  - **系统未登记车辆**：未在系统中留存信息的临停车辆
  - **开启准入**：允许除黑名单以外的所有车辆进入
  - **关闭准入**：仅限已登记且非黑名单的车辆放行。**访客车作为已登记车辆，在关闭准入时依然允许放行**
- **道闸通行规则(v1.7.0新增)**：
  - **限进规则**：车辆进场时必须处于系统有效期范围内才允许开闸
  - **不限出规则**：道闸不限制车辆出场的有效期，即便车辆出场时已超过登记有效期也应允许出场
- **访客车有效期定义(v1.7.0新增)**：
  - **管理有效期**：以来访日期段为准（例如2026-01-30至2026-01-31），不限制具体小时分钟
  - **收费有效期**：计费以车辆真实进场时间与出场时间为准，不受日期段限制
- 区域与楼层划分(地下A区、地面车位区等)

---

### 2.3 车位管理 (v1.4.0)

**模块定位**：车位资源的精细化管理与车辆授权。

**核心功能**：
- **车位档案维护**：支持单个录入或批量导入
- **车位-车辆关联**：支持"一位多车"白名单绑定
- **状态管理**：空闲、已售、已租、预约中、不可用

**业务校验**：
- 删除校验:仅允许删除未绑定车辆的车位
- 车位必须归属于特定停车场及区域
- **一位多车进场与计费判定(v1.2.0→v1.4.0锁定,v1.7.0补充)**：
  - **占用判定(首车进场)**：车位绑定的多辆车中，第一辆车进场时若车位处于空闲/可用状态，该车判定为"名额占用车"，按车位绑定的优惠收费规则执行
  - **溢出判定(后续车辆进场)**：同一车位绑定的其余车辆在名额占用车尚未离场时进入，判定为"溢出车辆"，按车场定义的默认收费规则(临时车计费标准)执行
  - **计费持续性原则(v1.4.0明确)**：溢出车辆的计费模式在进场时即已确定。**即使名额占用车在溢出车辆离场前先行出场，溢出车辆的计费模式不发生转变**，仍继续按默认收费规则计费直至其离场
  - **名额释放逻辑(v1.7.0补充)**：车位占用名额仅在名额占用车离场时释放；释放后若无该车位绑定的其他车辆在场，下一辆进场的绑定车辆可重新享受优惠计费

**数据版本管理**：
- 全量快照保存:记录车位基本信息、状态及绑定关系的所有变更
- 操作审计:记录操作人ID、变更时间、差异值

---

### 2.4 收费标准 (v1.8.0)

**模块定位**：停车收费规则的灵活配置与管理,确保每个车场必须具备默认收费规则。

**核心功能**：
- **收费模版管理**：
  - 时效租赁:支持自定义周期时长及单位(时/天/月/年)
  - 临停收费:首小时免费+阶梯计时、单一费率、按次计费、分时限时
  - 免费:特殊车辆或特定时期的全免配置
- **车场关联与默认规则约束(v1.7.0→v1.8.0优化)**：
  - **唯一性约束明确**：每个车场有且仅有一条默认收费规则,系统强制校验
  - **默认规则缺失预警优化**：
    - 首次检测到车场未配置默认规则时弹窗提醒
    - 提供"暂时忽略"或"不再提醒此车场"选项
    - 停车管理模块顶部保留橙色横幅警示,可随时配置
    - 不在每次进入模块时强制弹窗,避免干扰正常操作
- **访客车辆计费与缴费(v1.7.0→v1.8.0扩展)**：
  - 访客车辆与临停车计费逻辑完全一致，每次进入均自动匹配车场唯一的默认收费规则按次/时长计费
  - **缴费路径双通道(v1.8.0新增)**：
    - **移动端自主缴费**：访客车辆统一通过扫描场内或出口的"临停缴费二维码"进行支付
    - **后台手动结清**：管理员可在系统后台"车辆收费"管理模块对指定访客车辆执行"手动结清"操作，适用于线下收现、特殊情况免单放行、或线上支付异常后的补录处理
  - **账单归属**：访客费用为独立临停账单，严禁与住户月租/物业账单合并或平分
  - **代缴场景**：住户代缴需通过扫描"临停二维码"进行移动端支付
- **车位绑定设置**：定义是否需要强制绑定车位
- **规则下发**：通过边缘网关同步至停车控制系统
- **收费标准变更后的账单处理(明确时机)**：
  - 历史账单保持不变,不进行重新计算
  - **新账单生成时机**：在当前计费周期结束时生成新账单,按最新收费标准计费
  - 收费标准变更后,系统向所有使用该标准的车辆发送通知,告知下次续费将按新标准计费

**临停收费细节**：
- 封顶规则:24小时封顶或每日封顶
- 离场缓冲:支付后N分钟内免费离场

---

### 2.5 车辆管理 (v1.10.0)

**模块定位**：车辆档案的核心管理模块,连接多个业务模块,确保车牌唯一性与黑名单硬性约束。

**核心功能**：
- **车辆档案管理与唯一性约束（优化）**：
  - 车辆标签:业主车/长租车/临时车/临停车/访客车/黑名单车辆
  - 唯一性原则:系统内一个车牌号只能存在一条有效的档案数据
  - **访客查重优化(v1.9.0→v1.10.0)**:访客车辆登记时检测车牌是否已存在,若存在提示"该车牌已登记为XX住户车辆,不用添加为访客车"
  - 查重机制:PC端手动添加、小程序申请时必须全局查重
- **车辆有效期与更新逻辑(v1.9.0→v1.10.0优化)**：
  - **术语规范(v1.10.0明确)**:车辆有效期明确使用"更新"(Update)描述，不再使用"延长"或"挪动"，以避免逻辑歧义
  - **首次授权**:授权有效期起始点为车辆第一次申请进入系统并审核通过的时间
  - **支付驱动更新算法(v1.10.0优化)**:
    - **更新公式**：`车辆有效期 = MAX(当前有效期, 所有已支付账单中的最晚结束时间)`
    - **账单支付顺序约束**：账单必须按时间先后顺序支付，或在单次操作中一并支付，禁止跨期支付
  - **通行判定(道闸约束)(v1.10.0新增)**:
    - **进场限制**：道闸仅在车辆处于有效期范围内时允许进场
    - **出场限制**：道闸不限制车辆出场的有效期，即车辆在任何时间均可离场(离场时根据计费规则结算费用)
  - **临时车过期处理(欠费保护)**:
    - 有效期默认为2年，到期时系统自动检查是否存在未结清的待支付账单
    - 若存在欠费:标记为"已过期待清算"，不删除档案，向住户推送提醒"临时车已过期，请缴清欠费后重新申请"
    - 若无欠费或欠费缴清后:执行软删除
  - **换车申请逻辑(1换1原则)(v1.10.0强化,v1.7.0补充)**:
    - **1换1原则**：换车申请必须严格遵循"1换1"对应关系
    - **账单约束(v1.7.0新增)**：换车审核时要求原车不存在待支付账单，必须结清后才能审核通过
    - **资源流转**：换车申请审核通过后，原车自动释放其绑定的车位资源，新车自动占用原车释放的车位资源
    - **约束**：总车位占用数及车辆总数应保持恒定
    - 原车有效期缩短至更换生效时间，新车继承原车结束时间
    - 原车账单保持不变，新车按继承有效期生成新账单
    - 新车备注字段记录换车信息
  - **审核授权优先**:审核通过即授权通行,无需等待支付；车辆有效期以审核时物业填写的有效期为准
- **访客车辆管理(v1.10.0扩展)**：
  - **准入控制豁免(v1.10.0新增)**：访客车属于"系统已登记车辆"，当车场管理模块设置"关闭准入"(禁止外部车辆进入)时，仍允许已登记的有效访客车进场放行
  - **有效期定义(v1.10.0明确)**：
    - **车辆管理维度**：访客车有效期按"来访日期段"计算(例如1月30日至1月31日)，即该日期段内均有效
    - **车辆收费维度**：计费有效期基于真实的进场和出场时间戳
  - **信息维护**：支持对已登记的访客车进行车牌号变更，并同步更新来访车辆信息
  - **计费与支付**：按车场默认规则计费，支持访客或住户通过扫描临停二维码缴费，或后台手动结清
  - **有效期管理(v1.7.0修订)**:同一车牌被多人登记为访客车时，保持多段独立有效期，不合并为连续区间
  - 访客冲突检测:访客登记时检测车牌是否已存在,若存在提示不用添加为访客车
  - 访客离开状态:离场后档案保留但标记为"失效/过期"
  - 通行规则:有效期内支持多次进出,每次根据计费规则重新计算费用
- **车辆授权与车位关联**：支持一车绑定多个车位,支持一位多车
- **车辆信息下发**：
  - 审核约束:新车辆登记及核心信息变更需先审核后下发
  - 续费例外:时效续费完成后无需审核,立即下发
  - 黑名单禁令:黑名单车辆下发拦截指令至边缘网关,严禁进出小区
  - 黑名单立即下发:黑名单状态变更立即下发,失败自动重试直到成功
  - 手动重新下发:支持管理员手动触发下发流程
- **缴费与续费**：
  - 账单查询:查询所有未缴费账单及历史账单
  - 收费标准匹配:取当前生效的收费标准或系统默认规则
  - **访客车收费**:每次进出均按所属车场的默认收费规则计费，缴费方式为访客或住户通过扫描场内/出口临停二维码完成，或后台手动结清
  - 欠费缴费:实时查询并支持直接支付
- **消息提醒**：欠费通知、租赁到期通知(提前2天)、审核结果通知、临时车过期清算通知
- **停车催交机制(v1.7.0新增)**：
  - **催交周期**：7天/15天/30天向存在欠费的住户发送缴费通知
  - **催交范围**：包含住户本人名下车辆欠费及业主帮付的访客车辆欠费
  - **推送渠道**：App推送、短信通知、系统站内信
- **黑名单管控机制(v1.7.0强化)**：
  - **黑名单优先级最高**：黑名单车辆的限制权限高于所有其他车辆类型
  - 登记硬约束:黑名单车辆无法登记为访客车
  - **访客车加入黑名单处理(v1.7.0新增)**：如果车辆先被登记为访客车，后被加入黑名单，系统自动作废该车牌的所有"待生效/生效中"访客车记录，仍按黑名单车辆的限制进场规则执行
  - 加入黑名单:操作入口-车辆详情页；关联资产-原有有效期和车位绑定关系不解除；审批规则-不需要审批,立即生效
  - 移除黑名单:强制欠费检查，移除前系统自动检查未缴账单，必须结清所有欠费后才允许移出黑名单
  - 新增黑名单:支持直接添加新车牌,移除后直接删除档案
  - 财务继承:加入/移除黑名单时原有未缴账单不作废
  - 通行拦截:黑名单车辆无论是否在有效期内均严禁道闸放行
- **异常通行处理**：
  - 重复入场:取最近一次入场记录计费,其他入场记录标记为"异常数据"
  - 异常数据:支持查看和导出所有异常数据,便于故障排查

**资源释放逻辑**：车辆删除或权属变更时,自动释放绑定车位、授权权限及未生效预约

---

### 2.6 车辆审核 (v1.6.0)

**模块定位**：小程序端住户申请的审核门户。

**核心原则**：
- PC端物业直接操作不需要审核,直接生效并下发
- 仅对小程序端住户提交的申请进行审核

**审核场景**：
1. **长租车辆审核**：包含车辆信息、租赁信息、附件材料
2. **临时车辆审核**：不包含停车场和收费类型
3. **车辆信息变更审核**：修正已审核车辆的信息
4. **变更车辆审核(换车)**：转移租赁权益至新车辆
5. **临时车转租赁车审核**：将临时车转为长租车

**核心功能**：
- **列表页签区分**：
  - 待审核Tab:仅展示待审核记录,支持批量操作
  - 历史审核Tab:展示已通过/已驳回记录
- **批量操作优化**：
  - 批量通过、批量驳回
  - **批量审核失败详细展示**:
    - 展示失败记录列表(申请编号、车牌号、申请人、详细失败原因)
    - 提供[查看详情]按钮跳转到审核单详情页
    - 支持补充信息后重新提交审核
- **超时提醒**：待审核记录超过阈值时标红提醒并推送通知
- **费用冲突检查优化**：
  - 长租车辆审核:检查生效时间范围内的待支付账单
    - 提示为建议性质,不强制要求作废账单
    - 说明"审核通过后立即生效,住户可即时进出停车场"
    - 提供[作废这些账单]和[保留账单]选项
  - 换车审核:检查原车辆的所有待支付账单
    - 原车账单保持不变,新车继承有效期后按原规则生成新账单
    - 提示为建议性质,不强制要求作废账单
  - 临时车转租赁车审核:检查生效时间范围内的待支付账单
    - 生效时间内:建议性提示,可选择作废或保留
    - 生效时间外:强制校验,必须驳回申请要求先结清欠费
- **车辆有效期管理逻辑(v1.5.0→v1.6.0调整)**：
  - **审核时设置有效期结束时间**：
    - 长租车辆/临时车转租赁车：审核通过时，物业设置生效时间，系统根据收费标准周期自动计算有效期结束时间（失效时间）
    - 换车申请：新车辆的有效期结束时间继承原车辆的有效期结束时间
    - 临时车辆：有效期固定为审核通过时间 + 2年
  - **租赁车缴费后更新有效期**：
    - 租赁车缴费后，车辆收费模块生成新账单，同时更新车辆管理模块中的有效期结束时间为新账单的有效期结束时间
    - 车辆管理模块读取最新的有效期结束时间作为车辆当前的授权有效期
    - 临时车的有效期不会因缴费而更新
- **换车申请1换1车位继承原则(v1.5.0→v1.6.0明确)**：
  - **1换1原则**：新车绑定的车位数量必须与原车保持一致
  - **物业操作权限**：
    - ✅ **替换车位**：可以将原车的车位替换为其他车位（如将A-101替换为B-201）
    - ❌ **不允许增加车位**：不能在原有基础上额外绑定新的车位
    - ❌ **不允许减少车位**：不能减少车位绑定数量
  - **原车无车位时的处理**：若原车辆无车位绑定，新车也不绑定车位（除非收费标准要求必须绑定）
  - **车位容量检查**：车位继承时不检查车位容量，允许"一位多车"场景
  - **业务说明**：原车释放车位 → 新车占用车位，总占用数保持不变
- **审核授权优先原则**：
  - 审核通过即授权通行,无需等待支付
  - 车辆有效期以审核时物业填写的有效期为准
  - 住户可即时进出停车场,缴费与授权分离
  - 长期不缴费车辆可通过黑名单机制管理
- **审核填写区**：物业审核人员填写最终确认信息
  - 车场、收费标准、车位(根据收费标准判断是否必填)
  - 生效时间、失效时间(自动计算，v1.6.0恢复使用：审核时设置初始有效期)
  - 审核意见

**审核通过后流程**：
1. 保存审核版本
2. 根据申请类型执行对应操作(创建/更新车辆档案，并设置初始有效期结束时间)
3. 写入车辆管理模块（包含有效期结束时间）
4. 立即授权通行并下发至边缘网关(失败不影响数据写入,可手动重试)
5. 租赁车缴费后，由车辆收费模块更新有效期结束时间
6. 消息通知

**版本管理**：同一审核单支持查看完整审核历史,住户重新提交使用同一审核单号

---

### 2.7 车辆收费 (v1.8.0)

**模块定位**：停车收费业务的精细化管理,建立"一车一账"费用归集体系,支持单一车牌关联多条并行账单。

**核心功能**：
- **账单状态管理**：
  - 未生效:当前时间 < 开始时间
  - 生效中:开始时间 <= 当前时间 <= 结束时间
  - 已失效:当前时间 > 结束时间
  - 动态展示:列表页及详情页实时展示账单状态
- **支付状态管理**：待支付、已支付、已退款、已作废
- **缴费规则**：
  - 不支持部分缴费:单次支付必须核销整笔账单
  - **支付顺序约束(v1.8.0新增)**：若同一车辆存在多笔待支付的时效性账单(如连续3个月的月租账单)，系统要求必须按账单周期顺序支付，或支持一并合并支付。禁止跳跃支付(例如：不能在未支付1月账单的情况下直接支付3月账单)，以保证有效期的连续性
  - 金额匹配:实缴金额不能超过应交金额,允许小于(折扣/抹零)
  - 记录"应交金额"与"实缴金额"两个字段
- **操作规则**：
  - 账单作废:只能作废"待支付"状态的账单
  - **作废备注类型(v1.7.0新增)**：所有账单作废时必须回填对应的备注信息，类型包括：手动作废、冲突作废、合作方免除、黑名单作废等，在车辆费用及进出纪录均需展示
  - 退款操作:只有"已支付"状态可以发起退款
- **一车一账与多账单支持**：
  - 核心原则:为每一辆车(以车牌号为唯一标识)建立完整的费用档案
  - 多账单关联:系统必须支持一个车牌号下存在多条并行的收费账单
  - 场景举例:同一车辆可同时拥有一条"生效中"的月租账单,和多条"待支付"的临停账单
  - 规则来源:各账单根据其绑定的收费标准模版(如时效租赁模版、临停收费模版)独立生成
- **手动新增收费**：支持管理员手动创建收费账单(特殊欠费补录、线下协商收费)
- **访客冲突检测**：访客车辆登记时检测车牌是否已存在于车辆管理系统,若存在提示"该车牌已登记为XX住户车辆,不用添加为访客车"
- **临停清理(欠费保护)**：
  - 临时车2年有效期到期时，系统自动检查是否存在未结清的待支付账单
  - 若存在欠费:标记为"已过期待清算"，不删除档案，向住户推送提醒
  - 若无欠费或欠费缴清后:执行软删除
- **黑名单追缴(v1.8.0强化)**：移除黑名单前强制检查欠费，必须结清所有欠费后才允许移出黑名单
- **换车账单处理**：
  - 原车账单保持不变,不作废也不退款
  - 新车继承有效期后按原收费标准生成新账单或继承原账单
  - 新车账单备注字段记录换车信息
- **账单重叠处理**：长租车辆审批时若存在待支付临停账单且时间重叠,弹窗询问物业是否作废临停账单,避免重复收费
- **一位多车溢出计费(v1.7.0→v1.8.0优化)**：
  - **场景**：车位容量管理不设数量限制，一个车位允许绑定多辆车(如A、B、C...)
  - **计费优先级规则(按进场时间)(v1.8.0优化)**：
    - **首位优先**：当该车位绑定的任意一辆车(例如C车)最先入场时，该车享受车位绑定的优惠规则(如月租/免费)
    - **溢出计费**：在首位车辆(C车)未离场期间，该车位绑定的其他车辆(A车、B车...)若进入车场，系统自动按车场默认收费规则(如临停标准)计费
    - **权益释放**：只有当享受优惠的首位车辆(C车)出场后，车位的优惠权益才被释放，供下一辆入场的绑定车辆使用
- **收费标准变更后账单生成**：收费标准变更后,新账单在当前计费周期结束时生成,按最新收费标准计费
- **授权有效期更新算法(v1.7.0→v1.8.0优化)**：
  - **术语明确(v1.8.0)**:使用"更新"而非"延长"或"挪动"，确保语义准确
  - **计算公式(v1.8.0新增)**：`车辆最新授权有效期 = MAX(当前系统记录的有效期, 所有已支付账单中的最晚结束时间)`
  - 初始有效期:以车辆第一次申请进入系统的时间为准
  - 触发机制:仅在用户成功支付时效性账单后触发更新计算
  - 通行与计费判定:底层道闸及计费系统必须以车辆最新的授权有效期为准，判断是否放行或是否需要触发临时计费

**联动影响**：
- 车辆管理联动:时效性账单在"已支付"且"生效中"时,同步更新车辆有效期及白名单
- 退款联动:月租类账单退款时,自动缩短或撤销车辆有效期并同步至设备

---

### 2.8 进出纪录 (v1.5.0)

**模块定位**：车辆通行轨迹的记录与归档。

**核心功能**：
- **进场记录管理**：
  - 自动采集:通过边缘网关从停车系统同步
  - 同步要求:查询时展现最新进场记录(非实时推送)
  - **重复入场处理(v1.4.0→v1.5.0优化)**：
    - 允许车辆正常进入并产生新的入场纪录
    - 立即生成告警消息推送至物业员工端
    - **原在场记录标记为"异常数据"**,创建新在场记录
    - 不覆盖历史记录,所有记录均保留供后续审计
  - 手动增加:支持管理员补录
- **出场记录管理与计费关联(v1.4.0→v1.5.0优化)**：
  - 自动匹配:根据车牌号匹配对应入场记录
  - **匹配规则优化**:若存在多条未结案记录,取离出场时间最近的一条入场记录进行计费,**其他未结案记录标记为"异常数据"**
  - 计费逻辑对齐:本地停车系统反馈的计费数据应与该"最近入场记录"产生的时长保持一致
  - 手动出场:针对异常滞留车辆
- **状态流转(v1.4.0→v1.5.0新增)**：在场、已离场、手动结案、**异常数据(新增状态)**
- **记录删除(v1.4.0→v1.5.0新增)**：支持删除故障记录或错误记录,删除前需确认该记录未关联收费账单
- **收费规则(v1.4.0→v1.5.0明确)**：临停车/访客车使用车场唯一默认规则进行计费,确保计费标准统一

**关键字段**：
- 入场信息:车牌号、入场时间、道口ID、入场抓拍图
- 出场信息:离场时间、道口ID、离场抓拍图
- 停留时长、记录状态、数据来源、关联收费单ID、**异常标记(新增)**

**模块联动**：
- 车辆收费:临停车辆进出记录是生成收费单据的基础,记录中关联`charge_id`,确保基于最近一次入场记录计算
- 车辆管理:车辆详情中的"通行日志"直接调用本模块接口;重复入场的告警消息应能链接至该车辆的管理档案

---

### 2.9 收费报表 (v1.4.0)

**模块定位**：全方位、多维度的停车财务分析门户。

**单页展示架构**：
- **顶部:核心财务看板**
  - 默认视图:本月财务数据汇总
  - 核心指标:应收总额、实收总额、**欠费总额(可点击)**、退款总额、净收入
  - **欠费总额交互(v1.3.0→v1.4.0新增)**:点击欠费总额弹出"欠费名单明细抽屉"
- **中部:多维分析工作区**
  - Tab 1 - 收入构成:按车辆类型、支付渠道分布
  - Tab 2 - 资产与区域收益:按车场区域统计收益对比、泊位平均收益率
  - Tab 3 - 异常与审计监控:作废账单汇总、0元出场记录、离场缓冲导致的流失
- **底部:财务明细流水**
  - 默认加载本月明细数据
  - 穿透查询:点击车牌号弹出"一车一账"抽屉层
  - 实时联动:筛选条件同步影响看板和列表
  - 导出功能:支持Excel导出
- **欠费名单明细抽屉(v1.3.0→v1.4.0新增)**：
  - **欠费统计**:欠费车辆数、欠费账单数、最长欠费周期
  - **欠费列表字段**:
    - 车牌号、车辆类型
    - 关联人员(业主/租户姓名、联系电话)
    - 欠费总额、欠费笔数
    - 最早欠费时间、最长欠费天数
    - 关联房屋(楼栋-单元-房号)
  - **催缴辅助**:支持一键导出欠费清单Excel,包含所有欠费车辆及联系方式

**业务逻辑**：
- 一页式穿透:使用抽屉或模态框在当前页面展示明细,避免页面跳转
- 数据版本与快照:月结/日结快照保存生成时的完整状态
- **数据实时性(v1.3.0→v1.4.0强化)**:欠费补缴或作废后实时刷新欠费统计(T+0),确保物业人员看到的数据永远是最新状态

---

## 3. 模块相互关系拓扑图

```
┌─────────────────────────────────────────────────────────────────┐
│                         停车系统架构                               │
└─────────────────────────────────────────────────────────────────┘

【小程序端】
    │
    ├─ 业主小程序 (0ec6-) v1.2.0
    │   ├─ 停车首页 (我的车辆/我的车位)
    │   ├─ 车辆申请 (长租/临时/换车/变更/临转租)
    │   ├─ 车辆管理 (详情/续费/移除)
    │   ├─ 车位管理 (绑定/换绑)
    │   ├─ 访客邀请 (创建/分享/帮付)
    │   ├─ 停车缴费 (临停/欠费/缴费记录)
    │   └─ 消息推送 (审核结果/到期提醒/欠费提醒)
    │
    ├─ 物业小程序 (0ec6-) v1.2.0
    │   ├─ 小区信息 (统计数据展示)
    │   ├─ 合作方邀请 (创建/帮付/分享)
    │   └─ 岗亭保安登记 (快速录入访客)
    │
    ↓
【审核层】
    │
    ├─ 车辆审核 (3b4e-5) v1.6.0
    │   ├─ 待审核/历史审核 Tab
    │   ├─ 批量操作、超时提醒
    │   ├─ 费用冲突检查与账单作废
    │   └─ 审核通过后下发至边缘网关
    │
    ↓
【业务管理层】
    │
    ├─ 车场管理 (4e27-) v1.7.0 ──┐
    │   ├─ 车场档案                │
    │   ├─ 区域/楼层管理            │
    │   ├─ 运营模式配置            │  关联关系
    │   └─ 第三方PMS集成           │
    │                             │
    ├─ 车位管理 (7531-) v1.4.0 ───┤
    │   ├─ 车位档案维护            │
    │   ├─ 一位多车支持            │
    │   └─ 删除校验                │
    │                             │
    ├─ 收费标准 (bc0d-) v1.8.0 ───┤
    │   ├─ 时效租赁模版            │
    │   ├─ 临停收费模版            │
    │   ├─ 车场关联与规则约束       │
    │   └─ 下发至边缘网关          │
    │                             │
    ├─ 车辆管理 (77f0-) v1.10.0 ◄──┘
    │   ├─ 车辆档案管理
    │   ├─ 车位授权关联
    │   ├─ 缴费与续费
    │   ├─ 有效期管理
    │   ├─ 访客车辆管理
    │   └─ 消息提醒
    │
    ↓
【业务执行层】
    │
    ├─ 车辆收费 (d0a6-) v1.8.0
    │   ├─ 账单状态管理(未生效/生效中/已失效)
    │   ├─ 支付状态管理(待支付/已支付/已退款/已作废)
    │   ├─ 一车一账
    │   ├─ 访客帮付账单处理
    │   └─ 手动新增收费
    │
    ├─ 进出纪录 (d86b-7) v1.5.0
    │   ├─ 进场记录(自动采集/手动补录)
    │   ├─ 出场记录(自动匹配/手动出场)
    │   └─ 关联收费单
    │
    ↓
【数据分析层】
    │
    └─ 收费报表 (15d4-) v1.4.0
        ├─ 核心财务看板
        ├─ 多维分析工作区
        └─ 财务明细流水

【硬件集成层】
    │
    └─ 边缘网关 (Edge Gateway)
        ├─ 接收收费标准下发
        ├─ 接收车辆白名单下发
        ├─ 上传进出场事件
        └─ 对接第三方PMS系统
```

---

## 4. 业务流程串联说明

### 4.1 完整业务流程：从用户申请到财务报表

#### 阶段1：住户申请 (业主小程序端)

1. 住户在业主小程序端选择申请类型：
   - 长租车辆申请：填写停车场、收费类型、生效时间、上传附件(居住证明、身份证、行驶证、驾驶证)
   - 临时车辆申请：填写车辆信息、上传附件(无停车场和收费类型)
   - 车辆信息变更：修正已有车辆信息，自动回填当前车辆信息
   - 变更车辆(换车)：填写新车信息、更换生效时间
   - 临时车转月卡：临时车升级为长租车，车牌号自动带入

2. 系统自动带入房屋和住户信息

3. 提交后进入"待审核"状态
   - 小程序中显示"待审核"标签
   - 待审核期间：支持缴费和删除申请，禁止修改信息、换车、续费

4. 触发服务号一次性订阅消息授权请求(审核结果通知)

#### 阶段2：物业审核 (PC端)

1. 物业审核人员在"车辆审核"模块查看待审核列表
   - 支持按申请类型、时间范围筛选
   - 超时记录标红提醒

2. 进入审核详情页：
   - 查看住户提交的完整信息(车辆信息、附件材料、申请理由)
   - 如果是长租车辆/换车申请，系统自动检查费用冲突
     - 发现待支付账单与生效时间重叠时提示
     - 物业可选择批量作废冲突账单或保留
   - 临时车转月卡申请：检查原临停账单与长租生效时间是否重叠
   - 物业填写审核确认信息：
     - 车场(必填)、收费标准(必填)、车位(根据收费标准判断)
     - 生效时间(可修改)、失效时间(自动计算)
     - 审核意见

3. 审核操作：
   - **通过**：
     - 保存审核版本
     - 根据申请类型创建/更新车辆档案
     - 临时车转月卡：更新收费标准和车辆类型，备注"临时车转长租"
     - 写入"车辆管理"模块
     - 尝试下发至边缘网关(失败可手动重试)
     - 通过服务号向住户推送审核通过通知
   - **驳回**：
     - 保存驳回理由
     - 通过服务号向住户推送审核驳回通知(含驳回原因)
     - 住户可在小程序中重新编辑后提交(使用同一审核单号)

4. 支持批量审核操作(批量通过/批量驳回)

#### 阶段3：车辆管理与授权

1. 审核通过后，车辆信息进入"车辆管理"模块：
   - 车辆档案：车牌号、车辆类型、品牌型号、颜色
   - 权属信息：业主/租户/物业人员/外部人员
   - 车辆标签：业主车/长租车/临时车/临停车/访客车
   - 车位关联：绑定车位(支持一车多位、一位多车)
   - 有效期：取自已缴费下的最新停车账单结束时间

2. 车辆信息下发至边缘网关：
   - 新车辆或核心信息变更：需先审核后下发
   - 时效续费：支付完成后立即下发，无需审核
   - 下发状态：未同步/已同步/同步失败
   - 支持手动重新下发

3. 车辆授权生效，可正常进出停车场

4. 小程序端同步更新：
   - 待审核车辆变为正常车辆状态
   - 显示有效期、绑定车位等信息

#### 阶段4：车辆通行与计费

1. 车辆进场：
   - 边缘网关识别车牌，记录进场信息
   - 同步至"进出纪录"模块：车牌号、入场时间、道口ID、抓拍图
   - 重复入场处理：发送告警但不拦截，创建新记录

2. 车辆出场：
   - 边缘网关识别车牌，记录出场信息
   - 自动匹配对应入场记录(取时间最近的一条)
   - 计算停留时长

3. 收费计算(根据车辆类型)：
   - **长租车/业主车(时效租赁)**：
     - 有效期内无需支付临停费
     - 到期前7天/3天/1天推送续费提醒(需用户订阅)
     - 续费操作：
       - 用户在小程序端或管理员完成支付
       - 系统自动延长有效期(取最新账单结束时间)
       - 直接触发设备端下发，无需审核
   - **临时车/临停车**：
     - 根据收费标准计算费用
     - 临停收费逻辑：首小时免费+阶梯计时、封顶规则、离场缓冲
     - 生成收费账单，状态为"待支付"
   - **访客车**：
     - 按车场默认收费规则计费
     - 帮付场景：道闸直接开启，向业主推送缴费通知
     - 非帮付场景：道闸关闭，需访客扫码支付后放行

4. 账单写入"车辆收费"模块：
   - 账单状态：未生效/生效中/已失效(根据当前时间判断)
   - 支付状态：待支付
   - 应交金额、实缴金额(初始为0)

#### 阶段5：缴费与支付

1. 用户缴费渠道：
   - 业主小程序端：查看未缴费账单，在线支付
   - 临停扫码：扫描车场二维码缴费
   - PC端：管理员代缴或现场收费

2. 支付处理：
   - 不支持部分缴费，单次支付核销整笔账单
   - 实缴金额不能超过应交金额，允许小于(折扣/抹零)
   - 记录应交金额与实缴金额

3. 支付成功后：
   - 账单状态更新为"已支付"
   - 如果是时效租赁账单：
     - 车辆有效期更新为账单结束时间
     - 同步下发至边缘网关
   - 生成支付流水，记录支付渠道

4. 特殊操作：
   - **账单作废**：只能作废"待支付"状态的账单，需记录作废原因
   - **退款操作**：只能对"已支付"状态发起退款，退款后更新为"已退款"
     - 时效租赁账单退款：自动缩短或撤销车辆有效期并同步至设备

5. 欠费处理：
   - 系统自动推送欠费通知
   - 车辆管理详情中展示所有未缴费账单
   - 支持一键跳转支付

#### 阶段6：财务报表与分析

1. 数据自动汇总至"收费报表"模块：
   - 实时更新(T+0)：退款或作废操作后立即更新
   - 默认展示本月数据

2. 核心财务看板：
   - 应收总额：统计周期内产生的总账单金额
   - 实收总额：实际已支付入账的金额
   - 欠费总额：目前"待支付"且在有效期内的金额
   - 退款总额：已执行退款的金额
   - 净收入：实收总额 - 退款总额

3. 多维分析：
   - **收入构成**：按车辆类型、支付渠道分布
   - **资产收益**：按车场区域统计收益对比、泊位平均收益率
   - **异常监控**：作废账单汇总、0元出场记录、离场缓冲导致的流失

4. 明细穿透：
   - 点击车牌号查看"一车一账"全量记录
   - 支持导出Excel报表

5. 数据快照：
   - 月结/日结快照保存生成时的完整状态
   - 确保历史数据不受后续变更影响

### 4.2 特殊业务流程

#### 流程1：车辆信息变更(住户发起)

1. 住户在业主小程序端发起"车辆信息变更申请"
2. 系统自动回填当前车辆信息
3. 填写变更内容和变更理由
4. 提交后进入审核流程
5. 物业审核通过后，更新车辆档案并重新下发至边缘网关
6. 保存变更前的完整车辆信息版本(变更历史)
7. 通过服务号向住户推送审核结果通知

#### 流程2：换车申请(住户发起)

1. 住户选择原有效车辆，填写新车辆信息和更换生效时间
2. 提交审核
3. 物业审核确认车场、收费标准、车位及更换生效时间
4. 审核通过后，在更换生效时间执行：
   - 原车辆状态标记为"已失效"或"已注销"
   - 释放原车辆绑定的车位资源
   - 创建新车辆档案，继承原车辆的租赁权益(收费标准、剩余有效期等)
5. 下发至边缘网关

#### 流程3：临时车转月卡(住户发起)

1. 住户在临时车详情页点击"申请月卡"
2. 进入长租车申请页面，车牌号自动带入不可编辑
3. 填写停车场、收费类型等信息
4. 提交审核
5. 物业审核时检查原临停账单：
   - 若与长租生效时间重叠，提示是否作废
   - 若不重叠，建议先结清(非强制)
6. 审核通过后：
   - 更新车辆收费标准为长租车标准
   - 更新车辆类型为"租赁车"
   - 备注"临时车转长租"
   - 设置有效期
7. 唯一性保障：不创建新档案，仅更新原车辆档案

#### 流程4：PC端物业直接操作(无需审核)

1. 物业员工在"车辆管理"模块直接新增车辆或修改车辆信息
2. 操作直接生效并下发至边缘网关
3. 无需经过"车辆审核"模块
4. 适用场景：现场处理、紧急情况

#### 流程5：手动出场与补录

1. 识别失败或异常滞留车辆
2. 管理员在"进出纪录"模块执行"手动出场"
3. 记录状态标记为"手动结案"
4. 手动补录进场记录(如监控核实后补录)

#### 流程6：手动新增收费

1. 管理员在"车辆收费"模块手动创建收费账单
2. 适用场景：特殊欠费补录、线下协商收费、非系统自动感应产生的费用
3. 录入车牌号、费用类型、应交金额、有效期范围、备注
4. 账单初始状态为"待支付"

#### 流程7：业主访客帮付(业主小程序)

```
业主在小程序创建访客邀请
    ↓
开启"停车费用帮付"开关
    ↓
触发服务号一次性订阅授权(访客停车缴费通知)
    ↓
访客车辆登记，标记为"帮付"状态
    ↓
访客车辆入场
    ↓
访客车辆出场
    ↓
道闸直接开启放行(不等待支付)
    ↓
系统生成待支付账单
    ↓
通过服务号向业主推送缴费通知
    ↓
业主在"我的车辆"中看到"帮付访客车辆"
    ↓
业主点击[立即缴费]完成支付
    ↓
支付完成后，访客车辆从列表中隐藏
    ↓
缴费记录进入"我的停车缴费记录"
```

#### 流程8：合作方帮付(物业小程序)

```
物业在小程序创建合作方邀请
    ↓
填写单位名称、车牌号(支持多个)
    ↓
选择是否开启"停车费用帮付"开关
    ↓
合作方车辆登记
    ↓
合作方车辆入场
    ↓
合作方车辆出场
    ↓
┌─────────────────┬─────────────────┐
│  开启帮付模式    │  不开启帮付模式   │
├─────────────────┼─────────────────┤
│ 系统自动作废本次 │ 按默认收费标准   │
│ 停车账单        │ 收取费用         │
│       ↓         │       ↓         │
│ 账单标记"已作废"│ 车辆缴费完成后   │
│ 备注类型"合作方 │ 才能出场         │
│ 免除"           │                  │
│       ↓         │                  │
│ 道闸自动开启放行│                  │
│       ↓         │                  │
│ 已作废账单不计入│                  │
│ 收费统计        │                  │
└─────────────────┴─────────────────┘
    ↓
每次进出均按选择的模式执行
(合作方车辆不存在欠费追缴情况)
```

#### 流程9：岗亭保安现场登记(物业小程序)

```
访客到达岗亭
    ↓
保安打开物业小程序 → 快速登记
    ↓
搜索住户(按房号/姓名/手机号)
    ↓
选择住户
    ↓
填写访客信息:
  - 访客姓名(必填)
  - 联系方式(必填)
  - 车牌号(非必填，支持车牌识别)
  - 来访时间(默认当天)
    ↓
询问住户是否帮付停车费
    ↓
设置停车费用帮付开关
    ↓
确认登记 → 系统创建访客档案
    ↓
(可选) 发送短信通知住户
    ↓
放行访客进入小区
    ↓
访客信息同步至业主小程序
```

---

## 5. 核心数据流转路径

### 5.1 主数据流

```
【住户申请 - 业主小程序】
    ↓
[小程序停车系统] → 申请数据(车辆信息+租赁信息+附件)
    ↓
[车辆审核] → 审核数据(审核意见+车场+收费标准+车位+生效时间)
    ↓
[车辆管理] → 车辆档案(基础信息+权属+标签+车位关联+有效期)
    ↓
[边缘网关] → 白名单下发(车牌号+授权车场+有效期)
    ↓
【硬件设备】道闸/识别相机 → 允许通行
```

### 5.2 通行与收费数据流

```
【车辆进出】
    ↓
[边缘网关] → 进出场事件(车牌号+时间+道口+抓拍图)
    ↓
[进出纪录] → 通行记录(入场+出场+停留时长+状态)
    ↓                               ↓
[车辆管理] ← 通行日志查询      [车辆收费] ← 生成收费账单
                                    ↓
                            账单数据(账单状态+支付状态+应交/实缴金额)
                                    ↓
                            【用户支付(小程序/扫码)/管理员支付】
                                    ↓
                            [车辆管理] ← 更新有效期(时效租赁)
                                    ↓
                            [边缘网关] ← 下发更新后的白名单
```

### 5.3 财务数据流

```
[车辆收费] → 所有收费账单数据
    ↓
[收费报表] → 数据汇总与分析
    ├─ 核心财务看板：应收、实收、欠费、退款、净收入
    ├─ 多维分析：收入构成、资产收益、异常监控
    └─ 明细流水：一车一账穿透查询
    ↓
[业主小程序] ← 停车公共收入展示
[物业小程序] ← 小区信息统计展示

数据版本管理：
[车辆收费] → 月结/日结快照保存 → [收费报表] → 历史数据归档
```

### 5.4 配置数据流

```
【基础配置】
    ↓
[车场管理] → 车场档案+区域/楼层+PMS配置
    ↓
[车位管理] → 车位档案+车位状态+车位-车辆绑定
    ↓
[收费标准] → 收费模版(时效租赁+临停收费+免费)
    ↓
[边缘网关] ← 收费标准下发
    ↓
【硬件设备】计费系统
```

### 5.5 审核与授权数据流

```
【小程序申请】
    ↓
[小程序发起申请] → 申请数据
    ↓
[车辆审核] → 费用冲突检查 → [车辆收费]查询待支付账单
    ↓                              ↓
审核通过                    作废冲突账单(可选)
    ↓
[车辆管理] ← 写入车辆档案
    ↓
[车场管理]、[车位管理]、[收费标准] ← 关联查询
    ↓
[边缘网关] ← 下发白名单
```

---

## 6. 系统架构分层说明

### 6.1 架构分层模型

```
┌─────────────────────────────────────────────────────────────┐
│                      前端展示层                               │
├─────────────────────────────────────────────────────────────┤
│  小程序端(住户)          │         PC管理端(物业)             │
│  - 我的车辆              │  - 车辆审核                       │
│  - 车辆申请              │  - 车辆管理                       │
│  - 申请记录              │  - 车场管理                       │
│  - 缴费中心              │  - 车位管理                       │
│  - 进出记录查询          │  - 收费标准                       │
│                          │  - 车辆收费                       │
│                          │  - 进出纪录                       │
│                          │  - 收费报表                       │
└─────────────────────────────────────────────────────────────┘
                              ↕
┌─────────────────────────────────────────────────────────────┐
│                      业务逻辑层                               │
├─────────────────────────────────────────────────────────────┤
│  【住户申请业务】         │  【审核业务】                     │
│  - 长租车辆申请           │  - 审核流程管理                   │
│  - 临时车辆申请           │  - 批量审核                       │
│  - 信息变更申请           │  - 费用冲突检查                   │
│  - 换车申请               │  - 版本管理                       │
│                          │                                   │
│  【资源管理业务】         │  【收费业务】                     │
│  - 车场档案管理           │  - 账单状态管理                   │
│  - 车位档案管理           │  - 支付处理                       │
│  - 收费标准配置           │  - 退款/作废                      │
│  - 运营模式配置           │  - 一车一账                       │
│                          │                                   │
│  【车辆管理业务】         │  【通行业务】                     │
│  - 车辆档案管理           │  - 进出场记录                     │
│  - 车位授权               │  - 自动匹配                       │
│  - 有效期管理             │  - 异常处理                       │
│  - 缴费续费               │                                   │
│                          │                                   │
│  【财务分析业务】         │  【消息通知业务】                 │
│  - 数据汇总               │  - 审核结果通知                   │
│  - 多维分析               │  - 欠费通知                       │
│  - 报表生成               │  - 到期提醒                       │
└─────────────────────────────────────────────────────────────┘
                              ↕
┌─────────────────────────────────────────────────────────────┐
│                      数据持久层                               │
├─────────────────────────────────────────────────────────────┤
│  【核心业务数据】                                             │
│  - 车辆档案表(vehicle)                                        │
│  - 车场档案表(parking_lot)                                    │
│  - 车位档案表(parking_space)                                  │
│  - 收费标准表(fee_standard)                                   │
│  - 审核申请表(vehicle_audit)                                  │
│  - 审核版本历史表(vehicle_audit_version)                      │
│  - 收费账单表(parking_bill)                                   │
│  - 进出记录表(entry_exit_record)                              │
│  - 支付流水表(payment_transaction)                            │
│                                                               │
│  【关联数据】                                                 │
│  - 车位-车辆绑定表(space_vehicle_binding)                     │
│  - 房屋信息表(house)                                          │
│  - 住户信息表(resident)                                       │
│  - 员工信息表(staff)                                          │
│                                                               │
│  【配置数据】                                                 │
│  - 区域配置表(area_config)                                    │
│  - PMS配置表(pms_config)                                      │
│  - 系统参数表(system_config)                                  │
└─────────────────────────────────────────────────────────────┘
                              ↕
┌─────────────────────────────────────────────────────────────┐
│                      集成接口层                               │
├─────────────────────────────────────────────────────────────┤
│  【边缘网关集成】         │  【第三方支付集成】               │
│  - 白名单下发接口         │  - 微信支付                       │
│  - 收费标准下发接口       │  - 支付宝                         │
│  - 进出场事件上传接口     │  - 银联支付                       │
│  - 设备状态监控接口       │                                   │
│                          │                                   │
│  【PMS系统集成】          │  【消息推送集成】                 │
│  - 捷顺/博斯高/富士等     │  - App推送                        │
│  - 数据双向同步           │  - 短信通知                       │
│                          │  - 系统站内信                     │
└─────────────────────────────────────────────────────────────┘
```

### 6.2 数据一致性保障

**全量快照保存原则**：
- 车辆管理：每次车辆信息更新均需保存全量快照镜像
- 车位管理：记录车位基本信息、状态及绑定关系的所有变更
- 车辆审核：保存完整的申请信息快照及审核操作信息
- 收费报表：月结/日结快照包含当时的计费因子、车辆标签状态

**操作审计要求**：
- 记录操作人ID、操作时间、操作类型
- 记录变更前旧值、变更后新值、变更原因
- 支持完整的操作历史回溯

**数据版本管理**：
- 审核模块：同一审核单支持多个版本，版本号从1开始递增
- 车辆管理：变更历史完整保存
- 收费报表：历史快照不受后续变更影响

### 6.3 系统集成说明

**边缘网关(Edge Gateway)**：
- 作用：物业管理系统与硬件设备的数据中枢
- 上行数据：进出场事件、设备状态
- 下行数据：车辆白名单、收费标准
- 同步状态：未下发/已下发/下发失败
- 失败处理：支持手动重新下发，不影响业务数据写入

**第三方PMS系统集成**：
- 支持厂商：捷顺、博斯高、富士、PP停车等
- 集成方式：通过边缘网关进行标准化对接
- 数据下发：收费标准、车辆白名单
- 数据回传：进出场事件、设备状态

**消息通知集成**：
- 推送渠道：App推送、短信通知、系统站内信
- 触发场景：
  - 审核结果通知(通过/驳回)
  - 欠费通知
  - 租赁到期通知(提前2天)
  - 超时审核提醒

---

## 7. 各模块版本信息汇总

| 序号 | 模块名称 | 版本号 | 最后修订日期 | worktree路径 | 状态 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| 1 | 小程序停车系统 | v1.2.0 | 2026-02-04 | 0ec6- | 草稿 |
| 2 | 车场管理 | v1.7.0 | 2026-01-30 | 4e27- | 草稿 |
| 3 | 车位管理 | v1.4.0 | 2026-01-30 | 7531- | 草稿 |
| 4 | 收费标准 | v1.8.0 | 2026-01-30 | bc0d- | 草稿 |
| 5 | 车辆管理 | v1.10.0 | 2026-01-30 | 77f0- | 草稿 |
| 6 | 车辆审核 | v1.6.0 | 2026-01-30 | 3b4e-5 | 草稿 |
| 7 | 车辆收费 | v1.8.0 | 2026-01-30 | d0a6- | 草稿 |
| 8 | 进出纪录 | v1.5.0 | 2026-01-29 | d86b-7 | 草稿 |
| 9 | 收费报表 | v1.4.0 | 2026-01-29 | 15d4- | 草稿 |

### 7.1 模块依赖关系矩阵

| 模块 | 依赖模块 | 依赖说明 |
| :--- | :--- | :--- |
| 小程序停车系统 | 车辆审核、车辆管理、车位管理、车辆收费、车场管理、收费报表、进出纪录 | 业主端：申请流转至审核模块、查询车辆/车位/账单信息；物业端：查询统计数据、创建访客档案 |
| 车辆审核 | 车场管理、车位管理、收费标准、车辆管理、车辆收费 | 获取车场/车位/收费标准列表；写入车辆档案；检查费用冲突 |
| 车辆管理 | 车场管理、车位管理、收费标准、车辆收费、进出纪录、车辆审核 | 获取下发通道；绑定车位；查询账单；查看通行记录；接收审核结果 |
| 车位管理 | 车场管理 | 车位必须归属于特定车场及区域 |
| 收费标准 | 车场管理 | 收费标准必须关联具体车场 |
| 车辆收费 | 车辆管理、进出纪录 | 更新车辆有效期；关联进出场记录 |
| 进出纪录 | 车辆管理、车辆收费 | 关联车辆档案；关联收费账单 |
| 收费报表 | 车辆收费、车辆管理、车场管理、收费标准 | 汇总所有收费数据；多维度分析 |

---

## 8. 关键业务规则总结

### 8.1 审核规则

1. **PC端物业操作无需审核**：物业员工在PC端直接操作的车辆信息修改、新增车辆、修改车辆收费等操作直接生效并下发
2. **小程序端住户申请需审核**：所有通过小程序提交的申请必须经过车辆审核模块
3. **审核通过后数据写入与下发分离**：审核通过后车辆信息立即写入车辆管理模块，边缘网关下发失败不影响数据写入，可手动重试
4. **续费操作免审核**：时效续费完成后(支付成功)，无需经过审核，应立即触发下发指令
5. **费用冲突检查与账单作废**：审核长租车辆时，自动检查生效时间范围内的待支付账单，支持批量作废

### 8.2 收费规则

1. **账单状态判定**：未生效、生效中、已失效(根据当前时间与有效期判断)
2. **支付状态流转**：待支付 → 已支付 / 已作废，已支付 → 已退款
3. **缴费约束**：不支持部分缴费，单次支付必须核销整笔账单
4. **金额匹配**：实缴金额不能超过应交金额，允许小于(折扣/抹零)
5. **作废规则**：只能作废"待支付"状态的账单
6. **退款规则**：只有"已支付"状态可以发起退款，时效租赁账单退款需自动缩短或撤销车辆有效期

### 8.3 车位绑定规则

1. **一位多车支持**：一个车位可以授权给多个车牌号
2. **一车多位支持**：一辆车可以绑定多个固定车位
3. **删除校验**：仅允许删除未绑定车辆且无有效租赁/权属关系的车位
4. **收费标准联动**：当收费标准设置"需要绑定车位"时，车位字段为必填

### 8.4 有效期管理规则

1. **有效期来源**：车辆有效期需取自已缴费下的最新停车账单的结束时间
2. **续费延期**：用户/管理员完成支付后，系统自动延长有效期(取最新账单结束时间)
3. **到期提醒**：在车辆租赁到期前2天，提醒人员进行续费
4. **退款影响**：时效租赁账单发起退款时，系统应自动缩短或撤销对应的车辆有效期，并同步至底层设备

### 8.5 资源释放规则

1. **触发条件**：当车辆执行删除操作或发生权属变更(如从原业主变更为新业主)
2. **释放内容**：自动释放原先绑定的车位资源、授权权限及未生效的预约
3. **逻辑校验**：若车辆有关联的未完成订单，需提示先结算后再进行删除

### 8.6 进出场规则

1. **重复入场处理**：若车辆在"在场"状态下再次产生入场信号，系统发送告警提醒但不拦截，依然创建并保存新的入场记录
2. **出场匹配规则**：若存在多条未结案(在场)记录，取时间最近的一条入场记录进行关联
3. **手动操作**：支持管理员手动补录进场记录和手动出场

### 8.7 数据版本管理规则

1. **全量保存原则**：任何涉及核心信息的变更，系统需自动保存当前完整镜像
2. **操作审计**：记录操作人ID、变更时间、变更前后的差异值
3. **版本追溯**：支持查看历史版本的完整数据快照
4. **财务快照**：报表生成的月结/日结快照包含当时的计费因子、车辆标签状态，即使车辆随后被删除，历史记录仍保持原样

---

## 9. 系统特色与亮点

### 9.1 业务闭环完整

从住户在小程序端发起申请，到物业审核、车辆授权、通行记录、收费计费、财务报表，形成完整的业务闭环，覆盖车辆管理的全生命周期。

### 9.2 审核与授权分离

- 小程序端住户申请需审核，PC端物业操作无需审核
- 审核通过后数据立即写入，边缘网关下发失败不影响业务，可手动重试
- 续费操作免审核，支付完成后立即下发

### 9.3 费用冲突智能检查

审核长租车辆时，系统自动检查生效时间范围内是否存在待支付费用账单，支持批量作废冲突账单，避免重复收费。

### 9.4 一车一账体系

为每一辆车建立完整的费用档案，集中展示该车辆产生的所有费用记录(包含临停费、月租/租赁费等)，支持穿透查询。

### 9.5 账单状态双维管理

- **账单状态**：未生效、生效中、已失效(根据时间判断)
- **支付状态**：待支付、已支付、已退款、已作废
- 双维状态结合，精准描述账单的时间有效性与支付情况

### 9.6 灵活的运营模式

支持独立运营、场中场运营(商业+住宅)、多场协同运营(相邻小区或一二期)，满足不同物业管理场景需求。

### 9.7 一位多车与一车多位

- **一位多车**：一个车位可以授权给多个车牌号，适用于家庭多车场景
- **一车多位**：一辆车可以绑定多个固定车位，适用于跨区域停车需求

### 9.8 全量快照与版本管理

- 任何核心信息变更均保存完整镜像
- 支持历史版本回溯与版本对比
- 操作审计：记录操作人、时间、变更前后差异
- 财务快照不受后续变更影响，确保历史数据准确性

### 9.9 单页集成报表

所有财务统计与分析内容在同一页面集成展示，通过看板+页签+列表实现从宏观数据概览到微观流水明细的无缝穿透，避免页面跳转。

### 9.10 消息提醒与超时监控

- **主动提醒**：欠费通知、租赁到期通知(提前2天)、审核结果通知
- **超时监控**：待审核记录超过阈值时标红提醒并推送通知
- **多渠道推送**：App推送、短信通知、系统站内信

---

## 10. 待优化与扩展方向

### 10.1 短期优化

1. **批量操作增强**：
   - 批量修改车辆收费标准
   - 批量导出车辆档案
   - 批量下发至边缘网关

2. **数据统计优化**：
   - 车位使用率分析
   - 车辆类型分布趋势
   - 收费标准有效性评估

3. **用户体验优化**：
   - 审核流程可视化
   - 车辆通行轨迹地图展示
   - 移动端物业审核支持

### 10.2 中期扩展

1. **智能推荐**：
   - 基于历史数据推荐收费标准
   - 智能车位分配算法
   - 欠费预警与催缴策略

2. **权限细化**：
   - 角色权限体系(审核员、财务、管理员等)
   - 数据访问权限控制
   - 操作日志审计

3. **API开放**：
   - 提供标准化API接口
   - 支持第三方系统集成
   - Webhook事件推送

### 10.3 长期规划

1. **AI辅助决策**：
   - 车牌识别准确率优化
   - 异常行为检测(重复入场、长时间滞留)
   - 收费策略智能优化建议

2. **物联网扩展**：
   - 车位传感器集成(实时占用状态)
   - 充电桩管理与计费
   - 环境监测(温度、湿度、空气质量)

3. **数据分析平台**：
   - 自定义报表配置
   - 数据可视化大屏
   - BI商业智能分析

---

## 11. 附录

### 11.1 术语表

| 术语 | 说明 |
| :--- | :--- |
| 边缘网关 | 小区停车场的硬件控制系统，接收车辆白名单数据 |
| PMS | Parking Management System，停车管理系统 |
| 一位多车 | 一个车位可以授权给多个车牌号使用 |
| 一车多位 | 一辆车可以绑定多个固定车位 |
| 时效租赁 | 按固定周期(如月、年)收费的租赁方式 |
| 临停收费 | 针对临时进入车辆，按停留时长计费 |
| 账单状态 | 未生效、生效中、已失效，根据当前时间与有效期判断 |
| 支付状态 | 待支付、已支付、已退款、已作废 |
| 一车一账 | 为每一辆车建立完整的费用档案 |
| 全量快照 | 保存当前完整镜像，用于版本管理和历史回溯 |
| 场中场 | 商业与住宅区共用车场大门，但内部有独立区域 |
| 多场协同 | 同一物业管理下的相邻小区或一二期，资源库存影响或跨场权限共享 |
| 费用冲突 | 车辆在生效时间范围内存在待支付费用账单 |
| 批量审核 | 选择多条待审核记录，执行批量通过或批量驳回操作 |
| 超时提醒 | 当待审核记录等待时长超过设定阈值时，系统自动提醒审核人员 |
| 离场缓冲 | 支付后N分钟内免费离场 |

### 11.2 模块文档版本

| 模块 | 最新版本 |
| :--- | :--- |
| 小程序停车系统 | v1.2.0 |
| 车场管理 | v1.7.0 |
| 车位管理 | v1.4.0 |
| 收费标准 | v1.8.0 |
| 车辆管理 | v1.10.0 |
| 车辆审核 | v1.6.0 |
| 车辆收费 | v1.8.0 |
| 进出纪录 | v1.5.0 |
| 收费报表 | v1.4.0 |

---

## 12. 总结

本停车系统通过10个核心模块的有机整合，构建了一套完整的小区物业停车管理解决方案。系统严格遵循"先审核后下发"、"数据一致性"、"全量快照保存"等核心原则，实现了从住户申请到财务报表的完整业务闭环。

**核心价值**：
1. **业务闭环**：覆盖车辆管理全生命周期
2. **精细化管理**：车场、车位、车辆三级资产管理体系
3. **数据一致性**：通过边缘网关实现物业系统与硬件设备的数据同步
4. **财务透明化**：多维度的收费分析与财务报表
5. **灵活扩展**：支持多种运营模式与第三方系统集成

系统设计充分考虑了小区物业管理的实际需求，在功能完整性、操作便捷性、数据准确性等方面达到了较高水平，为物业公司提供了高效的停车管理工具。
