Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions DESIGN.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,11 @@ typography:
fontSize: "13px"
fontWeight: 500
lineHeight: 1.4
code:
fontFamily: '"JetBrains Mono", monospace'
fontSize: "12px"
fontWeight: 500
lineHeight: 1.5
rounded:
control: "7px"
field: "6px"
Expand All @@ -62,10 +67,8 @@ components:
rounded: "{rounded.panel}"
padding: "24px"
status:
backgroundColor: "{colors.attention-ground}"
textColor: "{colors.attention}"
rounded: "{rounded.status}"
padding: "6px 10px"
padding: "0"
---

## Overview
Expand Down
6 changes: 3 additions & 3 deletions Processing/tests/browser_change_assurance.py
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ def run_desktop(browser):

assert page.locator("[data-view-link]").count() == 3
assert page.get_by_role("heading", name="The schedule changed. Did the update explain it?").is_visible()
page.get_by_role("button", name="Try the Northstar example").click()
page.get_by_role("button", name="Try the example project").click()
page.locator("#readinessWorkspace").wait_for(state="visible")
readiness_status = page.locator("#readinessStatus").inner_text()
assert readiness_status.casefold() == "needs evidence before decision", readiness_status
Expand Down Expand Up @@ -112,7 +112,7 @@ def run_desktop(browser):

page.goto(BASE_URL)
page.wait_for_load_state("networkidle")
page.get_by_role("button", name="Try the Northstar example").click()
page.get_by_role("button", name="Try the example project").click()
page.locator("#readinessWorkspace").wait_for(state="visible")
page.evaluate("document.querySelector('#readinessWorkspace').scrollIntoView()")
page.screenshot(path=str(SCREENSHOTS / "change-assurance-overview.png"), full_page=False)
Expand All @@ -127,7 +127,7 @@ def run_mobile(browser):
page.wait_for_load_state("networkidle")
assert page.evaluate("document.documentElement.scrollWidth <= document.documentElement.clientWidth + 1")
assert page.locator("[data-view-link]").count() == 3
page.get_by_role("button", name="Try the Northstar example").click()
page.get_by_role("button", name="Try the example project").click()
page.locator("#readinessWorkspace").wait_for(state="visible")
assert page.locator("#blockerList .blocker").count() == 3
assert page.evaluate("document.documentElement.scrollWidth <= document.documentElement.clientWidth + 1")
Expand Down
4 changes: 2 additions & 2 deletions Processing/tests/browser_product_landing.py
Original file line number Diff line number Diff line change
Expand Up @@ -95,15 +95,15 @@ def own_files(browser):
page.locator("#assuranceNarrative").fill(original)
page.locator("#runAssuranceReview").click()
expect(page.locator("#readinessWorkspace")).to_be_visible()
expect(page.locator("#reviewFacts")).to_contain_text("Constraint changes")
expect(page.locator("#reviewFacts")).to_contain_text("constraint changes")
page.screenshot(path=str(CAPTURES / "projectlens-redesign-after-review.png"))
revision = "This project is not on track. The finish moves 73 days. All constraint and logic changes are acknowledged. The action owner is the Planning Manager, due 1 December 2027."
page.locator("#narrativeRevision summary").click()
page.locator("#revisedNarrative").fill(revision)
page.locator("#recheckNarrative").click()
expect(page.locator("#narrativeRevision")).not_to_have_attribute("open", "")
expect(page.locator(".original-narrative")).to_contain_text(original)
expect(page.locator("#reviewFacts")).to_contain_text("Constraint changes")
expect(page.locator("#reviewFacts")).to_contain_text("constraint changes")
page.locator("#showDecisionForm").click()
page.get_by_label("Approve with conditions", exact=True).check()
page.locator("#decisionOwner").fill("Review chair")
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Compare a project update with its schedules, inspect what changed, and record th

**Start here:** [Try ProjectLens](https://matthewpaver.github.io/ProjectLens/change-assurance.html). No install or account needed.

1. Select **Try the Northstar example**. Its finish moves by 73 days while the update says unchanged.
1. Select **Try the example project** (Northstar Grid Connection, a made-up project). Its finish moves by 73 days while the update says unchanged.
2. Inspect the source fields and review questions. Three findings are prioritised; all five remain available.
3. Record a decision with its owner and rationale, then download the evidence-linked record.

Expand Down Expand Up @@ -39,7 +39,7 @@ The browser tool is static HTML and JavaScript. Python's built-in server is enou
git clone https://github.com/MatthewPaver/ProjectLens.git
cd ProjectLens
python3 -m http.server 8000 --bind 127.0.0.1 --directory docs
# open http://127.0.0.1:8000/change-assurance.html and select "Try the Northstar example"
# open http://127.0.0.1:8000/change-assurance.html and select "Try the example project"
```

Expected result: the evidence desk shows three prioritised findings and five total questions, including the 73-day finish movement, with source dates beside the selected finding. Stop the server with Ctrl+C.
Expand Down
1 change: 0 additions & 1 deletion docs/change-assurance.css
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,6 @@ button:focus-visible, a:focus-visible, input:focus-visible, textarea:focus-visib
.assurance-view[hidden] { display: none !important; }
.assurance-hero { min-height: calc(100vh - 74px); display: grid; grid-template-columns: 1.08fr .92fr; align-items: center; gap: 5vw; padding: 5.5rem max(5vw,2rem); overflow: hidden; }
.assurance-hero h1 { margin: 0; max-width: 960px; font: 400 clamp(3rem,5.2vw,5.8rem)/.98 "Archivo Black",sans-serif; letter-spacing: -.045em; text-wrap: balance; }
.assurance-hero .eyebrow { display: flex; flex-wrap: wrap; align-items: center; gap: .55rem; line-height: 1.45; }
.assurance-hero h1 em { color: var(--assurance-orange); font-style: normal; }
.assurance-hero .hero-intro { max-width: 780px; margin: 2rem 0 0; color: #40514e; font-size: clamp(1rem,1.45vw,1.28rem); line-height: 1.62; text-wrap: pretty; }
.assurance-actions { display: flex; align-items: center; gap: .8rem; margin-top: 2rem; }
Expand Down
40 changes: 21 additions & 19 deletions docs/change-assurance.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
<link rel="icon" href="favicon.svg" type="image/svg+xml">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Archivo+Black&family=Libre+Franklin:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
<link rel="stylesheet" href="styles.css">
<link rel="stylesheet" href="change-assurance.css">
<link rel="stylesheet" href="walkthrough.css">
Expand All @@ -40,7 +40,7 @@
<a class="product-register-link" href="#decisions">Saved decisions</a>
</header>

<p id="walkthroughSession" class="tour-session" hidden>Synthetic walkthrough · records exist only in this tab until reload. <a href="change-assurance.html">Exit to full ProjectLens</a></p>
<p id="walkthroughSession" class="tour-session" hidden>Made-up example walkthrough. Records exist only in this tab until reload. <a href="change-assurance.html">Exit to full ProjectLens</a></p>
<div class="tour-layout">
<aside id="walkthroughGuide" class="tour-guide" hidden aria-label="Walkthrough guide"></aside>
<main id="workspace">
Expand All @@ -53,16 +53,16 @@
<section class="assurance-view active" data-view="reviews">
<div id="productLanding">
<section class="product-hero" id="top" aria-labelledby="productTitle">
<h1 id="productTitle">The schedule changed.<br>Did the update explain it?</h1>
<h1 id="productTitle"><span>The schedule changed.</span><span>Did the update explain it?</span></h1>
<p class="product-introduction">Compare two project schedules from Primavera P6 planning software with the project update. See the evidence behind the movement, then record a human decision.</p>
<div class="product-actions">
<button class="assurance-primary" id="loadAssuranceDemo" type="button">Try the Northstar example</button>
<button class="assurance-primary" id="loadAssuranceDemo" type="button">Try the example project</button>
<button class="product-text-button" id="showOwnPack" type="button">Use your own schedules</button>
</div>
<p class="product-privacy">Runs in your browser. Your schedule files stay with you.</p>
</section>
<section class="product-example" aria-label="Interactive Northstar example">
<div class="example-heading"><div><strong>Northstar Grid Connection</strong><span>Synthetic example</span></div><span>2 XER exports + narrative</span></div>
<section class="product-example" aria-label="Interactive example project: Northstar Grid Connection">
<div class="example-heading"><div><strong>Northstar Grid Connection</strong><span>Made-up example</span></div><span>2 schedule files + written update</span></div>
<div class="example-workspace">
<div class="example-selector"><h2>Changes to review</h2><div role="tablist" aria-label="Example changes" aria-orientation="vertical">
<button type="button" role="tab" id="example-finish" aria-selected="true" aria-controls="examplePanel" data-example="finish" disabled>Finish movement</button>
Expand Down Expand Up @@ -91,9 +91,9 @@ <h2 id="journeyTitle">From a changed date to a recorded decision.</h2>
</ol>
<aside class="journey-demo">
<h3>Follow one complete review.</h3>
<p>The guided Northstar example uses the same parser, forms and decision records as the full product.</p>
<p>The guided example uses the same file reader, forms and decision records as the full product.</p>
<a class="assurance-primary" href="?walkthrough=1">Take the guided walkthrough</a>
<p class="journey-note">Synthetic inputs. Walkthrough records exist only in that tab until reload. Downloads remain yours to keep.</p>
<p class="journey-note">Made-up inputs. Walkthrough records exist only in that tab until reload. Downloads remain yours to keep.</p>
<a class="product-text-button" href="#decisions">View saved decisions</a>
</aside>
</div>
Expand All @@ -106,7 +106,7 @@ <h3>Follow one complete review.</h3>
<details><summary>What can I compare?</summary><p>Two supported, single-project Primavera P6 XER exports from the same source project. ProjectLens checks their identity, dates and field coverage before comparing them. Missing fields and unsupported inputs are reported.</p></details>
</div>
</section>
<section class="product-start" aria-labelledby="startTitle"><div><h2 id="startTitle">Bring a change pack. Leave with clearer questions.</h2><p>Start with the example, or review your own two schedule exports.</p></div><div class="product-actions"><button class="assurance-primary" type="button" data-load-example>Open Northstar review</button><button class="product-text-button" type="button" data-own-files>Use my files</button></div></section>
<section class="product-start" aria-labelledby="startTitle"><div><h2 id="startTitle">Bring a change pack. Leave with clearer questions.</h2><p>Start with the example, or review your own two schedule exports.</p></div><div class="product-actions"><button class="assurance-primary" type="button" data-load-example>Open the example review</button><button class="product-text-button" type="button" data-own-files>Use my files</button></div></section>
<noscript><p class="product-noscript">JavaScript is needed for the interactive comparison. You can still <a href="demo/northstar-previous.xer" download>download the previous example</a>, <a href="demo/northstar-current.xer" download>download the current example</a> and <a href="method.md">read the method</a>.</p></noscript>
</div>

Expand All @@ -115,7 +115,7 @@ <h3>Follow one complete review.</h3>
<div class="compact-heading">
<div><h2 id="intakeTitle">Add your two XER files</h2></div>
<p>XER is the schedule export format from Primavera P6 planning software. Export both schedules (File &rarr; Export &rarr; Primavera XER): the previous submission and the current one. Your browser reads the files and uploads nothing. Add the narrative if you want ProjectLens to check what the update claims.</p>
<p class="sample-pair">No XER files to hand? Download a synthetic pair from either example project and choose the files below: <a href="./demo/northstar-previous.xer" download>Northstar previous</a> &middot; <a href="./demo/northstar-current.xer" download>Northstar current</a> · <a href="./demo/riverside-previous.xer" download>Riverside previous</a> &middot; <a href="./demo/riverside-current.xer" download>Riverside current</a>. Optional narrative: <a href="./demo/riverside-narrative.txt" download>Riverside narrative</a>.</p>
<p class="sample-pair">No XER files to hand? Download a made-up pair from either example project and choose the files below: <a href="./demo/northstar-previous.xer" download>Northstar previous</a> &middot; <a href="./demo/northstar-current.xer" download>Northstar current</a> · <a href="./demo/riverside-previous.xer" download>Riverside previous</a> &middot; <a href="./demo/riverside-current.xer" download>Riverside current</a>. Optional narrative: <a href="./demo/riverside-narrative.txt" download>Riverside narrative</a>.</p>
</div>
<div class="pack-grid">
<label class="assurance-file" for="assurancePrevious">
Expand Down Expand Up @@ -152,23 +152,25 @@ <h3>Follow one complete review.</h3>
<div class="readiness-status"><i aria-hidden="true"></i><span id="readinessStatus" role="status">Needs evidence before decision</span></div>
<h2 id="readinessHeadline">The proposed finish is not supported by the current narrative.</h2>
<p id="readinessExplanation">Resolve the blockers below or record why the decision authority accepts them.</p>
<dl id="reviewFacts" class="review-facts" aria-label="Schedule facts independent of narrative wording"></dl>
<div class="readiness-actions">
<button class="assurance-primary" id="showDecisionForm" type="button">Record human decision</button>
<button class="assurance-secondary light" id="requestAnswers" type="button">Draft questions for the team</button>
<button class="assurance-secondary light" id="reviewPrecedents" type="button">Explore public-record context</button>
<button class="product-text-button" id="requestAnswers" type="button">Draft questions for the team</button>
</div>
<div class="evidence-desk" id="evidenceDesk">
<div><h3>Findings</h3><div class="blocker-list" id="blockerList"></div></div>
<section class="finding-evidence" id="findingEvidence" tabindex="-1" aria-label="Selected finding evidence"></section>
</div>
<details class="review-numbers" id="reviewNumbers">
<summary>What changed in numbers</summary>
<p id="reviewFacts" class="review-facts"></p>
</details>
<details class="narrative-revision" id="narrativeRevision">
<summary>Check a revised narrative</summary>
<p>Recheck a revision against these same schedules. The first checked narrative stays in the record. Unchecked edits do not change the decision evidence.</p>
<label for="revisedNarrative">Narrative revision</label>
<textarea id="revisedNarrative" rows="7"></textarea>
<button type="button" class="assurance-secondary" id="recheckNarrative">Recheck against these schedules</button>
</details>
<div class="evidence-desk" id="evidenceDesk">
<div><h3>Findings</h3><div class="blocker-list" id="blockerList"></div></div>
<section class="finding-evidence" id="findingEvidence" tabindex="-1" aria-label="Selected finding evidence"></section>
</div>

</article>

Expand All @@ -191,7 +193,7 @@ <h2 id="readinessHeadline">The proposed finish is not supported by the current n
<p>ProjectLens saves the evidence version and any unresolved blockers with your decision. You make the decision; ProjectLens does not.</p>
</div>
<form id="decisionForm">
<p id="precedentGateBanner" class="precedent-gate-banner">Public-record context is optional. Untouched examples are recorded as not reviewed.</p>
<p id="precedentGateBanner" class="precedent-gate-banner">You can save without reviewing the optional public-record examples. They stay marked as not reviewed.</p>
<fieldset>
<legend>Decision</legend>
<label><input type="radio" name="decision" value="Approve" required><span>Approve</span></label>
Expand All @@ -214,7 +216,7 @@ <h2 id="readinessHeadline">The proposed finish is not supported by the current n
</section>

<details class="supporting-evidence" id="supportingEvidence">
<summary><span>Supporting evidence & public-record context</span><small>Optional context · schedule movements · narrative checks</small></summary>
<summary><span>Supporting evidence and public-record context</span><small>Schedule movements, narrative checks and optional examples from public records</small></summary>
<div class="evidence-summary" id="evidenceSummary"></div>
<div class="comparable-section" id="precedentSection">
<div>
Expand Down
Loading
Loading