# 总体需求 (docs/10_requirements-overview/main.md)

## 1. 项目整体框架与系统拓扑

本项目构建一套以 **IPC 摄像头**为中枢、**手环**为随身告警终端、多类 **433MHz 传感器**为探测前端的本地安防联动系统，同时通过 WiFi 连接云端，向手机 APP 发送推送通知。

```mermaid
graph TD
    Sensor[433MHz 传感器] -->|433MHz 射频信号| IPC[IPC 摄像头]
    Sensor -->|433MHz 射频信号| Wristband[随身手环]
    IPC -->|WiFi / LAN| Cloud[云端推送服务]
    Cloud -->|推送通知| App[手机 APP]
```

## 2. 核心信号流向与行为要求

1. **传感器触发**：探测到异常时（如门磁打开、烟雾浓度超标），发射固定编码信号（24位 EV1527 协议数据，包含 20位地址码 + 4位数据码）。
2. **手环与 IPC 独立接收**：IPC 和手环各自配备 433MHz 接收解调芯片，分别独立解码，互不依赖。
3. **终端响应行为**：
    *   **IPC 摄像头端**：解码成功后，TFT LCD 屏幕显示报警 ICON、闪光报警，并通过网关向云端推送手机通知。
    *   **手环端**：解码成功后，OLED 屏幕显示报警 ICON + 传感器自定义名称，多色 LED 亮起对应颜色，且马达触发特定振动模式。

## 3. 协作规范与门禁说明
本项目的开发协作基于《开发规范.md》定义的“七个环节”。任何目录下文件的修改应当保证其依赖项是同步的。
在每次完成阶段性工作或代码调整后，应运行 `bash .xagent/check-dirty.sh` 进行脏检测自检。