Compare commits
2 Commits
26bca745e6
...
bc9a133ee6
| Author | SHA1 | Date | |
|---|---|---|---|
| bc9a133ee6 | |||
| 786b896619 |
13
README.md
13
README.md
@ -31,7 +31,6 @@ Start with the [final report](docs/final_report.md). Supporting deliverables:
|
|||||||
- [Private-to-public architecture](docs/architecture.mmd)
|
- [Private-to-public architecture](docs/architecture.mmd)
|
||||||
- [10-minute presentation outline](docs/presentation_outline.md)
|
- [10-minute presentation outline](docs/presentation_outline.md)
|
||||||
- [Dashboard demo script](docs/demo_script.md)
|
- [Dashboard demo script](docs/demo_script.md)
|
||||||
- [Optional public-hosting notes](docs/bolt_deployment.md)
|
|
||||||
|
|
||||||
The [data inventory](docs/data_inventory.md) and archived
|
The [data inventory](docs/data_inventory.md) and archived
|
||||||
[project options](docs/project_options.md) provide source-discovery history;
|
[project options](docs/project_options.md) provide source-discovery history;
|
||||||
@ -63,7 +62,7 @@ python3 -m venv .venv
|
|||||||
|
|
||||||
The local `.env` contains PostgreSQL connection values and the project-specific
|
The local `.env` contains PostgreSQL connection values and the project-specific
|
||||||
`VIN_HASH_KEY`; it is excluded from Git. Never put those values in source code,
|
`VIN_HASH_KEY`; it is excluded from Git. Never put those values in source code,
|
||||||
screenshots, browser JavaScript, presentation materials, or a Bolt project.
|
screenshots, browser JavaScript, or presentation materials.
|
||||||
|
|
||||||
## Safe database access in VS Code
|
## Safe database access in VS Code
|
||||||
|
|
||||||
@ -165,11 +164,11 @@ authenticate the network transport, so use a trusted demo network.
|
|||||||
|
|
||||||
## Public hosting is not required
|
## Public hosting is not required
|
||||||
|
|
||||||
The current presentation plan is the same-network live demo above. Nothing
|
The presentation plan is the same-network live demo above. Nothing needs to be
|
||||||
needs to be uploaded or published, and the server exposes only the dashboard's
|
uploaded or published, and the server exposes only the dashboard's explicit
|
||||||
explicit static-file allowlist. The older
|
static-file allowlist. If public hosting is ever reconsidered, publish only a
|
||||||
[public-hosting checklist](docs/bolt_deployment.md) is retained only in case the
|
separately reviewed copy of the `dashboard/` directory—never the private source
|
||||||
delivery requirements change later.
|
repository.
|
||||||
|
|
||||||
## Author
|
## Author
|
||||||
|
|
||||||
|
|||||||
@ -92,7 +92,7 @@ records must never enter this directory.
|
|||||||
|
|
||||||
## Public hosting is not required
|
## Public hosting is not required
|
||||||
|
|
||||||
The current delivery path is the same-network live demo. No Bolt project,
|
The delivery path is the same-network live demo. No public URL, dependency
|
||||||
public URL, dependency install, or build step is needed. If public hosting is
|
install, or build step is needed. If public hosting is
|
||||||
ever reconsidered, publish only a separately reviewed copy of this dashboard
|
ever reconsidered, publish only a separately reviewed copy of this dashboard
|
||||||
directory—never the private source repository.
|
directory—never the private source repository.
|
||||||
|
|||||||
@ -1,192 +0,0 @@
|
|||||||
# Dashboard-only Bolt deployment
|
|
||||||
|
|
||||||
Last reviewed: 2026-07-21
|
|
||||||
|
|
||||||
> **Not part of the current delivery plan.** The presentation now uses the
|
|
||||||
> same-network live-demo procedure in [demo_script.md](demo_script.md). This
|
|
||||||
> checklist is retained only as a boundary reference if public hosting is
|
|
||||||
> reconsidered later.
|
|
||||||
|
|
||||||
## Non-negotiable publication boundary
|
|
||||||
|
|
||||||
Publish a **separate Bolt project or GitHub repository containing only the
|
|
||||||
contents of `dashboard/`**. In that project, `index.html` must be at the project
|
|
||||||
root.
|
|
||||||
|
|
||||||
Do not import the full Utah Vehicle Health source repository into Bolt. Do not
|
|
||||||
depend on Bolt supporting a `dashboard` working-root setting. The source
|
|
||||||
repository contains private-pipeline structure that a static host does not need,
|
|
||||||
even when local secrets and data are Git-ignored.
|
|
||||||
|
|
||||||
The deployment project must never contain `.env` files, credentials, private
|
|
||||||
data or marts, database files, model artifacts, SQL, pipeline scripts, repository
|
|
||||||
history from outside `dashboard/`, raw JSON, operational records, or row-level
|
|
||||||
predictions.
|
|
||||||
|
|
||||||
## 1. Verify the source dashboard locally
|
|
||||||
|
|
||||||
From the Utah Vehicle Health repository root:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm --prefix dashboard test
|
|
||||||
node dashboard/server.mjs
|
|
||||||
```
|
|
||||||
|
|
||||||
Open `http://127.0.0.1:4173` and verify:
|
|
||||||
|
|
||||||
- the development-preview banner says the values come from the private
|
|
||||||
10,000-vehicle sample and are not population estimates;
|
|
||||||
- the routes are Overview, Sample cohorts, Model & benchmark, and Data & methods;
|
|
||||||
- the final model is calibrated logistic regression and the boosted tree is
|
|
||||||
benchmark-only;
|
|
||||||
- model cards show 2024 calibration-fit diagnostics, not the opened 2025
|
|
||||||
holdout comparison;
|
|
||||||
- no vehicle-level prediction service or input form exists;
|
|
||||||
- county displays communicate feed coverage rather than population rankings;
|
|
||||||
and
|
|
||||||
- a missing or invalid aggregate bundle produces an unavailable state, not
|
|
||||||
fallback estimates.
|
|
||||||
|
|
||||||
Stop the local server with `Ctrl-C` after verification.
|
|
||||||
|
|
||||||
## 2. Create a fresh dashboard-only artifact
|
|
||||||
|
|
||||||
Use a new directory and, preferably, a new deployment repository. Copy the
|
|
||||||
**contents** of `dashboard/`, not the directory's parent and not the main
|
|
||||||
repository's `.git` history.
|
|
||||||
|
|
||||||
The reviewed project tree is:
|
|
||||||
|
|
||||||
```text
|
|
||||||
index.html
|
|
||||||
styles.css
|
|
||||||
package.json
|
|
||||||
server.mjs
|
|
||||||
README.md
|
|
||||||
js/
|
|
||||||
app.js
|
|
||||||
charts.js
|
|
||||||
data.js
|
|
||||||
public/data/
|
|
||||||
age_risk_curve.json
|
|
||||||
cohort_scorecard.json
|
|
||||||
coverage_quality.json
|
|
||||||
data_manifest.json
|
|
||||||
filter_catalog.json
|
|
||||||
model_diagnostics.json
|
|
||||||
overview_period_county.json
|
|
||||||
sha256_manifest.json
|
|
||||||
tests/
|
|
||||||
contract.test.mjs
|
|
||||||
```
|
|
||||||
|
|
||||||
Do not add any other repository directory. In the fresh artifact root, run:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm test
|
|
||||||
HOST=0.0.0.0 npm start
|
|
||||||
```
|
|
||||||
|
|
||||||
No dependency install or build step is required. The `PORT` environment
|
|
||||||
variable is honored automatically by `server.mjs` when a host supplies it.
|
|
||||||
|
|
||||||
Before creating the deployment repository, inspect its entire file tree. Apart
|
|
||||||
from `package.json` project metadata, the only JSON allowed is the reviewed
|
|
||||||
aggregate bundle under `public/data/`. Confirm that `data_manifest.json` still
|
|
||||||
declares:
|
|
||||||
|
|
||||||
```text
|
|
||||||
development_preview: true
|
|
||||||
population_estimate_allowed: false
|
|
||||||
locked_test_metrics_published: false
|
|
||||||
```
|
|
||||||
|
|
||||||
Do not hand-edit an aggregate file to make validation pass. Regenerate it
|
|
||||||
through the private local exporter and repeat the review.
|
|
||||||
|
|
||||||
## 3. Import only the dashboard repository into Bolt
|
|
||||||
|
|
||||||
The recommended handoff is a fresh GitHub repository containing the reviewed
|
|
||||||
tree above. It may be private if the connected Bolt account has access.
|
|
||||||
|
|
||||||
1. On the Bolt homepage, choose the GitHub import control.
|
|
||||||
2. Select the separate dashboard-only repository or use **Import from URL**.
|
|
||||||
3. Confirm `index.html` appears at the imported project root.
|
|
||||||
4. Inspect the Bolt file tree before previewing. If SQL, scripts, artifacts,
|
|
||||||
private data, `.env`, or source-repository files appear, stop and delete that
|
|
||||||
Bolt project; create a clean dashboard-only project instead.
|
|
||||||
5. Use `HOST=0.0.0.0 npm start` if Bolt requests a preview command. There is no
|
|
||||||
build command.
|
|
||||||
|
|
||||||
Bolt's current GitHub import workflow is documented in
|
|
||||||
[GitHub for version control](https://support.bolt.new/integrations/git).
|
|
||||||
|
|
||||||
If a separate GitHub repository is not used, create a fresh Bolt/StackBlitz
|
|
||||||
project and upload only the reviewed dashboard files so the same tree appears at
|
|
||||||
the project root. Never upload the full source repository and then try to hide
|
|
||||||
or ignore its private-pipeline directories.
|
|
||||||
|
|
||||||
## 4. Review in Bolt before publishing
|
|
||||||
|
|
||||||
Use the preview URL and repeat the local visual checks. Also verify directly:
|
|
||||||
|
|
||||||
- `/public/data/data_manifest.json` resolves;
|
|
||||||
- an unknown file path returns `404`;
|
|
||||||
- `/.env`, `/data/`, `/artifacts/`, `/models/`, `/sql/`, and `/scripts/` return
|
|
||||||
`404`;
|
|
||||||
- the browser makes requests only for the static HTML, CSS, JavaScript, and
|
|
||||||
approved files under `/public/data/`; and
|
|
||||||
- no analytics, database, authentication, or third-party data service was added
|
|
||||||
by an automated Bolt edit.
|
|
||||||
|
|
||||||
Preview privately first. If Bolt proposes code changes, review the full diff and
|
|
||||||
rerun `npm test`; do not accept changes that add a database, environment secret,
|
|
||||||
tracking script, model API, prediction form, or remote data source.
|
|
||||||
|
|
||||||
## 5. Publish with Bolt Hosting
|
|
||||||
|
|
||||||
Bolt Hosting is the intended host for this prototype:
|
|
||||||
|
|
||||||
1. Open the dashboard-only project.
|
|
||||||
2. Select **Publish** in the upper-right corner.
|
|
||||||
3. Choose private visibility for presentation review when available.
|
|
||||||
4. Select **Publish** and wait for the generated `bolt.host` URL.
|
|
||||||
5. Run the post-publication checks below before changing visibility to public.
|
|
||||||
|
|
||||||
Bolt documents this flow in
|
|
||||||
[Publish your project to a live website](https://support.bolt.new/cloud/hosting/publish).
|
|
||||||
Bolt's Netlify integration is optional and is not required for this dashboard;
|
|
||||||
see [Netlify integration](https://support.bolt.new/integrations/netlify) only if
|
|
||||||
hosting requirements explicitly change.
|
|
||||||
|
|
||||||
## 6. Post-publication checks
|
|
||||||
|
|
||||||
At the exact published URL:
|
|
||||||
|
|
||||||
1. Hard-refresh and confirm the development-preview banner remains visible.
|
|
||||||
2. Visit all four routes and verify labels, charts, and keyboard navigation.
|
|
||||||
3. Confirm the Model & benchmark view identifies logistic as final, tree as
|
|
||||||
benchmark, and its values as 2024 calibration-fit checks.
|
|
||||||
4. Confirm no 2025 holdout metric appears in the site or public JSON.
|
|
||||||
5. Confirm there is no vehicle-level lookup, input form, or row-level output.
|
|
||||||
6. Confirm coverage language does not imply statewide representation or county
|
|
||||||
ranking.
|
|
||||||
7. Request the denied paths from step 4 again and require `404`.
|
|
||||||
8. Save the published URL, release ID, publication date, and reviewer decision;
|
|
||||||
do not save private paths, row values, or credentials in the release note.
|
|
||||||
|
|
||||||
If any check fails, use Bolt's Publish menu to unpublish or keep the site private
|
|
||||||
until a corrected dashboard-only artifact passes local and hosted review.
|
|
||||||
|
|
||||||
## Updating a published prototype
|
|
||||||
|
|
||||||
Changes in a Bolt project are not automatically live. For each update:
|
|
||||||
|
|
||||||
1. regenerate/review aggregates locally;
|
|
||||||
2. run the dashboard contract test;
|
|
||||||
3. update the separate dashboard-only repository/project;
|
|
||||||
4. inspect Bolt's diff and preview;
|
|
||||||
5. use **Publish > Update**; and
|
|
||||||
6. repeat every post-publication check.
|
|
||||||
|
|
||||||
Never synchronize private pipeline directories into the deployment repository.
|
|
||||||
@ -112,7 +112,7 @@ possible, but must never appear in public outputs.
|
|||||||
- Extreme repeat counts exist and require invalid/shared-identifier filtering.
|
- Extreme repeat counts exist and require invalid/shared-identifier filtering.
|
||||||
|
|
||||||
Use a salted one-way internal token if a stable identifier is needed during
|
Use a salted one-way internal token if a stable identifier is needed during
|
||||||
feature engineering. Never send VINs or plates to the browser or Bolt.
|
feature engineering. Never send VINs or plates to the browser.
|
||||||
|
|
||||||
## Operational and sensitive relations
|
## Operational and sensitive relations
|
||||||
|
|
||||||
|
|||||||
@ -222,4 +222,3 @@ ranking, production model, diagnosis, or individual decision tool.
|
|||||||
- [Private-to-public architecture](architecture.mmd)
|
- [Private-to-public architecture](architecture.mmd)
|
||||||
- [10-minute presentation outline](presentation_outline.md)
|
- [10-minute presentation outline](presentation_outline.md)
|
||||||
- [Dashboard demo script](demo_script.md)
|
- [Dashboard demo script](demo_script.md)
|
||||||
- [Optional public-hosting notes](bolt_deployment.md)
|
|
||||||
|
|||||||
@ -162,7 +162,7 @@ Use option 1 as the main story and option 6 as its data-engineering foundation:
|
|||||||
3. Compare a transparent logistic baseline with a tree model.
|
3. Compare a transparent logistic baseline with a tree model.
|
||||||
4. Validate on a later time period and separately by county/source.
|
4. Validate on a later time period and separately by county/source.
|
||||||
5. Export only aggregate scorecards, curves, and de-identified model outputs.
|
5. Export only aggregate scorecards, curves, and de-identified model outputs.
|
||||||
6. Build the public Bolt dashboard over those safe outputs.
|
6. Build the static dashboard over those safe outputs.
|
||||||
|
|
||||||
This gives the project a coherent end-to-end narrative across data engineering,
|
This gives the project a coherent end-to-end narrative across data engineering,
|
||||||
analytics, machine learning, responsible validation, and product design.
|
analytics, machine learning, responsible validation, and product design.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user