DocsCode and infrastructure

Teams and scorecards

Say who owns what, give teams their own alerts, permissions and approvals, and score every service on nine basics.

Teams

Teams says who owns what. OpsNexa Online suggests the teams it finds in Backstage catalog-info.yaml groups and CODEOWNERS (@acme/payments), with the people in them who have accounts. Make one in a click and pick its leads.

A team owns every service whose owner names match, the repositories and systems you give it, and the apps built from those repositories. Its page shows its people, services, apps and what runs in production, recent deploys, shared code it should upgrade, its scorecard and its alert channels.

Teams: each team with its services, apps, versions behind, cost and open risks.
Teams: what each one owns and how it's doing.

Team permissions

Off until an admin turns them on. Then developers change only the apps and repositories their teams own, or that no team owns. Looking is always allowed. The same rule applies to AI assistants.

Lead approvals

When an app’s production deploys need approval, a lead of the team that owns it can approve, as well as admins (never the person who asked).

Team channels

A notification channel can belong to a team. It then hears only about that team’s apps and repositories, while company channels hear everything. See Monitors and notifications.

Scorecards

Systems → Scorecards checks every service against nine basics:

  1. it has an owner;
  2. a team owns it;
  3. no critical or high risks;
  4. shared code pinned to versions;
  5. nothing a major version behind;
  6. it’s known where it runs;
  7. pull requests are checked;
  8. alerts reach someone;
  9. its database is backed up, recently.

A check that doesn’t apply (a library isn’t deployed) isn’t counted. Each service gets a score and a grade (great from 90, good from 70, needs work from 50, at risk below), and each check says how to fix it. Teams get the score of what they own, and the company gets one number to watch over time.

Scorecards: the company score, each check, and every service.
Scorecards: one number for the company, and what to fix first.

Something unclear or missing? Tell us, or press the ? at the top of OpsNexa Online for the guide and tours inside the product.