Skip to content

Project Portfolio Management (PPM)

The PPM module provides a complete project portfolio management solution for tracking initiatives, budgets, risks, tasks, and timelines. It integrates directly with the Initiative card type to enrich each project with status reporting, cost tracking, and Gantt visualization.

Note

The PPM module can be enabled or disabled by an administrator in Settings. When disabled, PPM navigation and features are hidden.

Portfolio Dashboard

PPM Portfolio Dashboard

The Portfolio Dashboard is the main entry point for PPM. It provides:

  • KPI Cards — Total initiatives, total budget, total actual cost, and health status summaries
  • Health Pie Charts — Distribution of schedule, cost, and scope health (On Track / At Risk / Off Track)
  • Status Distribution — Breakdown by initiative subtype and status
  • Gantt Overview — Timeline bars showing each initiative's start and end dates, with RAG health indicators

Grouping & Filtering

Use the toolbar to:

  • Group by any related card type (e.g., Organization, Platform) to see initiatives grouped by business unit or technology platform
  • Filter by subtype (Idea, Program, Project, Epic)
  • Search by initiative name

These filters persist in the URL, so refreshing the page retains your current view.

Initiative Detail View

Click any initiative to open its detail page with seven tabs:

Overview Tab

PPM Initiative Overview

The overview shows a summary of the initiative's health and financials:

  • Health Summary — Schedule, cost, and scope indicators from the latest status report
  • Budget vs. Actual — Combined KPI card showing total budget and actual spend with variance
  • Recent Activity — Latest status report summary

Status Reports Tab

PPM Status Reports

Monthly status reports track project health over time. Each report includes:

Field Description
Report Date The reporting period date
Schedule Health On Track, At Risk, or Off Track
Cost Health On Track, At Risk, or Off Track
Scope Health On Track, At Risk, or Off Track
Summary Executive summary of current status
Accomplishments What was achieved this period
Next Steps Planned activities for the next period

Budget & Costs Tab

PPM Budget and Costs

Track financial data with two types of line items:

  • Budget Lines — Planned budget by fiscal year and category (CapEx / OpEx). Budget lines are grouped according to the fiscal year start month configured in Settings. For example, if the fiscal year begins in April, a budget line dated June 2026 belongs to FY 2026–2027
  • Cost Lines — Actual expenditures with date, description, and category

Budget and cost totals automatically roll up to the Initiative card's costBudget and costActual attributes. When PPM cost lines exist, these card fields are marked as auto-computed and become read-only in the card detail view.

Risk Management Tab

PPM Risk Management

The risk register tracks project risks with:

Field Description
Title Brief description of the risk
Probability Likelihood score (1–5)
Impact Impact score (1–5)
Risk Score Auto-calculated as probability x impact
Status Open, Mitigating, Mitigated, Closed, or Accepted
Mitigation Planned mitigation actions
Owner User responsible for managing the risk

Tasks Tab

PPM Task Board

The task manager supports both Kanban board and list views with four status columns:

  • To Do — Tasks not yet started
  • In Progress — Tasks currently being worked on
  • Done — Completed tasks
  • Blocked — Tasks that cannot proceed

Tasks can be filtered and grouped by Work Breakdown Structure (WBS) item. Drag and drop cards between columns to update status. Each task supports:

  • Priority levels (Critical, High, Medium, Low)
  • Assignee (with notification on assignment)
  • Start and due dates
  • Tags for categorization
  • Comments for discussion

Display filters (view mode, WBS filter, group-by toggle) persist in the URL across page refreshes.

Gantt Tab

PPM Gantt Chart

The Gantt chart visualizes the project timeline with:

  • Work Packages (WBS) — Hierarchical work breakdown structure items with start/end dates
  • Tasks — Individual task bars linked to work packages
  • Milestones — Key dates marked with diamond indicators
  • Progress Bars — Visual completion percentage, draggable to adjust directly
  • Quarterly Ticks — Timeline grid for orientation

Interact with the Gantt chart using:

  • Drag bars to reschedule items
  • Resize bar edges to change duration (1-day granularity)
  • Right-click for context menu (edit, add task, mark done, delete)
  • Today button to scroll to the current date

Card Details Tab

The last tab shows the full card detail view, including all standard sections (description, lifecycle, attributes, relations, stakeholders, comments, history).

Work Breakdown Structure (WBS)

The WBS provides a hierarchical decomposition of project scope:

  • Work Packages — Logical groupings of tasks with start/end dates and completion tracking
  • Milestones — Significant events or completion points
  • Hierarchy — Parent-child relationships between WBS items
  • Auto-completion — Completion percentage is automatically calculated from child task done/total ratios, then rolled up recursively through the WBS hierarchy to parent items. Top-level completion represents overall initiative progress

Card Detail Integration

When PPM is enabled, Initiative cards display a PPM tab as the last tab in the card detail view. Clicking this tab navigates directly to the PPM Initiative Detail View (Overview tab). This provides a quick entry point from any Initiative card to its full PPM project page.

Conversely, the Card Details tab within the PPM Initiative Detail View shows the standard card detail sections without the PPM tab, avoiding circular navigation.

Permissions

Permission Description
ppm.view View the PPM dashboard, Gantt chart, and initiative reports. Granted to all roles by default
ppm.manage Create and manage status reports, tasks, costs, risks, and WBS items. Granted to Admin, BPM Admin, and Member roles
reports.ppm_dashboard View the PPM portfolio dashboard. Granted to all roles by default