# 车位管理需求文档 (Parking Space Management)

## 修订历史

| 版本号 | 修订日期 | 修订内容 | 修订人 | 状态 |
| :--- | :--- | :--- | :--- | :--- |
| v1.0.0 | 2026-01-27 | 初始版本：梳理车位管理核心基础模块需求 | Antigravity | 已发布 |
| v1.1.0 | 2026-01-27 | 格式对齐与业务完善：关联车场/区域、支持一位多车、批量维护及删除校验 | Antigravity | 已发布 |
| v1.2.0 | 2026-01-29 | 业务逻辑补充：明确“一位多车”场景下的进场自动计费规则 | Antigravity | 已发布 |
| v1.3.0 | 2026-01-30 | 逻辑精细化：明确以进场时间判定占用权，首车离场方可释放位能 | Antigravity | 已发布 |
| v1.4.0 | 2026-01-30 | 计费逻辑锁定：明确溢出车辆计费不受首车离场影响，仅按进场状态判定 | Antigravity | 草稿 |

---

## 1. 模块概述
本模块核心目标是管理停车场内的具体车位资源。通过与“车场管理”模块的区域/楼层深度关联，实现车位的精细化档案管理、状态实时追踪以及车位与车辆、住户的绑定关系维护。支持多种运营场景下的车辆授权（如一位多车）。

## 2. 功能说明

### 2.1 车位档案维护
- **功能目标**：建立及维护车位的数字化身份，确保与物理空间的一致性。
- **功能项**：
  - **新增/批量新增**：支持单个录入或通过模板批量导入车位数据。
  - **编辑修改**：支持对车位编号、属性、所属区域的实时更新。
  - **删除控制 (关键校验)**：仅允许删除未绑定车辆且无有效租赁/权属关系的车位。若车位已绑定车辆，系统应拦截删除操作并提示先解除绑定。

### 2.2 车位-车辆关联 (一位多车)
- **功能目标**：灵活管理车位的使用权，不限制单车位的绑定车辆上限。
- **功能项**：
  - **白名单绑定**：支持为一个车位添加多个授权车牌，系统不设容量上限。
  - **关联信息展示**：在车位详情中展示所有已绑定的车辆及其对应的住户信息、房屋信息。

### 2.3 状态管理
- **功能目标**：实时监控车位的商业及物理状态。
- **状态定义**：空闲、已售、已租、预约中、不可用（维修/故障）。

---

## 3. 需求细节

### 3.1 车位基本信息 (Space Profile)
- **字段定义**：
  - 车位编号 (必填, 唯一)
  - **所属停车场** (关联项, 必填)
  - **所属区域/楼层** (关联项, 必填, 来源于车场管理模块)
  - 车位类型 (标准、微型、子母、充电桩)
  - 车位状态 (空闲、已售、已租、预约中、不可用)

### 3.2 权属与绑定明细 (Ownership & Bindings)
- **字段定义**：
  - **绑定车辆信息**：车牌号、车辆品牌/颜色。
  - **关联人员信息**：业主/租户姓名、联系电话。
  - **关联住户/房屋**：房屋编号 (如：1栋1单元101)。
- **显示逻辑**：点击车位可透视查看当前车位绑定的所有车辆列表，以及每辆车对应的住户身份。

### 3.3 业务校验规则
- **删除校验**：
  - 触发条件：尝试删除车位记录。
  - 校验逻辑：系统检查该车位当前绑定的车辆数量。
  - 结果：若绑定车辆数 > 0，则禁止删除并弹出警告：“该车位已绑定车辆，请先解绑后再执行删除操作。”

- **一位多车进场与计费判定 (基于进场瞬间状态锁定)**：
  - **占用判定（首车进场）**：
    - 当车位绑定的多辆车中，第一辆车（A车）进场时，若该车位处于空闲/可用状态，A车判定为“名额占用车”。
    - **收费规则**：按该车位绑定的优惠收费规则（如：包月、已售车位管理费模式）执行。
  - **溢出判定（后续车辆进场）**：
    - 当同一车位绑定的其余车辆（B、C...N车）在 A 车尚未离场时进入，判定为“溢出车辆”。
    - **收费规则**：按车场定义的**默认收费规则**（临时车计费标准）执行。
  - **计费持续性原则（不受出场影响）**：
    - **关键逻辑**：溢出车辆（B车）的计费模式在进场时即已确定。即使“名额占用车”（A车）在 B 车离场前先行出场，**B 车的计费模式不发生转变**，仍继续按默认收费规则计费直至其离场。
  - **名额释放逻辑**：
    - 车位的占用名额仅在“名额占用车”（A车）离场时释放。释放后，后续新进场的绑定车辆可重新竞争该占用名额。

---

## 4. 关联关系管理 (Associations)
- **车场管理模块**：车位必须归属于特定的“停车场”及“区域”。当车场区域发生变动时，应同步影响车位的归属路径。
- **收费标准模块**：系统需同时支持调用“车位绑定规则” and “车场默认规则”。一旦车辆进场确定计费模式，该次停车记录将锁定对应规则。
- **业主/房屋模块**：通过车辆关联，反查并展示车辆所属的住户及房屋档案信息。
- **数据版本管理原则**：
  - **全量快照保存**：任何涉及车位基本信息、状态或绑定关系的变更，系统需自动保存当前完整镜像。
  - **操作审计**：记录操作人 ID、变更时间、变更前后的差异值。