# 车场管理需求文档 (Parking Lot Management)

## 修订历史

| 版本号 | 修订日期 | 修订内容 | 修订人 | 状态 |
| :--- | :--- | :--- | :--- | :--- |
| 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-29 | 逻辑强化：细化准入控制逻辑，明确外部车辆限制规则 | Antigravity | 已发布 |
| v1.6.0 | 2026-01-29 | 规则定义：明确已登记车辆分类及黑名单/未登记车辆拦截逻辑 | Antigravity | 已发布 |
| v1.7.0 | 2026-01-30 | 访客与道闸细节：细化访客车有效期逻辑及道闸限进不限出规则 | Antigravity | 草稿 |

---

## 1. 模块概述
本模块核心目标是建立停车场的数字化基础模型。针对**小区物业管理**场景，管理停车场、区域及楼层的静态配置与运营规则，支持独立、嵌套（场中场）、协同等多种物业运营模式，并实现与物业常用第三方停车管理系统的对接。

## 2. 功能说明

### 2.1 基础资料维护
- **功能目标**：建立小区停车资产的档案。
- **功能项**：
  - **车场档案创建**：支持新增、编辑、删除停车场基础信息。
  - **层级架构定义**：支持在一个车场下划分多个逻辑区域或物理楼层。
  - **库存同步**：支持从车位模块实时同步或手动维护总泊位数量。

### 2.2 运营模式配置
- **功能目标**：根据小区实际地理及业务环境，灵活配置车场间的逻辑关系。

### 2.3 访客车辆管理 (Visitor Management)
- **功能目标**：支持业主或物业对来访车辆进行预报备。
- **功能项**：
  - **访客报备**：录入来访车牌号、来访日期段。
  - **信息变更**：支持在有效期内变更来访车辆的车牌号等基础信息。

---

## 3. 需求细节

### 3.1 停车场信息管理 (Lot Profile)
- **功能描述**：管理小区内停车场的全局基本配置及准入逻辑。
- **核心字段与逻辑**：
  - **外部车辆准入**：设置是否允许外部车辆进入小区（开关：是/否）。
    - **车辆分类定义**：
      - **系统已登记车辆**：业主车、租赁车、临时车（已登记）、访客车、白名单、黑名单。
      - **系统未登记车辆**：即未在系统中留存信息的临停车辆。
    - **准入逻辑 (Entry Logic)**：
      - **是（开启）**：允许除“黑名单”以外的所有车辆进入。
      - **否（关闭）**：仅限**已登记且非黑名单**的车辆放行。**访客车**作为已登记车辆，在“关闭准入”时依然允许放行。
  - **道闸通行规则**：
    - **限进规则**：车辆进场时，必须处于系统的**有效期范围内**才允许开闸。
    - **不限出规则**：道闸**不限制**车辆出场的有效期。即便车辆出场时已超过其登记的有效期，也应允许出场（具体缴费逻辑由收费模块处理）。

### 3.2 访客车专项逻辑 (Visitor Vehicle Logic)
- **有效期定义**：
  - **管理有效期**：以“来访日期的日期段”为准（例如：2026-01-30 至 2026-01-31），不限制具体小时分钟。在此日期段内的任意时间点均可首次进场。
  - **收费有效期**：计费以车辆的“真实进场时间”与“真实出场时间”为准，不受日期段限制。
- **灵活性要求**：
  - 支持在有效期内，因访客变更车辆等原因，修改已登记的访客车牌号信息。

### 3.3 区域与楼层管理 (Area/Floor Management)
- **详细字段**：
  - 区域名称、所属停车场、区域总泊位数、区域属性 (业主专用、访客专用、共用)

### 3.4 运营模式管理 (Operation Mode Management)
- **支持模式**：独立运营、场中场运营（商业+住宅）、多场协同运营。

### 3.5 关联关系管理 (Associations)
- **关联项**：
  - **车位模块**：关联具体的车位明细数据。
  - **收费标准**：关联计费规则（访客车收费根据实际停放时长计算）。
  - **设备配置**：关联道闸、识别相机。