添加示例文件

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 | 新增权限不足规则 |