From ac39cde79f81ef19e91ef081b67f2e5e01f461e5 Mon Sep 17 00:00:00 2001 From: lingyunxsh Date: Tue, 9 Jun 2026 23:04:53 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E7=A4=BA=E4=BE=8B=E6=96=87?= =?UTF-8?q?=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 10 + docs/domain/README.md | 18 + docs/domain/alerts.md | 65 +++ docs/domain/app-device-control.md | 99 +++++ docs/domain/device-lifecycle.md | 99 +++++ docs/domain/hmi-dictionary.md | 128 ++++++ docs/domain/networking.md | 82 ++++ docs/products/smart-lamp-mini/README.md | 12 + docs/products/smart-lamp-mini/pdd.md | 423 ++++++++++++++++++++ docs/products/smart-lamp-mini/references.md | 51 +++ docs/views/smart-lamp-mini-role-view.md | 45 +++ 11 files changed, 1032 insertions(+) create mode 100644 docs/domain/README.md create mode 100644 docs/domain/alerts.md create mode 100644 docs/domain/app-device-control.md create mode 100644 docs/domain/device-lifecycle.md create mode 100644 docs/domain/hmi-dictionary.md create mode 100644 docs/domain/networking.md create mode 100644 docs/products/smart-lamp-mini/README.md create mode 100644 docs/products/smart-lamp-mini/pdd.md create mode 100644 docs/products/smart-lamp-mini/references.md create mode 100644 docs/views/smart-lamp-mini-role-view.md diff --git a/README.md b/README.md index 1047db7..1260df3 100644 --- a/README.md +++ b/README.md @@ -444,3 +444,13 @@ domain-rules-v1.0 ## 文档约束 每一层应该写什么、不应该写什么，以及文档之间如何引用和维护，见 [产品文档写作约束](docs/governance/document-rules.md)。 + +## 示例文档 + +第一份完整示例为 [智能小夜灯 Mini PDD](docs/products/smart-lamp-mini/pdd.md)。 + +该示例包含： + +- [通用规则层](docs/domain/README.md) +- [引用规则清单](docs/products/smart-lamp-mini/references.md) +- [角色视图](docs/views/smart-lamp-mini-role-view.md) diff --git a/docs/domain/README.md b/docs/domain/README.md new file mode 100644 index 0000000..a3853e9 --- /dev/null +++ b/docs/domain/README.md @@ -0,0 +1,18 @@ +# 通用规则层 + +本目录存放跨设备复用的 IoT 产品规则。这里的内容是单品 PDD 的引用来源，不针对某一款具体设备。 + +## 当前规则文档 + +- [HMI 全局交互字典](hmi-dictionary.md) +- [设备生命周期状态](device-lifecycle.md) +- [通用配网体验规则](networking.md) +- [App 设备控制规则](app-device-control.md) +- [通用异常与告警规则](alerts.md) + +## 使用要求 + +- 每条通用规则必须有规则编号 +- 单品 PDD 只能引用通用规则，不复制规则全文 +- 修改通用规则时必须记录影响范围 +- 废弃规则应标记为已废弃，并说明替代规则 diff --git a/docs/domain/alerts.md b/docs/domain/alerts.md new file mode 100644 index 0000000..0aec50c --- /dev/null +++ b/docs/domain/alerts.md @@ -0,0 +1,65 @@ +# 通用异常与告警规则 + +本文档定义 IoT 设备在异常情况下的通用产品体验。 + +## 适用范围 + +适用于需要向用户展示异常、限制操作或引导恢复的 IoT 设备。 + +## 规则列表 + +### 设备离线 + +规则编号：ALERT-DEVICE-OFFLINE + +产品定义：设备当前无法被 App 确认在线状态，远程控制不可用或不可确认。 + +用户感知：App 展示离线状态，并提示用户检查电源、距离或网络环境。 + +触发条件：设备进入离线不可控状态。 + +例外情况：支持本地控制的设备，应在单品 PDD 中说明本体操作是否仍可使用。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 控制失败 + +规则编号：ALERT-CONTROL-FAILED + +产品定义：用户发起控制后，设备未能完成预期状态变化。 + +用户感知：App 展示控制失败，并提供可理解的原因或重试入口。 + +触发条件：设备离线、权限不足、设备受限、状态冲突或其他导致控制未生效的情况。 + +例外情况：如果控制结果无法确认，应展示处理中或状态未知，而不是直接展示成功。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 设备过热保护 + +规则编号：ALERT-OVERHEAT-PROTECTION + +产品定义：设备因温度异常进入保护状态，限制继续使用可能带来风险的能力。 + +用户感知：App 展示设备保护中，并提示用户等待设备恢复或检查使用环境。 + +触发条件：设备进入高温保护状态。 + +例外情况：不具备温度保护能力或不存在发热风险的设备不适用。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +## 版本记录 + +| 日期 | 规则编号 | 变更 | +| --- | --- | --- | +| 2026-06-09 | ALERT-DEVICE-OFFLINE | 新增设备离线告警 | +| 2026-06-09 | ALERT-CONTROL-FAILED | 新增控制失败告警 | +| 2026-06-09 | ALERT-OVERHEAT-PROTECTION | 新增过热保护告警 | diff --git a/docs/domain/app-device-control.md b/docs/domain/app-device-control.md new file mode 100644 index 0000000..dd462b9 --- /dev/null +++ b/docs/domain/app-device-control.md @@ -0,0 +1,99 @@ +# App 设备控制规则 + +本文档定义 App 控制 IoT 设备时的通用产品体验。 + +## 适用范围 + +适用于用户可以通过 App 查看状态、发起控制或管理权限的设备。 + +## 规则列表 + +### 控制状态一致 + +规则编号：APP-CONTROL-STATE-CONSISTENCY + +产品定义：App 展示的设备状态应尽量与用户可感知的设备状态保持一致。 + +用户感知：用户在 App 中看到的开关、状态文案和设备真实表现不应产生明显冲突。 + +触发条件：用户进入设备详情页、发起控制、设备状态变化或收到共享设备状态变化。 + +例外情况：离线、弱网、OTA 升级或设备本地操作导致 App 尚未确认状态时，应展示过渡或不可确认状态。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 控制反馈 + +规则编号：APP-CONTROL-FEEDBACK + +产品定义：用户发起控制后，App 应给出明确反馈，避免用户不知道操作是否被接收。 + +用户感知：控制成功时，App 展示新的状态；控制失败时，App 展示失败原因或重试入口；状态未确认时，App 展示处理中。 + +触发条件：用户通过 App 操作开关、亮度、定时、场景或自动化。 + +例外情况：仅本体控制设备不适用。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 离线控制限制 + +规则编号：APP-CONTROL-OFFLINE-LIMIT + +产品定义：设备离线时，App 不应让用户误以为远程控制已经立即生效。 + +用户感知：用户可以看到设备离线，控制入口应被限制或明确提示不可用。 + +触发条件：设备处于离线不可控状态时，用户尝试控制设备。 + +例外情况：如果产品支持离线指令排队，应在单品 PDD 中明确说明用户预期和生效条件。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 多入口控制覆盖 + +规则编号：APP-CONTROL-MULTI-ENTRY-SYNC + +产品定义：当设备可由 App、本体按键、定时、场景或自动化等多个入口控制时，最新生效的控制结果应成为当前设备状态。 + +用户感知：用户在任一入口操作后，其他入口看到的状态应同步更新。 + +触发条件：多个控制入口先后改变同一设备状态。 + +例外情况：如果某一入口被权限、离线或安全策略限制，应展示对应限制原因。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 权限不足 + +规则编号：APP-CONTROL-PERMISSION-DENIED + +产品定义：用户没有控制权限时，App 不应允许其完成控制。 + +用户感知：用户看到权限限制说明，并知道需要联系设备拥有者或切换账号。 + +触发条件：共享用户、访客用户或未授权用户尝试执行受限操作。 + +例外情况：只读共享设备可展示状态，但不得提供有效控制入口。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +## 版本记录 + +| 日期 | 规则编号 | 变更 | +| --- | --- | --- | +| 2026-06-09 | APP-CONTROL-STATE-CONSISTENCY | 新增状态一致规则 | +| 2026-06-09 | APP-CONTROL-FEEDBACK | 新增控制反馈规则 | +| 2026-06-09 | APP-CONTROL-OFFLINE-LIMIT | 新增离线控制限制规则 | +| 2026-06-09 | APP-CONTROL-MULTI-ENTRY-SYNC | 新增多入口控制覆盖规则 | +| 2026-06-09 | APP-CONTROL-PERMISSION-DENIED | 新增权限不足规则 | diff --git a/docs/domain/device-lifecycle.md b/docs/domain/device-lifecycle.md new file mode 100644 index 0000000..2aad130 --- /dev/null +++ b/docs/domain/device-lifecycle.md @@ -0,0 +1,99 @@ +# 设备生命周期状态 + +本文档定义 IoT 设备从出厂到日常使用中的通用产品状态。 + +## 适用范围 + +适用于需要绑定、联网、远程控制或 App 管理的 IoT 设备。 + +## 规则列表 + +### 出厂未绑定 + +规则编号：DEVICE-UNBOUND + +产品定义：设备尚未绑定到任何用户账号。 + +用户感知：用户需要通过 App 添加设备后才能进行完整控制。 + +触发条件：新设备首次上电、用户重置设备，或设备被解除绑定后回到可绑定状态。 + +例外情况：不支持 App 绑定的设备不适用。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 配网中 + +规则编号：DEVICE-PAIRING + +产品定义：设备正在等待用户通过 App 完成添加、配网或绑定。 + +用户感知：App 展示添加流程，设备本体进入可识别的配网提示状态。 + +触发条件：设备进入配网模式，或用户在 App 中发起添加设备。 + +例外情况：仅本地控制设备不适用。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 在线可控 + +规则编号：DEVICE-ONLINE-CONTROLLABLE + +产品定义：设备已绑定且当前可以被 App 控制。 + +用户感知：用户可在 App 中查看设备状态，并发起控制操作。 + +触发条件：设备完成绑定，并处于可被用户控制的状态。 + +例外情况：设备处于 OTA 升级限制、故障保护或权限不足场景时，不应展示为完全可控。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 离线不可控 + +规则编号：DEVICE-OFFLINE-UNCONTROLLABLE + +产品定义：设备已绑定，但当前无法通过 App 完成远程控制。 + +用户感知：App 展示离线状态，不允许用户误以为控制已经生效。 + +触发条件：设备断电、网络不可用、距离过远或其他导致 App 无法确认控制结果的情况。 + +例外情况：设备本体按键仍可使用时，应在单品 PDD 中说明本地控制是否可用。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### OTA 升级限制 + +规则编号：DEVICE-OTA-LIMITED + +产品定义：设备正在升级，部分或全部控制能力临时不可用。 + +用户感知：App 明确展示升级中状态，并避免用户重复操作造成误解。 + +触发条件：设备进入固件升级流程。 + +例外情况：紧急关闭、断电保护等安全相关能力可由单品 PDD 另行定义。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +## 版本记录 + +| 日期 | 规则编号 | 变更 | +| --- | --- | --- | +| 2026-06-09 | DEVICE-UNBOUND | 新增出厂未绑定状态 | +| 2026-06-09 | DEVICE-PAIRING | 新增配网中状态 | +| 2026-06-09 | DEVICE-ONLINE-CONTROLLABLE | 新增在线可控状态 | +| 2026-06-09 | DEVICE-OFFLINE-UNCONTROLLABLE | 新增离线不可控状态 | +| 2026-06-09 | DEVICE-OTA-LIMITED | 新增 OTA 升级限制状态 | diff --git a/docs/domain/hmi-dictionary.md b/docs/domain/hmi-dictionary.md new file mode 100644 index 0000000..86d388d --- /dev/null +++ b/docs/domain/hmi-dictionary.md @@ -0,0 +1,128 @@ +# HMI 全局交互字典 + +本文档定义无屏 IoT 设备常用的指示灯、按键和本体反馈语言。 + +## 适用范围 + +适用于具备本体按键、指示灯或简单反馈能力的无屏设备。 + +## 规则列表 + +### 白灯常亮 + +规则编号：HMI-LIGHT-WHITE-ON + +适用范围：具备白色照明能力的灯类设备。 + +产品定义：主灯处于开启状态。 + +用户感知：用户可以直接看到设备发光。 + +触发条件：用户通过 App、本体按键、自动化、定时或其他被授权入口打开设备。 + +例外情况：设备进入故障保护、断电、离线不可控或 OTA 升级限制状态时，主灯表现以对应规则为准。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 白灯熄灭 + +规则编号：HMI-LIGHT-WHITE-OFF + +适用范围：具备白色照明能力的灯类设备。 + +产品定义：主灯处于关闭状态。 + +用户感知：用户可以直接看到设备不发光。 + +触发条件：用户通过 App、本体按键、自动化、定时或其他被授权入口关闭设备。 + +例外情况：设备断电时不等同于用户主动关闭，App 应根据设备状态区分展示。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 蓝灯慢闪 + +规则编号：HMI-LIGHT-BLUE-SLOW + +适用范围：具备蓝色状态指示灯的无屏设备。 + +产品定义：设备正在等待配网或绑定。 + +用户感知：用户可通过 App 搜索并绑定设备。 + +触发条件：设备进入配网状态。 + +例外情况：不具备独立状态指示灯的设备，应在单品 PDD 中定义替代体验。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 蓝灯急闪三次 + +规则编号：HMI-LIGHT-BLUE-FAST-3 + +适用范围：具备蓝色状态指示灯的无屏设备。 + +产品定义：设备配网或绑定失败。 + +用户感知：用户可感知当前操作未成功，需要回到 App 查看失败原因并重试。 + +触发条件：配网失败、绑定失败或用户主动取消配网。 + +例外情况：失败原因需要由 App 展示，不应仅依赖指示灯表达。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 按键短按 + +规则编号：HMI-BUTTON-SHORT-PRESS + +适用范围：具备单个本体按键的设备。 + +产品定义：用户进行一次短时按压，用于触发设备最常用的即时操作。 + +用户感知：设备应在短按后立即给出可见或可感知反馈。 + +触发条件：用户短按设备按键。 + +例外情况：设备处于配网、OTA、故障保护等限制状态时，应在单品 PDD 中说明短按是否可用。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 长按五秒 + +规则编号：HMI-BUTTON-LONG-PRESS-5S + +适用范围：具备本体按键且支持重置的设备。 + +产品定义：用户长按按键 5 秒，用于触发设备重置或进入配网准备状态。 + +用户感知：设备进入可重新绑定或重新配网的状态。 + +触发条件：用户连续按住设备按键达到 5 秒。 + +例外情况：是否清除已有绑定关系，由对应产品的绑定规则或单品 PDD 定义。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +## 版本记录 + +| 日期 | 规则编号 | 变更 | +| --- | --- | --- | +| 2026-06-09 | HMI-LIGHT-WHITE-ON | 新增灯类设备主灯开启规则 | +| 2026-06-09 | HMI-LIGHT-WHITE-OFF | 新增灯类设备主灯关闭规则 | +| 2026-06-09 | HMI-LIGHT-BLUE-SLOW | 新增配网等待状态规则 | +| 2026-06-09 | HMI-LIGHT-BLUE-FAST-3 | 新增配网失败反馈规则 | +| 2026-06-09 | HMI-BUTTON-SHORT-PRESS | 新增短按规则 | +| 2026-06-09 | HMI-BUTTON-LONG-PRESS-5S | 新增长按五秒规则 | diff --git a/docs/domain/networking.md b/docs/domain/networking.md new file mode 100644 index 0000000..214b213 --- /dev/null +++ b/docs/domain/networking.md @@ -0,0 +1,82 @@ +# 通用配网体验规则 + +本文档定义 App 管理型 IoT 设备的通用配网体验。 + +## 适用范围 + +适用于需要用户通过 App 添加、联网或绑定的设备。 + +## 规则列表 + +### 进入配网 + +规则编号：NET-PAIRING-ENTER + +产品定义：设备进入等待 App 添加的状态。 + +用户感知：设备本体应给出配网提示，App 应引导用户完成添加。 + +触发条件：新设备首次上电、用户长按重置按键，或用户在 App 中重新添加设备。 + +例外情况：设备无状态灯时，应在单品 PDD 中定义替代体验。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 配网成功 + +规则编号：NET-PAIRING-SUCCESS + +产品定义：设备完成添加、绑定并进入可管理状态。 + +用户感知：App 展示添加成功，并进入设备控制页或设备列表。 + +触发条件：设备完成用户授权下的绑定流程。 + +例外情况：如果设备添加成功但暂时不可控，App 应明确展示对应状态。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 配网失败 + +规则编号：NET-PAIRING-FAILED + +产品定义：设备未能完成添加、联网或绑定。 + +用户感知：App 展示失败原因和重试入口，设备本体给出失败提示。 + +触发条件：用户取消、设备未被发现、网络不可用、授权失败或设备状态不满足添加条件。 + +例外情况：失败原因无法判断时，App 使用通用失败提示。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +### 配网超时 + +规则编号：NET-PAIRING-TIMEOUT + +产品定义：设备进入配网流程后，如果在规定时间内未完成绑定，系统应判定为配网超时。 + +用户感知：App 展示配网失败，并提供重新配网入口。 + +触发条件：用户发起配网后，设备未在规定时间内完成绑定。 + +例外情况：具备屏幕的设备可以在屏幕端同步展示超时提示。 + +被引用产品： + +- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md) + +## 版本记录 + +| 日期 | 规则编号 | 变更 | +| --- | --- | --- | +| 2026-06-09 | NET-PAIRING-ENTER | 新增进入配网规则 | +| 2026-06-09 | NET-PAIRING-SUCCESS | 新增配网成功规则 | +| 2026-06-09 | NET-PAIRING-FAILED | 新增配网失败规则 | +| 2026-06-09 | NET-PAIRING-TIMEOUT | 新增配网超时规则 | diff --git a/docs/products/smart-lamp-mini/README.md b/docs/products/smart-lamp-mini/README.md new file mode 100644 index 0000000..1182c73 --- /dev/null +++ b/docs/products/smart-lamp-mini/README.md @@ -0,0 +1,12 @@ +# 智能小夜灯 Mini + +本目录存放智能小夜灯 Mini 的单品定义文档。 + +## 文档入口 + +- [智能小夜灯 Mini PDD](pdd.md) +- [引用规则清单](references.md) + +## 产品一句话 + +智能小夜灯 Mini 是一款面向卧室、儿童房和走廊的 App 可控小夜灯，核心能力是让用户通过 App、本体按键、定时和自动化稳定控制灯光亮灭。 diff --git a/docs/products/smart-lamp-mini/pdd.md b/docs/products/smart-lamp-mini/pdd.md new file mode 100644 index 0000000..b0543f0 --- /dev/null +++ b/docs/products/smart-lamp-mini/pdd.md @@ -0,0 +1,423 @@ +# 智能小夜灯 Mini PDD + +## 产品定位 + +智能小夜灯 Mini 是一款面向卧室、儿童房、走廊和床头场景的 App 可控小夜灯。 + +产品核心目标是让用户能够稳定、低打扰地控制小灯亮灭，并在离线、权限不足、配网失败等异常场景下获得明确反馈。 + +## 目标用户 + +- 需要夜间柔和照明的家庭用户 +- 需要远程查看和控制小灯状态的家长 +- 需要通过定时或自动化减少手动操作的用户 +- 对复杂照明设置无强需求，只需要可靠亮灭控制的用户 + +## 核心场景 + +### 床头即时控制 + +用户睡前通过 App 或本体按键打开小灯，起床后关闭小灯。 + +### 夜间照明 + +用户在夜间短暂起身时打开小灯，避免强光刺激。 + +### 儿童房看护 + +家长可以远程查看小灯当前是否开启，并在需要时打开或关闭。 + +### 定时开关 + +用户设置固定时间自动开灯或关灯，例如每天 22:30 自动关闭。 + +### 自动化联动 + +用户可将小灯加入家庭场景，例如“回家后打开走廊小灯”或“睡眠模式关闭小灯”。 + +## 功能范围 + +### 包含能力 + +- App 查看小灯当前亮灭状态 +- App 打开小灯 +- App 关闭小灯 +- 本体按键切换亮灭 +- 定时打开 +- 定时关闭 +- 自动化场景打开或关闭 +- 设备共享后的授权控制 +- 离线状态展示 +- 配网、重置、解绑后的重新添加 +- OTA 升级期间的状态限制展示 + +### 不包含能力 + +- 不支持彩色灯光 +- 不支持亮度调节 +- 不支持色温调节 +- 不支持音乐律动 +- 不支持语音播报 +- 不支持作为网关控制其他设备 + +## 设备形态与约束 + +### 物理形态 + +设备为插电式小夜灯，正面为白色柔光灯面，底部有一个本体按键，侧面有一枚蓝色状态指示灯。 + +### 安装与使用 + +- 适合插在卧室、儿童房、走廊、床头附近插座 +- 不建议用于室外、浴室淋水区或高温封闭环境 +- 用户应能在不打开 App 的情况下通过本体按键完成亮灭切换 + +### 产品约束 + +- 主灯仅表达照明亮灭，不承担复杂状态提示 +- 蓝色状态指示灯仅用于配网、失败、重置等低频状态 +- 夜间使用场景下，状态提示不得产生明显打扰 +- 设备离线时，本体按键仍可用于本地亮灭控制 + +## 引用的通用规则 + +本产品引用的完整规则清单见 [引用规则清单](references.md)。 + +主要引用： + +- [HMI 全局交互字典](../../domain/hmi-dictionary.md) +- [设备生命周期状态](../../domain/device-lifecycle.md) +- [通用配网体验规则](../../domain/networking.md) +- [App 设备控制规则](../../domain/app-device-control.md) +- [通用异常与告警规则](../../domain/alerts.md) + +## 核心状态定义 + +### 未绑定 + +遵循 [出厂未绑定](../../domain/device-lifecycle.md#出厂未绑定)。 + +引用规则：DEVICE-UNBOUND + +本产品表现：设备首次上电后进入可添加状态，蓝色状态指示灯慢闪。 + +### 配网中 + +遵循 [配网中](../../domain/device-lifecycle.md#配网中) 和 [进入配网](../../domain/networking.md#进入配网)。 + +引用规则： + +- DEVICE-PAIRING +- NET-PAIRING-ENTER +- HMI-LIGHT-BLUE-SLOW + +本产品表现：蓝色状态指示灯慢闪，主灯保持用户上一次可见状态。首次上电无历史状态时，主灯默认熄灭。 + +### 在线可控 + +遵循 [在线可控](../../domain/device-lifecycle.md#在线可控)。 + +引用规则：DEVICE-ONLINE-CONTROLLABLE + +本产品表现：用户可通过 App、本体按键、定时和自动化控制小灯亮灭。 + +### 离线不可控 + +遵循 [离线不可控](../../domain/device-lifecycle.md#离线不可控) 和 [设备离线](../../domain/alerts.md#设备离线)。 + +引用规则： + +- DEVICE-OFFLINE-UNCONTROLLABLE +- ALERT-DEVICE-OFFLINE +- APP-CONTROL-OFFLINE-LIMIT + +本产品表现：App 展示设备离线，不允许用户误以为远程亮灭控制已生效。本体按键仍可控制小灯亮灭。 + +### OTA 升级限制 + +遵循 [OTA 升级限制](../../domain/device-lifecycle.md#ota-升级限制)。 + +引用规则：DEVICE-OTA-LIMITED + +本产品表现：升级期间 App 展示升级中，亮灭控制入口临时限制。用户仍可通过断开电源停止照明，但 App 不将其展示为一次正常关闭操作。 + +## 亮灭控制规则 + +### App 打开小灯 + +引用规则： + +- [白灯常亮](../../domain/hmi-dictionary.md#白灯常亮)：HMI-LIGHT-WHITE-ON +- [控制反馈](../../domain/app-device-control.md#控制反馈)：APP-CONTROL-FEEDBACK +- [控制状态一致](../../domain/app-device-control.md#控制状态一致)：APP-CONTROL-STATE-CONSISTENCY + +产品定义：用户在 App 中点击开关打开小灯。 + +用户感知：App 开关进入开启状态，小灯亮起。 + +边界规则： + +- 在线可控时，操作应进入成功、失败或处理中三种明确结果之一 +- 设备离线时，遵循 [离线控制限制](../../domain/app-device-control.md#离线控制限制) +- 权限不足时，遵循 [权限不足](../../domain/app-device-control.md#权限不足) + +### App 关闭小灯 + +引用规则： + +- [白灯熄灭](../../domain/hmi-dictionary.md#白灯熄灭)：HMI-LIGHT-WHITE-OFF +- [控制反馈](../../domain/app-device-control.md#控制反馈)：APP-CONTROL-FEEDBACK +- [控制状态一致](../../domain/app-device-control.md#控制状态一致)：APP-CONTROL-STATE-CONSISTENCY + +产品定义：用户在 App 中点击开关关闭小灯。 + +用户感知：App 开关进入关闭状态，小灯熄灭。 + +边界规则： + +- 在线可控时，操作应进入成功、失败或处理中三种明确结果之一 +- 设备离线时，App 不展示关闭已生效 +- OTA 升级限制期间，App 展示控制暂不可用 + +### 本体按键切换亮灭 + +引用规则： + +- [按键短按](../../domain/hmi-dictionary.md#按键短按)：HMI-BUTTON-SHORT-PRESS +- [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖)：APP-CONTROL-MULTI-ENTRY-SYNC + +产品定义：用户短按设备底部按键，切换当前亮灭状态。 + +用户感知：灯灭时短按后点亮，灯亮时短按后熄灭。 + +边界规则： + +- 在线可控时，App 应更新为本体按键后的最新状态 +- 离线时，本体按键仍可使用，但 App 在恢复在线前不展示未经确认的新状态 +- OTA 升级限制期间，短按控制是否可用以 App 当前展示限制为准 + +### 定时打开或关闭 + +引用规则： + +- [控制反馈](../../domain/app-device-control.md#控制反馈)：APP-CONTROL-FEEDBACK +- [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖)：APP-CONTROL-MULTI-ENTRY-SYNC + +产品定义：用户设置指定时间自动打开或关闭小灯。 + +用户感知：到达设定时间后，小灯根据定时规则改变亮灭状态。 + +边界规则： + +- 如果设备在线，定时结果应成为最新设备状态 +- 如果设备离线，App 应展示定时可能未执行或执行结果不可确认 +- 如果多个定时在同一时间冲突，应以用户最近保存的有效定时为准 + +### 自动化场景控制 + +引用规则： + +- [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖)：APP-CONTROL-MULTI-ENTRY-SYNC +- [控制状态一致](../../domain/app-device-control.md#控制状态一致)：APP-CONTROL-STATE-CONSISTENCY + +产品定义：小灯可被用户创建的家庭场景或自动化规则打开或关闭。 + +用户感知：自动化触发后，小灯状态变化，App 设备页展示最新状态。 + +边界规则： + +- 自动化结果与手动操作冲突时，以最后生效的操作为当前状态 +- 用户手动关闭后，如果后续自动化再次打开，应展示为自动化触发后的最新状态 +- 自动化执行失败时，遵循 [控制失败](../../domain/alerts.md#控制失败) + +## 配网与重置 + +### 首次添加 + +遵循 [进入配网](../../domain/networking.md#进入配网)、[配网成功](../../domain/networking.md#配网成功)、[配网失败](../../domain/networking.md#配网失败) 和 [配网超时](../../domain/networking.md#配网超时)。 + +引用规则： + +- NET-PAIRING-ENTER +- NET-PAIRING-SUCCESS +- NET-PAIRING-FAILED +- NET-PAIRING-TIMEOUT +- HMI-LIGHT-BLUE-SLOW +- HMI-LIGHT-BLUE-FAST-3 + +本产品表现： + +- 首次上电后，蓝色状态指示灯慢闪 +- 配网成功后，App 进入设备控制页 +- 配网失败后，蓝色状态指示灯急闪三次，App 展示失败原因和重试入口 +- 配网超时后，App 展示超时结果，设备回到可重新添加状态 + +### 设备重置 + +引用规则： + +- [长按五秒](../../domain/hmi-dictionary.md#长按五秒)：HMI-BUTTON-LONG-PRESS-5S +- [进入配网](../../domain/networking.md#进入配网)：NET-PAIRING-ENTER + +产品定义：用户长按本体按键 5 秒，使设备进入重新添加状态。 + +用户感知：蓝色状态指示灯慢闪，App 可重新发现设备。 + +差异说明：本产品长按 5 秒仅进入重新添加状态，不直接承诺清除 App 账号中的历史设备记录；解绑关系以 App 操作为准。 + +差异原因：避免用户误触后失去家庭共享和定时配置。 + +## 权限与共享 + +### 拥有者 + +产品定义：设备拥有者可查看、打开、关闭、设置定时、创建自动化、共享和解绑设备。 + +### 可控制共享用户 + +引用规则： + +- [权限不足](../../domain/app-device-control.md#权限不足)：APP-CONTROL-PERMISSION-DENIED + +产品定义：被授权控制的共享用户可查看、打开和关闭小灯。 + +限制：共享用户是否可编辑定时和自动化，由家庭权限设置决定。 + +### 只读共享用户 + +引用规则： + +- [权限不足](../../domain/app-device-control.md#权限不足)：APP-CONTROL-PERMISSION-DENIED + +产品定义：只读用户可查看小灯亮灭状态，但不能执行打开、关闭、定时或自动化操作。 + +用户感知：控制入口应展示为不可用或提示权限不足。 + +## 异常与边界场景 + +### 设备离线后用户尝试开灯 + +引用规则： + +- [离线控制限制](../../domain/app-device-control.md#离线控制限制)：APP-CONTROL-OFFLINE-LIMIT +- [设备离线](../../domain/alerts.md#设备离线)：ALERT-DEVICE-OFFLINE + +产品定义：App 不发送或不承诺立即生效的开灯结果。 + +用户感知：用户看到设备离线，并获得检查电源、网络或距离的提示。 + +### 设备离线期间本体按键开灯 + +引用规则： + +- [按键短按](../../domain/hmi-dictionary.md#按键短按)：HMI-BUTTON-SHORT-PRESS +- [控制状态一致](../../domain/app-device-control.md#控制状态一致)：APP-CONTROL-STATE-CONSISTENCY + +产品定义：用户仍可通过本体按键控制小灯。 + +用户感知：本地灯光立即变化；App 在设备恢复在线前不承诺展示最新状态。 + +### App 显示开灯处理中 + +引用规则： + +- [控制反馈](../../domain/app-device-control.md#控制反馈)：APP-CONTROL-FEEDBACK + +产品定义：用户发起开灯后，App 尚未确认结果。 + +用户感知：App 展示处理中，避免用户误以为操作已经成功或失败。 + +处理结果： + +- 确认成功后展示开启 +- 确认失败后展示失败原因和重试入口 +- 结果不可确认时展示状态未知或离线 + +### 自动化与手动操作冲突 + +引用规则： + +- [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖)：APP-CONTROL-MULTI-ENTRY-SYNC + +产品定义：多个入口都能控制小灯时，以最后生效的控制结果作为当前状态。 + +示例： + +- 22:30 定时关灯 +- 用户 22:31 手动开灯 +- 当前状态应为开启 + +### 设备过热保护 + +引用规则： + +- [设备过热保护](../../domain/alerts.md#设备过热保护)：ALERT-OVERHEAT-PROTECTION + +产品定义：设备进入保护状态时，App 限制继续开灯。 + +用户感知：App 展示保护中，提示用户等待恢复或检查环境。 + +差异说明：本产品属于低功率小夜灯，过热保护为低概率异常，但仍作为安全边界保留。 + +## App 页面信息要求 + +### 设备卡片 + +应展示： + +- 设备名称 +- 当前亮灭状态 +- 在线或离线状态 +- 快捷开关入口 + +不应展示： + +- 技术连接状态细节 +- 用户无法理解的错误码 +- 与亮灭无关的复杂参数 + +### 设备详情页 + +应展示： + +- 主开关 +- 当前状态 +- 定时入口 +- 自动化入口 +- 共享与权限入口 +- 设备信息入口 + +异常状态下应展示： + +- 离线提示 +- 控制失败提示 +- OTA 升级中提示 +- 权限不足提示 + +## 通用规则差异 + +### 主灯不承载状态提示 + +通用规则：HMI-LIGHT-WHITE-ON、HMI-LIGHT-WHITE-OFF + +差异说明：本产品主灯仅表达照明亮灭，不用于表达配网、失败或告警。 + +差异原因：小夜灯主要用于夜间照明，主灯闪烁会打扰用户。 + +替代体验：状态提示由蓝色状态指示灯和 App 文案承担。 + +### 离线时保留本体控制 + +通用规则：DEVICE-OFFLINE-UNCONTROLLABLE、APP-CONTROL-OFFLINE-LIMIT + +差异说明：设备离线仅表示 App 远程控制不可用，不影响本体按键亮灭。 + +差异原因：小灯作为近距离照明设备，本地即时控制优先级高。 + +替代体验：App 展示离线，本体按键继续可用。 + +## 版本记录 + +| 日期 | 版本 | 变更 | +| --- | --- | --- | +| 2026-06-09 | v0.1 | 新增智能小夜灯 Mini 示例 PDD | diff --git a/docs/products/smart-lamp-mini/references.md b/docs/products/smart-lamp-mini/references.md new file mode 100644 index 0000000..47b7a77 --- /dev/null +++ b/docs/products/smart-lamp-mini/references.md @@ -0,0 +1,51 @@ +# 智能小夜灯 Mini 引用规则清单 + +本文档集中记录智能小夜灯 Mini PDD 引用的通用规则，便于评审和影响范围追踪。 + +## HMI 规则 + +| 规则编号 | 来源 | +| --- | --- | +| HMI-LIGHT-WHITE-ON | [白灯常亮](../../domain/hmi-dictionary.md#白灯常亮) | +| HMI-LIGHT-WHITE-OFF | [白灯熄灭](../../domain/hmi-dictionary.md#白灯熄灭) | +| HMI-LIGHT-BLUE-SLOW | [蓝灯慢闪](../../domain/hmi-dictionary.md#蓝灯慢闪) | +| HMI-LIGHT-BLUE-FAST-3 | [蓝灯急闪三次](../../domain/hmi-dictionary.md#蓝灯急闪三次) | +| HMI-BUTTON-SHORT-PRESS | [按键短按](../../domain/hmi-dictionary.md#按键短按) | +| HMI-BUTTON-LONG-PRESS-5S | [长按五秒](../../domain/hmi-dictionary.md#长按五秒) | + +## 设备状态规则 + +| 规则编号 | 来源 | +| --- | --- | +| DEVICE-UNBOUND | [出厂未绑定](../../domain/device-lifecycle.md#出厂未绑定) | +| DEVICE-PAIRING | [配网中](../../domain/device-lifecycle.md#配网中) | +| DEVICE-ONLINE-CONTROLLABLE | [在线可控](../../domain/device-lifecycle.md#在线可控) | +| DEVICE-OFFLINE-UNCONTROLLABLE | [离线不可控](../../domain/device-lifecycle.md#离线不可控) | +| DEVICE-OTA-LIMITED | [OTA 升级限制](../../domain/device-lifecycle.md#ota-升级限制) | + +## 配网规则 + +| 规则编号 | 来源 | +| --- | --- | +| NET-PAIRING-ENTER | [进入配网](../../domain/networking.md#进入配网) | +| NET-PAIRING-SUCCESS | [配网成功](../../domain/networking.md#配网成功) | +| NET-PAIRING-FAILED | [配网失败](../../domain/networking.md#配网失败) | +| NET-PAIRING-TIMEOUT | [配网超时](../../domain/networking.md#配网超时) | + +## App 控制规则 + +| 规则编号 | 来源 | +| --- | --- | +| APP-CONTROL-STATE-CONSISTENCY | [控制状态一致](../../domain/app-device-control.md#控制状态一致) | +| APP-CONTROL-FEEDBACK | [控制反馈](../../domain/app-device-control.md#控制反馈) | +| APP-CONTROL-OFFLINE-LIMIT | [离线控制限制](../../domain/app-device-control.md#离线控制限制) | +| APP-CONTROL-MULTI-ENTRY-SYNC | [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖) | +| APP-CONTROL-PERMISSION-DENIED | [权限不足](../../domain/app-device-control.md#权限不足) | + +## 异常规则 + +| 规则编号 | 来源 | +| --- | --- | +| ALERT-DEVICE-OFFLINE | [设备离线](../../domain/alerts.md#设备离线) | +| ALERT-CONTROL-FAILED | [控制失败](../../domain/alerts.md#控制失败) | +| ALERT-OVERHEAT-PROTECTION | [设备过热保护](../../domain/alerts.md#设备过热保护) | diff --git a/docs/views/smart-lamp-mini-role-view.md b/docs/views/smart-lamp-mini-role-view.md new file mode 100644 index 0000000..03a841a --- /dev/null +++ b/docs/views/smart-lamp-mini-role-view.md @@ -0,0 +1,45 @@ +# 智能小夜灯 Mini 角色视图 + +本文档是智能小夜灯 Mini 的角色阅读入口。它不创造新的产品规则，只链接到通用规则和单品 PDD。 + +## 产品团队入口 + +- 产品定位：[智能小夜灯 Mini PDD - 产品定位](../products/smart-lamp-mini/pdd.md#产品定位) +- 功能范围：[智能小夜灯 Mini PDD - 功能范围](../products/smart-lamp-mini/pdd.md#功能范围) +- 不包含能力：[智能小夜灯 Mini PDD - 不包含能力](../products/smart-lamp-mini/pdd.md#不包含能力) +- 版本记录：[智能小夜灯 Mini PDD - 版本记录](../products/smart-lamp-mini/pdd.md#版本记录) + +## 设计团队入口 + +- HMI 语言：[HMI 全局交互字典](../domain/hmi-dictionary.md) +- App 控制反馈：[App 设备控制规则](../domain/app-device-control.md) +- 亮灭控制：[智能小夜灯 Mini PDD - 亮灭控制规则](../products/smart-lamp-mini/pdd.md#亮灭控制规则) +- App 页面信息：[智能小夜灯 Mini PDD - App 页面信息要求](../products/smart-lamp-mini/pdd.md#app-页面信息要求) +- 异常与边界：[智能小夜灯 Mini PDD - 异常与边界场景](../products/smart-lamp-mini/pdd.md#异常与边界场景) + +## 硬件团队入口 + +- 设备形态与约束：[智能小夜灯 Mini PDD - 设备形态与约束](../products/smart-lamp-mini/pdd.md#设备形态与约束) +- 主灯亮灭规则：[HMI 全局交互字典 - 白灯常亮](../domain/hmi-dictionary.md#白灯常亮) +- 主灯熄灭规则：[HMI 全局交互字典 - 白灯熄灭](../domain/hmi-dictionary.md#白灯熄灭) +- 本体按键规则：[HMI 全局交互字典 - 按键短按](../domain/hmi-dictionary.md#按键短按) +- 长按重置规则：[HMI 全局交互字典 - 长按五秒](../domain/hmi-dictionary.md#长按五秒) + +## 研发团队入口 + +- 设备生命周期：[设备生命周期状态](../domain/device-lifecycle.md) +- 配网体验：[通用配网体验规则](../domain/networking.md) +- App 控制规则：[App 设备控制规则](../domain/app-device-control.md) +- 异常规则：[通用异常与告警规则](../domain/alerts.md) +- 单品差异：[智能小夜灯 Mini PDD - 通用规则差异](../products/smart-lamp-mini/pdd.md#通用规则差异) + +## 运营与客服入口 + +- 核心场景：[智能小夜灯 Mini PDD - 核心场景](../products/smart-lamp-mini/pdd.md#核心场景) +- 离线提示来源：[通用异常与告警规则 - 设备离线](../domain/alerts.md#设备离线) +- 控制失败来源：[通用异常与告警规则 - 控制失败](../domain/alerts.md#控制失败) +- 权限限制来源：[App 设备控制规则 - 权限不足](../domain/app-device-control.md#权限不足) + +## 规则清单 + +- [智能小夜灯 Mini 引用规则清单](../products/smart-lamp-mini/references.md)