研发效能度量平台

面向中小研发团队的交付效能看板。平台提供 GitLab 与 Jenkins Webhook 接入能力，将构建、测试和部署事件统一为流水线记录，并按项目、团队、环境与时间窗口计算 DORA 相关指标。

主要功能

• GitLab/Jenkins Webhook 接入、签名校验与事件幂等处理
• 部署频率、变更前置时间、变更失败率、构建成功率和平均恢复时间统计
• 7/30/90/180 天及项目、团队、环境、数据源组合筛选
• 流水线分页检索、Jira 需求关联、构建阶段与日志钻取
• WebSocket 实时推送流水线状态
• 手动运行演示流水线，完整模拟排队、测试、发布与完成过程
• 项目健康度、失败阶段和交付趋势分析

技术栈

层次	技术
后端	Java 21、Spring Boot 3、Spring Data JPA、WebSocket
数据	H2（本地演示）、MySQL/Redis（生产配置入口）
前端	Vue 3、Vite、ECharts、Axios、STOMP
工程化	Maven、Docker Compose、GitHub Actions

快速启动

Docker Compose

docker compose up --build

访问 http://localhost:5173。

本地开发

要求：JDK 21、Maven 3.9+、Node.js 20+

cd backend
mvn spring-boot:run

cd frontend
npm ci
npm run dev

演示数据

默认配置启动后会生成 4,800 条构建与部署记录。不同项目拥有独立的构建耗时、成功率、覆盖率和失败阶段分布，便于离线演示筛选、钻取与图表交互。数据为本地模拟数据，不包含任何真实企业信息。

接口示例

GET  /api/dashboard/summary?days=30
GET  /api/dashboard/trends?days=30&team=Finance
GET  /api/dashboard/projects?days=90
GET  /api/builds?keyword=DEV-9001&status=FAILED
GET  /api/builds/{id}
POST /api/pipelines/run
POST /api/webhooks/gitlab
POST /api/webhooks/jenkins

Webhook 令牌通过环境变量 WEBHOOK_TOKEN 配置。开发环境默认值仅用于本机演示。

项目结构

.
├── backend/                 Spring Boot 服务
├── frontend/                Vue 3 看板
├── docs/                    架构说明与截图
├── docker-compose.yml       容器化启动
└── .github/workflows/       持续集成

指标口径与事件处理链路见 docs/architecture.md。

说明

仓库默认使用内存数据库，便于直接运行。切换到 MySQL/Redis 时，可参考 backend/src/main/resources/application-prod.yml 配置环境变量。