Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
d7c5747
fix: make the Reporting line orange
viklund Oct 22, 2026
a3810e1
feat: show the Plan & Deliver and Operate & Control halves on the map
viklund Oct 22, 2026
3b27fcc
feat: report map layout metrics in check.js
viklund Oct 22, 2026
7b1b93e
feat: route the Agreements arcs above and the Control arc below
viklund Oct 22, 2026
ca7d371
feat: let ISM-SLM leave SLM down to the right
viklund Oct 22, 2026
208fb6d
feat: merge the transfers leaving CHM into two trunks
viklund Oct 22, 2026
fd5d451
feat: draw route bends as curves so branches are continuous
viklund Oct 22, 2026
fe30371
fix: tighten a curve to make room for a gap next to it
viklund Oct 22, 2026
3b51529
experiment: swap SLM and CRM
viklund Oct 22, 2026
3f2f7ed
experiment: route the Reporting line below the Assurance fork
viklund Oct 22, 2026
32fda78
experiment: merge the transfers leaving ISRM into two trunks
viklund Oct 22, 2026
a7cca06
experiment: turn the row-6 trunk down to SRM earlier
viklund Oct 22, 2026
daa9c29
feat: select every connection under a click on a shared stretch
viklund Oct 22, 2026
0d29d65
experiment: bring the transfers into CSI from below
viklund Oct 22, 2026
e416706
feat: add a grid overlay as a layout aid, off by default
viklund Oct 22, 2026
28d0c6d
style: make the grid overlay's lines clearer
viklund Oct 22, 2026
f0997ba
experiment: merge CONFM's transfers to ISRM and PM into a fork
viklund Oct 22, 2026
586bfa8
experiment: let CONFM-PM cross row 19 straight before turning
viklund Oct 22, 2026
f52851a
feat: let map.json choose which transfers stay unbroken at crossings
viklund Oct 22, 2026
029724d
feat: report crossing points and kinds of shared segments
viklund Oct 22, 2026
c1feefe
experiment: merge CAPM-SRM into the SACM-SRM line
viklund Oct 22, 2026
44bb6ee
experiment: move the junction above CHM up a row
viklund Oct 22, 2026
99eec07
experiment: merge the ISM transfer into row 17 further east
viklund Oct 22, 2026
79c09bb
experiment: move the Reporting line down to row 14
viklund Oct 22, 2026
6f7b5a9
experiment: move the CONFM and RDM labels clear of the Control arc
viklund Oct 22, 2026
9f1a200
docs: bring the spec in line with the new map layout
viklund Oct 22, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,19 @@ document versions they bring in.

### Added

- The map shows its two halves, Plan & Deliver and Operate & Control, as shaded bands
(`zones` in `map.json`, checked by `scripts/check.js`), named in the legend, in each
station's spoken name and in its frame subtitle, and labelled as a study aid.
- Clicking a stretch of the map where several connections run together selects all of them
(`#A-B,C-D`): the frame lists each one's description and flows, and the map highlights and
animates each.
- `scripts/check.js` prints layout metrics for each edition's map (crossing points,
shared segments by kind, close parallels); `--layout` lists each one with its grid
coordinates.
- `drawFirst` in `map.json` names transfers to draw before the others, so the others break
where they cross them.
- A grid overlay for maintainers, off by default: `SHOW_GRID` in `src/map.js` or `?grid` in
the address.
- Initial process map of FitSM 3.0: FitSM-0 Overview and vocabulary v3.0.1, FitSM-1
Requirements v3.0.1, FitSM-2 Process activities and implementation v3.0.2, FitSM-3 Role
model v3.0.1 (all ITEMO e.V., CC BY 4.0). 14 processes, 17 general and 65 process
Expand All @@ -35,3 +48,15 @@ document versions they bring in.
to screen readers; the legend's transfer sample takes its colour from the content.
- Checks for alias format, `map.grid` fields and role `tasks`; `scripts/check.js` works
from any working directory; unit tests for the map geometry and selection rules.

### Changed

- The Reporting and improvement line is orange (`#e06000`, was `#bf360c`) so it can be told
apart from the red Operations line.
- A new map layout: CRM and SLM swap places so the Agreements row is straight and the
Assurance line forks below SLM; transfers leaving CHM, ISRM and CONFM run together as
trunks and branch off; the Reporting line runs below the Assurance fork on row 14; no
transfer runs along a coloured line. Crossing points on the map fall from 51 to 13 and
close parallels from 28 to 5.
- Route bends are drawn as curves, so a branch leaves a trunk smoothly; a curve next to a
crossing is tightened, down to a sharp corner, so the crossing's gap fits.
35 changes: 34 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,13 +25,15 @@ says about it, with a reference to the FitSM document and section for every item
| --- | --- |
| 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 or `#GR` for the general requirements.
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
Expand Down Expand Up @@ -77,6 +79,7 @@ Then open http://localhost:8765. No build step and no dependencies are needed.
| `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`,
Expand All @@ -98,6 +101,20 @@ file could not be read. A line whose processes are not all connected through tha
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:

```text
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`.

```bash
node --test
```
Expand Down Expand Up @@ -139,6 +156,22 @@ Edit `lines` in `map.json` only. Membership, names, colours and label sides are
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.

### Choosing which line breaks at a crossing

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.

### Changing the halves

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.

## CI/CD

| Workflow | Trigger | What it does |
Expand Down
160 changes: 91 additions & 69 deletions content/fitsm-3.0/map.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"note": "The lines group related processes as a study aid. They are not part of FitSM.",
"note": "The lines and the two halves group related processes as a study aid. They are not part of FitSM.",
"background": "#ffffff",
"transfer": {
"colour": "#8a8a8a",
Expand All @@ -14,6 +14,26 @@
"y": 2
}
},
"zones": [
{
"id": "plan-deliver",
"name": "Plan & Deliver",
"fill": "#eef3f9",
"top": 0,
"bottom": 13,
"label": "nw",
"stations": ["SPM", "SLM", "CRM", "SUPPM", "SRM", "SACM", "CAPM", "ISM"]
},
{
"id": "operate-control",
"name": "Operate & Control",
"fill": "#f7f3ea",
"top": 13,
"bottom": 26,
"label": "sw",
"stations": ["ISRM", "PM", "CSI", "CONFM", "CHM", "RDM"]
}
],
"lines": [
{
"id": "agreements",
Expand Down Expand Up @@ -59,7 +79,7 @@
{
"id": "reporting",
"name": "Reporting and improvement",
"colour": "#bf360c",
"colour": "#e06000",
"stations": [
"CSI",
"SRM"
Expand All @@ -73,19 +93,19 @@
"label": "n"
},
"SLM": {
"x": 12,
"x": 20,
"y": 4,
"label": "n"
},
"CRM": {
"x": 20,
"x": 12,
"y": 4,
"label": "n"
},
"SUPPM": {
"x": 28,
"y": 4,
"label": "n"
"label":"e"
},
"SRM": {
"x": 4,
Expand All @@ -95,7 +115,7 @@
"SACM": {
"x": 12,
"y": 10,
"label": "e"
"label": "n"
},
"CAPM": {
"x": 20,
Expand All @@ -120,12 +140,12 @@
"CSI": {
"x": 34,
"y": 16,
"label": "s"
"label": "e"
},
"CONFM": {
"x": 12,
"y": 22,
"label": "s"
"label": "w"
},
"CHM": {
"x": 20,
Expand All @@ -135,53 +155,53 @@
"RDM": {
"x": 28,
"y": 22,
"label": "s"
"label": "e"
}
},
"drawFirst": ["CONFM-ISRM", "CONFM-PM"],
"routes": {
"SACM-SLM": [],
"SLM-SPM": [],
"SACM-SLM": [
[16, 10],
[20, 6]
],
"SLM-SPM": [
[18, 2],
[6, 2]
],
"CRM-SLM": [],
"SACM-SRM": [],
"ISRM-PM": [],
"CHM-CONFM": [],
"CHM-RDM": [],
"CAPM-CHM": [
[26, 16]
],
"CRM-SPM": [
[18, 6],
[6, 6]
],
"SLM-SUPPM": [
[15, 7],
[25, 7]
],
"CAPM-CHM": [],
"CRM-SPM": [],
"SLM-SUPPM": [],
"CAPM-SRM": [
[18, 12],
[6, 12]
[12, 12],
[10, 10]
],
"CONFM-RDM": [
[14, 20],
[26, 20]
[14, 24],
[26, 24]
],
"CHM-CRM": [
[20, 16],
[26, 10]
[20, 12]
],
"SPM-SUPPM": [
[2, 4],
[2, 1],
[24, 1],
[27, 4]
[2, 0],
[28, 0]
],
"CSI-SRM": [
[31, 16],
[23, 8],
[6, 8]
[29, 14],
[6, 14],
[4, 12]
],
"ISRM-RDM": [
[11, 19],
[8, 18],
[9, 19],
[28, 19]
],
"CHM-SPM": [
Expand All @@ -190,66 +210,68 @@
[0, 8]
],
"ISM-SLM": [
[28, 9],
[24, 5],
[11, 5]
[24, 10],
[20, 6]
],
"CRM-SRM": [
[20, 6],
[15, 11],
[4, 11]
[12, 5],
[11, 6],
[7, 6],
[4, 9]
],
"CRM-CSI": [
[26, 4],
[32, 10],
[32, 14]
[20, 12],
[20, 15],
[22, 17],
[33, 17]
],
"CHM-CSI": [
[21, 22],
[28, 15],
[34, 15]
[20, 17],
[33, 17]
],
"ISRM-SPM": [
[8, 13],
[4, 9]
[8, 8]
],
"ISRM-SLM": [
[4, 12]
[8, 8],
[10, 6],
[18, 6]
],
"CHM-SACM": [
[19, 21],
[19, 15],
[12, 15]
[20, 17],
[19, 16],
[18, 16]
],
"CHM-ISM": [
[21, 21],
[21, 17]
[20, 17],
[25, 17],
[26, 16],
[26, 12]
],
"CHM-ISRM": [
[19, 22],
[16, 25],
[8, 25]
[19, 21],
[9, 21],
[8, 20]
],
"SLM-SRM": [
[11, 5],
[6, 5],
[3, 8],
[3, 9]
],
"CAPM-SLM": [
[17, 10],
[12, 5]
[18, 6],
[7, 6],
[4, 9]
],
"CAPM-SLM": [],
"CONFM-ISRM": [
[7, 17]
[12, 20],
[11, 19],
[9, 19],
[8, 18]
],
"CONFM-PM": [
[12, 20]
[12, 18],
[14, 18]
],
"CHM-PM": [
[21, 21],
[18, 18],
[18, 16]
[20, 17],
[19, 16]
]
}
}
2 changes: 1 addition & 1 deletion index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ <h1>FitSM Process Map</h1>
<div class="map-column">
<div id="map" class="map"></div>
<aside id="legend" class="legend" aria-labelledby="legend-title">
<h2 id="legend-title">Lines are a study aid, not part of FitSM</h2>
<h2 id="legend-title">Halves and lines are a study aid, not part of FitSM</h2>
<ul id="legend-list"></ul>
</aside>
</div>
Expand Down
Loading