feat: 重构项目心跳为Redis LIST并更新相关文档

重构项目心跳数据结构为Redis LIST,更新相关文档和OpenSpec规范。主要变更包括:
- 将项目心跳从STRING改为LIST类型
- 更新后端服务以支持LIST操作
- 同步更新文档和OpenSpec规范
- 统一后端端口为3001
- 添加部署指南和Windows部署文档

修复前端API请求路径,移除硬编码的localhost地址。添加PM2和Nginx配置文件模板,完善部署流程文档。更新Redis集成协议文档,明确LIST数据结构和外部项目对接规范。
This commit is contained in:
2026-01-17 18:36:52 +08:00
parent a8faa7dcaa
commit 7ac3949dfa
40 changed files with 4179 additions and 323 deletions

View File

@@ -138,11 +138,11 @@ Web_BLS_ProjectConsole/
### 日志记录展示
日志记录展示模块负责从Redis队列读取日志记录,并以友好的格式展示在控制台界面中。
日志记录展示模块负责从 Redis LIST 读取日志记录,并以友好的格式展示在控制台界面中。
#### 主要功能
- 实时读取Redis队列中的日志记录
- 实时读取 Redis LIST 中的日志记录
- 以列表形式展示日志记录,包含时间戳、日志级别和消息内容
- 支持按日志级别和时间范围过滤日志
- 自动滚动到最新日志(可选)
@@ -151,24 +151,24 @@ Web_BLS_ProjectConsole/
#### 技术实现
- 使用Redis List作为日志队列
- 使用Server-Sent EventsSSE实现实时更新
- 使用轮询方式拉取最新日志
- 前端使用Vue组件化开发实现日志列表和过滤功能
### 控制台指令发送
控制台指令发送模块允许用户发送控制台指令到Redis队列供其他程序读取和执行
控制台指令发送模块允许用户发送控制台指令到目标项目的 HTTP API由心跳中的 `apiBaseUrl` 提供基地址)
#### 主要功能
- 提供指令输入框,允许用户输入控制台指令
- 支持指令验证,确保指令格式正确
- 支持发送指令到Redis队列
- 支持发送指令到目标项目 API
- 显示指令发送状态和结果
- 维护指令历史记录,支持重新发送历史指令
#### 技术实现
- 使用Redis List作为指令队列
- 后端根据项目心跳解析目标项目 `apiBaseUrl` 并转发调用
- 前端使用Vue组件化开发实现指令表单和历史记录功能
- 后端实现指令验证和发送逻辑
@@ -218,22 +218,16 @@ git push origin feature/feature-name
### 测试指南
#### 单元测试
#### 测试
```bash
npm run test:unit
npm test
```
#### 集成测试
#### 开发时 watch
```bash
npm run test:integration
```
#### 端到端测试
```bash
npm run test:e2e
npm run test:watch
```
#### 代码质量检查