dependencytrack/frontend

Dependency-Track Front End (UI) 镜像文档

1. 镜像概述和主要用途

Dependency-Track Front End (UI) 是一个单页应用（SPA），作为开源组件分析平台 Dependency-Track 的前端用户界面。Dependency-Track 旨在帮助组织识别和降低软件供应链中的风险，而本前端镜像提供了直观的可视化界面，支持用户与平台核心功能进行交互，包括风险监控、组件分析、漏洞管理等。

本项目基于现代前端技术栈构建，主要技术框架包括：

• Vue.js（JavaScript 前端框架）
• Bootstrap Vue（UI 组件库）
• CoreUI（管理系统界面框架）

2. 核心功能和特性

2.1 核心功能

• 提供 Dependency-Track 平台的全功能可视化操作界面，支持组件风险监控、漏洞分析、项目管理等核心业务场景
• 动态交互体验：基于 SPA 架构，实现页面无刷新更新，提升用户操作流畅度
• 与 Dependency-Track 后端 API Server 深度集成，实时同步数据

2.2 技术特性

• 基于 Vue.js 构建，具备轻量、高效的前端渲染能力
• 采用 Bootstrap Vue 和 CoreUI 组件库，确保界面响应式设计，适配多种设备
• 模块化架构，支持功能扩展和定制化开发

3. 兼容性矩阵

使用时需确保前端版本与 Dependency-Track API Server 版本兼容，版本对应关系如下：

版本说明：自 Dependency-Track v4.2 起，前端与后端 API Server 的主版本（major）和次版本（minor）保持一致（遵循语义化版本），但补丁版本（patch）可能独立更新。

4. 使用场景和适用范围

4.1 适用场景

• 开发团队：监控项目依赖组件的安全风险，优化依赖管理
• 安全团队：分析软件供应链漏洞，制定风险缓解策略
• DevOps 团队：集成到 CI/CD 流程中，实现自动化风险管控

4.2 适用范围

• 需管理软件供应链风险的企业或组织
• 使用 Dependency-Track 平台进行组件分析的用户
• 对前端界面有定制化需求的技术团队（基于开源代码二次开发）

5. 部署方案

5.1 Docker 部署说明

前端镜像需通过 Docker 部署，具体部署步骤请参考官方文档：
Docker 部署指南

5.2 部署架构

前端部署架构如下（基于官方架构图）：
!https://raw.githubusercontent.com/DependencyTrack/frontend/master/docs/images/Frontend-Deployment.svg?sanitize=true

架构说明：前端作为独立服务部署，通过 HTTP/HTTPS 与后端 API Server 通信，支持单独扩展或与后端协同部署。

6. 使用方法和配置说明

6.1 基本使用流程

1. 部署 Dependency-Track 后端 API Server（需确保版本兼容，参考兼容性矩阵）
2. 部署前端镜像，配置前端服务与后端 API Server 的通信地址
3. 通过浏览器访问前端服务地址，使用 Dependency-Track 平台功能

6.2 配置说明

前端与后端的通信配置、端口映射、环境变量等详细参数，请参考官方 Docker 部署文档中的配置章节。

7. 社区资源

• 项目官网：Dependency-Track 官方网站，提供平台概述、教程及社区资源链接
• 社区支持：通过官网获取社区论坛、Issue 跟踪、贡献指南等资源

8. 版权与许可

Dependency-Track Front End (UI) 版权所有 (c) Steve Springett。保留所有权利。

根据 Apache 2.0 许可协议授权修改和再分发。完整许可条款参见 https://github.com/DependencyTrack/frontend/blob/master/LICENSE%E3%80%82