# 停车收费标准设置需求文档 (Parking Fee Standard)

## 修订历史

| 版本号 | 修订日期 | 修订内容 | 修订人 | 状态 |
| :--- | :--- | :--- | :--- | :--- |
| v1.0.0 | 2026-01-27 | 初始版本：梳理停车收费标准设置核心需求框架 | Antigravity | 已发布 |
| v1.1.0 | 2026-01-27 | 扩展版本：关联车场管理、增加收费模版体系、支持边缘网关下发及车位绑定设置 | Antigravity | 已发布 |
| v1.2.0 | 2026-01-27 | 完善版本：优化收费规则逻辑、细化临停计费、增加功能操作说明及同步状态提示 | Antigravity | 已发布 |
| v1.3.0 | 2026-01-27 | 细节优化：时效租赁模版支持自定义时长及单位选择（时/天/月/年） | Antigravity | 已发布 |
| v1.4.0 | 2026-01-27 | 逻辑补充：增加收费标准变更后的账单处理规则 | Antigravity | 已发布 |
| v1.5.0 | 2026-01-27 | 逻辑补充：增加访客车计费原则及默认规则缺失提醒 | Antigravity | 已发布 |
| v1.6.0 | 2026-01-29 | 逻辑优化：明确默认规则唯一性、新账单生成时机及预警交互优化 | Antigravity | 已发布 |
| v1.7.0 | 2026-01-29 | 逻辑优化：明确访客车计费逻辑一致性及扫码缴费交互要求 | Antigravity | 已发布 |
| v1.8.0 | 2026-01-29 | 功能扩展：增加系统后台手动结清访客车辆费用功能 | Antigravity | 草案 |

---

## 1. 模块概述
本模块负责小区停车收费规则的灵活配置与管理。通过建立标准化的收费模版体系（涵盖时效租赁、临停收费等），实现“一场一策”的精准计费管理。针对访客及临停车辆，系统支持移动端自主缴费与后台人工结清双通道模式，并具备配置缺失的预警能力。系统支持将配置好的收费标准通过小区边缘网关下发至底层停车控制系统，确保计费逻辑的一致性与实时性。

## 2. 功能说明

### 2.1 收费模版管理
- **功能目标**：提供多样化的计费方案配置，支持业务场景的全覆盖。
- **支持模版类型**：
  - **时效租赁**：针对长租车辆，支持按自定义周期时长及单位进行收费配置。
  - **临停收费**：针对临时进入车辆（访客车、临停车），提供组合计费逻辑（首小时免费+阶梯计时、单一费率、按次计费、分时限时等）。
  - **免费**：针对特殊车辆或特定时期的全免配置。

### 2.2 车场关联与规则约束
- **功能目标**：实现收费标准与物理车场的逻辑绑定。
- **约束规则**：
  - **唯一性（默认规则）**：每个车场**有且仅有一条**被标记为“默认”的收费规则。
  - **计费原则**：访客车辆及临停车进入车场时，系统自动识别并匹配该车场唯一的**默认收费规则**进行计费。
  - **规则配置预警（体验优化）**：
    - **触发条件**：若某车场未配置“默认收费规则”。
    - **提醒逻辑**：用户进入模块时，系统弹出可关闭的预警提醒，不阻断操作流程。
  - **筛选机制**：支持根据车场维度筛选和查看对应的收费标准列表。

### 2.3 车位绑定设置
- **功能目标**：定义收费规则在资产维度的颗粒度。
- **功能逻辑**：支持在模版层面设置“是否需要绑定车位”，开启后车辆审批/新增时车位字段必填。

### 2.4 规则下发与集成
- **功能目标**：实现配置数据向硬件/边缘侧的同步。
- **核心逻辑**：费用保存后，系统自动同步下发至小区边缘网关（Edge Gateway）并实时提示状态。

### 2.5 基础操作功能
- **列表展示、新增、修改、删除**：提供标准化的规则管理界面。

---

## 3. 需求细节

### 3.1 收费模版配置细节 (Fee Template Details)
- **时效租赁模版**：支持自定义时长及单位 [时、天、月、年]。
- **临停收费模版**：支持首小时免费+阶梯、单一费率、按次、分时/限时。支持设置24H/每日封顶及离场缓冲时长。

### 3.2 下发机制 (Distribution Mechanism)
- **同步反馈**：前端同步显示网关响应结果，失败可重试。

### 3.3 收费标准变更后的账单处理 (Billing Handling After Fee Change)
- **处理原则**：历史账单金额不变；新账单（含续费）在当前计费周期结束时按新标准生成。

### 3.4 访客车缴费与结清逻辑 (Visitor Payment & Settlement Logic)
- **移动端自主缴费**：访客车辆统一通过扫描场内/出口的“临停缴费二维码”进行移动端支付。
- **后台手动结清 (Manual Settlement)**：
  - **功能入口**：系统后台“车辆收费”管理模块。
  - **功能描述**：管理员可对指定访客车辆执行“手动结清”操作。
  - **应用场景**：适用于线下收现、特殊情况免单放行、或线上支付异常后的补录处理。
  - **结清效果**：执行后，系统将该笔临停账单标记为“已结清”，并向底层停车系统发送放行指令（受离场缓冲时长限制）。
- **账单归属**：
  - 访客费用独立核算，**严禁**与住户账单合并或平分。
- **代缴场景支撑**：住户代缴需通过扫描访客车的临停二维码完成。

---

## 4. 关联关系 (Associations)
- **车场管理**：关联车场 ID，遵循默认规则唯一性。
- **车辆/车位管理**：根据规则开关触发必填校验。
- **边缘网关 (Edge Gateway)**：作为下发和实时放行指令的传输通道。