添加示例文件

docs/products/smart-lamp-mini/README.md

@@ -0,0 +1,12 @@
+# 智能小夜灯 Mini
+
+本目录存放智能小夜灯 Mini 的单品定义文档。
+
+## 文档入口
+
+- [智能小夜灯 Mini PDD](pdd.md)
+- [引用规则清单](references.md)
+
+## 产品一句话
+
+智能小夜灯 Mini 是一款面向卧室、儿童房和走廊的 App 可控小夜灯，核心能力是让用户通过 App、本体按键、定时和自动化稳定控制灯光亮灭。

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 |

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#设备过热保护) |