feat: initialize managed portal

managed/store_dwell_alert/README_zh.md

@@ -0,0 +1,73 @@
+# 店内停留报警项目中文说明
+
+这个项目用于单路店内 RTSP 摄像头的人体检测、停留计时和本地 JSON 事件输出。
+
+## 功能
+
+- 基于 `YOLO11n` 的店内人员检测与跟踪
+- 停留时长统计
+- 短暂离开后重关联
+- 店员白名单排除
+- 半小时统计
+- 本地 `JSONL` 事件输出
+- 安装完成后自动启动
+- 开机自动启动
+
+## 目标机器
+
+- `Ubuntu 24.04`
+- `Python 3.12`
+- NVIDIA 显卡可用
+- `nvidia-smi` 可正常执行
+
+## 安装前需要修改
+
+先编辑 `scripts/run.sh`，至少改这几个变量：
+
+- `RTSP_URL`
+- `CAMERA_ID`
+- `EVENT_SINK_PATH`
+
+## 安装
+
+在项目根目录执行：
+
+```bash
+sudo bash scripts/install.sh
+```
+
+安装脚本会自动：
+
+- 检查并安装 `ffmpeg`
+- 检查并安装 `python3.12-venv`
+- 创建 `.venv`
+- 离线安装 `wheelhouse/` 中的依赖
+- 生成 `config/local.yaml`
+- 安装 `systemd` 服务
+- 自动启动服务
+- 设置开机自启
+
+## 服务管理
+
+服务名：
+
+```bash
+store-dwell-alert.service
+```
+
+常用命令：
+
+```bash
+sudo systemctl status store-dwell-alert.service
+sudo systemctl restart store-dwell-alert.service
+sudo systemctl stop store-dwell-alert.service
+sudo systemctl start store-dwell-alert.service
+sudo systemctl disable store-dwell-alert.service
+```
+
+## 输出位置
+
+- 运行日志：`logs/runtime.log`
+- 事件结果：`logs/events.jsonl`
+- 本地配置：`config/local.yaml`
+- 店员图库：`data/staff_gallery/`