Skip to content

Publish the Snowflake migration and RTA-mini lab artifacts under workshop_public - #83

Merged
sishuo-yang merged 2 commits into
build-workshop-v1from
feature/separate-workshop-code
Aug 3, 2026
Merged

Publish the Snowflake migration and RTA-mini lab artifacts under workshop_public#83
sishuo-yang merged 2 commits into
build-workshop-v1from
feature/separate-workshop-code

Conversation

@sishuo-yang

Copy link
Copy Markdown
Collaborator

Adds workshop_public/ — the runnable lab artifacts for two labs, separated from their instructions. The instructions live on the hosted playbook at labs.demohouse.cloud; this directory is only the things a learner runs.

workshop_public/snowflake_migration_lab/

A four-stage NYC-taxi Snowflake → ClickHouse migration lab.

Stage Contents
01-setup-snowflake/ Terraform (database, roles, warehouses, streams, monitors), table/seed SQL, a nyc_taxi_dbt Medallion project, a live trip producer, 7 showcase Snowflake queries (QUALIFY, LATERAL FLATTEN, VARIANT, MERGE, streams/CDC), and a Superset stack with 3 dashboard exports
02-plan-and-design/ Snowflake profiling scripts and migration-plan.md, the plan the learner fills in
03-migrate-to-clickhouse/ ClickHouse Cloud Terraform, the migration script, parity validation, benchmark and cutover scripts, a mirrored nyc_taxi_dbt_ch project, and a Superset ClickHouse connection
04-evaluation/ assessment.md, the blank badge assessment

workshop_public/RTA-mini-workshop/

The RTA-mini forex dashboard — Flask app, Dockerfile, compose file, static frontend, and tests.

Credential-bearing files ship only as .example templates, with .gitignore entries for .env, *.tfvars, profiles.yml, and Terraform state.

Second commit: aligning with the hosted playbook

The five design worksheets that were in 02-plan-and-design/worksheets/ are removed. They are now interactive pages on the site that check each answer as it is picked and keep the learner's work in browser storage; every answer and explanation there traces back to these files' answer keys. The two exercises with no direct on-site exercise — worksheet 03's "Non-Obvious Translation Decisions" and worksheet 04's "Risk Register" — became reflection questions, and 04's register is also written out in full in the site's worked-example reference.

migration-plan.md and assessment.md stay: both are still edited on disk, both are referenced by full path from the playbook, and module 03's setup.sh reads the plan's completion checklist.

Removing those files left seven pointers dangling — and every URL they pointed at was dead regardless. workshop.demohouse.cloud 404s; the site moved to labs.demohouse.cloud, and the old name resolves to a separate, older deployment. The three touched scripts are synced from the upstream copies that had already fixed this and differed only in those lines; the two READMEs are hand-edited, having no upstream counterpart. The same dead host is fixed in the RTA-mini README.

Verification

  • All 9 surviving labs.demohouse.cloud URLs return 200.
  • The three touched scripts pass bash -n.
  • No reference to a deleted worksheet file survives anywhere in workshop_public/.
  • The published lab matches the upstream public manifest exactly — 104 files against 103 manifest entries, the extra being the published-only README.md. RTA-mini matches its manifest exactly.

Note for reviewers

The upstream public-readme spec still describes "five worksheets you fill in", so regenerating snowflake_migration_lab/README.md from it would reintroduce the stale wording. Worth fixing on the WorkshopHouse side.

🤖 Generated with Claude Code

sishuo-yang and others added 2 commits August 2, 2026 16:48
…ead host

The five design worksheets in 02-plan-and-design/worksheets/ are now interactive
pages on the workshop site, which checks each answer as the learner picks it and
keeps their work in browser storage. Every answer and explanation on those pages
traces back to these files' answer keys, so nothing is lost by deleting them --
including the two exercises that have no direct on-site equivalent: worksheet
03's "Non-Obvious Translation Decisions" and worksheet 04's "Risk Register" both
became reflection questions, and 04's register is also written out in full in the
site's worked-example reference.

migration-plan.md and assessment.md stay. Both are still files the learner edits
on disk, both are referenced by full path from the playbook, and module 03's
setup.sh reads the plan's completion checklist.

Removing the files left seven pointers dangling, and every URL they would have
been rewritten to was dead anyway: workshop.demohouse.cloud 404s, because the
site moved to labs.demohouse.cloud and the old name resolves to a separate,
older deployment. Both setup.sh files and 01_profile_snowflake.sh are synced
from the upstream copies that had already fixed this, and differed only in these
lines. The two READMEs are hand-edited -- they have no upstream counterpart.

Also fixes the same dead host in RTA-mini-workshop/README.md, which had two
references to it.

All nine surviving labs.demohouse.cloud URLs return 200 and the three touched
scripts pass bash -n.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@sishuo-yang
sishuo-yang merged commit 9fdee3e into build-workshop-v1 Aug 3, 2026
3 checks passed
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