diff --git a/MANIFEST.md b/MANIFEST.md index 7836726..87977ef 100644 --- a/MANIFEST.md +++ b/MANIFEST.md @@ -24,6 +24,12 @@ admits future files. - `assets/img/transitrix-icon.svg` - `assets/js/theme.js` - `assets/og/transitrix-og.png` +- `capability-maps/SHA256SUMS` +- `capability-maps/acme-capability-map-demo.zip` +- `capability-maps/acme-cycle.svg` +- `capability-maps/acme-mdm-coverage.svg` +- `capability-maps/index.html` +- `capability-maps/render-dsm-capabilities-html-6.8.2.zip` - `de/dsl-examples/index.html` - `de/dsm/index.html` - `de/index.html` diff --git a/capability-maps/SHA256SUMS b/capability-maps/SHA256SUMS new file mode 100644 index 0000000..39451de --- /dev/null +++ b/capability-maps/SHA256SUMS @@ -0,0 +1,4 @@ +04a9275f94ec62ca4de611953c160f9df5c856ba1fe2b02f060555ef3208d0bb acme-capability-map-demo.zip +4192a5f5b65a8444d7be6589895927cffc28fb1d55a952431bfa032589d03274 render-dsm-capabilities-html-6.8.2.zip +de05bc57f0957ae4730763efeabe7d1eaaa3ad73426757b407428f99ba62fdbe acme-cycle.svg +546b31238d542037d16dd77be23ef0d37274cf649208a08353ba31bb9aea89b5 acme-mdm-coverage.svg diff --git a/capability-maps/acme-capability-map-demo.zip b/capability-maps/acme-capability-map-demo.zip new file mode 100644 index 0000000..371996a Binary files /dev/null and b/capability-maps/acme-capability-map-demo.zip differ diff --git a/capability-maps/acme-cycle.svg b/capability-maps/acme-cycle.svg new file mode 100644 index 0000000..c771dd6 --- /dev/null +++ b/capability-maps/acme-cycle.svg @@ -0,0 +1 @@ +Acme Corp — Expanded Demonstration{"methodology_revision": "888c03d33c2d899ec85a612901075b67811614e5", "methodology_baseline_revision": "3c75d0403dd4e2dc618bc9535ea293d0495e1ec1", "methodology_contract_status": "merged core-methodology correction; not released", "adapter_version": "dsm-capability-html/6", "renderer_version": "6.8.2", "model_revision": "transitrix/acme-corp@e331590b13935d1d0922063acbf1f6a0cb3cdba2+demo-extension-2026-10-23; management-cycle/tag teaching overlay 2026-10-23; multi-system coverage demo; dated history/current/plan demo", "state_id": "current", "state_kind": "current", "horizon_label": "", "as_of": "2026-10-23", "layout_mode": "layers", "show_backlog": false, "tag_filter": null, "layer_vocabulary": ["Strategic", "Learning", "Planning", "Execution", "Assurance"], "tag_vocabulary": ["ESG", "MDM", "Support"], "classification_mapping": "explicit layer/tags; legacy property mapped without inheritance", "coverage_system_id": "DEMO-APPLICATION-DATA", "coverage_colors": {"APPLICATION-CRM-1": "#0d9488", "APPLICATION-OMS-1": "#d97706", "DEMO-APPLICATION-DATA": "#7c3aed", "DEMO-APPLICATION-ESG": "#db2777", "DEMO-APPLICATION-GOVERNANCE": "#2563eb", "DEMO-APPLICATION-WAREHOUSE": "#65a30d"}, "view_contract": "Local view adapter, not full methodology conformance. Explicit snapshots and planned scenarios; horizon labels are not inferred dates.", "mapping_semantics": "Mappings do not inherit. Missing mapping means not specified, not unsupported. Area is not a coverage percentage.", "functional_overlap_semantics": "Boundary of the union of pairwise intersections of selected outer system polygons: points inside at least two polygons. Capability cut-out masks do not affect this contour; it does not prove redundant functionality.", "view_date": "2026-10-23", "snapshot_as_of": "2026-10-22", "effective_from": "2026-10-01", "effective_to": "2027-01-01", "view": {"coverage_shape": "angled", "round_coverage": false, "functional_overlap": false, "functional_overlap_system_pairs": [], "view_date": "2026-10-23", "system_id": null, "depth": 3, "system_labels": false, "maturity": false, "legend": true, "sort_layers": true, "show_backlog": false, "tag_filter": null, "coverage": false, "coverage_system_id": null, "coverage_system_ids": []}}Acme Corp — Expanded DemonstrationSource-backed core + illustrative layers, intersections and applicationsCurrent State — extended demo · As of 2026-10-22Current-state snapshotDate: 2026-10-23 · Snapshot basis: 2026-10-22 · Recorded snapshot basis; no implied daily observationLayout: Layers · Backlog: off · Tag: All · System: All · Depth: 3 · System labels: off · Maturity: off · Legend: on · Coverage: offOrder Management — layer: Execution; tags: nonev.1.0.0/0Order ManagementLayer: ExecutionCustomer Relationship Management — layer: Strategic; tags: nonev.2.0.0/0Customer Relationship ManagementLayer: StrategicInventory & Warehousing (demo) — layer: Execution; tags: nonev.3.0.0/0Inventory & Warehousing (demo)Layer: ExecutionStrategicLearningPlanningExecutionAssuranceNot specifiedExecutionAssurancePlanningExecutionAssuranceExecutionAssuranceCompliance & Data Protection — layer: Not specified; tags: Supporth.1.0.0/0Compliance & DataProtectionSupportOrder data protection (demo) — layer: Execution; tags: Supporth.1.1.0/1Order data protection (demo)SupportOrder erasure controls (demo) — layer: Assurance; tags: Supporth.1.1.1/1Order erasure controls (demo)SupportCustomer consent controls (demo) — layer: Execution; tags: Supporth.1.2.0/2Customer consent controls (demo)SupportConsent audit (demo) — layer: Assurance; tags: Supporth.1.2.1/2Consent audit (demo)SupportWarehouse privacy (demo) — layer: Execution; tags: Supporth.1.3.0/3Warehouse privacy (demo)SupportOrder Intake — layer: Execution; tags: nonev.1.1.0/0Order IntakeOrder validation (demo) — layer: Execution; tags: nonev.1.1.1/0Order validation (demo)Order Fulfilment — layer: Execution; tags: nonev.1.2.0/0Order FulfilmentPick and pack (demo) — layer: Execution; tags: nonev.1.2.1/0Pick and pack (demo)Fulfilment planning (demo) — layer: Planning; tags: nonev.1.3.0/0Fulfilment planning (demo)Sustainability (demo) — layer: Not specified; tags: ESGh.2.0.0/0Sustainability (demo)ESGPackaging impact planning (demo) — layer: Planning; tags: ESGh.2.1.0/1Packaging impact planning (demo)ESGPackaging evidence (demo) — layer: Assurance; tags: ESG, Supporth.2.1.1/1Packaging evidence (demo)ESG · SupportWarehouse energy (demo) — layer: Execution; tags: ESGh.2.2.0/3Warehouse energy (demo)ESGCustomer strategy (demo) — layer: Strategic; tags: nonev.2.1.0/0Customer strategy (demo)Customer insights (demo) — layer: Learning; tags: nonev.2.2.0/0Customer insights (demo)Master Data Management (demo) — layer: Not specified; tags: MDMh.3.0.0/0Master Data Management(demo)MDMProduct reference data (demo) — layer: Execution; tags: MDMh.3.1.0/1Product reference data (demo)MDMCustomer reference data (demo) — layer: Execution; tags: MDMh.3.2.0/2Customer reference data (demo)MDMCustomer data quality checks (demo) — layer: Assurance; tags: MDM, Supporth.3.2.1/2Customer data quality checks (demo)MDM · SupportInventory master data (demo) — layer: Execution; tags: MDMh.3.3.0/3Inventory master data (demo)MDMWarehouse planning (demo) — layer: Planning; tags: nonev.3.1.0/0Warehouse planning (demo)Stock reconciliation (demo) — layer: Assurance; tags: MDMv.3.1.1/0Stock reconciliation (demo)MDMReturns improvement (demo) — layer: Not specified; tags: ESGv.3.2.0/0Returns improvement (demo)ESGBands: management-cycle stages \ No newline at end of file diff --git a/capability-maps/acme-mdm-coverage.svg b/capability-maps/acme-mdm-coverage.svg new file mode 100644 index 0000000..8f92209 --- /dev/null +++ b/capability-maps/acme-mdm-coverage.svg @@ -0,0 +1 @@ +Acme Corp — Expanded Demonstration{"methodology_revision": "888c03d33c2d899ec85a612901075b67811614e5", "methodology_baseline_revision": "3c75d0403dd4e2dc618bc9535ea293d0495e1ec1", "methodology_contract_status": "merged core-methodology correction; not released", "adapter_version": "dsm-capability-html/6", "renderer_version": "6.8.2", "model_revision": "transitrix/acme-corp@e331590b13935d1d0922063acbf1f6a0cb3cdba2+demo-extension-2026-10-23; management-cycle/tag teaching overlay 2026-10-23; multi-system coverage demo; dated history/current/plan demo", "state_id": "target", "state_kind": "target", "horizon_label": "Planned demo for 2027; not Acme commitments", "as_of": "2027-01-01", "layout_mode": "classic", "show_backlog": false, "tag_filter": "MDM", "layer_vocabulary": ["Strategic", "Learning", "Planning", "Execution", "Assurance"], "tag_vocabulary": ["ESG", "MDM", "Support"], "classification_mapping": "explicit layer/tags; legacy property mapped without inheritance", "coverage_system_id": "DEMO-APPLICATION-DATA", "coverage_colors": {"APPLICATION-CRM-1": "#0d9488", "APPLICATION-OMS-1": "#d97706", "DEMO-APPLICATION-DATA": "#7c3aed", "DEMO-APPLICATION-ESG": "#db2777", "DEMO-APPLICATION-GOVERNANCE": "#2563eb", "DEMO-APPLICATION-WAREHOUSE": "#65a30d"}, "view_contract": "Local view adapter, not full methodology conformance. Explicit snapshots and planned scenarios; horizon labels are not inferred dates.", "mapping_semantics": "Mappings do not inherit. Missing mapping means not specified, not unsupported. Area is not a coverage percentage.", "functional_overlap_semantics": "Boundary of the union of pairwise intersections of selected outer system polygons: points inside at least two polygons. Capability cut-out masks do not affect this contour; it does not prove redundant functionality.", "view_date": "2027-01-01", "snapshot_as_of": "2027-01-01", "effective_from": "2027-01-01", "effective_to": "2028-01-01", "view": {"coverage_shape": "angled", "round_coverage": false, "functional_overlap": true, "functional_overlap_system_pairs": [["DEMO-APPLICATION-DATA", "DEMO-APPLICATION-GOVERNANCE"], ["DEMO-APPLICATION-DATA", "DEMO-APPLICATION-WAREHOUSE"], ["DEMO-APPLICATION-GOVERNANCE", "DEMO-APPLICATION-WAREHOUSE"]], "view_date": "2027-01-01", "system_id": null, "depth": 3, "system_labels": false, "maturity": false, "legend": true, "sort_layers": false, "show_backlog": false, "tag_filter": "MDM", "coverage": true, "coverage_system_id": null, "coverage_system_ids": ["DEMO-APPLICATION-DATA", "DEMO-APPLICATION-GOVERNANCE", "DEMO-APPLICATION-WAREHOUSE"]}}Acme Corp — Expanded DemonstrationSource-backed core + illustrative layers, intersections and applicationsTarget State — illustrative scenario · Planned demo for 2027; not Acme commitments · As of 2027-01-01Target scenario, not a current factDate: 2027-01-01 · Snapshot basis: 2027-01-01 · Planned scenario; not an observed outcomeLayout: Classic · Backlog: off · Tag: MDM · System: All · Depth: 3 · System labels: off · Maturity: off · Legend: on · Coverage: Data Hub (demo), Governance Portal (demo), Warehouse System (demo)Order Management — layer: Execution; tags: nonev.1.0.0/0Order ManagementCustomer Relationship Management — layer: Strategic; tags: nonev.2.0.0/0Customer Relationship ManagementInventory & Warehousing (demo) — layer: Execution; tags: nonev.3.0.0/0Inventory & Warehousing (demo)Warehouse planning (demo) — layer: Planning; tags: nonev.3.1.0/0Warehouse planning (demo)Stock reconciliation (demo) — layer: Assurance; tags: MDMv.3.1.1/0Stock reconciliation (demo)MDMMaster Data Management (demo) — layer: Not specified; tags: MDMh.3.0.0/0Master Data Management(demo)MDMProduct reference data (demo) — layer: Execution; tags: MDMh.3.1.0/1Product reference data (demo)MDMCustomer reference data (demo) — layer: Execution; tags: MDMh.3.2.0/2Customer reference data (demo)MDMCustomer data quality checks (demo) — layer: Assurance; tags: MDM, Supporth.3.2.1/2Customer data quality checks(demo)MDM · SupportInventory master data (demo) — layer: Execution; tags: MDMh.3.3.0/3Inventory master data (demo)MDMMuted boxes: parent/domain contextCoverage: Data Hub (demo)Coverage: Governance Portal (demo)Coverage: Warehouse System (demo)Overlap: explicit shared mappings; area is not a percentageRed contour: intersection of 2+ system coverage polygonsData Hub (demo) coverage — explicit business-capability mappings; polygon area is not a percentageData Hub (demo)Governance Portal (demo) coverage — explicit business-capability mappings; polygon area is not a percentageGovernance Portal (demo)Warehouse System (demo) coverage — explicit business-capability mappings; polygon area is not a percentageWarehouse System (demo) \ No newline at end of file diff --git a/capability-maps/index.html b/capability-maps/index.html new file mode 100644 index 0000000..26711d8 --- /dev/null +++ b/capability-maps/index.html @@ -0,0 +1,164 @@ + + + + + + Business capabilities, system coverage and time | Transitrix + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
Learn / Capability maps
+
+

Business capabilities, system coverage and time

+

See what the business can do, how its systems support that work, and which state of the organisation you are looking at.

+

By Valerii Korobeinikov · · 6 min read

+
+ +
+

One map, several useful questions

+

A capability map names the abilities an organisation needs: order management, customer relationship management, fulfilment planning, data quality control. It gives a stable structure for discussing change even when teams, processes and applications are being reorganised.

+

The same structure can answer different questions. Which abilities belong together? Which help set direction, plan work, execute it or check results? Which systems support them? What was different last quarter, and what is only planned for next year?

+

The standalone capability-map skill turns explicitly supplied data into an interactive HTML file and a native vector image. The HTML works locally in a browser; Python 3 generates it without a server or external rendering service.

+ +

Acme Corp is a teaching example. Its source-backed core comes from the public Acme model; added capabilities, classifications, technical mappings and historical/planned scenarios are illustrative. The diagram keeps these disclosures visible. It does not describe a measured deployment.

+
+ +
+

Keep the business structure readable

+

Level-one vertical capabilities form domain columns. Their level-two and level-three capabilities sit inside the relevant parent, with enough width for their names. Horizontal capabilities form bands across domains; explicit intersection boxes show where their more specific abilities apply.

+

For example, Order Management is a domain. A horizontal data-management capability can contain separate abilities for order, customer and inventory data. Its identity and hierarchy matter independently of whether those boxes also carry the tag MDM, meaning master data management.

+

The classic layout emphasises this structure. Turning on Sort by layers arranges explicitly classified abilities into coloured zones while keeping their parent frames and horizontal intersections.

+
+ Acme teaching map with vertical business domains, horizontal capabilities and coloured management-cycle zones; nested cards remain within their parent frames. +
The same hierarchy grouped by management-cycle stage. Open the vector image for detail, or use the interactive download to switch layouts.
+
+
+ +
+

Five stages describe the role of an ability

+

The stage classification adapts Plan–Do–Check–Act with an explicit Learning stage. Strategic planning belongs to Strategic; Planning describes tactical and operational planning. Strategic also includes significant changes to direction informed by what the organisation has learned.

+
+ + + + + + + + +
Our stageCycle correspondenceExamples of abilities
StrategicAct + strategic PlanChoose direction, set strategic priorities, redesign the organisation.
LearningLearnResearch, reflect, retain knowledge and develop competence.
PlanningTactical/operational PlanPlan capacity, budgets, resources and schedules.
ExecutionDoFulfil orders, run operations and maintain reference data.
AssuranceCheckCheck quality, outcomes, controls and compliance.
+

This is a way to organise a view, not a process sequence. Improvement can happen within every domain. A broad parent capability can remain unclassified while its children occupy different stages; a missing stage stays visibly unspecified.

+

Tags answer a different question. ESG (environmental, social and governance), MDM and Support describe subject affiliation or a supporting role. They appear on boxes and can filter the map. A tag neither creates a horizontal capability nor changes its stage. Neither classification is inherited automatically.

+
+ +
+

Show system coverage without inventing support

+

A system can link directly to a business capability. It can also expose a named technical ability with its own explicit business-capability mappings. Those two evidence paths remain distinct, even when they lead to the same box.

+

Select one or more systems and enable Coverage polygons. Each system receives a translucent polygon and a name inside it. The example lets you compare Data Hub, Governance Portal and Warehouse System over reference-data abilities.

+
+ Planned Acme teaching scenario filtered by MDM, with three translucent system coverage polygons and a red outline around their overlapping region. +
Three systems over an MDM-filtered planned scenario. The red contour encloses the area inside at least two selected outer polygons, including any three-way intersection.
+
+

Use Functional overlap to outline that shared geometric region in red. It is a prompt for investigation: two systems near the same business ability may perform complementary work. The contour alone proves neither duplicate functionality nor a reason to retire a system. Polygon area is not a coverage percentage, and an absent link means support has not been specified.

+

Switch between angled and rectangular polygons, then round their corners independently. These choices change presentation, not mapping facts. System labels, coverage and backlog are optional; labels expand boxes only when shown.

+
+ +
+

Choose a date and keep plans visibly separate

+

The timeline moves through explicitly supplied state periods. In the Acme teaching example, you can inspect a historical period, the current demonstration and a planned 2027 scenario. Capabilities, maturity assessments and system mappings change at their stated boundaries.

+

A selected date is not the date on which evidence was observed. A plan does not become an observed result just because its date has passed. The example therefore keeps the selected date, snapshot basis and scenario kind separate. Dates outside the supplied periods show no data rather than extending the last known state.

+

Try this route through the download:

+
    +
  1. Open the extracted HTML. Compare the classic layout with Sort by layers.
  2. +
  3. Select the MDM tag and Data Hub, Governance Portal and Warehouse System. Enable coverage and overlap.
  4. +
  5. Move between October 2026 and January 2027. Read the current/planned caption as mappings change.
  6. +
  7. Enable Diagram only and Fit to screen. Restore controls, then download the exact visible SVG.
  8. +
+
+ +
+

Use it with your own model

+

The skill download contains agent instructions, a human README, renderer, input contract, tests and source/illustration notes. Copy the folder into an Agent Skills host or run the renderer directly:

+
python3 scripts/render.py assets/example.json capability-map.html
+python3 scripts/render.py assets/example.json capability-map.svg --no-backlog
+

Replace the example with an explicit JSON projection of your source model. The renderer does not ingest native Transitrix YAML or edit DSM/Studio. The core methodology correction is merged but not yet part of a tagged release; the bundled mapping notes identify its revision and the limits of released validators. A successful render does not establish source-model validity.

+

The downloadable HTML contains all supplied snapshots. Its filters are presentation controls, not a way to remove sensitive source data before sharing. The provided demonstration uses public and synthetic teaching data.

+

Browse the skill source and README. Read the capability modelling guide, inspect the Acme source revision, or verify the downloads against their SHA-256 checksums.

+
+

Continue with model examples or the learning path.

+
+ + + + diff --git a/capability-maps/render-dsm-capabilities-html-6.8.2.zip b/capability-maps/render-dsm-capabilities-html-6.8.2.zip new file mode 100644 index 0000000..889843d Binary files /dev/null and b/capability-maps/render-dsm-capabilities-html-6.8.2.zip differ diff --git a/index.html b/index.html index 77e95db..7021c77 100644 --- a/index.html +++ b/index.html @@ -207,6 +207,7 @@

Questions, answered

  • Which editor do I use?
  • Is Transitrix open source?
  • What can I model?
  • +
  • Business capabilities, system coverage and time
  • Do I need DSM to get started?
  • diff --git a/learn/index.html b/learn/index.html index b453d9b..c91448e 100644 --- a/learn/index.html +++ b/learn/index.html @@ -142,6 +142,7 @@

    Learn Transitrix

    Learn more

    Once you've worked through the path: