# Project Workspace

Keep clients and their projects in one place, share files and sign-offs, and give clients their own portal.

Project notes, photos, drawings and client emails end up spread across notebooks, phones and inboxes. At Acme Precision, the office keeps each client's projects, phase plan, job photos, files and sign-offs in Project Workspace, and the client follows along in their own portal.

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

## What it does

Project Workspace keeps **clients**, and under each client its **projects**. Each project has a plan of **phases**, with smaller **steps** under them. The left menu has two pages:

- **Clients**: the client register, one card per client with a count of their projects. Click a card to see only that client's projects.
- **Projects**: the project schedule, with each project's code, client, phase progress bar and due date.

The **Search clients, projects** box at the top filters both as you type. Open a project to see its due date, phases done and a **Complete** bar, and these tabs:

- **Board**: the phases in **To do**, **In progress**, **Review** and **Done** columns.
- **Photos**: job photos by day, with time, who took them and location.
- **Approvals**: sign-offs requested from a team member or the client.
- **Team**: the people working on the project.
- **Files**: drawings, PDFs and models.
- **Messages**: one conversation with the client, shared with their portal.
- **Notes**: internal notes the client never sees.

Clients you invite sign in to a separate **Client Portal** to see progress, shared documents and approvals, and to message your team.

## Set it up

A Workspace Admin does this first.

1. Give the permissions to your own roles, such as Office Manager or Project Lead (see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f)). Out of the box only Admin can change anything. Anyone who uses the Project Workspace page also needs **Manage clients** in this version, or the page does not load its clients and projects.
2. Open **Module Settings** from the ⋮ on the **Project Workspace** sidebar row. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
3. Under **Public pages**, find **Client Portal**. Use **Copy link** or **Embed code** to put it on your website, **Turn off** to close it, or **New link** to replace the link.
4. Set how the portal looks: **portal_theme** (light or dark), **portal_accent** (a colour such as #1F6FEB), **portal_headline** and **portal_welcome** (the words on its sign-in page).
5. Decide on **text_assist**. On, the **Assist** button sends drafts and some project details to the AI provider under your workspace's AI key. Off hides it for your team and the portal.
6. Add your clients, then their projects, then the phases on each project's board.

## Add a client

1. Click **New client** at the top (or **New client** on the empty **Clients** page).
2. Fill in **Client name**, and the **Company**, **Email** and **Phone** if you have them.
3. Click **Create**. The client's card appears in the register.

## Start a project

1. Click **New project** at the top.
2. Pick the **Client** and enter the **Project name**.
3. Fill in the **Project code**, **Due date**, **Job site address** and **Description** if you have them. Click **Assist** to tidy a rough description.
4. Click **Create**. The project opens on its **Board**.

## Plan the work on the board

1. Open the project. The **Board** tab shows first.
2. Click **+ Add phase** under a column. Enter the **Phase name**, **Status**, **Due date** and **Assignee**, and tick any **Depends on** phases that must finish first. Click **Create**.
3. Drag a card to another column to change its status. If a phase it depends on is not done, a **Waiting on** warning names it. Late due dates show in red.
4. To break a phase into steps, click **+** (**Add step**) on its card, name the step and click **Create**. Tick a step's box when it is finished.
5. Click the pencil (**Edit phase**) to change a phase, or **Delete phase** inside that window to remove it.

## Assign the team

1. Open the **Team** tab.
2. Pick a person in **Choose a team member…** and a role: **Member**, **Lead** or **Viewer**.
3. Click **Assign**. The list shows how many phases each person has. Click **Remove** to take someone off.

The team also shows to the client in the portal.

## Keep project files

1. Open the **Files** tab and click **Upload file**. To attach a file to one phase, click the paperclip on its card.
2. Use **View** to preview a file, **Download** to save it, or **Delete** to remove it.
3. To let the client download a file from the portal, tick **client** next to it. A red **Send to external client?** box asks you to confirm; click **Yes, share with client**, or **Cancel**.

## Review job photos

Crews take photos with the DV Field phone app (see below), and you can add them from a computer too.

1. Open the **Photos** tab. Photos are grouped by day.
2. Filter with **All**, **Before**, **Progress**, **After** or **Inspection**, or pick a phase in **All stages**. Click **Before / after** to see the two side by side.
3. Click **Add photos** to upload from your computer.
4. Click a photo to see when it was taken, by whom and where (**map** opens the location). Change its **Caption**, **Tag** or **Stage**, tick **Shared with the client** if the client may see it, and click **Save**. **Delete photo** removes it.

## Download a photo report

1. On the **Photos** tab, pick a tag filter if you want only those photos.
2. Click **PDF report**. The branded PDF downloads when it is ready.

## Send the customer a photo gallery

A gallery is a private web page anyone with the link can view without signing in. Only photos ticked **Shared with the client** go in.

1. On the **Photos** tab, click **Share with customer**.
2. Under **Photos**, pick **All photos** or one tag. Under **Link lasts**, pick **1 day**, **3 days** or **7 days**.
3. Under **Also show**, tick **Who took each photo** or **Exact GPS location** only if the customer should see them.
4. Click **Create link** and confirm with **Yes, share with client**.
5. Click **Open gallery** to check it, then **Copy link** or **Copy message** and send it from your own email.
6. To stop a link early, open **Share with customer** again and click **Revoke** under **Active links**.

## Request a sign-off

1. Open the **Approvals** tab and click **Request approval**.
2. Enter a **Title**, and a **Description** and **Phase** if it helps.
3. Under **Send to**, pick **Team member** and choose the **Approver**, or **Client — external**.
4. Click **Send request**. For the client, confirm with **Yes, share with client**. The request shows in their portal under **Needs your attention**.
5. A named team approver opens the **Approvals** tab and clicks **Approve**. **Delete** removes a request.

## Message the client

Everything on the **Messages** tab appears in the client's portal, and their replies appear here.

1. Open the **Messages** tab.
2. Type your message. Click **Assist** to polish the wording, and **Undo** to go back to yours.
3. Click **Send to thread**.

## Keep internal notes

1. Open the **Notes** tab. Notes are marked **Internal** and the client never sees them.
2. Type in **Add an internal note…** and click **Add note**.
3. Click **Pin** to keep a note at the top, **Unpin** to release it, or **Delete** to remove it.

## Invite a client to the portal

1. On **Clients**, click the client's card, then click **Portal access**.
2. Under **Invite a contact**, enter the **Full name**, **Email** and a **Title (optional)**.
3. Under **Can they approve?**, pick **Approver — may sign off milestones** or **View only — sees everything, signs nothing**.
4. Under **Projects they may see**, tick the projects. Tick none to let them see all of this client's projects.
5. Click **Send invite** and confirm.
6. Use **Copy link**, **Copy message** or **Open in email app** to send the invite yourself. The link works once and expires in 7 days.
7. For a contact already invited, use **Make approver** or **Make view-only**, **Projects…** to change what they see, **New invite link**, or **Revoke** to stop them signing in.

## What clients see in the portal

1. The client opens the invite link, chooses a password and clicks **Set password and continue**. Later they sign in with their email and password.
2. **Overview** shows the project's current phase, progress and phase timeline, the team, and **Needs your attention**, where they click **Approve** or **Ask a question**.
3. **Documents** lists the files you shared, with **Download**.
4. **Approvals** lists every request. Only approver contacts can approve.
5. **Messages** is the shared thread. They type and click **Send message**.
6. A client with more than one project switches between them at the top.

## Get the crew phone app

1. Open the module's own settings page, **Mobile app**.
2. Click **Download APK**, have crews scan the QR code with the phone camera, or use **Copy link**, **Copy message** or **Email it**.
3. Crews follow **Install on Android**, open the app and sign in with their work email and password.

## 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 clients and projects** | Open projects and see phases, team, photos, approvals, messages and internal notes; download photo reports; approve team sign-offs addressed to them. | Admin, Operator, Viewer |
| **Manage clients** | Add and edit clients. In this version it is also needed just to see the client list, so the web screen does not load properly without it. | Admin |
| **Manage projects** | Create and edit projects, request and delete approvals, post on the client thread, use Assist, and invite, change or revoke client portal contacts. **Give with care.** | Admin |
| **Manage project phases** | Add, edit, move and delete phases and their checklist steps on the board. | Admin |
| **Assign the project team** | Add and remove people on a project, and approve team sign-offs that name no specific approver. | Admin |
| **Write notes** | Add, pin and delete internal notes. | Admin |
| **Manage project files** | Upload, view, download and delete files and photos, share them with the client portal, and create or revoke customer photo gallery links. **Give with care.** | Admin |
| **Client portal access** | For client sign-ins only: see their own projects, shared documents and progress, message the team and (if approver) sign off. Given automatically through a 'Client Portal' role when a contact is invited; staff don't need it. | Nobody |

## Good to know

- Nothing is emailed for you. You send portal invites and gallery links yourself, from your own email.
- Anything that goes to the client (a shared file, a client approval, a gallery) asks you to confirm first.
- The project team does not limit who sees a project. Anyone with **View clients and projects** sees every project.
- Most buttons show for everyone. Someone without the permission gets an error when they click.
- This version has no button to edit or archive a client or project, and notes go on projects only.
- The portal calls the project due date **Permit target**, and names the phase columns **Upcoming**, **In review** and **Complete**.
- Project Workspace has no assistant of its own. Its projects, clients, phases, files, photos, messages and approvals are available to workspace reports and dashboards; see [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).

## More help

This version has no Help page or runbooks of its own yet. For the settings page, public pages and versions, see [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).


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