wwwthoughtworks/build-your-own-radar

交互式雷达图生成库

概述

交互式雷达图生成库是一个用于生成交互式雷达图的工具，灵感来源于ThoughtWorks技术雷达（thoughtworks.com/radar）。该库旨在帮助团队或个人可视化、分类和评估技术、工具、框架、平台等元素，通过直观的雷达图形式展示不同维度的评估结果，便于技术决策和知识共享。

核心功能和特性

• 交互式雷达图生成：支持生成可交互的雷达图，用户可通过点击、悬停等操作查看详细信息
• 灵感源自ThoughtWorks技术雷达：遵循技术雷达的分类逻辑（如"采纳"、"试验"、"评估"、"暂缓"等）
• 高度可定制：支持自定义雷达图标题、分类标签、颜色方案、评估维度等
• 数据导入支持：支持通过JSON、CSV等格式导入评估数据，快速生成雷达图
• 轻量级部署：可通过Docker容器化部署，简化环境配置和使用流程

使用场景和适用范围

• 技术评估与规划：团队技术栈评估、新技术引入决策
• 工具选型分析：多工具对比、选型优先级排序
• 项目技术梳理：梳理项目中使用的各类技术组件及其状态
• 团队知识共享：向团队成员或外部展示技术生态和评估结果
• 培训与演示：技术培训、会议演示中的可视化辅助工具

使用方法和配置说明

基本使用流程

1. 准备评估数据文件（支持JSON或CSV格式）
2. 通过Docker运行容器，挂载数据目录并配置相关参数
3. 访问容器暴露的Web端口，查看和交互雷达图

配置参数（环境变量）

数据文件格式示例（JSON）

json
{
  "quadrants": [
    {
      "name": "语言与框架",
      "items": [
        {
          "name": "React",
          "ring": "采纳",
          "description": "前端UI框架，已在多个项目中稳定使用"
        },
        {
          "name": "Vue 3",
          "ring": "试验",
          "description": "正在试点项目中评估其适用性"
        }
      ]
    }
  ]
}

Docker部署示例

基本运行命令

bash
docker run -d \
  -p 8080:8080 \
  -v /本地数据目录:/app/data \
  -e RADAR_TITLE="项目技术雷达" \
  -e DATA_PATH="/app/data/my-radar.json" \
  interactive-radar:latest

Docker Compose配置示例

yaml
version: '3'
services:
  radar:
    image: interactive-radar:latest
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    environment:
      - RADAR_TITLE=团队技术评估雷达
      - CATEGORIES=推荐,考虑,观察,避免
      - PORT=8080
    restart: unless-stopped