📊 SRE & Platform Engineering — Platform Developer Portal Kit Demo

• Service Catalog (Backstage-compatible YAML) — catalog-info.yaml entries for multiple example services showing ownership, dependencies, lifecycle, and API definitions
• Software Templates (Scaffolder YAML) — Ready-to-use scaffolder templates for creating new services, APIs, and frontend applications following your golden path
• API Documentation (OpenAPI 3.1) — Example OpenAPI specs showing best practices for documenting internal and external APIs
• Golden Path Onboarding Guides — Markdown guides for new developers: getting started, service ownership, and the "paved road" for shipping software
• Self-Service Infrastructure (HCL/Terraform) — Reusable Terraform modules for common infrastructure patterns (ECS services, RDS databases, S3 buckets)
• TechDocs Structure — MkDocs-ready documentation structure for publishing technical documentation through your portal

# Add to the root of your service repository
cp catalog/catalog-info-api-gateway.yaml /path/to/your-service/catalog-info.yaml
# Edit the metadata to match your service


# Use any Terraform module directly
cd infra/modules/ecs-service
terraform init
terraform plan -var="service_name=my-api" -var="container_image=my-registry/my-api:latest"

from src.catalog_validator import CatalogValidator

validator = CatalogValidator()
validator.load_directory("catalog/")

report = validator.validate()
print(report.summary())
# Outputs: validation results for all catalog-info.yaml files