edmur/cptm-alerts

CPTM线路状态通知工具

实时监控圣保罗地铁和火车线路状态变化，并直接发送通知到Slack频道。

!GitHub release ![Build Status]([***] !Docker Cloud Build Status !Docker Cloud Automated build !GitHub !PHP Version

!通知示例

快速开始

工作区

1. 您需要一个Slack工作区。如果没有，请创建一个。

Token获取

1. 您需要为工作区生成Token以与项目通信。
2. 为此，请在您的工作区创建App。 !工作区App
3. 创建App后，在侧边菜单进入Bot Users并为App创建Bot。
4. 创建Bot后，在侧边菜单进入OAuth & Permissions，在Scope部分授予chat:write:bot和bot权限，需重新安装App以应用权限。 !App配置
5. 保存Bot User OAuth Access Token，用于项目配置。

项目配置

通过Docker运行

• 创建容器命令：

sh
docker run --detach \
--env SLACK_KEY=your-slack-bot-oauth-key \
--env SLACK_CHANNEL=channel-name \
--env NOTIFY_LEVEL=0 \
--env NOTIFY_DAYS=all \
--env NOTIFY_LINES=all \
--restart unless-stopped \
edmur/cptm-alerts

• 替换SLACK_KEY和SLACK_CHANNEL的值；NOTIFY_LEVEL/NOTIFY_DAYS/NOTIFY_LINES为可选参数。

• 生产环境建议创建卷：

sh
docker volume create cptm_alerts_data

docker run --detach \
--env SLACK_KEY=your-slack-bot-oauth-key \
--env SLACK_CHANNEL=channel-name \
--env NOTIFY_LEVEL=0 \
--env NOTIFY_DAYS=all \
--env NOTIFY_LINES=all \
--restart unless-stopped \
--volume cptm_alerts_data:/usr/src/Storage \
edmur/cptm-alerts

本地运行

1. 克隆项目：

sh
git clone https://github.com/rumd3x/cptm-alerts.git
# 或 composer create-project rumd3x/cptm-alerts

2. 进入项目文件夹：cd cptm-alerts。
3. 安装依赖：composer install（composer创建项目无需此步骤）。
4. 创建配置文件：cp .env.example .env。
5. 编辑.env：填写SLACK_CHANNEL和SLACK_KEY。
6. 检查线路状态：php /path/to/project/run.php。
7. 自动通知：添加到cron，例如：

sh
* * * * * php /path/to/project/run.php >> /path/to/log/run.log 2>&1

环境配置

NOTIFY_LEVEL

整数，表示最低通知级别：

• 0：预期变化（运营结束/开始）
• 1：积极变化（恢复正常）
• 2：警告变化（线路延误）
• 3：危险变化（线路停运）

NOTIFY_DAYS

通知日期（逗号分隔）：

• all：每天；0=周日，1=周一...6=周六

NOTIFY_LINES

监控线路（逗号分隔）：

• all：所有线路；1=地铁1号线（蓝），2=地铁2号线（绿）...17=CPTM17号线（金）

调试

未收到通知时：

• 检查composer执行情况
• 查看cron日志或命令输出
• 查看项目日志：/path/to/project/Storage/Logs/app.log
• 检查文件/文件夹权限

待办

• 增加单元测试覆盖率
• 支持更多提供商
• 添加IFTTT Trigger支持