tech radar

Motivation

Chez Zalando, nous maintenons un radar technologique public pour aider nos équipes d'ingénierie à s'aligner sur les choix technologiques. Il est basé sur le travail pionnier de ThoughtWorks.

Ce référentiel contient le code pour générer la visualisation: radar.js (basé sur D3.js v4). N'hésitez pas à l'utiliser et à l'adapter à vos propres fins.

Usage

1. Inclure d3.js et radar.js :

 < script src =" https://d3js.org/d3.v4.min.js " > </ script >
< script src =" https://zalando.github.io/tech-radar/release/radar-0.9.js " > </ script >

2. Insérez une balise svg vide:

 < svg id =" radar " > </ svg >

3. Configurer la visualisation radar:

 radar_visualization ( {
  repo_url : "https://github.com/zalando/tech-radar" ,
  svg_id : "radar" ,
  width : 1450 ,
  height : 1000 ,
  scale : 1.0 ,
  colors : {
    background : "#fff" ,
    grid : "#bbb" ,
    inactive : "#ddd"
  } ,
  // Some font families might lead to font size issues
  // Arial, Helvetica, or Source Sans Pro seem to work well though
  font_family : "Arial, Helvetica" ,
  title : "My Radar" ,
  quadrants : [
    { name : "Bottom Right" } ,
    { name : "Bottom Left" } ,
    { name : "Top Left" } ,
    { name : "Top Right" }
  ] ,
  rings : [
    { name : "INNER" ,  color : "#5ba300" } ,
    { name : "SECOND" , color : "#009eb0" } ,
    { name : "THIRD" ,  color : "#c7ba00" } ,
    { name : "OUTER" ,  color : "#e09b96" }
  ] ,
  print_layout : true ,
  links_in_new_tabs : true ,
  entries : [
   {
      label : "Some Entry" ,
      quadrant : 3 ,          // 0,1,2,3 (counting clockwise, starting from bottom right)
      ring : 2 ,              // 0,1,2,3 (starting from inside)
      moved : - 1             // -1 = moved out (triangle pointing down)
                            //  0 = not moved (circle)
                            //  1 = moved in  (triangle pointing up)
                            //  2 = new       (star)
   } ,
    // ...
  ]
} ) ;

Les inscriptions sont positionnées automatiquement afin qu'elles ne se chevauchent pas. Le paramètre "échelle" peut aider à régler la taille du radar.

À titre d'exemple de travail, vous pouvez consulter docs/index.html - la source de notre radar technologique public.

Déploiement

Tech Radar est une page statique, il peut donc être déployé à l'aide de tout fournisseur d'hébergement de votre choix offrant un hébergement de page statique.

Développement local

1. Installez les dépendances avec le fil (ou NPM):

 yarn 

2. Démarrer le serveur de développement local:

 yarn start

3. Votre navigateur par défaut doit ouvrir automatiquement et afficher l'URL

 http://localhost:3000/

Licence

 The MIT License (MIT)

Copyright (c) 2017-2024 Zalando SE

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.