Files
tom_analysis_agent/app/operating_model/names.py

67 lines
2.6 KiB
Python

"""The names this Workflow is written in: its Phases, its Deliverables and its files."""
from __future__ import annotations
# Phases, in order.
SCOPING = "scoping"
REQUIREMENTS = "operational_requirements"
DESIGN = "operating_model_design"
VALIDATION = "validation"
PACKAGING = "packaging"
PHASES = (SCOPING, REQUIREMENTS, DESIGN, VALIDATION, PACKAGING)
# Deliverable kinds.
OPERATING_SCOPE = "operating_scope"
OPERATIONAL_REQUIREMENTS = "operational_requirements"
CAPABILITY_MODEL = "capability_model"
TARGET_OPERATING_MODEL = "target_operating_model"
VALIDATION_RESULTS = "validation_results"
GUIDE = "operating_model_guide"
# Data files.
SCOPE_DATA_FILE = "scope.json" # the engine's: what every Specialist reads of the spec
REQUIREMENTS_FILE = "operational-requirements.json"
CAPABILITIES_FILE = "capabilities.json"
GRAPH_FILE = "target-operating-model.json"
FINDINGS_FILE = "findings.json"
STAFFING_FILE = "staffing.json"
ORGANISATION_FILE = "organisation.mmd"
VERDICTS_FILE = "verdicts.json"
SCENARIOS_FILE = "scenarios.json"
CHANGES_FILE = "changes.json"
GUIDE_FILE = "operating-model-guide.md"
CHANGE_REQUEST_FILE = "architecture-change-request.md"
# Hours a Capability must be staffed for and a Role works, narrowest first.
HOURS = ("business", "extended", "24x7")
PARTY_KINDS = ("customer", "provider", "supplier", "cloud_provider")
CUSTOMER = "customer"
ACCOUNTABLE, RESPONSIBLE, CONSULTED, INFORMED = (
"accountable",
"responsible",
"consulted",
"informed",
)
RESPONSIBILITY_KINDS = (ACCOUNTABLE, RESPONSIBLE, CONSULTED, INFORMED)
CUSTOM = "custom" # a Capability the catalogue does not have
# Team Topologies: the four kinds of team, and the three ways two teams work together.
TEAM_TYPES = ("stream_aligned", "platform", "enabling", "complicated_subsystem")
COLLABORATION, X_AS_A_SERVICE, FACILITATING = (
"collaboration",
"x_as_a_service",
"facilitating",
)
INTERACTION_MODES = (COLLABORATION, X_AS_A_SERVICE, FACILITATING)
# What a Measure tells about a business outcome. The first three are the layers of
# measuring how work flows (DORA, SPACE, DevEx); none stands in for another.
OUTCOME_LAYER, GUARDRAIL_LAYER, LEADING_LAYER = "outcome", "guardrail", "leading"
DEVELOPER_LAYERS = (OUTCOME_LAYER, GUARDRAIL_LAYER, LEADING_LAYER)
MEASURE_LAYERS = (*DEVELOPER_LAYERS, "service_level", "cost")
# The catalogue entry whose measures must cover all three developer layers.
MEASUREMENT_ENTRY = "delivery-and-developer-experience-measurement"
def wider(first: str, second: str) -> bool:
"""Whether `first` hours are wider than `second`."""
return HOURS.index(first) > HOURS.index(second)