trivadis/trivadis-technology-radar

Trivadis Technology Radar

镜像概述和主要用途

Trivadis Technology Radar是基于AOE Technologies开源项目构建的静态网站生成器，用于创建和维护技术雷达。技术雷达是一种可视化工具，帮助团队展示技术采用状态（试用、评估、采用、搁置），并跟踪技术演进历程。该镜像提供了便捷的部署方式，支持本地开发和Docker容器化运行。

核心功能和特性

• 静态网站生成：将Markdown格式的技术项目文件转换为可视化的技术雷达网站
• 版本化管理：支持按发布日期（YYYY-MM-DD）组织技术项目，形成历史版本记录
• 项目属性定义：通过front-matter头信息定义项目的象限、环、技能等属性
• 搜索功能：内置搜索能力，便于快速查找技术项目
• Docker化部署：提供Docker镜像，支持一键部署运行

使用场景和适用范围

• 技术团队展示技术栈选择与演进策略
• 企业级技术治理与标准化建设
• 技术趋势跟踪与团队知识共享
• 项目技术选型决策支持

使用方法和配置说明

Docker部署

通过Docker快速运行技术雷达网站：

bash
docker run -p 8080:8080 docker.xuanyuan.run/trivadis/trivadis-technology-radar

运行后访问 [***] 即可查看技术雷达。

本地开发安装

如需自定义开发，可通过以下步骤本地部署：

bash
git clone git@github.com:trivadispf/trivadis-technology-radar.git
cd trivadis-technology-radar 
yarn
yarn watch

执行完成后，浏览器会自动打开 [***]

项目维护方法

创建发布版本

在/radar目录下按发布日期（格式：YYYY-MM-DD）创建文件夹，每个发布文件夹下按象限创建子文件夹，用于存放对应象限的技术项目。

技术项目文件格式

技术项目使用Markdown（.md）格式，文件头部需包含front-matter头信息定义项目属性：

markdown
---
title:      		"Technology"
ring:       		adopt
quadrant:   		languages-and-frameworks
skills:     		react
releated:	  		"Other Technology"
building-block:	"name of the building block"
---

Text goes here. You can use **markdown** here.

front-matter属性说明

• title：项目名称（必填）
• quadrant：象限（必填），可选值：languages-and-frameworks（语言与框架）、methods-and-patterns（方法与模式）、platforms-and-aoe-services（平台与服务）、tools（工具）
• ring：技术采用阶段（必填），可选值：trial（试用）、assess（评估）、adopt（采用）、hold（搁置）
• info：（可选）项目简短描述，显示在概览页面
• featured：（可选，默认"true"）设为false时，项目不在雷达象限中显示，但仍可在概览中访问

项目版本控制

.md文件名作为项目唯一标识，新版本中的同名文件会覆盖旧版本项目，属性将合并并创建历史记录。

注意事项

• 版权说明：雷达中的文章文本和描述受AOE版权保护，不得用于自定义雷达
• 样式修改：如需复用CSS和样式，需修改字体（原字体为授权字体）和颜色（原颜色使用AOE企业标识）
• 贡献提示：欢迎贡献代码，项目有计划功能列表（见下方Todos）

计划功能（Todos）

• 添加图标
• 实现搜索功能
• 完善CSS样式
• 获取使用指南页面内容
• 项目标签功能（显示标签/自动关联相关项目）
• 概览页面标签过滤
• 项目详情页显示历史记录（需第二个发布版本支持）
• 优化语义化和SEO
• 移动端适配
• 添加移动端导航和搜索
• 为现有CSS组件创建更多React组件
• 重构路由中的硬编码子文件夹
• 雷达生成单元测试