"""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)