# 小区原始车辆数据录入需求文档 (Initial Vehicle Data Import)

## 修订历史

| 版本号 | 修订日期 | 修订内容 | 修订人 | 状态 |
| :--- | :--- | :--- | :--- | :--- |
| v1.0.0 | 2026-05-12 | 初始版本：定义小区接入/PMS切换/车场扩建场景下的存量车辆批量录入向导，覆盖前置检查、模板解析、校验、关联补全、下发联动与批次回滚 | Antigravity | 已废弃 |
| v1.1.0 | 2026-05-12 | 范围与对接调整：①移除"物业车"导入支持；②房屋字段统一为"楼栋-单元-房号"三段式格式；③移除本模块自有的"导入批次管理"页签，全部历史与详情对接至**物业设置 - 导入日志**；④确认 5 项待办事项的最终结论（含 5000 行以上异步模式、并发单事件串行、第三方 PMS 入库不下发） | Antigravity | 已废弃 |
| v1.2.0 | 2026-05-12 | 下发策略精简：移除"仅入库不下发"这一用户可选项，下发路径由 PMS 类型**自动决定**——**自研 PMS 由业务系统主动下发到边缘网关**；**第三方 PMS 入库后由第三方系统主动拉取**，本系统不再提供策略选择 UI | Antigravity | 草稿 |

---

## 1. 目标

为**小区首次接入系统**、**PMS 切换**、**车场扩建**等场景提供一次性的存量车辆批量录入能力。完成档案写入后，自动联动收费标准、车位、住户档案与边缘网关，并将本次操作的日志统一写入 **物业设置 - 导入日志**，支持追溯、重试与回滚。

**与既有功能边界**：

| 既有能力 | 本模块新增 |
| :--- | :--- |
| 新增车辆（单条录入，见车辆管理 §2.1） | **批量导入**（Excel 模板向导式） |
| 批量下发（对已存档案再次下发） | 导入完成后**联动下发**至边缘网关 |
| 车辆审核（小程序住户申请流） | **跳过审核**直接产生 `已下发` 状态档案 |
| 访客登记 / 黑名单管理 | **不在本模块范围**（继续沿用各自入口） |
| 临停车 | 系统自动产生，**不通过本模块录入** |
| **物业车** | **不在本模块范围**（数量稀少，统一走"新增车辆"逐条录入） |

---

## 2. 模块定位

- **功能位置**：车辆管理模块下的"专项子流程"。
- **入口**：
  - 车辆管理列表顶部操作栏增加 `📥 原始车辆导入` 按钮。
  - **不在本模块内提供历史/批次入口**，统一前往"物业设置 - 导入日志"查看（详见 §4）。
- **形态**：向导式弹窗（6 步），非常驻 Tab。
- **覆盖车辆类型**：业主车、长租车、临时车、白名单（共 **4** 类，**移除"物业车"**）。

---

## 3. 核心功能需求

### 3.1 向导流程总览

```
①前置检查 → ②下载模板 → ③上传解析 → ④预览校验 → ⑤关联补全 → ⑥确认下发
```

| 步骤 | 阻断条件 | 用户主要动作 |
| :--- | :--- | :--- |
| ① 前置检查 | 缺车场 / 缺默认收费规则 / 缺边缘网关时阻断 | 查看检查项，跳转修复 |
| ② 下载模板 | 无 | 下载 Excel 模板与字段说明 |
| ③ 上传解析 | 文件不合规、行数超限 | 上传文件，等待解析（或转异步） |
| ④ 预览校验 | 存在 ❌ 错误时禁用"下一步" | 行内修正、导出错误清单 |
| ⑤ 关联补全 | 业主车/长租车未匹配到住户时阻断 | 统一指定收费标准/有效期 |
| ⑥ 确认下发 | 无 | 确认导入并联动下发 |

### 3.2 前置检查 (Step 1)

进入向导即执行三项检查，结果以三级提示呈现：

| 检查项 | 通过条件 | 不通过处理 |
| :--- | :--- | :--- |
| **车场配置** | 当前小区至少存在 1 个车场 | 🛑 红色阻断，提供"前往车场管理"跳转 |
| **默认收费规则** | 每个车场均已配置默认收费规则 | ⚠️ 黄色警告，提供"前往收费标准"跳转；可忽略继续 |
| **边缘网关** | 自研 PMS 车场的边缘网关状态为"在线" | ⚠️ 黄色警告，提示"网关离线，自研 PMS 车场的车辆档案将先入库并置为待同步，待网关恢复后由系统自动重试同步"；可继续 |
| **并发占用**（v1.1.0 新增） | 本小区当前不存在进行中的导入事件 | 🛑 红色阻断，提示当前进行中事件的操作人与开始时间 |

> **设计原则**：导入是高频但低容错的操作，前置检查避免用户在第 ⑥ 步才发现下发失败。

### 3.3 下载模板 (Step 2)

#### 3.3.1 模板列定义（v1.1.0 调整）

| 列名 | 类型 | 必填 | 校验规则 | 备注 |
| :--- | :--- | :--- | :--- | :--- |
| 车牌号 | 字符串 | 是 | 中国车牌正则 + 系统内唯一性 + 文件内唯一性 | 大小写自动转换 |
| 车辆类型 | 枚举 | 是 | **业主车 / 长租车 / 临时车 / 白名单**（4 类） | 不支持物业车、访客车、黑名单 |
| 业主姓名 | 字符串 | 业主车/长租车必填 | 必须与房屋全称在住户档案中**精确匹配** | 白名单填授权单位名称 |
| **房屋全称** | 字符串 | 业主车/长租车必填 | 格式严格为 **`楼栋-单元-房号`**（如 `1-2-101`） | 三段式，缺一不可 |
| 联系电话 | 字符串 | 否 | 11 位手机号格式 | 校验仅作警告 |
| 所属车场 | 字符串 | 是 | 必须为本小区已配置车场名称 | 留空时可在 Step ⑤ 统一指定 |
| 收费标准 | 字符串 | 否 | 必须为本小区已配置标准名称 | 留空时可在 Step ⑤ 按类型统一指定 |
| 绑定车位 | 字符串 | 条件必填 | 当选用"需绑定车位"的收费规则时必填 | 校验车位存在且未被占用 |
| 有效期起 | 日期 | 是 | YYYY-MM-DD | |
| 有效期止 | 日期 | 否 | YYYY-MM-DD，需晚于"有效期起" | 留空表示长期有效（业主车默认场景） |
| 备注 | 字符串 | 否 | ≤ 200 字符 | |

> **房屋全称格式说明**：采用"`楼栋-单元-房号`"三段式（示例：`1-2-101` 表示 1 栋 2 单元 101 房），与住户档案的房屋唯一标识对齐。任意一段缺失视为格式错误。（注：房屋全称里楼栋-单元-房号，有些小区可能不存在单元）

#### 3.3.2 模板辅助资料

- 模板首行：列名 + 必填标记
- 模板第二行：示例数据（注释行，导入时自动跳过）
- 同时提供下载：
  - **字段说明文档**（PDF）
  - **本小区已配置的车场 / 收费标准 / 房屋全称清单**（供物业线下填写时参考，房屋清单同样输出三段式全称）

### 3.4 上传解析 (Step 3)

#### 3.4.1 上传限制与执行模式（v1.1.0 调整）

| 项 | 阈值 | 处理 |
| :--- | :--- | :--- |
| 文件格式 | `.xlsx` / `.xls` | 强校验，不符则拒绝 |
| 文件大小 | ≤ 10 MB | 超限拒绝 |
| 数据行数 ≤ 5000 行 | — | **同步模式**：前端解析 + 后端二次校验，进度条实时展示 |
| 数据行数 5000 ~ 20000 行 | — | **异步模式**：转后台异步任务，弹窗可关闭，处理结果通过站内消息通知 + 写入物业设置-导入日志 |
| 数据行数 > 20000 行 | — | 拒绝，提示拆分文件分批导入 |

#### 3.4.2 异步模式说明（v1.1.0 新增）

| 项 | 说明 |
| :--- | :--- |
| 触发条件 | 文件行数 > 5000 |
| 用户体验 | 上传完成后提示"任务已提交至后台，可关闭弹窗，处理完成后将通过消息中心通知"；用户可立即关闭弹窗或继续其他工作 |
| 处理位置 | 服务端异步队列，单小区串行（参考 §3.2 并发校验） |
| 进度查询 | 在物业设置-导入日志中可见任务状态：`排队中` / `解析中` / `校验中` / `待处理`（需要预览修正）/ `下发中` / `已完成` / `失败` |
| 校验交互 | 异步模式下若存在 ❌ 错误，任务停在 `待处理`，用户点击日志详情进入与 Step ④ 相同的预览校验页继续操作 |
| 通知 | 关键节点通过站内消息、SMS 或邮件（按物业通知偏好）通知操作人 |

#### 3.4.3 异常处理

| 场景 | 处理 |
| :--- | :--- |
| 文件格式不符 | 终止上传，提示重新选择 |
| 列名缺失或乱序 | 提示"请使用最新模板"，提供模板下载链接（模板版本兼容由技术层处理，详见 §9） |
| 行数超限（>20000） | 提示拆分文件 |
| 整列空白 | 自动跳过，预览页提示 |

### 3.5 预览校验 (Step 4)

#### 3.5.1 顶部统计区

```
总数 N    ✅ 通过 X    ⚠️ 警告 Y    ❌ 错误 Z
```

提供筛选 Tab：`全部 / 仅通过 / 仅警告 / 仅错误`。

#### 3.5.2 行级状态判定

| 状态 | 触发条件 | 是否阻断 |
| :--- | :--- | :--- |
| ✅ 通过 | 全部校验通过 | 否 |
| ⚠️ 警告 | 选填字段格式异常、有效期偏短、电话号码不合规等 | 否 |
| ❌ 错误 | 必填缺失、车牌冲突、住户匹配失败、车位被占等 | **是**（不允许下一步） |

#### 3.5.3 校验维度清单

**A. 车牌唯一性校验**

| 冲突场景 | 处理 |
| :--- | :--- |
| 与系统现有有效档案冲突 | ❌ 错误：「该车牌已登记为 [车主/物业]，请检查」 |
| 文件内重复 | ❌ 错误：「文件内第 X 行、第 Y 行车牌重复」 |

**B. 住户匹配校验（严格匹配，v1.1.0 调整）**

> 业主车/长租车的"业主姓名 + 房屋全称（`楼栋-单元-房号`）"组合必须在住户档案中精确存在。

| 场景 | 处理 |
| :--- | :--- |
| 姓名 + 房屋全称 精确匹配 | ✅ 通过 |
| 房屋全称格式不合规（非三段式） | ❌ 错误：「房屋全称格式应为 `楼栋-单元-房号`（如 1-2-101）」 |
| 房屋全称存在但姓名不符 | ❌ 错误：「房屋 [1-2-101] 当前住户为 [张三]，与导入数据 [李四] 不一致」 |
| 房屋全称不存在 | ❌ 错误：「房屋 [X-Y-Z] 在住户档案中不存在，请先在业主管理模块补全档案」 |

**C. 关联资源校验**

| 字段 | 校验内容 |
| :--- | :--- |
| 所属车场 | 必须存在于车场管理；自研 PMS 车场需提示边缘网关状态；第三方 PMS 车场允许通过但不下发（详见 §3.7） |
| 收费标准 | 必须存在于收费标准模块；校验"是否需绑定车位"标记 |
| 绑定车位 | 必须存在且当前未被占用 |
| 有效期 | 起始 ≤ 截止；起始日期不晚于当前日期 + 7 天 |

#### 3.5.4 行内编辑能力

- 错误行支持**就地编辑**关键字段（车牌、姓名、房屋全称、车场、收费标准、车位、有效期）
- 编辑后实时重新校验该行
- 顶部"导出错误清单"按钮：下载仅含错误行的 Excel，便于线下补录后重新上传

### 3.6 关联补全 (Step 5)

针对模板中**未填写但允许统一指定**的字段进行批量赋值，避免逐行填写。

#### 3.6.1 可批量指定项（v1.1.0 调整）

| 字段 | 赋值粒度 | 默认建议 |
| :--- | :--- | :--- |
| 所属车场 | 全量 / 按车辆类型 | 单车场小区默认填充唯一车场 |
| 收费标准 | **按车辆类型分别指定（4 类）** | 业主车 → 业主月卡；长租车 → 长租月卡；临时车 → 临时车按时计费；白名单 → 白名单免费 |
| 有效期止 | 按车辆类型 | 业主车长期；长租车起始日 + 12 个月；临时车起始日 + 2 年；白名单按需 |

#### 3.6.2 阻断校验

- 若仍存在业主车/长租车未匹配到住户，**不允许进入 Step ⑥**，提示返回 Step ④ 修正。
- 若选定的收费规则需绑定车位但仍有空车位字段，提示返回 Step ④ 补全。

### 3.7 确认下发 (Step 6)

#### 3.7.1 下发路径（v1.2.0 重写）

下发路径由车辆所属车场的 PMS 类型**自动决定**，**不向用户提供策略选择 UI**：

| 车场 PMS 类型 | 下发路径 | 触发方 | 档案初始状态 |
| :--- | :--- | :--- | :--- |
| **自研 PMS** | 业务系统主动调用边缘网关白名单下发接口 | **本业务系统**（推） | `下发中` → 成功 `已同步` / 失败 `同步失败` |
| **第三方 PMS** | 业务系统仅完成档案入库，**不主动推送**；由第三方系统按既有对接机制自行拉取 | **第三方 PMS**（拉） | `等待外部同步`（终态由第三方系统决定，本系统不更新） |

#### 3.7.2 关键规则

| 规则 | 说明 |
| :--- | :--- |
| **无策略选择** | 用户在 Step ⑥ 不再看到"立即下发 / 仅入库"等单选项，仅展示按车场预计的执行计划 |
| **网关离线兜底** | 自研 PMS 车场若网关离线，档案仍正常写入并置为 `待同步`，由系统重试队列自动同步，无需用户决策 |
| **第三方拉取不可见** | 本系统不感知第三方系统的拉取结果，状态保持 `等待外部同步`；如需追溯请前往第三方 PMS 控制台 |
| **混合车场批次** | 若一个批次同时包含自研与第三方 PMS 车场的车辆，系统按车辆所属车场分别走对应路径 |

#### 3.7.3 执行进度

分两阶段，独立进度条：

```
[阶段 1] 档案写入   ████████░░  800 / 1000
[阶段 2] 网关同步   ███░░░░░░░  300 / 700   （仅自研 PMS 车辆纳入分母；第三方 PMS 车辆不参与）
```

#### 3.7.4 失败处理

| 类型 | 处理 |
| :--- | :--- |
| 档案写入失败（如并发冲突） | 标记该行失败，继续处理后续行；完成后展示失败明细 |
| 自研 PMS 网关同步失败 | 标记 `同步失败`，自动重试 3 次（间隔 30s / 2min / 5min）；仍失败则进入车辆管理的"同步失败"队列，支持手动重试 |
| 自研 PMS 网关离线（全部失败） | 档案保留，状态置为 `待同步`；网关恢复后系统自动重试 |
| 第三方 PMS 拉取异常 | 本系统不感知；档案保持 `等待外部同步`，由物业自行在第三方系统排查 |

#### 3.7.5 完成页

展示：
- 批次号、操作人、起止时间
- 总数 / 成功写入 / 写入失败
- 自研 PMS：同步成功 / 同步失败 / 待同步
- 第三方 PMS：等待外部同步（数量）
- 三个操作入口：`前往物业设置-导入日志查看` / `再次导入` / `关闭`

---

## 4. 对接物业设置 - 导入日志（v1.1.0 重写）

本模块**不再维护独立的"导入批次"页签**。所有原始车辆导入的历史记录与详情，统一对接至 **物业设置 - 导入日志**模块。

### 4.1 写入契约

每次导入事件（无论是否成功完成）都会向"物业设置 - 导入日志"产生一条记录。

#### 4.1.1 列表层级字段（本模块产出）

| 字段 | 说明 |
| :--- | :--- |
| 业务来源 | 固定值：`停车-原始车辆导入` |
| 批次号 | `IMPORT-VEHICLE-YYYYMMDD-NNNN` |
| 操作人 | 物业操作员账号 |
| 操作小区 | 当前所在小区 |
| 提交时间 | 进入向导时间 |
| 完成时间 | 全部阶段结束时间（异步模式下含队列等待） |
| 执行模式 | `同步` / `异步` |
| 任务状态 | `排队中` / `解析中` / `校验中` / `待处理` / `下发中` / `已完成` / `失败` / `已回滚` |
| 总数 | 数据行总数 |
| 成功 / 失败 | 档案写入结果 |
| 同步成功 / 同步失败 / 等待外部同步 | 网关下发结果 |
| 来源说明 | 用户在 Step ⑥ 标注：`初始化导入` / `PMS 切换` / `车场扩建` |

#### 4.1.2 详情层级字段（本模块产出）

详情页由"物业设置-导入日志"模块统一渲染框架，本模块仅负责提供数据：

| 数据块 | 内容 |
| :--- | :--- |
| 概要 | 列表所有字段 + 文件名 + 文件大小 + Excel 模板版本号 |
| 行级明细 | 每行：行号、车牌、车辆类型、业主姓名、房屋全称、所属车场、收费标准、绑定车位、有效期、写入状态、同步状态、失败原因 |
| 操作记录 | 重试记录、回滚记录、补发同步记录（每次操作的时间、操作人、影响行数） |
| 附件 | 原始上传文件（可下载）、错误清单（仅含失败行） |

### 4.2 操作回流

"物业设置 - 导入日志"详情页支持的操作，本模块需提供对应能力：

| 操作 | 触发条件 | 本模块响应 |
| :--- | :--- | :--- |
| **查看车辆档案** | 单行操作 | 跳转至车辆管理详情页 |
| **单条重新下发** | 任意已写入但同步失败的行 | 调用边缘网关下发接口（仅自研 PMS） |
| **补发同步**（批次级） | 批次内存在同步失败行 | 批量重试该批次所有同步失败行 |
| **整批回滚** | 同时满足下方 §4.3 条件 | 软删除批次内全部车辆档案 + 同步撤销白名单 |

### 4.3 整批回滚约束

仅允许回滚同时满足以下条件的批次：

| 条件 | 说明 |
| :--- | :--- |
| 批次内**所有车辆**均未产生通行记录 | 一旦有车辆已进出场，回滚会破坏进出记录完整性 |
| 批次内**所有车辆**均无关联账单 | 已生成账单需先在车辆收费模块作废 |
| 操作时间在批次完成后 **7 天内** | 防止历史批次误操作 |

回滚效果：

- 批次内所有车辆档案 **软删除**（参考车辆管理 §2.7 删除清理逻辑）
- 同步下发"撤销白名单"指令至边缘网关
- "物业设置-导入日志"中该批次状态置为 `已回滚`，不可二次回滚

### 4.4 跨模块协议要点

| 项 | 约定 |
| :--- | :--- |
| 数据所有权 | 列表与详情的展示由"物业设置-导入日志"负责；行级业务数据由本模块提供 |
| 接口风格 | RESTful，业务来源标识 `parking-initial-import` |
| 状态同步 | 任务状态变更（如同步失败累计 ≥ 10 条）需实时回写至日志记录 |
| 权限 | "物业设置-导入日志"的查看/操作权限独立配置，与本模块不强绑定 |

---

## 5. 外部模块关联

| 关联模块 | 关联方式 | 关键约束 |
| :--- | :--- | :--- |
| **车场管理** (02) | 必选关联；校验 PMS 类型 / 边缘网关状态 | 路径由 PMS 类型自动决定：自研 PMS 由本系统主动下发；第三方 PMS 由对方系统主动拉取 |
| **收费标准** (04) | 必选关联；按车辆类型在 Step ⑤ 批量赋值 | 校验"是否需绑定车位"标记；变更时遵循"历史账单不变"原则 |
| **车位管理** (03) | 选填；选中后车位状态置为 `已占用` | 占用冲突时报错（参考车位统计规则 v1.8.0） |
| **车辆管理** (05) | 写入目标模块；批次号写入档案 `创建来源` 字段 | **跳过审核**直接产生 `已下发` 状态档案；遵循唯一性原则 |
| **车辆审核** (06) | **不经过审核** | 物业 PC 端操作不需要审核 |
| **住户档案** (业主管理模块) | 严格匹配（姓名 + 房屋全称三段式） | 匹配不到 ❌ 阻断；不在本模块创建住户 |
| **边缘网关** | 调用"白名单下发"接口（参考车场管理 §4.2） | 失败重试 3 次；超时进入"同步失败"队列 |
| **物业设置 - 导入日志**（v1.1.0 新增） | 写入批次记录与行级明细；接收回流操作 | 所有历史查询、详情、回滚操作的唯一入口 |

---

## 6. 数据流

```
【导入流程】
Excel 模板 → 上传解析 → 前端预校验 → 后端二次校验
                                            ↓
                          ┌─────────────────┴─────────────────┐
                          ↓                                   ↓
                  写入车辆档案 (车辆管理)              更新车位占用 (车位管理)
                          ↓
                  生成批次记录                         同步写入
                  ────────────────────────────────→  物业设置-导入日志
                          ↓
                  ┌───────┴───────────────┐
                  ↓                       ↓
       自研 PMS：业务系统下发      第三方 PMS：等待对方拉取
       (本系统主动 PUSH 网关)       (本系统不主动 PUSH)
                  ↓                       ↓
            边缘网关                状态 `等待外部同步`
                  ↓                  (终态由第三方决定)
            状态 `已同步`
                  ↓
            (失败) 重试队列 ─────────────→ 状态回写到日志
```

---

## 7. 业务规则

### 7.1 唯一性与查重

- 沿用车辆管理 §2.1 唯一性原则：系统内一个车牌号只能存在一条有效档案。
- 本模块在 Step ④ 实时执行查重，**不允许导入冲突车牌**。

### 7.2 跳过审核的依据

- 本模块仅在 **PC 端** 由物业操作员发起，对应车辆审核模块开发备注中的"PC 端物业直接操作不需要审核"。
- 小程序端住户提交的申请仍走车辆审核流程。

### 7.3 房屋全称格式（v1.1.0 新增）

- 全系统统一采用 `楼栋-单元-房号` 三段式（如 `3-1-1502`）。
- 模板、校验、详情展示、日志输出均遵循该格式。
- 与住户档案、楼栋管理等模块的字段对齐。

### 7.4 有效期与道闸约束

- 沿用车辆管理 §2.2：
  - 进场限制：道闸仅在有效期范围内允许进场。
  - 出场不限制有效期。

### 7.5 数据来源标记

- 本模块写入的所有车辆档案，`创建来源` 字段统一标记为 `初始化导入`，并记录 `批次号`。
- 后续在车辆管理详情页可见，作为追溯与回滚依据。

### 7.6 并发控制（v1.1.0 调整）

- **同一小区同一时间仅允许存在 1 个进行中的导入事件**（含异步队列中的任务）。
- 前置检查 Step ① 显式校验，被占用时阻断并提示当前事件操作人。
- 跨小区互不影响。

### 7.7 不支持的场景

| 场景 | 处理建议 |
| :--- | :--- |
| 物业车批量导入（v1.1.0 移除） | 数量稀少，统一走"新增车辆"逐条录入 |
| 访客车批量预报备 | 走车辆管理的"登记访客"入口（参考车辆管理 §2.3） |
| 黑名单批量导入 | 走车辆管理的"加入黑名单"入口（参考车辆管理 §2.6） |
| 临停车录入 | 系统自动产生，无需录入 |
| 跨小区车辆同步 | v1.1 不支持，需分别导入 |

---

## 8. 消息提醒

| 触发场景 | 接收方 | 内容 |
| :--- | :--- | :--- |
| 异步任务进入处理 | 操作人 | 「批次 IMPORT-VEHICLE-XXXX 已开始处理，预计 X 分钟」 |
| 异步任务需要人工修正 | 操作人 | 「批次 IMPORT-VEHICLE-XXXX 存在 N 条错误，请前往物业设置-导入日志处理」 |
| 导入完成 | 操作人 | 「批次 IMPORT-VEHICLE-XXXX 已完成：成功 X 条，失败 Y 条」 |
| 同步失败累计 ≥ 10 条 | 操作人 + 物业管理员 | 「批次 IMPORT-VEHICLE-XXXX 同步失败 N 条，请检查边缘网关状态」 |
| 整批回滚 | 操作人 | 「批次 IMPORT-VEHICLE-XXXX 已回滚，N 条车辆档案已撤销」 |

---

## 9. 已确认事项（原"待确认事项"，v1.1.0 收敛）

| # | 问题 | 结论 |
| :--- | :--- | :--- |
| 1 | Excel 模板版本管理 | **由技术层处理**：模板内嵌版本号，后端识别旧版本并自动按映射兼容；PRD 不再约束具体策略 |
| 2 | 自研 / 第三方 PMS 的下发路径 | **下发路径按车场 PMS 类型自动决定，不向用户暴露策略选项**：自研 PMS 由业务系统主动下发到边缘网关；第三方 PMS 入库后由第三方系统主动拉取（详见 §3.7.1） |
| 3 | 导入并发 | **同一小区同时只能存在 1 个导入事件**；跨小区互不影响（详见 §7.6） |
| 4 | 大数据量场景 | **5000 行以上转后台异步导入模式**；20000 行以上拒绝并要求拆分（详见 §3.4） |
| 5 | 回滚 7 天窗口 | 维持 7 天；后续如需突破由产品评审决定，不在 v1.1 范围 |

---

## 10. 关联文档

- 02_车场管理_v1.7.0.md（车场配置、边缘网关、自研 PMS）
- 03_车位管理_v1.4.0.md（车位占用与冲突）
- 04_收费标准_v1.8.0.md（收费规则下发、本地计费引擎）
- 05_车辆管理_v1.10.0.md（车辆档案、唯一性、有效期、下发逻辑）
- 06_车辆审核_v1.6.0.md（审核流程边界）
- 10_设备管理_v1.0.0.md（边缘网关与设备组）
- 物业设置 - 导入日志模块（待立项，本模块提供数据契约）