Goldfields Goldrush W.A. - Educational Mathematics Game

A progressive financial mathematics simulation game for students, themed around Western Australian gold mining.

Game Structure

📂 Directory Organization

wa-gold-rush/
├── levels/
│   ├── level-1-basic/           # ARCHIVED: Original 10-round game
│   │   ├── index.html
│   │   ├── script.js
│   │   └── style.css
│   └── level-2-tycoon/          # Active Goldfields Venture mode (bundles Levels 2-5 progression)
│
├── shared/                       # Shared utilities across levels
│   ├── game-config.json         # Game configuration & assets
│   ├── storage.js               # OneDrive & localStorage
│   └── shared-styles.css        # Common styling
│
├── teacher/                      # Teacher dashboard
│   ├── dashboard.html
│   └── dashboard-state.js
│
├── index.html                    # Level selector (home page)
└── README.md

Levels Overview

Level	Name	Description	Duration	Features
1	Basic Mining	Original game - single mine, 10 rounds fixed	10 min	Dice rolls, 3 dig types
2	Goldfields Venture	Multiple mines, upgrades, machinery, resale	Unending	Net worth + event system
3	WA Goldfields	Southern Cross, Coolgardie, Kalgoorlie progression	Unending	Regional strategy
4	Advanced	Company mode, random events, advanced risk	Unending	Strategic planning
5	Classroom Challenge	Shared local leaderboard + teacher stats/pause	Ongoing	Classroom competition
6	Goldfields Mastery (planned)	Historical timeline simulation — not playable; recognised but disabled	—	See Level 6 blueprint

Architecture and planning (draft)

Each student has one identity (GGR_Students) and an independent game per level (one GGR_StudentProgress row per UPPER(ClassCode)|UPPER(StudentCode)|Level). In the browser each level is saved separately (wa_gr_level_save_v1|CLASS|STUDENT|LEVEL); the old shared level2_autosave slot is migrated non-destructively and kept as a backup. Tenant-dependent behaviour (save protocol v2, full cloud restore, server leaderboard, level reset, competition snapshots, Level 6 analytics) is behind runtime feature flags that default OFF. Nothing in these documents is live-verified.

Save/recovery safety: progress remains local-only until authenticated v2 conditional saving and exact-slot retrieval are configured and verified. Legacy/unverified uploads (including retries) are held; local play, save and backup export remain available. No tenant features are activated by this repair. Operators must follow the phased save/recovery runbook before a pilot; server refusal of old unconditional writers must come first.

• Future-state architecture — identity, per-level saves, migration, restore, leaderboards, competitions, Level 1 assessment, level guide
• Flow registry and contracts — existing, optional and planned flows
• Save protocol v2 — server revision / compare-and-swap, idempotency receipts, reset generation, test vectors
• Level 6 Goldfields Mastery blueprint
• Manual repair template (mixed-level histories)
• Staged release, rollback and tenant acceptance matrix

Level 1: Basic Mining (Archived)

Access: /levels/level-1-basic/index.html

The original working game - preserved as-is for reference and student access.

• Duration: 10 rounds maximum
• Starting Cash: $100
• Dig Types: Safe (10%), Medium (50%), Deep Vein (300%)
• Mechanics: Dice rolls determine dig success

Data Privacy

✅ No identifying data stored offsite

• All game data stored locally on student devices
• Teacher can export progress to OneDrive (encrypted, education tenant)
• Compliant with education department data policies

Progression Note

Detailed progression steps are condensed into the current Level 2 Goldfields Venture implementation and reflected on the home page cards for Levels 2–5.

Teacher Dashboard

Access: /teacher/dashboard.html

• Import student lists (bulk or individual)
• Assign students to levels
• Monitor local shared progress and leaderboard statistics
• Pause game for lessons
• Toggle Strict Classroom Mode (Competition Lock) to require student login for leaderboard/rankings/shared records while still allowing free-play and saves
• Track wealthiest player, most mines owned, most profitable strategy, and average class wealth

---

Teacher Dashboard data flow (Microsoft Lists → Power Automate)

Microsoft Lists → Power Automate → Teacher Dashboard → Student Games

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗