stc32g128k/Docs/10_requirements-overview/main.md

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

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

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

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 进行脏检测自检。