openapi: 3.1.0
info:
  title: UI Copy, IA & Localization Neutralization Logical Contract
  version: 0.1.0
  summary: Logical view-model contract for environment-first operator copy on bounded workspace-first admin surfaces.
paths:
  /admin/choose-tenant:
    get:
      summary: Environment chooser surface
      operationId: getEnvironmentChooserSurface
      responses:
        '200':
          description: Environment-first chooser contract
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnvironmentChooserSurface'
  /admin/workspaces/{workspace}/managed-tenants:
    get:
      summary: Managed environments landing surface
      operationId: getManagedEnvironmentLandingSurface
      parameters:
        - $ref: '#/components/parameters/Workspace'
      responses:
        '200':
          description: Managed-environment registry contract
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedEnvironmentLandingSurface'
  /admin/workspaces/{workspace}/environments/{environment}:
    get:
      summary: Environment dashboard surface
      operationId: getEnvironmentDashboardSurface
      parameters:
        - $ref: '#/components/parameters/Workspace'
        - $ref: '#/components/parameters/Environment'
      responses:
        '200':
          description: Environment dashboard heading and chip contract
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnvironmentDashboardSurface'
  /__logical/shell/context-bar:
    get:
      summary: Shared shell/context-bar copy surface
      operationId: getEnvironmentShellSurface
      responses:
        '200':
          description: Environment-first shell label contract
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnvironmentShellSurface'
  /__logical/policy/provider-helper-copy:
    get:
      summary: Pinned provider-helper copy surfaces
      operationId: getPolicyProviderHelperSurface
      responses:
        '200':
          description: Policy detail, versions restore, and baseline-compare helper-copy contract
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyProviderHelperSurface'
components:
  parameters:
    Workspace:
      name: workspace
      in: path
      required: true
      schema:
        type: string
    Environment:
      name: environment
      in: path
      required: true
      schema:
        type: string
  schemas:
    EnvironmentChooserSurface:
      type: object
      required:
        - title
        - primaryActionLabel
        - emptyStateLabel
        - searchPlaceholder
      properties:
        title:
          type: string
          enum:
            - Choose environment
            - Umgebung auswählen
        primaryActionLabel:
          type: string
        emptyStateLabel:
          type: string
        searchPlaceholder:
          type: string
        providerOwnedLabelsOutOfScope:
          type: array
          items:
            type: string
          default:
            - Sign in with Microsoft
    ManagedEnvironmentLandingSurface:
      type: object
      required:
        - title
        - openActionLabel
        - registryBackLinkLabel
      properties:
        title:
          type: string
          enum:
            - Managed environments
            - Verwaltete Umgebungen
        openActionLabel:
          type: string
        registryBackLinkLabel:
          type: string
        rowContextField:
          type: string
          enum:
            - environment_label
    EnvironmentDashboardSurface:
      type: object
      required:
        - title
        - scopeLabel
      properties:
        title:
          type: string
          enum:
            - Environment dashboard
            - Umgebungs-Dashboard
        scopeLabel:
          type: string
        returnLabel:
          type: string
        helperCopy:
          type: object
          additionalProperties:
            type: string
          description: Neutral default copy for bounded restore/capture/baseline-compare entry surfaces. Provider detail remains secondary.
    EnvironmentShellSurface:
      type: object
      required:
        - scopeLabel
        - returnLabel
      properties:
        scopeLabel:
          type: string
        returnLabel:
          type: string
        duplicateScopeSummaryForbidden:
          type: boolean
          const: true
    PolicyProviderHelperSurface:
      type: object
      required:
        - policyDetailSyncDescription
        - viewPolicyCaptureSubheading
        - versionsRestoreLabel
        - versionsRestoreHeading
        - baselineCompareRbacSummaryHeading
      properties:
        policyDetailSyncDescription:
          type: string
        viewPolicyCaptureSubheading:
          type: string
        versionsRestoreLabel:
          type: string
        versionsRestoreHeading:
          type: string
        baselineCompareRbacSummaryHeading:
          type: string
        providerDetailSecondaryOnly:
          type: boolean
          const: true