Skip to content

feat(demo): civil-engineer trial pack — landing + 3D twins + Streamlit demo tab#58

Merged
harsh-pandhe merged 4 commits into
mainfrom
feat/demo-prep
May 24, 2026
Merged

feat(demo): civil-engineer trial pack — landing + 3D twins + Streamlit demo tab#58
harsh-pandhe merged 4 commits into
mainfrom
feat/demo-prep

Conversation

@harsh-pandhe
Copy link
Copy Markdown
Owner

Summary

Demo-ready pack for the civil-engineer trial tomorrow.

  • docs/index.md — rewritten as a proper landing: hero, 4-step How it works panel, 3-stat proof strip, 12-card case-study grid (each thumbnail links to its full page).
  • docs/PROCESS.md — narrated end-to-end walkthrough. Names every Eurocode/ISO check by its standard. No code.
  • docs/DEMO_RUNBOOK.md — internal cheat-sheet: pre-flight checklist, click-by-click script, fallback plans for every common failure mode.
  • tools/build_case_study_twins.py — regenerates interactive 3-D HTML twins for every case study. All 12 twins generated.
  • 12 case-study pages — now embed the twin via iframe so every page renders as 3-D in the docs site.
  • app/streamlit_app.py — new Demo tab as the front entry point: preset selector for 6 real installations, folium map, lat/lon fallback inputs, one-click run via P47 DEM cache.
  • pyproject.tomlstreamlit-folium + folium added to ui extras.
  • mkdocs.ymlProcess page added to the nav.

Why

Tomorrow a civil engineer trials the toolchain. He's non-technical. He needs to see the process, run it himself, and see the result in 3-D — all without touching a terminal.

Test plan

  • Full pytest: 452 passing on top of the merged engine queue
  • All 12 twin.html files built and embedded
  • app/streamlit_app.py syntax-valid
  • mkdocs nav valid
  • Cloudflare Tunnel smoke from a phone — run before the demo

…mo tab

Civil-engineer-friendly demo pack:

* docs/index.md — rewritten as a proper landing: hero, 4-step
  "How it works" panel, 3-stat proof strip, 12-card case-study
  grid linking each thumbnail to its full study page.
* docs/PROCESS.md — narrated end-to-end walkthrough (no code) of
  how an engineer drops two coordinates and gets a permit pack.
  Names every Eurocode/ISO check by its standard.
* docs/DEMO_RUNBOOK.md — internal cheat-sheet for the trial:
  pre-flight checklist, click-by-click script, fallback plans for
  every common failure mode.
* tools/build_case_study_twins.py — regenerates interactive 3-D
  HTML twins for every case study from its towers.csv. Idempotent;
  --rebuild forces all. All 12 twins generated.
* docs/case_studies/*.md — each page now embeds its twin.html via
  iframe so every case study renders as 3-D in the docs site.
* app/streamlit_app.py — new "Demo" tab as the front entry point:
  preset selector for 6 real installations, folium map showing the
  picked corridor, lat/lon inputs as a fallback, one-click run that
  fetches the DEM via P47 cache, runs the GA, shows alignment +
  convergence, and points the engineer at the Optimize / 3-D tabs
  for downloads.
* pyproject.toml — streamlit-folium + folium added to the `ui`
  extras so the demo map ships with `make install`.
* mkdocs.yml — Process page added to the nav.
@harsh-pandhe harsh-pandhe merged commit 126dacf into main May 24, 2026
2 checks passed
@harsh-pandhe harsh-pandhe deleted the feat/demo-prep branch May 24, 2026 07:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant