Org trees

An org tree is Deckgauge's model of your engineering organisation — people, roles, and reporting lines. Contribution ranking, employee boards, and the timesheet's per-tree status configuration all hang off it.

deckgauge · Org tree
N. Kwan
VP Engineering
T. Alvarez
Eng Manager
F. Byrne
Eng Manager

A hierarchy rooted at a chosen person, imported from a CSV or Microsoft Graph.

Building the tree

  • Import Chart — in the tree's toolbar, upload a CSV or Excel roster (name, email, role, manager). Rows are created or updated by a stable employee id; a manager reference that doesn't match another row is reported as an orphan warning.
  • Microsoft Graph — in the tree's Source tab, connect a Microsoft account and set a root person; everyone reporting up to them is pulled in on Sync now. See Microsoft Graph.

Either way, click Sync in the toolbar afterwards to match the roster's identities against your connected sources — this is what populates each person's activity, contribution ranking, and matched status. See Contribution ranking for how that matching works, and how to fix it when it's wrong.

Renaming and deleting a tree

Both live on the org tree's own page, next to its name. Rename prompts for a new name. Delete permanently removes the tree's employees and identity aliases and its timesheet configuration — synced hours data itself isn't deleted, but the tree's timesheet view is gone — and there's no undo.

Deleting a person deletes their whole branch

Removing an employee removes that person and every descendant beneath them — the branch, not just the node. The confirmation dialog names the count and rolls the names (capped at five, then "and N more"), and deleting a leaf still gets a one-person message.

This changed, and there is no undoDeleting a manager used to re-parent their direct reports onto the deleted person's own manager — and only the direct ones, so grandchildren were left dangling under a parent nobody chose. It now removes the subtree. "Delete this manager, keep their team" is no longer one step: drag the reports out first, then delete. The dialog is the only guard, because nothing in the product has an undo.

Employee boards and the timesheet

Inside a tree, + New board creates an employee board — a Monday-style view of the tree's people, with configurable columns, bulk actions, and a Rating column tied to contribution ranking. See Employee boards.

The tree's Timesheet and Report tabs are a view on this same tree, not a separate entity — they show CapEx/OpEx time allocation for its people. See Timesheet & workload.

Under the hood

Clicking a person on the org chart, or a row's Rating column on any employee board, opens their card, with tabs for Updates, Profile, Activity, and Ranking.

If it looks wrong

SymptomCauseFix
Import reports unresolved managersA row's manager reference doesn't match another row's employee idFix the manager id or name in the source file and re-import
People aren't updating after a Microsoft syncThe two-step sync (pull roster, then match) is still runningWait for the Source tab's status to leave "Syncing…", then check again
Deleted a tree by mistakeDelete has no undoRestore from a backup — see Backup & restore

Related

Last updated