backstage-catalog

This repository is the source of truth for org-level Backstage entities at Weezevent: Systems, Domains, and any Groups not auto-synced from GitHub Teams.

It is automatically discovered by Backstage via the GitHub org integration — no manual registration needed.

---

Structure

systems/           ← one file per product area, owned by each Team Lead
domains/           ← optional grouping of systems into broader domains
docs/              ← TechDocs markdown for system pages (optional but recommended)
catalog-info.yaml  ← registers this repo itself in the catalog

---

What is a System?

A System is a product-level page in Backstage that groups all the repos belonging to a product area. Once a System entity exists, any component that declares spec.system: weezpay will automatically appear on the WeezPay system page.

This gives team leads a single page showing every service, app, library, and tool they own.

---

How to create or update your System

1. Edit (or create) systems/<your-system>.yaml in this repo
2. Fill in the fields — see the existing files for examples
3. Open a PR — it is just YAML, any team member can review it
4. Once merged, your system page is live within minutes at: https://backstage.build-00.openticket.tech/catalog/default/system/<your-system>

To add a documentation page to your system, create docs/<your-system>/index.md and add this annotation to your system YAML:

annotations:
  backstage.io/techdocs-ref: dir:./docs/<your-system>

---

Finding your group name

Browse available groups at: https://backstage.build-00.openticket.tech/catalog/default/group?filters%5Bkind%5D=group&filters%5Buser%5D=all

Use the squad-level group for spec.owner, e.g. group:default/dev-squad-doom.

---

Questions

Ask in #dev-backstage.