96 lines
2.1 KiB
Markdown
96 lines
2.1 KiB
Markdown
|
---
|
||
|
|
title: Tasks — Reference
|
||
|
|
---
|
||
|
|
|
||
|
|
# Tasks — Reference
|
||
|
|
|
||
|
|
The Tasks page shows all tasks across every workstream and domain, with live
|
||
|
|
filtering, a status distribution chart, and a blocked-tasks highlight section.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Task statuses
|
||
|
|
|
||
|
|
| Status | Meaning |
|
||
|
|
|--------|---------|
|
||
|
|
| **todo** | Not yet started |
|
||
|
|
| **in_progress** | Actively being worked on |
|
||
|
|
| **blocked** | Cannot proceed — has a blocking reason |
|
||
|
|
| **done** | Completed |
|
||
|
|
| **cancelled** | Dropped; not counted toward totals |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Task priorities
|
||
|
|
|
||
|
|
| Priority | Use for |
|
||
|
|
|----------|---------|
|
||
|
|
| **critical** | Must be resolved immediately; blocks a release or governance gate |
|
||
|
|
| **high** | Should be resolved this session or next |
|
||
|
|
| **medium** | Normal backlog priority |
|
||
|
|
| **low** | Nice-to-have; deferred is acceptable |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Filter bar
|
||
|
|
|
||
|
|
| Filter | Effect |
|
||
|
|
|--------|--------|
|
||
|
|
| **Status** | Multi-select — show only chosen statuses |
|
||
|
|
| **Priority** | Multi-select — show only chosen priorities |
|
||
|
|
| **Domain** | Multi-select — filter by domain slug |
|
||
|
|
| **Assignee** | Case-insensitive substring match on the assignee field |
|
||
|
|
|
||
|
|
All filters are applied client-side after each poll.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Status Distribution chart
|
||
|
|
|
||
|
|
A horizontal bar chart (Observable Plot) showing the count of filtered tasks
|
||
|
|
per status, colour-coded:
|
||
|
|
|
||
|
|
| Colour | Status |
|
||
|
|
|--------|--------|
|
||
|
|
| grey-blue | todo |
|
||
|
|
| blue | in_progress |
|
||
|
|
| red | blocked |
|
||
|
|
| green | done |
|
||
|
|
| light grey | cancelled |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Blocked Tasks section
|
||
|
|
|
||
|
|
Shows cards for every task currently in `blocked` status within the active
|
||
|
|
filter. Each card displays:
|
||
|
|
|
||
|
|
- Priority badge and status
|
||
|
|
- Domain and workstream context
|
||
|
|
- Task title
|
||
|
|
- Blocking reason (amber background)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## KPI sidebar card
|
||
|
|
|
||
|
|
Shows four counts for the unfiltered dataset: open (todo + in_progress +
|
||
|
|
blocked), blocked, in progress, done, and a done-% of total.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Sorting
|
||
|
|
|
||
|
|
Tasks are sorted by status (blocked first, then in_progress, todo, done,
|
||
|
|
cancelled) then by priority (critical → high → medium → low) within each
|
||
|
|
status group.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Data sources
|
||
|
|
|
||
|
|
Polls every **15 seconds**:
|
||
|
|
- `GET /tasks/?limit=500`
|
||
|
|
- `GET /workstreams/`
|
||
|
|
- `GET /topics/`
|