# M-BRIDGE 中继桥接服务
## 光湖四节点架构·神经连接层
广播编号：BC-M-BRIDGE-001-FM
开发者：DEV-002 肥猫（HoloLake Human Bridge）
版本：v1.0
技术栈：Node.js + Express + JSON持久化 + HTTP健康探测

### 模块定位
光湖四节点（Notion/GitHub/guanghulab.com/钉钉）的神经连接层，负责所有节点间的数据流转、Webhook接收、状态聚合与健康检查。

### 核心功能
1. 基础Express服务（端口3020），提供模块身份查询接口
2. 接收GitHub/SYSLOG Webhook推送，实现事件路由与持久化
3. 聚合所有注册节点状态，提供3秒超时健康探测
4. 事件日志持久化与自动清理（30天），支持多条件查询
5. 统一配置管理，敏感信息占位符隔离

### 配置文件
- 配置路径：`config.json`
- 包含项：端口、日志路径、节点注册表、事件保留天数、敏感信息占位符
- 注意：**敏感信息请勿推送到GitHub**，仅在本地配置真实值。

### 快速启动
1. 进入模块目录：`cd guanghulab/backend/bridge`
2. 安装依赖：`npm install`
3. 启动服务：`node server.js`
4. 验证启动：访问 http://localhost:3020 查看模块身份信息

### 核心接口列表
| 接口地址 | 请求方法 | 接口功能 | 验收项 |
|----------|----------|----------|--------|
| / | GET | 模块身份信息查询 | 0-2 |
| /bridge/webhook/github | POST | 接收GitHub Webhook推送 | 1-1 |
| /bridge/webhook/syslog | POST | 接收SYSLOG推送 | 1-3 |
| /bridge/status | GET | 桥接服务自身状态查询 | 2-1 |
| /bridge/nodes | GET | 所有注册节点健康状态查询 | 2-2 |
| /bridge/events | GET | 事件日志多条件查询 | 2-4 |

### 仓库路径
`backend/bridge/`
### 验收标准
遵循BC-M-BRIDGE-001-FM广播全量验收总表，共20项验收要求。