Centralized_I-M_Database/SummerProject2026
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fixed issues w/ accessing website on other computers

Browse Source
This commit is contained in:
kevinbell
2026-07-22 16:26:12 -06:00
parent c1e453d962
commit 8bb76d8e6c
13 changed files with 266 additions and 68 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/architecture.mmd
+2 -2
View File
@@ -63,7 +63,7 @@ flowchart TD
end
EXPORT -.-> GUARDRAILS
SITE --> BOLT[Separate dashboard-only<br/>Bolt project]
SITE --> DEMO[Allowlisted local static server<br/>same-network live demo]
subgraph TESTS[Verification]
direction LR
@@ -80,5 +80,5 @@ flowchart TD
class SOURCE,SAMPLE,STAGE,EPISODES,MART,PRIVATE,REPORT private
class LOGISTIC,TREE model
class PUBLIC,CONTRACT,SITE,VIEWS,BOLT public
class PUBLIC,CONTRACT,SITE,VIEWS,DEMO public
class GUARDRAILS warning
docs/bolt_deployment.md
+5
View File
@@ -2,6 +2,11 @@
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
docs/dashboard_spec.md
+7 -9
View File
@@ -121,13 +121,11 @@ developer console.
- Preserve the warning banner and fail-closed unavailable state on desktop and
mobile layouts.
## Deployment boundary
## Demo boundary
Bolt receives a separate dashboard-only project whose root is the contents of
`dashboard/`. Do not import or upload the full private-pipeline repository and
do not rely on a configurable subdirectory working root. The deployable project
contains no `.env`, private `data/`, model artifacts, SQL, pipeline scripts, or
repository history outside the dashboard directory.
See [bolt_deployment.md](bolt_deployment.md) for the reviewed handoff and
post-publication checks.
The current delivery is a same-network live demo started with
`node dashboard/server.mjs --lan`. The local server resolves files only beneath
`dashboard/` and serves only its explicit shell, JavaScript, stylesheet, and
approved aggregate allowlist. It does not expose `.env`, private `data/`, model
artifacts, SQL, pipeline scripts, or repository history. Stop the server after
the demo; no public hosting step is required.
docs/demo_script.md
+13 -7
View File
@@ -5,16 +5,22 @@ Target length: **2 minutes 45 seconds**, embedded in the
## Before the audience arrives
1. From the repository root, run `node dashboard/server.mjs`.
2. Open `http://127.0.0.1:4173/#overview`.
3. Confirm the header says the sample aggregates validated.
4. Confirm the private-sample development-preview banner is visible.
5. Visit all four routes: Overview, Sample cohorts, Model & benchmark, and Data
1. Put the presenting computer and demo computer on the same trusted network.
2. Stop any older dashboard process, then from the repository root run
`node dashboard/server.mjs --lan`.
3. On the demo computer, open the printed **Other devices** URL for the shared
Wi-Fi or Ethernet interface with `/#overview` appended. On the presenting
computer, use the printed **This computer** URL.
4. Confirm the header says **Validated sample aggregates**. If an older copy of
the JavaScript was previously loaded, hard-refresh the page once.
5. Confirm the private-sample development-preview banner is visible.
6. Visit all four routes: Overview, Sample cohorts, Model & benchmark, and Data
& methods.
6. Reset Sample cohorts and leave its sort on largest support.
7. Reset Sample cohorts and leave its sort on largest support.
Do not open developer tools, private files, model artifacts, database clients,
or environment variables during the presentation.
or environment variables during the presentation. Stop the server with
`Ctrl-C` when the demo is over.
## Live talk track
docs/final_report.md
+6 -6
View File
@@ -172,7 +172,8 @@ The public boundary is intentionally narrow:
private read-only source
-> private local extraction and model pipeline
-> suppression-reviewed aggregate JSON
-> dashboard-only static Bolt project
-> allowlisted local static server
-> same-network demo browser
```
The public dashboard and presentation materials contain no VIN, plate, ZIP,
@@ -180,10 +181,9 @@ station, technician identifier, private vehicle token, raw JSON, credential,
operational record, or row-level prediction. The browser never connects to the
source database.
Bolt publication must use a separate project or repository containing only the
contents of `dashboard/`, with `index.html` at its root. The full source
repository must not be imported into Bolt. The reviewed procedure is in
[bolt_deployment.md](bolt_deployment.md).
The presentation uses `node dashboard/server.mjs --lan` only for the live demo.
The server has an explicit dashboard-file allowlist and is stopped afterward;
the prototype is not published to a public host.
## Limitations
@@ -222,4 +222,4 @@ ranking, production model, diagnosis, or individual decision tool.
- [Private-to-public architecture](architecture.mmd)
- [10-minute presentation outline](presentation_outline.md)
- [Dashboard demo script](demo_script.md)
- [Dashboard-only Bolt deployment](bolt_deployment.md)
- [Optional public-hosting notes](bolt_deployment.md)
docs/presentation_outline.md
+7 -4
View File
@@ -22,7 +22,7 @@ model** and histogram gradient boosting as the **benchmark**.
| 3:10-4:20 | 5. Model comparison | Logistic final versus prevalence/previous-outcome baselines and boosted-tree benchmark |
| 4:20-4:50 | 6. Model decision | Calibrated logistic wins the declared sample comparison and is easier to explain |
| 4:50-7:35 | Live dashboard demo | Overview, Sample cohorts, Model & benchmark, Data & methods |
| 7:35-8:30 | 7. Privacy architecture | Private pipeline to suppressed aggregate JSON to dashboard-only Bolt project |
| 7:35-8:30 | 7. Privacy architecture | Private pipeline to suppressed aggregate JSON to an allowlisted same-network demo server |
| 8:30-9:20 | 8. Limitations | Sampling, feed coverage, source/time confounding, heterogeneous non-pass, one-time holdout |
| 9:20-10:00 | 9. Close | Prototype is complete and honest about what it can—and cannot—claim |
@@ -124,7 +124,7 @@ Show:
```text
private read-only data -> local modeling -> suppressed aggregate JSON
-> dashboard-only Bolt project
-> allowlisted local static server -> same-network demo browser
```
State that the public bundle has no VINs, plates, ZIPs, stations, technician
@@ -159,8 +159,11 @@ cannot establish.
## Presentation checklist
- Start the local dashboard before presenting: `node dashboard/server.mjs`.
- Open `http://127.0.0.1:4173/#overview` and close unrelated browser tabs.
- Put both computers on the same trusted network, stop any older dashboard
process, and run `node dashboard/server.mjs --lan`.
- On the demo computer, open the printed **Other devices** URL for the shared
Wi-Fi or Ethernet interface with `/#overview` appended. Close unrelated
browser tabs.
- Use a fresh page load to confirm aggregate validation succeeds.
- Keep a screenshot or short recording as a backup, with the sample warning
visible.
docs/project_charter.md
+2 -2
View File
@@ -69,8 +69,8 @@ is not a second final model and is not used to drive the product.
5. Histogram gradient boosting as a benchmark only.
6. Chronological development evaluation with an explicit one-time 2025 gate.
7. Suppression-reviewed static dashboard assets with fail-closed validation.
8. Model card, final report, presentation materials, and dashboard-only Bolt
deployment instructions.
8. Model card, final report, presentation materials, and same-network dashboard
demo instructions.
## Acceptance criteria