NFC 模板
模块状态： 平台侧的 NFC 模板配置页已可用。配套的 NFC 手机 App 集成仍在开发中，部分字段与端到端行为可能在后续版本中调整。
NFC 模板把已有的物模型与一条读 RPC、一条写 RPC绑定为一个可复用的配置。具备 NFC 能力的手机 App 即可据此从 NFC 标签读取设备参数、并把新参数写回，复用平台已有的数据解析（物模型）与指令编码（RPC）逻辑——无需与设备建立实时 LoRaWAN 会话。
配置入口位于 模型管理 → NFC 模板。
1. 概念
一个 NFC 模板把三个构件绑定在一起：
| 绑定 | 作用 |
|---|---|
| 物模型（必填） | 把从 NFC 标签读到的原始字节解析为标准化属性，并作为待写入参数的数据结构。 |
| 读 RPC（可选） | 编码 App 向标签发起读取请求的字节帧，和/或解码读回的内容。 |
| 写 RPC（可选） | 编码 App 写回标签以更新设备参数的字节帧。 |
由于物模型与 RPC 脚本只需在平台上编写一次，同一套解析与编码逻辑即可在 LoRaWAN 上/下行与 NFC 读/写之间复用，无需在手机 App 中重复实现字节级逻辑。
2. 新建 NFC 模板
- 进入 模型管理 → NFC 模板 → 新增。
- 填写下列字段后点击确定保存。
| 字段 | 必填 | 说明 |
|---|---|---|
| ID | — | 保存时自动生成，只读。 |
| 名称 | 是 | 模板的可读名称。 |
| 描述 | 否 | 关于模板用途的自由文本备注。 |
| 物模型 | 是 | 用于解析 NFC 读到的数据、并约定待写入参数结构的物模型。 |
| 读 RPC | 否 | 其脚本负责编码 NFC 读取请求 / 解码响应的 RPC。 |
| 写 RPC | 否 | 其脚本负责编码通过 NFC 写回设备参数的 RPC。 |
列表页展示每个模板的名称、描述、绑定物模型、读 RPC、写 RPC 及最后更新时间，并支持按名称、物模型或 RPC 搜索。
3. 不依赖设备测试脚本
NFC 场景通常没有实时设备上下文——App 只想确认某个物模型或 RPC 脚本能否正确解析输入。为此，RPC 模型与物模型编辑器的测试操作支持 skipDeviceCheck 标志：
- 当
skipDeviceCheck为 true 时，平台不再到设备缓存中查找设备，而是注入一个合成的占位设备（eui = "__empty__"，归属当前租户），即使输入的 EUI 没有匹配到真实设备也能完成测试。 - 当
skipDeviceCheck为 false 时（常规 RPC/物模型测试的默认值），平台仍要求设备存在，否则返回Device not found。
借此即可在接入物理标签前，用样例输入验证 NFC 模板所绑定的脚本。
4. 接口
所有接口均为租户范围，遵循标准的列表表约定：
| 方法 | 路径 | 用途 |
|---|---|---|
POST | /nfc-template/find-page | 分页查询 NFC 模板。 |
POST | /nfc-template/batch-save-update | 新增或更新一个/多个模板（{ dataList: [...] }）。 |
POST | /nfc-template/batch-delete-by-ids | 按 ID 删除模板（{ ids: [...] }）。 |
NFC 手机 App 的读/写流程仍在开发中。本页仅说明平台侧的模板配置；设备端的 NFC 交互将在该集成完成后补充。