# Project Management

Plan each project from a template, track its tasks, dates and weekly updates, and see what it has cost against its budget.

When a project's plan lives in one spreadsheet, its invoices in another and its weekly status in someone's email, nobody can say whether it is on track. At Acme Precision, the ERP cutover and the new composite tube line are both in Project Management, so the plant manager can see which tasks are overdue, what has been invoiced against the funding, and what the team decided this week.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

Each project is an outline of tasks (a work breakdown structure, or WBS) with dates, owners, status and % complete. Every project starts from a **template**, and is one of two kinds:

- **Simple** (Board and Timeline): tasks, dates, materials and people, with no money tabs. Good for engineering changes, new products and internal projects.
- **Full** (plan, funding and actuals): adds budgets, funding and invoiced cost, so you can see whether spending is on track. Good for contracts and programs.

The module adds these pages under **Project Management** in the sidebar:

- **Projects**: every project with its **Status**, **Priority**, **Manager**, **Start**, **Finish**, the money columns and **Attention** flags. Tiles at the top total the open projects. **Board** shows every open project's tasks at once, a lane for each.
- **Reports**: ready-made **Project status report**, **Project Progress Record** and **Completed this week**.

Click a project to open it. A full project has the tabs **Overview**, **Plan**, **Board**, **Timeline**, **Updates**, **Workload**, **Actuals**, **Funding**, **Baselines & changes**, **Team** and **Details**. A simple project has **Board**, **Timeline**, **Updates**, **Plan**, **Workload**, **Team** and **Details**. **MS Project** and **Excel** at the top right download the project.

## Set it up

A Workspace Admin does this first.

1. Open **Module Settings** from the ⋮ on the **Project Management** sidebar row, and look at **Preferences**: the working days and hours in a day, how far invoiced cost may trail before a task is flagged **Behind glidepath** (25% of budget out of the box), project fields you don't use (for example cost, to hide every budget and funding view), what to call the project's responsible person (for example *Task Owner*), and one set of level names for every project if you want them to match. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
2. On **Projects**, click **Configuration**. Under **Templates and their lists**, pick a template to review its statuses, priorities, task types, task statuses, cost categories and risk levels. Three templates ship: **Standard project**, **Government R&D contract (deliverable-based)** and **Engineering project**. Click **Clone** for a copy you can rename and reshape, or **Hide from New project** for one you don't use.
3. Under **Company**, add your business units under **Organizations / business units**, tick the holidays you observe under **Holidays (non-working days)**, add any **Custom fields**, and fill the **Resource pool** with people, roles and materials, each with a rate and weekly capacity.
4. Give the permissions to your own roles, such as Project Manager or Engineer. See [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f).
5. Click **New project** to create the first one.

## Find a project and see what needs attention

1. Open **Projects** from the sidebar.
2. Read the tiles: **Funded (open)**, **Budget (open)**, **Invoiced (open)**, **Overdue tasks** and **Behind glidepath** (plus **Milestones done** when projects have milestones).
3. Narrow the list with **Search name, code, customer, contract…**, **All templates** and **All statuses**. Tick **Show archived** to see archived projects.
4. Click a column heading to sort by it. The list starts with the most urgent priority first.
5. Click a project to open it.

## Start a project

1. On **Projects**, click **New project**.
2. Under **Start from**, click a template. It sets the project's lists, level names and starter tasks, and whether it is Simple or Full.
3. Fill in **Name** (required), and if you have them **Code**, **Customer**, **Contract number**, **Start**, **Finish**, **Manager** and **Master project** (to place it under another project).
4. Click **Create**. The project opens on its plan with the template's starter tasks.

To switch a project between Simple and Full later, change **Workspace** on its **Details** tab and click **Save**.

## Check a project's health

1. Open a full project. It starts on **Overview**.
2. Read the tiles: **Funded**, **Current budget**, **Invoiced to date**, **Glidepath to date** (what should have been spent by today), **Expected progress**, **Actual progress**, **Invoiced vs glidepath** and **Work complete**.
3. The **Planned vs invoiced** chart shows spending by month. Pick **Through today** or **Full schedule**.
4. Below are the top-level tasks, **Due in the next 90 days**, **Needs attention** and **Invoiced by category**. Click a task to open it.
5. Use **Showing** to narrow the whole page to one part of the plan.

## Build and read the plan

1. Open the **Plan** tab. Each row has its WBS number, title, status, owner, dates and flags, and on a full project its budget, baseline, slip, invoiced cost and glidepath.
2. Click **Add task** to add a task at the top level.
3. Use **Show** with **1**, **2** or **All** to fold the outline to a level, or click a row's arrow to fold one branch.
4. Filter with **Find WBS, task or owner…**, **Any flag** and **Any owner**.
5. Pick a baseline in **Compare to** to measure slips and budget changes against it.
6. On a task with nothing beneath it, click the **Done** cell to change its % complete.

Flags mark what needs attention: **Overdue**, **Past deadline**, **Behind glidepath**, **Over budget**, **Unbudgeted**, **Order now** (the start is within the task's lead time) and **Link conflict** (the dates break a predecessor link).

## Change a task

1. Click a task on the **Plan**, **Board** or **Timeline** to open its panel.
2. Change its **Type**, **Status**, **Priority**, **Owner**, **% complete**, **Start**, **Finish**, **Deadline**, **Budget**, **Estimated hours**, **Lead time (days)** and risks.
3. When you move dates or budget, fill in **Reason for change** and **Reference** (for example a contract modification). They go into the change log.
4. Under **Predecessors**, click **Add** to link a task that must come first. Links check your dates; they don't move them.
5. Under **Resources**, click **Assign** to give people from the resource pool their planned hours.
6. Under **Materials**, click **Add** for each part or long-lead item, then move it from **Needed** to **Ordered** to **Received**.
7. Click **Save**. **Add sub-task** adds a task beneath this one.

## Move work on the Board and Timeline

1. On **Projects**, click **Board** to see every open project's tasks, a lane for each. Click a project's name to open its own **Board**.
2. Drag a card to another column to change its status. A late finish date shows in red, and the card shows how many materials are in.
3. Group the board with **By stage** or **By owner**, and filter it by task, owner or flag.
4. Open the **Timeline** tab for a Gantt chart. Pick **Month**, **Week** or **Day**.
5. Drag a bar to move a task, or drag its ends to change the start or finish.

## Write the weekly update

1. Open the **Updates** tab and click **New update**. It copies the last entry, so you change only what moved.
2. Set the **Date**, **Overall status**, **Current benchmark** and **Completion forecast**. If the forecast moved, say why in **If it moved, why**.
3. Fill in **Progress and decisions**, **Risks and blockers** and **Decisions needed**, and add **Photos and files** (JPEG, PNG or PDF).
4. Under **Open actions**, change the state of actions from earlier updates. Click **Add an action** for new ones; each becomes a task in the plan with its owner and due date.
5. Click **Add update**.

Entries are kept as written. You can correct one on the day you wrote it; after that, add a new entry. An unsaved update is kept as a draft in your browser.

## Review and sign a gate

1. Open a milestone that must be reviewed before the project moves on. In the **Engineering project** template, every stage ends in one.
2. Click **Set up gate**. Fill in **Criteria / evidence required**, **Evidence**, **Outcome**, **Review date**, **SOP revision** and **Conditions / update**, and click **Save gate**.
3. Each party that must approve clicks **Sign**, picks who they are **Signing as** (for example Engineering or Quality), chooses **Approved** or **Rework**, adds a note and signs. Who signed and when is recorded.

## Track cost and funding

These tabs are on full projects.

1. Open **Actuals** to see invoiced cost. Each line is booked to a WBS, a month, an organization and a cost category.
2. Pick **Rows** and **Columns** for the summary, and filter the ledger by dates, category, organization or WBS.
3. Click **Add line** to record a cost by hand.
4. Click **Upload invoice** and pick the invoice PDF. AI reads it and checks that every figure adds up, then shows it beside the ledger as *New*, *Same*, *Changed* or *Not on invoice*. Tick the lines you want and click **Post selected lines**, or **Discard**.
5. Open **Funding** to see the award and each modification, with **Funded**, **Current budget** and **Funding less budget**. Click **Add entry** to record a new one.

A cost line whose WBS isn't in the plan is kept as unmatched. Add that task, then click **re-match**.

## Take a baseline

1. When the plan is agreed, open **Baselines & changes** and click **Take baseline**. Give it a name and a note.
2. Every later slip and budget change is measured against it. Click **Compare in plan** to see the plan against any baseline.
3. The **Change log** lists every change to dates or budget, with the reason, reference and who made it.

## Limit who can change a project

1. Open the project's **Team** tab and click **Add member**.
2. Pick the person and a role: **Manager** (edits and manages members), **Editor** (edits the plan), **Contributor** (updates status, % complete and notes on the tasks in their **Scope**) or **Viewer**.
3. Tick **Only members below may edit** and click **Save**.

Your role on a project shows in its header (*You: …*). The owner of a task doesn't get access just by being the owner.

## Print a status report or progress record

1. Open **Reports** under **Project Management** in the sidebar.
2. Pick **Project status report** (every project on one page, from its latest weekly update), **Project Progress Record** (one project's information, weekly updates and gate sign-offs) or **Completed this week** (projects completed and gates passed, week by week).
3. Create the report and open it. Print it, or save it as a PDF from the print dialog.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **View projects** | See every project with its plan, funding, actuals, baselines and change log, download the Excel and Microsoft Project exports, and ask the assistant about projects. | Admin, Operator, Viewer |
| **Plan and update projects** | Create projects; add and edit tasks, links and resource assignments; record progress, funding and actuals; upload and post invoices; take baselines; manage a project's members. On a project that limits editing to members, what they can change depends on their role on the Team tab. | Admin, Operator |
| **Delete projects and entries** | Delete whole projects, tasks, baselines, funding entries and actuals lines. Deleting a project cannot be undone. Today this permission also gives full access to Configuration and lets them edit every project (see notes). **Give with care.** | Admin |
| **Set up project lists and templates** | Maintain templates and their lists, organizations, holidays, custom fields and the resource pool, save a project as a template, and edit any project regardless of its members. **Give with care.** | Admin |

## Ask its agent

The **Project Assistant** answers from your own projects, and with edit access it can create projects and tasks, record progress and costs, add funding and links, and take a baseline. When it changes a date or budget it asks for the reason. It has your access, no more. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48).

- *Which tasks on the ERP cutover are overdue, and when were they due?*
- *How much has been invoiced on the new composite tube line, by cost category?*
- *Summarize where the second-source qualification stands and what is due in the next 60 days.*

## Good to know

- Links between tasks don't move dates. They flag **Link conflict** when your dates break them; drag the bar on the **Timeline**, or export to Microsoft Project, which schedules from the links.
- A task is **Unbudgeted** when neither it nor any task above it has a budget. Milestones are never flagged. Tick **Inactive** on a task to keep it for the record but leave it out of every roll-up.
- A parent task's dates, budget and % complete roll up from the tasks beneath it unless you give it its own.
- Archived projects are hidden. Tick **Show archived** on **Projects** to see them.
- **Save as template** on a project's **Details** tab turns its outline into a new template. Budgets, actuals and funding aren't copied.
- Deleting a project deletes every task, baseline, funding entry and cost line in it, and can't be undone.
- Reading invoices and the assistant need the workspace's AI to be set up.
- Project status, KPIs, open work, timeline and cost data are available for dashboards. See [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).

## More help

Click **Help** at the top right of the Projects page or of any project for the full reference: **Overview**, **How it works**, **Who can do what**, **Questions** and, for administrators, **Setup**. Project Management has no runbooks yet. See [Find and follow a runbook](article:4b62ad1f-577a-4998-8bce-f00226376522) for modules that have them.


Source: https://datavisions.ai/docs/module-guides/project-management
