A subway-style map of FitSM, the lightweight IT service management standard. The 14 FitSM processes are stations; the interfaces between them are the connections. Click a station or a connection and the frame beside the map shows what FitSM says about it, with a reference to the FitSM document and section for every item.
Live site: https://genomicdatainfrastructure.github.io/fitsm-process-map/
| Click on | You see |
|---|---|
| A process (station) | Its objective, requirements (FitSM-1), roles, databases and records, activities, interfaces, and inputs/outputs exchanged with parties outside the processes |
| A connection | FitSM's description of the interface and the inputs and outputs exchanged in each direction |
| A stretch where several connections run together | All of those connections, each with its description and flows, and each highlighted on the map |
| A role | Its tasks (FitSM-3), split into tasks specific to the process and tasks common to every role of that kind |
| An activity | Its procedure, as the ordered steps from FitSM-2 |
| A database or record | Its FitSM-0 definition and the processes that use it |
| General requirements (header) | FitSM-1's general requirements GR1–GR7 |
Any view can be opened directly by link, for example …/fitsm-process-map/#ISRM for a
process, #ISRM-PM for an interface, #CHM-ISRM,CONFM-ISRM for several interfaces or #GR
for the general requirements.
The coloured lines group related processes as a study aid. They are not part of FitSM, and the page says so wherever they appear. Everything else on the page is FitSM's own text, with the few interpretations (such as which records a process uses) labelled "Not part of FitSM".
The content comes from FitSM edition 3.0, published by ITEMO e.V. under CC BY 4.0 at fitsm.eu/downloads:
- FitSM-0 Overview and vocabulary: definitions of records and information stores
- FitSM-1 Requirements: general requirements GR1–GR7 and process requirements PR1–PR14
- FitSM-2 Process activities and implementation: objectives, activities and procedures, inputs/outputs and key interfaces
- FitSM-3 Role model: roles and tasks
The exact document versions the site reflects are listed in the page footer and in
content/fitsm-3.0/edition.json.
The page fetches its content over HTTP, so opening index.html from the file system does not
work. Serve the folder with any static server, for example:
python3 -m http.server 8765Then open http://localhost:8765. No build step and no dependencies are needed.
| Path | Purpose |
|---|---|
index.html, styles.css |
The page: header, map container, legend, detail frame, footer |
src/app.js |
Loads the content, builds the model, renders, and routes on the address hash |
src/content.js |
Turns the JSON files into an indexed model (pure, tested in Node) |
src/graph.js |
Line colours, interchanges, labels (pure, tested in Node) |
src/router.js |
Parses and formats the address hash (pure, tested in Node) |
src/map.js |
Draws the SVG map |
src/panel.js |
Renders the detail frame views |
content/editions.json |
Which FitSM editions are present and which one the page shows |
content/fitsm-3.0/ |
The FitSM 3.0 content: eight JSON files (see below) |
scripts/check.js |
Consistency and contrast checks, run in CI |
scripts/layout.js |
Layout metrics for the map (crossings, overlaps, close parallels), used by check.js |
tests/ |
Unit tests (node --test) and fixtures for the check script |
Each edition directory holds edition.json (documents, versions, licence), processes.json,
requirements.json, roles.json, activities.json, records.json, interfaces.json and
map.json (lines, station positions, routes). Every content item carries a source naming
the FitSM document and section it comes from.
node scripts/check.jsChecks every edition listed in content/editions.json: all references resolve, every process
has its objective, requirements, roles and activities and sits on a line, every interface has
a route, line colours pass WCAG contrast, and more. Exit code 0 means no errors; 1 means at
least one error (each printed as error <edition>/<file>: <item>: <message>); 2 means a
file could not be read. A line whose processes are not all connected through that line is a
warning and does not fail the run. Options: --content <dir> checks one edition directory;
--editions <file> names a different editions file; --quiet prints findings only.
For each edition the script also prints a layout line, for example:
layout fitsm-3.0/map.json: 15 crossing points (34 crossings between pairs), 40 shared segments (37 transfer merges, 3 within a line, 0 mixed), 7 close parallels
Crossing points are the places on the map where lines cross; a trunk of several
connections crossing a line is one crossing point but one crossing per pair. Shared
segments are stretches where two connections lie on top of each other: transfers merged
into a trunk, two connections of the same line, or a mixed pair (such as a transfer over a
coloured line), which is usually worth avoiding. Close parallels are parallel stretches at
most one grid unit apart. The line is for information only and never fails the run. Add --layout to list each one with its grid
coordinates, which helps when re-routing connections in map.json.
node --testRuns the unit tests for the pure modules and the check script's fixtures.
Only content/ changes for a content update; the page code does not.
- Download the new PDFs from the URL in the current
edition.json(downloads). - Copy the current edition directory to a new one, for example
content/fitsm-3.1/, and add it tocontent/editions.jsonundereditions. Leavecurrentpointing at the old one until the new content is complete. - In the new directory, update
edition.json: each document'sversion,urland the page of its licence statement. - Work through the files in this order, because later files reference earlier ones:
processes.json→requirements.json→roles.json→activities.json→records.json→interfaces.json→map.json. Quote FitSM text unchanged; put wording of your own only intonotefields. - Run
node scripts/check.jsand fix every error; read the warnings. - Set
currentincontent/editions.jsonto the new id and add a line toCHANGELOG.mdnaming the edition and the documents' versions. - Open a pull request citing the FitSM document and section for each content change.
- Add an entry to
interfaces.jsonwith the two process codes in alphabetical order and at least one description or one flow. - Add a route for the same id to
map.jsonunderroutes(an empty array draws a straight segment). - Run the checks: a missing route fails with the interface id.
Edit lines in map.json only. Membership, names, colours and label sides are free to
change; the checks verify that every process is on a line, that colours pass contrast, and
warn when a line's stations are not connected through interfaces.
Where two connections cross, the one drawn later breaks with a short gap. Coloured lines are
drawn first; transfers follow in the order of interfaces.json. To keep a transfer unbroken
where it crosses other transfers, list its id under drawFirst in map.json; listed
transfers are drawn before all other transfers, in the listed order.
The map is split into two halves, Plan & Deliver and Operate & Control, drawn as shaded bands
behind the lines. They are defined under zones in map.json: each has a name, a fill
colour, the grid rows it covers (top and bottom), the corner its name sits in (label:
nw, ne, sw or se) and its stations. The checks verify that
every listed station sits inside its band, that no station is in two halves, that bands do
not overlap, and that line colours keep 3:1 contrast against each fill.
| Workflow | Trigger | What it does |
|---|---|---|
test.yml — Run Tests |
Every push and pull request | REUSE compliance, node scripts/check.js, node --test |
main.yml — Publish main |
After Run Tests succeeds on main (or manually) |
Re-runs the checks, copies the site files to _site/ and deploys them to GitHub Pages |
release.yml — Publish release |
Tags matching v* |
Creates a GitHub release with the site attached as a zip |
All actions are pinned to commit SHAs. The project has no package-managed dependencies and loads nothing from third-party servers at runtime.
One-time setup: in the repository's Settings → Pages, set Source to GitHub Actions.
See CONTRIBUTING.md and the Code of Conduct. Every
file carries SPDX copyright and licence information (REUSE); check
with reuse lint.
The whole project, code, documentation and content, is licensed under
Creative Commons Attribution 4.0 International (CC BY 4.0), the same
licence as FitSM. FitSM content © ITEMO e.V., reproduced unchanged; the site's own additions
are labelled on the page. See the SPDX headers and REUSE.toml for per-file information.
The only third-party files in the repository are the Spec Kit
templates and scripts under .specify/, used to write the specification; they stay under
their own MIT licence and are not part of the published site.