Watchtower QA Guide

Watchtower Q2 KPI Flow

This guide documents the exact local QA flow for the new Watchtower Q2 weekly KPI setup. Notes are short on purpose, but each role now has a more detailed click path and more granular screenshots.

Flow To Run First

This is the order used before capturing any screenshots.

  1. Reset local stack, seed all data, and keep Metabase running.
  2. Login as Tuan Le and create objective `C4` in Q2 2026.
  3. Create two new weekly project KPIs: one for Nam Hoang and one for Nishith Murab.
  4. Return to Planning, create `C4-KR1`, and link both KPIs in two screens.
  5. Set KPI allocation to `50% / 50%`.
  6. Set client access to `Visible to client` for the Nam KPI and `Client can update` for the Nishith KPI.
  7. Login as Director and add rollout for both KPIs.
  8. Login as Nam Hoang and submit the internal weekly report.
  9. Login as Nishith Murab, walk Summary, burnout, Evidence & History, and KPI detail first, then submit the client weekly report.
  10. Login as Tuan Le, jump from the OKR back into KPI detail, review the internal submission, and verify the client lane.

Local Prep

Baseline verified before running the role flow.

  • App: https://seta.quickdemo.site/login
  • Metabase: https://bi.seta.quickdemo.site
  • Quarter used in this guide: Q2 2026
  • Watchtower note: Nam Hoang is given PM membership on WT so the project weekly manual KPI can stay assigned to him.

Scope Created

  • Objective: C4
  • KR: C4-KR1
  • Internal KPI: WT-C4-NAM
  • Client KPI: WT-C4-NISHITH

Access Split

  • Nam KPI: client access VIEW
  • Nishith KPI: client access INPUT
  • Allocation split: 50 / 50
  • Quarter: Q2 2026

Generated

  • Generated at: 30 Mar 2026, 11:19
  • Output: docs/guide/watchtower-q2-kpi-flow.html
  • Assets: docs/guide/assets
  • Metabase health: {"status":"ok"}

1. Tuan Le Builds The Q2 OKR And KPI Setup

Tuan creates the new objective, creates both weekly project KPIs, then returns to the OKR tree to add the KR and link both KPIs in two screens.

Step 1

Fill the new objective dialog

Create objective `C4` for the Watchtower Q2 weekly reporting flow.

Step 2

Confirm the new objective in Planning

Check that `C4` is visible in the Planning tree before adding KPI coverage.

Step 3

Create the Nam internal weekly KPI

This KPI is a project weekly manual KPI for Nam Hoang.

Step 4

Review the Nam KPI detail page

Confirm the KPI detail page is created correctly before rollout.

Step 5

Create the Nishith client weekly KPI

This KPI is a project weekly manual KPI for Nishith Murab.

Step 6

Review the Nishith KPI detail page

Confirm the second KPI is ready to be linked back into the KR.

Step 7

Return to Planning before adding the KR

Open the newly created `C4` objective and start the KR flow from the objective card.

Step 8

KR step 1: fill the KR details

Create `C4-KR1` with the Q2 target and status.

Step 9

KR step 1: select the two supporting KPIs

Choose both new KPIs before moving to the configuration screen.

Step 10

KR step 2: open KPI link configuration

Review the selected KPI list and allocation summary.

Step 11

KR step 2: set 50/50 split and client access

Nam KPI is `Visible to client`; Nishith KPI is `Client can update`.

Step 12

Confirm the linked KPIs back in the OKR tree

The KR should now show both linked KPI cards under `C4`.

2. Director Rolls Out Both KPIs

Rollout is completed from the Director account because coverage management is Director-only in the current RBAC.

Step 1

Roll out the Nam KPI

Assign Watchtower and override ownership so Nam submits and Tuan reviews.

Step 2

Land on the Nam tracking detail after rollout

The redirect confirms the assignment was created.

Step 3

Roll out the Nishith KPI

Assign the client KPI to the Watchtower project for Q2.

Step 4

Land on the Nishith tracking detail after rollout

The second redirect confirms the client KPI assignment is live.

3. Nam Hoang Submits The Internal Report

Nam enters the internal weekly report from Tracking and submits it for Tuan review.

Step 1

Open the Nam tracking page

Start from the live assignment detail before filling the weekly report.

Step 2

Fill the weekly report

Complete the checkboxes, evidence note, and review notes before submitting.

Step 3

Confirm the submitted state

The page should move into the submitted handoff for review.

4. Nishith Murab Walks The Client Pages And Submits

Nishith goes through the client-facing Summary, burnout, Evidence & History, and KPI detail views first, then returns to Needs Input to submit the weekly report.

Step 1

Client Summary page

Open Watchtower in the client workspace and capture the summary screen.

Step 2

Team Stability burnout summary

Capture the burnout snapshot shown on Summary before opening deeper evidence.

Step 3

Needs Input list

Open the client queue filtered to the new KPI.

Step 4

Open the KPI card before input

Review the live client input card before opening the detail page.

Step 5

Client KPI detail page

Capture the client-facing KPI detail page reached from the card.

Step 6

Evidence & History before submit

Open the read-only evidence workspace before going back to input.

Step 7

Burnout dashboard inside Evidence & History

The embedded Metabase dashboard shows burnout trend, member heatmap, and supporting evidence for the project.

Step 8

Fill the client report

Enter the weekly client update before pressing Submit.

Step 9

Confirm the submitted client state

The current-cycle card should show the newly submitted record.

Step 10

Evidence & History page

Capture the client evidence/history view after submission.

5. Tuan Le Reviews The Result

Tuan first reopens the new OKR, jumps from the linked KPI card into the KPI detail page, then reviews Nam’s submission and checks the client lane.

Step 1

Open the new OKR again before review

Use the linked KPI cards in the `C4` objective as the entry point.

Step 2

Jump from OKR into the KPI detail page

This shows the exact path from the OKR tree into the live KPI detail.

Step 3

Review the Nam submission

Open the review step from the assignment detail and add the review note.

Step 4

Approve the Nam submission

Confirm the approved state after Tuan finishes the review.

Step 5

Check the client lane after Nishith submits

Use the client KPI tracking detail as the final verification screen.