TenantAtlas/specs/406-provider-policy-domain-public-taxonomy/contracts/public-taxonomy-routes.openapi.yaml
ahmido 09dc9988cb 406: Provider & Policy Domain Public Taxonomy (#401)
## Summary
- add the 406 feature specification for a public provider and policy-domain taxonomy surface
- include plan, research, data model, quickstart, checklist, and public route contract artifacts
- update agent context with the 406 website technology notes

## Notes
- this PR is spec and planning work only
- no runtime website implementation is included yet

## Validation
- reviewed pending git scope before commit
- verified `Agents.md` has no editor diagnostics

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #401
2026-05-26 12:54:23 +00:00

168 lines
4.8 KiB
YAML

openapi: 3.1.0
info:
title: Tenantial Public Provider and Policy Domain Taxonomy Routes
version: 0.1.0
description: >
Static public website route contract for Spec 406. These routes return
HTML pages only and do not expose platform runtime APIs, tenant data, or
provider integration capabilities.
servers:
- url: http://127.0.0.1:4321
description: Local website preview using WEBSITE_PORT default
paths:
/platform/domains:
get:
summary: German public provider and policy domain taxonomy page
operationId: getGermanProviderPolicyDomainTaxonomy
tags:
- Public Website
responses:
"200":
description: Static HTML taxonomy page
content:
text/html:
schema:
type: string
examples:
page:
summary: Required visible content
value: "Microsoft 365 zuerst. Gebaut fuer Policy-Domaenen ueber Intune hinaus."
"404":
description: Route not configured
x-content-requirements:
locale: de
mustInclude:
- Microsoft 365 first-market positioning in German site language
- Intune as first strong policy focus, not full product category
- Status legend with five public status meanings
- Microsoft 365 domain matrix
- Future provider direction section
- Buyer-facing MSP and enterprise IT section
mustNotInclude:
- href="#"
- Google supported
- AWS supported
- Okta supported
- multi-cloud supported
- all cloud providers
- every SaaS platform
- provider-agnostic restore
- universal policy governance
- automatic remediation
- automatic restore
- self-healing
- real-time drift
- immutable backups
- gerichtsfeste Nachweise
- lueckenlose Evidenz
/en/platform/domains:
get:
summary: English public provider and policy domain taxonomy page
operationId: getEnglishProviderPolicyDomainTaxonomy
tags:
- Public Website
responses:
"200":
description: Static HTML taxonomy page
content:
text/html:
schema:
type: string
examples:
page:
summary: Required visible content
value: "Microsoft 365 first. Built for policy domains beyond Intune."
"404":
description: Route not configured
x-content-requirements:
locale: en
mustInclude:
- Microsoft 365 first-market positioning
- Intune as first strong policy focus, not full product category
- Status legend with five public status meanings
- Microsoft 365 domain matrix
- Future provider direction section
- Buyer-facing MSP and enterprise IT section
mustNotInclude:
- href="#"
- Google supported
- AWS supported
- Okta supported
- multi-cloud supported
- all cloud providers
- every SaaS platform
- provider-agnostic restore
- universal policy governance
- automatic remediation
- automatic restore
- self-healing
- real-time drift
- immutable backups
components:
schemas:
PublicStatusLabel:
type: object
required:
- key
- label
- description
properties:
key:
type: string
enum:
- current-focus
- planned-domain
- architecture-direction
- not-currently-available
- not-claimed
label:
type: string
description:
type: string
PolicyDomainRow:
type: object
required:
- domain
- provider
- statusKey
- governanceValue
- tenantialHelpsWith
- claimBoundary
properties:
domain:
type: string
provider:
type: string
statusKey:
$ref: "#/components/schemas/PublicStatusKey"
governanceValue:
type: string
tenantialHelpsWith:
type: string
claimBoundary:
type: string
FutureProviderRow:
type: object
required:
- provider
- statusKey
- safeWording
- claimBoundary
properties:
provider:
type: string
statusKey:
$ref: "#/components/schemas/PublicStatusKey"
safeWording:
type: string
claimBoundary:
type: string
PublicStatusKey:
type: string
enum:
- current-focus
- planned-domain
- architecture-direction
- not-currently-available
- not-claimed