Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/bug_template.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-FileCopyrightText: 2024 PNED G.I.E.
#
# SPDX-License-Identifier: Apache-2.0
# SPDX-License-Identifier: CC-BY-4.0

name: "🐞 Bug Report"
description: Report the issue you are having
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/feature_template.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-FileCopyrightText: 2024 PNED G.I.E.
#
# SPDX-License-Identifier: Apache-2.0
# SPDX-License-Identifier: CC-BY-4.0

name: "✨ Feature Request"
description: Suggest an idea for this project
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/story_template.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-FileCopyrightText: 2024 PNED G.I.E.
#
# SPDX-License-Identifier: Apache-2.0
# SPDX-License-Identifier: CC-BY-4.0

name: "📝 User Story"
description: Provide a detailed user story including what needs to be done, why, the tasks involved, and the acceptance criteria.
Expand Down
2 changes: 1 addition & 1 deletion .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<!-- SPDX-FileCopyrightText: 2024 PNED G.I.E. -->

<!-- SPDX-License-Identifier: Apache-2.0 -->
<!-- SPDX-License-Identifier: CC-BY-4.0 -->

## 🚀 Pull Request Checklist

Expand Down
15 changes: 10 additions & 5 deletions .github/workflows/main.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-FileCopyrightText: 2024 PNED G.I.E.
# SPDX-FileCopyrightText: 2026 PNED G.I.E.
#
# SPDX-License-Identifier: Apache-2.0
# SPDX-License-Identifier: CC-BY-4.0

name: Publish main

Expand All @@ -27,19 +27,24 @@ env:

jobs:
build:
name: Build site
name: Assemble site
if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ env.SHA }}
- name: Check FitSM data and page script
- uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5.0.0
with:
node-version: 22
- name: Check FitSM content, map and scripts
run: node scripts/check.js
# No build step: the deployed files are the files in the repository.
- name: Assemble site
run: |
mkdir _site
cp index.html fitsm-data.js _site/
cp index.html styles.css _site/
cp -r src content _site/
- uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
- uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
with:
Expand Down
18 changes: 11 additions & 7 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-FileCopyrightText: 2024 PNED G.I.E.
# SPDX-FileCopyrightText: 2026 PNED G.I.E.
#
# SPDX-License-Identifier: Apache-2.0
# SPDX-License-Identifier: CC-BY-4.0

name: Publish release

Expand All @@ -22,14 +22,18 @@ jobs:
contents: write
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- name: Check FitSM data and page script
- uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5.0.0
with:
node-version: 22
- name: Check FitSM content, map and scripts
run: node scripts/check.js
- name: Package site
run: |
mkdir -p "fitsm-process-map-${GITHUB_REF_NAME}"
cp index.html fitsm-data.js README.md "fitsm-process-map-${GITHUB_REF_NAME}/"
cp -r LICENSES "fitsm-process-map-${GITHUB_REF_NAME}/"
zip -r "fitsm-process-map-${GITHUB_REF_NAME}.zip" "fitsm-process-map-${GITHUB_REF_NAME}"
dir="fitsm-process-map-${GITHUB_REF_NAME}"
mkdir -p "$dir"
cp index.html styles.css README.md CHANGELOG.md "$dir/"
cp -r src content LICENSES "$dir/"
zip -r "$dir.zip" "$dir"
- name: Create release
env:
GH_TOKEN: ${{ github.token }}
Expand Down
22 changes: 18 additions & 4 deletions .github/workflows/test.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-FileCopyrightText: 2024 PNED G.I.E.
# SPDX-FileCopyrightText: 2026 PNED G.I.E.
#
# SPDX-License-Identifier: Apache-2.0
# SPDX-License-Identifier: CC-BY-4.0

name: Run Tests

Expand All @@ -20,9 +20,23 @@ jobs:
- uses: fsfe/reuse-action@676e2d560c9a403aa252096d99fcab3e1132b0f5 # v6.0.0

check:
name: Data and page checks
name: Content checks
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- name: Check FitSM data and page script
- uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5.0.0
with:
node-version: 22
- name: Check FitSM content, map and scripts
run: node scripts/check.js

unit:
name: Unit tests
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5.0.0
with:
node-version: 22
- name: Run unit tests
run: node --test
11 changes: 9 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,10 +1,17 @@
# SPDX-FileCopyrightText: 2026 PNED G.I.E.
#
# SPDX-License-Identifier: Apache-2.0
# SPDX-License-Identifier: CC-BY-4.0

# Local tooling (Claude Code preview config, editor settings)
.claude/
.DS_Store

# Site build output (assembled in CI)
# Site output assembled in CI for GitHub Pages
_site/

# The project has no package-managed dependencies; ignore a stray install anyway
node_modules/

# Release zips built locally
fitsm-process-map-v*/
fitsm-process-map-v*.zip
12 changes: 12 additions & 0 deletions .specify/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Machine-local Spec Kit state — not meant to be shared.
# Managed by the Specify CLI; safe to edit (your changes are preserved on refresh).

# Local pointer to the current feature directory. Rewritten every time you
# switch features, so it is per-checkout state rather than something to share.
feature.json

# Per-machine extension config overrides.
extensions/*/local-config.yml

# Extension catalog cache written by `specify extension search`; per-machine, re-downloaded on demand.
extensions/.cache/
9 changes: 9 additions & 0 deletions .specify/init-options.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"ai": "claude",
"ai_skills": true,
"feature_numbering": "sequential",
"here": true,
"integration": "claude",
"script": "sh",
"speckit_version": "1.1.1.dev0"
}
15 changes: 15 additions & 0 deletions .specify/integration.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
{
"version": "1.1.1.dev0",
"integration_state_schema": 1,
"installed_integrations": [
"claude"
],
"integration_settings": {
"claude": {
"script": "sh",
"invoke_separator": "-"
}
},
"integration": "claude",
"default_integration": "claude"
}
17 changes: 17 additions & 0 deletions .specify/integrations/claude.manifest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"integration": "claude",
"version": "1.1.1.dev0",
"installed_at": "2026-10-03T14:19:51.535976+00:00",
"files": {
".claude/skills/speckit-analyze/SKILL.md": "3237cd827194efaf6bb06ba05ef9bc1a703a223d362f5e34d0558c5a38ae34d0",
".claude/skills/speckit-clarify/SKILL.md": "164f49ef87cb2e922585316f5281b455a8e1940b1efd25317d517a567acae472",
".claude/skills/speckit-constitution/SKILL.md": "60c27f3962e78edf204b2b2e7cba91a616980860b61d6bf2051dc6965d483dda",
".claude/skills/speckit-implement/SKILL.md": "7186d59488f89dcf23abd17baed118b05c242d4f62f1de3f9f44625a2b1728f0",
".claude/skills/speckit-converge/SKILL.md": "9f93c1d573592f146670202210128ed24a9d75c92133951b19a2bb0e34eac13b",
".claude/skills/speckit-plan/SKILL.md": "9e97fc0b4ce895c70a1ea720dc0377618c23e27c83ecf4d87b6e0f6c323790a4",
".claude/skills/speckit-checklist/SKILL.md": "5dc436df0c727e9078bf182dd385e5cb1b60ee67ebe644d3f659ec12e3b78abb",
".claude/skills/speckit-specify/SKILL.md": "d4d93f2444355136e78bb533988aa2dd560dc4b258f4923f67b1a437e7de38f8",
".claude/skills/speckit-tasks/SKILL.md": "d148aeda1011260c4465c5f105fa1e045a0b0224ccb3e6e0c1ec32c732cae1ae",
".claude/skills/speckit-taskstoissues/SKILL.md": "464bbaf464a28ffa371b0452599c18e7cb5799630148d9f945e6a4d7066a1234"
}
}
19 changes: 19 additions & 0 deletions .specify/integrations/speckit.manifest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
{
"integration": "speckit",
"version": "1.1.1.dev0",
"installed_at": "2026-10-03T14:19:51.614039+00:00",
"files": {
".specify/scripts/bash/common.sh": "53cb1c23e349db4586c272436ce35c6e2f36a9c0b5351a85e0b216d9887a26b7",
".specify/scripts/bash/setup-plan.sh": "d0bd298c026446f3c63167130d65e49e4aa4485de6bef18bcdfd57b19aa0de96",
".specify/scripts/bash/setup-tasks.sh": "4a33dd1e6c32ddc7d570f4b538572c54069192573eed0ec654d9fb826e31a4fe",
".specify/scripts/bash/check-prerequisites.sh": "daa377146db4fb69912f42611a7b91c5d55873b3e3e27ed33bd8d67505826344",
".specify/scripts/bash/resolve-template.sh": "829e227096abc8bf0889889ec9f792f503ca5d395b7836a8a7eb739ee75214e7",
".specify/scripts/bash/create-new-feature.sh": "972f03ed8ca5ee17b7baad6d56d821d46269d77abc337496beafb0fe85a725f2",
".specify/templates/constitution-template.md": "ce7549540fa45543cca797a150201d868e64495fdff39dc38246fb17bd4024b3",
".specify/templates/checklist-template.md": "856532b3cb66171c662cc16f16b31a5856e4655a8666aad1e545bbfc7f603ca1",
".specify/templates/tasks-template.md": "fc29a233f6f5a27ca31f1aa46b596af6500c627441c6e62b2bc4a1d721525842",
".specify/templates/spec-template.md": "3945437fc35cd30a5b2bf7beea680337c3516826d3efa5a6b92c4a7eca1ba28e",
".specify/templates/plan-template.md": "7e637502d41eccf0ca672496636365691fdca62ef37b27ec07fcb412dbfa90d4",
".specify/.gitignore": "8c908410d177a1ef3d0dee16d7ad55f2ac3333df3104c4d4adee1c9b82f1dbc1"
}
}
4 changes: 4 additions & 0 deletions .specify/memory/.constitution-template.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"sha256": "ce7549540fa45543cca797a150201d868e64495fdff39dc38246fb17bd4024b3",
"source": "core"
}
140 changes: 140 additions & 0 deletions .specify/memory/constitution.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
# FitSM Process Map Constitution

This project builds an interactive process map of FitSM, the lightweight IT service management
standard published by ITEMO e.V. It is governed by the same four principles that FitSM applies
to itself, as stated in the foreword of every FitSM document: practicality, consistency,
sufficiency and extendibility. It also applies FitSM's own management approach (clear
responsibilities, documented content and continual improvement) to how the project is run.

## Core Principles

### I. Practicality

FitSM is meant to be usable without a heavy toolset, and so is this map.

- The site MUST run as static files in a current browser. It MUST NOT need a build step,
bundler, server-side code or account.
- Each part of the standard (process, requirement, role, record, activity, interface) MUST be
reachable within two clicks from the map. Each process MUST be linkable by its FitSM code
(for example `#ISRM`).
- Content MUST be written in plain language for people learning FitSM. Jargon that FitSM does
not itself define MUST be avoided or explained.
- The page MUST be usable with a keyboard and on a phone-width screen.

Rationale: a learning aid that is hard to open, run or read fails its purpose.

### II. Consistency with the Standard

The map MUST say what FitSM says. The source documents are FitSM-0, FitSM-1, FitSM-2 and FitSM-3
(v3), and the latest edition published at fitsm.eu is the reference.

- Every item of FitSM content MUST be traceable to a named FitSM document and section, such as
a requirement ID (PR1–PR14), an activity or a role.
- FitSM terms MUST be used with their FitSM-0 meanings, and quoted text MUST NOT be reworded.
- The map MUST show exactly the 14 FitSM processes. It MUST NOT add processes, roles or
requirements that FitSM does not define.
- Anything that is interpretation rather than quotation MUST be labelled on the page. That
includes derived databases, reconciling conflicting tables and colour groupings.
- When FitSM documents disagree, both versions MUST be shown with a note. The map MUST NOT
silently pick one.

Rationale: users rely on the map to learn the standard. An unlabelled deviation teaches
something FitSM does not say.

### III. Sufficiency

FitSM includes only what is necessary, and the map follows the same rule.

- A feature MUST serve understanding of the standard. Decoration, tracking and features not
tied to FitSM content MUST NOT be added.
- The project MUST NOT add package-managed dependencies (npm, pip and similar) or container
images unless a spec justifies the need and the plan records it. If one is added, a
dependency licence scan and, for images, an image scan MUST be added to CI.
- Each bundled third-party resource (such as a font) MUST be listed in the README with its
licence.

Rationale: each addition is something to maintain, review and license. The smallest map that
teaches FitSM fully is the right size.

### IV. Extendibility

FitSM is designed to be extended, and the map MUST be easy to extend without rework.

- All FitSM content MUST live in a content store separate from presentation and behaviour.
Correcting or adding content MUST NOT require changes to page code.
- The content model MUST let a later FitSM edition, a translation, or further content (such
as FitSM-4 templates) be added alongside the current content, not on top of it.
- Each item MUST have a stable identifier based on FitSM's own codes, so that links and
cross-references keep working when content is extended.

Rationale: FitSM evolves, and organisations adapt it. A map that can only show one fixed
edition has a short life.

### V. Openness and Attribution

FitSM is free and openly licensed under CC BY 4.0, and the map is distributed under the same
licence.

- The whole project (code, documentation and FitSM content) is licensed under Creative Commons
Attribution 4.0 International (CC BY 4.0). No other licence MAY be used for the project's
own work. A bundled third-party resource keeps its own open licence and is listed as such.
- FitSM content MUST be credited to ITEMO e.V. under CC BY 4.0 with a link to fitsm.eu, both on
the page and in the content store.
- Every file MUST carry SPDX copyright and licence information, and the repository MUST pass
`reuse lint`.

Rationale: openness is what lets the map exist and be reused. Using FitSM's own licence for
everything keeps reuse simple and attribution is a licence condition, not a courtesy.

### VI. Continual Improvement

FitSM is built on continual improvement (Plan, Do, Check, Act), and the project MUST apply it to
itself.

- Every change MUST pass the automated consistency checks: all references resolve, no required
content is missing, and the page script parses. New kinds of content MUST come with new
checks.
- Error reports and suggested corrections to FitSM content MUST be handled through GitHub
issues, citing the FitSM source.
- Releases MUST be tagged with a version (`v*`) and recorded in a changelog.

Rationale: a process map of a quality standard should show the same discipline it describes.

## Content and Technical Constraints

- Technology: HTML, CSS and JavaScript without frameworks, served as static files on GitHub
Pages. Node.js is used only for CI checks and is not needed to view the site.
- Content scope: FitSM v3 (FitSM-0 to FitSM-3). Adding another FitSM part or edition needs a
spec of its own.
- Labelling: the page MUST visibly separate quoted FitSM content from interpretation and study
aids.
- Accessibility: text and diagram colours MUST meet WCAG 2.1 AA contrast. Information MUST NOT be
shown by colour alone.
- Supply chain: GitHub Actions MUST be pinned to commit SHAs.

## Development Workflow and Quality Gates

- Spec-driven: new features follow the Spec Kit flow (specify, plan, tasks, implement). Each plan
MUST include a Constitution Check against Principles I–VI.
- Content changes MUST cite the FitSM document and section they come from in the pull request.
- Every pull request MUST pass CI (REUSE compliance and the consistency checks) before it is
merged. Only `main` is deployed.
- Reviewers MUST check that interpretation is labelled (Principle II) and that no unnecessary
dependency is added (Principle III).
- Commit messages follow the conventions in `CONTRIBUTING.md`.

## Governance

- This constitution takes precedence over other project practices. If guidance conflicts with
it, the constitution applies until it is amended.
- Amendments are made by pull request that changes this file. The pull request MUST state the
reason and the version bump, and it needs maintainer approval.
- Versioning follows semantic versioning:
- MAJOR: a principle is removed or redefined in a way that is not backward compatible.
- MINOR: a principle or section is added, or guidance is materially expanded.
- PATCH: wording is clarified without changing meaning.
- Compliance is reviewed in every pull request, and in full when a new FitSM edition is
published.
- Day-to-day guidance for contributors is in `README.md` and `CONTRIBUTING.md`.

**Version**: 2.0.1 | **Ratified**: 2026-10-03 | **Last Amended**: 2026-10-03
Loading
Loading