O Modelo da Plataforma

A Chave Semântica

Tudo deriva de uma única chave de três segmentos:

{project} - {env} - {service}

Segmento	Função	Exemplos
project	Limite de propriedade — domínio ou área de produto	payments, orders, platform
env	Alvo de implantação	dev, staging, prod, mgmt
service	Carga de trabalho individual ou peça de infra	api, worker, gke-main

env é de propriedade do Kubernetes e do ArgoCD. O Backstage observa env em tempo de execução — nunca o define.

Como a Chave Mapeia Entre Todos os Sistemas

Conceito	Backstage	ArgoCD	Kubernetes	Crossplane
Limite de propriedade	Domain	AppProject	label project	Prefixo de namespace dos Claims
Produto lógico	System	ApplicationSet	grupo de namespace <project>-*	—
Carga de trabalho	Component	Application (base)	label service	—
Recurso de nuvem	Resource	Application	namespace de infra <project>-<env>-infra	Claim
Instância de deploy	(observado)	Application (instância)	namespace <project>-<env>-<service>	—

Visão Completa

Catálogo Backstage       ArgoCD                   Kubernetes               Nuvem
─────────────────────────────────────────────────────────────────────────────────────

Domain: payments    ──►  AppProject: payments  ──►  label: project=payments
│
├── System: gateway  ──►  AppSet: gateway       ──►  grupo de namespace: payments-*
│   └── Component:   ──►  Application:           ──►  payments-dev-api
│       gateway-api        gateway-api-<env>           payments-staging-api
│                                                       payments-prod-api
│
└── Resource:        ──►  Application:           ──►  payments-prod-infra     ──►  GKE Cluster
    gcp-payments-          crossplane-payments-         Claim: gke-main              (GCP)
    prod-gke-main          prod-gke-main