SEO / Portfolio / Public Site
Strategic Implementation of the Scenario Command Center and Event Studio for Simulation Earth
Report summary
The integration of the Scenario Command Center and the Scenario Event Studio within the Simulation Earth framework on IARPA.org requires a rigorous synthesis of human-computer interaction (HCI) principles, cognitive psychology, spatial accessibility, and serious-game design methodologies. Simulation
Key topics
- SEO / Portfolio / Public Site
- SEO
- Portfolio
- Public Site
- AI
- Angular
- Privacy
- Semantic Systems
- Research Archive
Research provenance
For citation, use the report title and canonical URL. Archival presence does not establish authorship or promote report statements into portfolio evidence.
This page renders the archived Markdown as safe, formatted HTML. It is background research and does not become a portfolio claim without evidence review.
Full report
On this page
Executive Summary and Design Philosophy
The integration of the Scenario Command Center and the Scenario Event Studio within the Simulation Earth framework on IARPA.org requires a rigorous synthesis of human-computer interaction (HCI) principles, cognitive psychology, spatial accessibility, and serious-game design methodologies. Simulation Earth operates as a deterministic, browser-local, fictional world model encompassing 48 synthetic cells. The overarching design mandate is to facilitate safe, educational, cause-first scenario authoring while maintaining an impenetrable cognitive and interactive boundary between the factual Current Statistics environment and the fictional Simulation Earth outcomes. The design philosophy is heavily anchored in cognitive load theory and the facilitation of eudaimonic player experiences, which emphasize reflection, meaning-making, and critical analysis over hedonic or purely entertainment-driven engagement1. By strategically minimizing extraneous cognitive load through progressive disclosure and informational chunking, the interface allocates the user's finite cognitive resources to germane load—the productive mental effort required to understand complex system cascades and geopolitical preparedness2. The architecture strictly prohibits predictive claims, targeted real-world accusations, and the selection of desired harmful outcomes. Instead, it enforces a cause-first deterministic engine where users manipulate initiating facts and observe derived consequences within a safely abstracted, synthetic environment.
First-Use Orientation and Spatial Entry Points
The onboarding architecture must immediately and unambiguously distinguish between the read-only factual Current Statistics and the fictional, branching nature of Simulation Earth. When a user first accesses the environment, the cognitive framing must establish that the simulation is an educational serious game utilized for understanding complex systemic pressures, not a predictive oracle5. Upon initialization, a deterministic orientation sequence locks the interface for an initial two-minute period. During this period, the system requires the user to acknowledge the synthetic nature of the 48 geographic cells and the strict prohibition on predictive targeting. A browser-local state variable governs this flow, ensuring it is only presented during first use or following a hard reset. The visual language of Simulation Earth diverges sharply from Current Statistics through the use of distinct color palettes, stylized topographical shading, and persistent watermarks denoting the environment as a "Fictional Simulation Sandbox." Discoverability in spatial interfaces often suffers when reliant on hidden gestures or non-standard key chords7. The entry points to the Scenario Command Center must accommodate universal access patterns without relying exclusively on right-clicks. The interaction model establishes spatial selection as the primary action. A single click, tap, or standard keyboard execution on any of the 48 synthetic cells selects the geographic anchor. Upon selection, a high-contrast, persistent floating action button titled "Open Command Center" appears in the safe-area viewport, operable via standard mouse, touch, or keyboard traversal8. Keyboard acceleration is supported via a dedicated key command, bypassing the spatial selection if a cell is already focused and immediately launching the Command Center modal. In environments lacking WebGL capabilities, the globe gracefully degrades to a two-dimensional equirectangular projection utilizing semantic HTML maps. The entry points remain identical in this fallback, ensuring feature parity for users reliant on standard document object model interactions.
Responsive Architecture and Accessible Behavior
The spatial nature of a WebGL globe introduces significant accessibility barriers for users reliant on screen readers or keyboard navigation9. The interface must bridge the gap between the HTML DOM and the WebGL canvas context. Spatial accessibility demands rigorous attention to focus management. The 48 synthetic cells are represented in a visually hidden, functionally interactive HTML list overlaid semantically on the canvas, ensuring that the WebGL rendering is purely decorative for screen readers10. The primary container utilizes specific application roles only when appropriate, carefully managing the interception of keyboard events7. Users navigate the spatial environment utilizing standard keyboard progression to enter the globe container and directional keys for spatial navigation between the cells. The current cell is announced via live regions, detailing its synthetic designation and current baseline status8. When the body-level Scenario Command Center modal is invoked, focus is strictly trapped within the modal shell. The background application receives attributes rendering it inert and hidden from assistive technology, preventing background scrolling and phantom screen-reader traversal12. A strict escape hierarchy is enforced to protect the user experience. A dismissal command first closes any active dropdowns or tooltips, subsequently cancels any uncommitted preview state, and finally dismisses the Command Center modal, returning focus precisely to the synthetic cell that initiated the action11. The interface heavily respects reduced-motion preferences by disabling globe rotations and modal transition animations, maintains strict contrast ratios, and supports browser-based zoom magnification up to 400 percent without triggering horizontal scrolling13.
Event Taxonomy and Information Architecture
The event taxonomy utilizes a scalable, hierarchical database of fictional event families. These records are designed to initiate high-level educational system pressures without simulating exact real-world tactical operations. The taxonomy avoids precise coordinates, real-world facilities, or prohibited casualty estimates. The following matrix defines the exhaustive catalog of 75 safe event-family records, mapped to their respective macro-categories and maturity states.
| ID | Macro-Category | Fictional Event Family | Aliases / Search Terms | Required Anchor | Consequence Horizon | Maturity |
|---|---|---|---|---|---|---|
| ENV-01 | Natural/Environmental | Oceanic Temperature Anomaly | Marine heatwave, ocean warming | Coastal/Oceanic | Long-run | Active |
| ENV-02 | Natural/Environmental | Sustained Continental Drought | Water scarcity, aridification | Continental | One-year | Active |
| ENV-03 | Natural/Environmental | High-Yield Seismic Event | Earthquake, tectonic shift | Tectonic Fault | Immediate | Active |
| ENV-04 | Natural/Environmental | Synthetic Atmospheric River | Flooding, torrential rain | Coastal/Inland | 30-day | Active |
| ENV-05 | Natural/Environmental | Rapid Glacial Calving | Sea level rise, ice shelf | Polar/Coastal | Long-run | Active |
| ENV-06 | Natural/Environmental | Stratospheric Aerosol Injection | Geoengineering, dimming | Global | One-year | Prototype |
| ENV-07 | Natural/Environmental | Volcanic Ash Cloud Disruption | Eruption, airspace closure | Tectonic/Island | 30-day | Active |
| ENV-08 | Natural/Environmental | Subterranean Aquifer Depletion | Groundwater loss, sinkholes | Inland | Long-run | Active |
| ENV-09 | Natural/Environmental | Permafrost Methane Release | Carbon feedback, thawing | Tundra/Polar | Long-run | Active |
| ENV-10 | Natural/Environmental | Super-Cyclonic Storm Formation | Hurricane, typhoon | Tropical/Coastal | 30-day | Active |
| HLT-01 | Health/Outbreak | Synthetic Zoonotic Spillover | Pandemic, viral emergence | Urban/Peri-urban | One-year | Active |
| HLT-02 | Health/Outbreak | Vector-Borne Range Expansion | Mosquito, disease spread | Temperate/Tropical | One-year | Active |
| HLT-03 | Health/Outbreak | Antimicrobial Resistance Surge | Superbug, antibiotic failure | Global/Urban | Long-run | Active |
| HLT-04 | Health/Outbreak | Fungal Crop Blight | Agricultural failure, famine | Agricultural | One-year | Active |
| HLT-05 | Health/Outbreak | Waterborne Pathogen Outbreak | Cholera proxy, sanitation | Urban/Riverine | 30-day | Active |
| HLT-06 | Health/Outbreak | Regional Pharmaceutical Shortage | Supply chain, medicine | Regional | 30-day | Active |
| HLT-07 | Health/Outbreak | Medical Infrastructure Overload | ICU capacity, triage | Urban | 30-day | Active |
| HLT-08 | Health/Outbreak | Strategic Vaccine Deployment | Immunization logistics | Regional/Global | One-year | Prototype |
| HLT-09 | Health/Outbreak | Avian Influenza Variant (Fictional) | Poultry culling, ag-stress | Agricultural | One-year | Active |
| HLT-10 | Health/Outbreak | Synthetic Prion Detection | Livestock crisis, food safety | Agricultural | Long-run | Review-Req |
| INF-01 | Infrastructure | Electromagnetic Grid Stress | Blackout, power failure | Urban/Regional | 30-day | Active |
| INF-02 | Infrastructure | Continental Pipeline Disruption | Energy transit, fuel shortage | Continental | 30-day | Active |
| INF-03 | Infrastructure | Subsea Cable Severance | Telecommunications, internet | Oceanic/Coastal | Immediate | Active |
| INF-04 | Infrastructure | Desalination Plant Failure | Water security, coastal stress | Coastal | 30-day | Active |
| INF-05 | Infrastructure | Intermodal Port Congestion | Shipping delay, logistics | Coastal/Port | One-year | Active |
| INF-06 | Infrastructure | Regional Rail Network Collapse | Transit failure, freight | Inland/Urban | 30-day | Active |
| INF-07 | Infrastructure | Smart-City Sensor Synchronization | Urban management stress | Urban | Immediate | Prototype |
| INF-08 | Infrastructure | Hydroelectric Dam Capacity Drop | Energy, drought cascade | Riverine | One-year | Active |
| INF-09 | Infrastructure | Aviation Control Network Outage | Air traffic, routing | Regional | Immediate | Active |
| INF-10 | Infrastructure | Strategic Mineral Processing Halt | Supply chain, rare earths | Industrial | One-year | Active |
| ECO-01 | Economic | Fiat Currency Devaluation | Inflation, purchasing power | National/Regional | One-year | Active |
| ECO-02 | Economic | Sovereign Debt Restructuring | Default proxy, fiscal stress | National | Long-run | Active |
| ECO-03 | Economic | Critical Commodity Price Shock | Commodities, market spike | Global | One-year | Active |
| ECO-04 | Economic | Transnational Capital Flight | Investment withdrawal | Regional | One-year | Active |
| ECO-05 | Economic | Secondary Sanctions Cascade | Trade embargo, friction | Global | Long-run | Active |
| ECO-06 | Economic | Automated Trading Flash Crash | Market volatility, algorithms | Global | Immediate | Active |
| ECO-07 | Economic | Agricultural Export Embargo | Food security, trade halt | Agricultural | One-year | Active |
| ECO-08 | Economic | Industrial Base Labor Strike | Workforce, manufacturing | Industrial | 30-day | Active |
| ECO-09 | Economic | Insurance Market Retreat | Climate risk pricing | Coastal/Risk | Long-run | Prototype |
| ECO-10 | Economic | Cryptocurrency Liquidity Crisis | Digital asset stress | Global | 30-day | Active |
| INS-01 | Institutional | Electoral System Stress | Voting friction, legitimacy | National | 30-day | Active |
| INS-02 | Institutional | Civil Service Walkout | Administration, bureaucracy | Regional | 30-day | Active |
| INS-03 | Institutional | Judicial System Paralysis | Courts, rule of law | National | One-year | Prototype |
| INS-04 | Institutional | Municipal Insolvency | Local government, services | Urban | One-year | Active |
| INS-05 | Institutional | Treaty Withdrawal | Multilateralism, diplomacy | Global | Long-run | Active |
| INS-06 | Institutional | Domestic Separatist Agitation | Cohesion, fracturing | Regional | Long-run | Review-Req |
| INS-07 | Institutional | Regulatory Capture Revelation | Corruption, public trust | National | One-year | Active |
| INS-08 | Institutional | Emergency Powers Invocation | Civil liberties stress | National | 30-day | Active |
| INS-09 | Institutional | Multilateral Aid Suspension | Development, dependency | Regional | One-year | Active |
| INS-10 | Institutional | Pension Fund Default Risk | Social safety net, elderly | National | Long-run | Active |
| IFO-01 | Information | Synthetic Media Saturation | Deepfakes, truth decay | Global | 30-day | Active |
| IFO-02 | Information | Targeted Disinformation Campaign | Propaganda, cognitive | Regional | One-year | Active |
| IFO-03 | Information | State-Level Internet Splintering | Firewall, digital sovereignty | National | Long-run | Active |
| IFO-04 | Information | Algorithmic Polarization | Social media, extremism | Global | Long-run | Active |
| IFO-05 | Information | Mass Data Exfiltration | Privacy breach, cyber | Institutional | One-year | Active |
| IFO-06 | Information | Scientific Consensus Fracturing | Expertise denial, trust | Global | Long-run | Active |
| IFO-07 | Information | Investigative Journalism Blackout | Censorship, press freedom | National | One-year | Active |
| IFO-08 | Information | Financial Panic Rumor Propagation | Bank run, confidence | Regional | Immediate | Active |
| IFO-09 | Information | Historical Revisionism Endorsement | Curriculum, cultural memory | National | Long-run | Prototype |
| IFO-10 | Information | Open-Source Intelligence Contradiction | Verification failure | Global | 30-day | Active |
| AUT-01 | Autonomous/AI | Autonomous Logistics Saturation | Drone delivery, airspace | Urban | 30-day | Active |
| AUT-02 | Autonomous/AI | Algorithmic Supply Chain Lock | Optimization failure | Global | 30-day | Active |
| AUT-03 | Autonomous/AI | Layered Counter-Autonomy Defense | Airspace denial, swarms | Regional/Military | Immediate | Active |
| AUT-04 | Autonomous/AI | Generative AI Economic Displacement | Automation, labor market | Global | Long-run | Active |
| AUT-05 | Autonomous/AI | Autonomous Grid Management Loop | Power oscillation, feedback | Regional | Immediate | Prototype |
| ORB-01 | Orbital | Kessler Syndrome Onset | Space debris, cascade | Orbital | Long-run | Active |
| ORB-02 | Orbital | High-Altitude Electromagnetic Pulse | EMP proxy, satellite loss | Orbital/Surface | Immediate | Review-Req |
| ORB-03 | Orbital | Commercial Constellation Interference | GPS denial, timing sync | Global | 30-day | Active |
| ORB-04 | Orbital | Coronal Mass Ejection (CME) | Solar flare, grid stress | Global | 30-day | Active |
| ORB-05 | Orbital | Lunar Resource Contest | Extraterrestrial diplomacy | Orbital/Lunar | Long-run | Prototype |
| CON-01 | Conflict/Risk | Strategic Command-Link Contest | Deterrence, communication | Global | Immediate | Review-Req |
| CON-02 | Conflict/Risk | Fictional Fissile Material Loss | Proliferation, security | Point-of-origin | One-year | Active |
| CON-03 | Conflict/Risk | Early-Warning Radar Anomaly | False alarm, escalation | Regional | Immediate | Active |
| RCV-01 | Recovery | Post-Crisis Infrastructure Rebuild | Resilience, reconstruction | Regional | Long-run | Active |
| RCV-02 | Recovery | Institutional Trust Restoration | Reconciliation, transparency | National | Long-run | Active |
Events transition automatically from active to deprecated status if real-world analogous events render the educational abstraction overly sensitive or indistinguishable from current geopolitical targeting. Deprecated events remain strictly within browser-local saved templates to preserve user data but cannot be selected for the initialization of new scenario branches.
Recommendation Logic and Ethical Engagement
The Command Center avoids manipulative engagement algorithms optimized for outrage or fear amplification. Instead, it utilizes a deterministic, privacy-preserving recommendation engine that computes relevance based solely on browser-local session state variables, such as the active mode, current branch, date, synthetic setting, and explicitly declared learning goals. The deterministic engine calculates a relevance score for event families based on the active cell's topological and infrastructure metadata. If the user selects a coastal synthetic cell, the engine boosts environmental anomalies and desalination failures14. This operational model requires no user profiling, no server-side analytics, and zero external tracking. Recommendations are rendered strictly explainable. The interface presents an "Explore Similar Scenarios" module featuring a clear provenance badge, explicitly stating the systemic dependency that triggered the suggestion. This transparent, deterministic mapping fosters intellectual curiosity and calibrated reasoning, mitigating the deceptive urgency found in predictive or engagement-driven algorithms.
Cause-First Authoring: Guided versus Advanced Modalities
The Scenario Event Studio requires users to manipulate initiating facts rather than selecting a desired consequence, maintaining the foundational integrity of the serious game framework5. The five-row modal shell supports a Guided Mode tailored for first-time users and students, and an Advanced Mode optimized for analytical rigor. Both modalities interface with an identical deterministic simulation engine. Guided Mode mitigates cognitive overload by abstracting complex inputs into qualitative sliders and preset clusters2. Defaults are explicitly explained through persistent tooltips, and advanced controls are hidden to prevent the implication of physical precision. Conversely, Advanced Mode unlocks granular categorical variables while rigorously maintaining the non-negotiable prohibition on exact yields, blast radii, or real-world weapon parameters.
| Control Category | Control Name | Mode Visibility | Default State | Dependency / Derived Output | Safety Note / Strict Constraint |
|---|---|---|---|---|---|
| Core | Fictional Event Family | Guided & Adv | None (Required) | Locks geographic anchor type | Must entirely prohibit real-world targets. |
| Context | Scenario Preset | Guided Only | "Baseline" | Populates underlying Advanced sliders | Presets must remain highly qualitative. |
| Scale | Abstract Scale | Guided & Adv | "Moderate" | Derives affected cell radius | Actively replaces precise weapon yields. |
| Time | Consequence Horizon | Guided & Adv | "30-day" | Derives consequence windows | Caps maximum projection to stop speculative drift. |
| Actors | Fictional Actor Class | Advanced | "State Proxy A" | None | Strictly enforces synthetic naming conventions. |
| Actors | Synthetic Actor | Advanced | "Unattributed" | Requires Actor Class | Prohibits real-world organization nomenclature. |
| Geography | Setting | Guided & Adv | Cell Default | Locked by event family (e.g., Coastal) | Exact latitudinal/longitudinal coordinates blocked. |
| Capacity | Preparedness | Advanced | "Average" | Modulates immediate consequence severity | Designed to test systemic readiness, not fault. |
| Capacity | Response Capacity | Advanced | "Nominal" | Modulates 30-day recovery curve | Focuses on institutional logistics. |
| Capacity | Infrastructure Resilience | Advanced | "Standard" | Modulates secondary systemic failures | Evaluates cascading grid dependencies. |
| Complexity | Cascade Complexity | Advanced | "Linear" | Derives tertiary economic/health effects | Limits infinite exponential growth. |
| Complexity | Evidence Uncertainty | Advanced | "Clear" | Modulates information availability to actors | Strictly prevents operational coercion training. |
| Complexity | Onset Pattern | Advanced | "Sudden" | Modulates preparedness effectiveness | Evaluates early-warning system efficacy. |
| Context | Event Assumptions (up to 3\) | Advanced | None | Derives specific consequence channels | Locked exclusively to high-level systemic abstractions. |
| Narrative | Private Note | Both | Empty | Browser-local only, no simulation derivation | Sanitized upon import; aggressively stripped of entities. |
Simulation State Machine and Branching Mechanics
To maintain a pristine boundary between speculative what-if experimentation and committed fictional outcomes, the Event Studio operates a rigorous state machine governing branch creation and data mutation.
| System State | User Action / Trigger | Engine Activity | Visual Interface Response |
|---|---|---|---|
| BASELINE | Application initialization or return. | Engine is entirely idle. | Globe reflects factual statistics or previously committed fictional states. |
| INSPECTOR\_OPEN | User selects an event family. | Engine prepares parameter defaults. | Globe is visually dimmed and rendered inert. Minimum context is presented before configuration. |
| CONFIG\_DIRTY | User alters configuration parameters. | Engine validates inputs locally. | Localized, non-committing bounding box highlights the affected cell. Timeline history remains pristine. |
| PREVIEW\_MODE | User executes "Calculate Preview." | Deterministic engine processes initiating facts. | Modal transitions to a comparative view. Globe updates with hashed, semi-transparent overlay denoting uncommitted projection. |
| COMMITTING | User explicitly confirms the preview. | Engine finalizes state mutation arrays. | Transition animations execute. Fictional watermark intensifies. |
| BRANCH\_ACTIVE | State successfully mutates. | New local history array is generated. | Interface announces divergence into a fictional timeline. Provides explicit "Return to Baseline" recovery action. |
The read-only branch-comparison specification allows users to deeply evaluate two distinct branch profiles simultaneously. This engine strictly locks the event family, date, and synthetic location, establishing a non-mutation invariant that forces the comparison to act as a pure read-only differential calculator. It juxtaposes critical metrics utilizing diverging data visualizations. The interface explicitly avoids false probability claims, framing the comparison contextually as a differential output under specified assumptions rather than projecting the likelihood of an event occurring15.
Consequence Communication and Uncertainty Visualization
Data visualization within the scenario inspector is structured to respect intrinsic cognitive processing limitations by organizing dense information logically16. Consequences are parsed into discrete temporal chunks, ensuring that immediate effects are separated from long-run macro-economic shifts. This progressive disclosure prevents overwhelming the user with a monolithic block of text, focusing cognitive attention sequentially2. The interface visualizes systemic pathways through abstracted flow diagrams, mapping primary infrastructure pressures to secondary capacities without detailing precise, localized casualty metrics. Deterministic outputs are rendered with intentional visual fuzziness to communicate uncertainty. Rather than presenting mathematically absolute predictions, the interface displays confidence intervals and bounding boxes. This enforces calibrated reasoning over false precision, supporting the pedagogical goals of the serious gaming environment15.
Debriefing Framework and the Learning Loop
Drawing from robust literature on serious games and human-computer interaction, effective learning occurs not merely through gameplay manipulation, but through structured debriefing and active reflection5. The application systematically integrates the core principles of the SAVEstate documentation method1. The optional, browser-local private note field allows users to explicitly document their hypotheses before calculating a preview, engaging in reflection-in-action. Following the commitment of a branch, a dedicated debriefing drawer surfaces. This interface presents the user's initial notes alongside the newly simulated consequences, prompting them to inspect their causal assumptions and acknowledge systemic surprises. The platform actively subverts traditional gamification paradigms that reward score maximization. Instead, it tracks and rewards the exploration of complex counterfactuals, gamifying analytical rigor and hypothesis testing rather than consequence maximization1.
Templates, Portability, and Sanitization Protocols
Users can save, pin, export, and import scenario templates to facilitate classroom use and collaborative analysis. To maintain strict safety boundaries against malicious or prohibited data injections, the import pipeline features an aggressive, schema-validating parser.
| Template Bundle Field | Data Type | Specification and Sanitization Rules |
|---|---|---|
| schema\_version | String | Must match the current application version index. Rejects legacy schemas automatically. |
| bundle\_hash | String | Cryptographic verification of structural integrity. |
| event\_family\_id | String | Must validate against the internal taxonomy of 75 approved fictional events. |
| synthetic\_cell\_id | Integer | Must strictly map to an integer between 1 and 48\. |
| parameters\_object | Object | Validates configuration sliders against defined minimum and maximum bounds. |
| private\_note | Null / Excluded | Explicitly stripped from all export bundles to preserve absolute local privacy. |
The importer instantly rejects any data payload containing regular expression matches for real-world coordinate pairs, recognized nation-state nomenclature, or known geopolitical entity identifiers. Upon dropping a template file into the browser, a difference-preview modal appears. It lists precisely which synthetic parameters will be loaded and requires explicit user consent before overwriting the active branch configuration. The strict avoidance of automatic background merging prevents state corruption and limits the execution of untrusted template definitions.
Textual Wireframes for Multi-Device Environments
The responsive design strictly adheres to a single-scrolling workspace framework, ensuring robust accessibility and comprehension across highly variable device viewports13.
Desktop Application Environment (Side-by-Side Presentation)
\+-----------------------------------------------------------------------------+ | \[Header\] Scenario Event Studio (Fictional Simulation Mode) \[X\] Cancel | \+-----------------------------------------------------------------------------+ | \[Detail Selector\] Event Family: INF-01 (Electromagnetic Grid Stress) | \+-----------------------------------------------------------------------------+ | \[WORKSPACE (Left: Configuration)\] | \[WORKSPACE (Right: Preview)\] | | (Scrollable Parameter Region) | (Scrollable Consequence Region) | | \> Abstract Scale: \[---O--\] Moderate | \ Derived Fictional Outcomes \ | | \> Horizon: \[ 30-day (v) \] | | | \> Setting: Synthetic Cell 42 (Urban) | \[ Immediate \] \[ 30-day \] \[ 1-yr \] | | | \- Grid oscillation projected | | \[ Advanced Configuration (Expand) \] | \- Secondary telecom disruption | | | | | \> Private Note: \[\_\_\_\_\_\_\_\_\_\_\_\_\_\_\] | \> Provenance: Based on systemic | | | resilience research \[Info\] | \+-----------------------------------------------------------------------------+ | \[Guardrail\] SAFETY BOUNDARY: No real-world targeting permitted. | \+-----------------------------------------------------------------------------+ | \[Calculate Preview\] \-\> \[Commit to New Branch\] | \+-----------------------------------------------------------------------------+
Narrow Laptop Viewport (760px to 1024px)
The workspace utilizes an adaptive flexbox model. The side-by-side view collapses into a stacked hierarchy where the configuration module sits above the preview data. This ensures that editable fields always precede the secondary preview in the document object model sequence, guaranteeing logical screen reader flow and focus order8.
Mobile Portrait Environment (Bottom-Sheet Presentation)
\+---------------------------------------+ | (Globe visually dimmed in background) | \+---------------------------------------+ | \[^\] Drag to expand | \[X\] Close | | Scenario Event Studio (Fictional) | \+---------------------------------------+ | Event: INF-01 (Grid Stress) | \+---------------------------------------+ | (Scrollable area restricted to sheet) | | \> Scale: \[ Moderate (v) \] | | \> Horizon: \[ 30-day (v) \] | | \> Advanced Config \[Expand\] | | | | \[Calculate Preview\] | | | | (Data preview populates below fields) | \+---------------------------------------+
Mobile Landscape Environment
To prevent vertical spatial constraint failures, the landscape view forces a condensed two-column layout identical in structure to the desktop presentation but systematically removes peripheral padding, utilizing full viewport width. The header compresses into a slim, sticky navigation bar.
Two-Dimensional Fallback Presentation
Replaces the WebGL background entirely with a high-contrast scalable vector graphics projection. Synthetic cells are rendered as interactive, semantically labeled button elements positioned over the projection. The Command Center modal behaves identically to the Desktop view, strictly utilizing standard dialog HTML elements for robust fallback accessibility.
Comprehensive User Journeys
The interface accommodates diverse user profiles interacting with complex systems analysis and serious gaming constraints. The First-Time Visitor Profile: Arrives via a public link, fundamentally curious about the platform's capabilities. They land on the factual Current Statistics view. Upon clicking a synthetic cell, the system intercepts the interaction, displaying the mandatory orientation sequence. The visitor reads the explicit distinction between factual data and Simulation Earth, acknowledging the constraints. Entering Guided Mode, they select the "Oceanic Temperature Anomaly" event, leave the qualitative sliders on their default states, and engage the preview calculation. They view the diagram of secondary effects, internalize the marine infrastructure pressures, and exit the session without saving, successfully orienting to the platform's purpose without cognitive overwhelm. The Graduate Student Profile: Utilizing the platform for political science coursework on systemic cascading failures. This user leverages keyboard shortcuts to bypass spatial clicking, rapidly entering Advanced Mode. They select "Electoral System Stress," adjusting the institutional trust parameters downward and evidence uncertainty upward. Critically, they utilize the private note function to document their hypothesis regarding civic breakdown prior to previewing the data. After committing the branch, they proceed to the debriefing drawer to evaluate their hypothesis against the deterministic 30-day consequence output, subsequently exporting the template bundle to submit alongside their academic analysis. The Professional Analyst Profile: Tasked with exploring supply chain resilience architectures without touching classified or targeted data. They select a coastal synthetic cell and initiate an "Intermodal Port Congestion" event. Tweaking infrastructure resilience and cascade complexity, they commit the first branch. They instantly branch a second timeline utilizing identical parameters but with heavily increased preparedness metrics. Opening the branch comparison drawer, they evaluate the diverging visualizations to mathematically understand how theoretical preparedness buffers mitigate 30-day economic pressures. The Keyboard-Only Access Profile: A motor-impaired user utilizing a switch device or standard keyboard for primary navigation. The user navigates the application layer utilizing standard tab progression. Focus seamlessly enters the main container. They utilize arrow keys to traverse the visually hidden but semantically structured list of 48 synthetic cells. Selection automatically shifts focus to the modal invocation button. Upon opening the command center, focus is rigidly trapped. The user tabs logically through the guided sliders, utilizes the spacebar to activate the preview calculation, and employs the escape key to cleanly dismiss the modal, returning focus to the original synthetic cell button without disruption8. The Mobile Commuter Profile: Exploring the application on a handheld device in portrait orientation. The user long-presses on the globe to inspect a cell, triggering the fallback interaction for touch environments. The Command Center elevates smoothly as a bottom-sheet module. The background globe is rendered inert, preventing accidental zoom disruptions. The user scrolls vertically through the single-scroller interface, tapping the calculate button. The sheet dynamically expands to maximum safe height to display the preview data, which the user eventually dismisses via a downward swipe gesture on the header handle. The Nonvisual Screen-Reader Profile: Utilizing advanced screen-reader software on a desktop environment. Tabbing into the primary interface announces the interactive fictional globe and instructions for spatial navigation. Selecting a cell and opening the command center triggers the dialog role, announcing the modal title clearly. The user navigates through form fields built strictly with standard semantic inputs, minimizing unnecessary ARIA overhead7. Upon calculating the preview, an assertive live region announces the completion of the calculation. The user tabs directly into the preview data table, which is structurally marked up with semantic headers and data cells for flawless nonvisual interpretation.
Usability-Study Protocol and Evaluation Criteria
The evaluation of the interface centers strictly on the comprehension of the fictional boundary and the ease of scenario manipulation without inducing cognitive overload. No fabricated metrics or deceptive engagement criteria are utilized to measure success. The testing cohort requires 15 diverse participants, explicitly including domain experts, academic students, mobile-exclusive users, and individuals reliant on assistive technology.
| Evaluation Stage | Testing Task | Comprehension Question / Success Metric | Stopping Rule / Failure Condition |
|---|---|---|---|
| Orientation | Identify the current mode of the application. | "Are you currently viewing factual data or a fictional simulation?" | If a user expresses belief that a generated consequence is a real-world predictive threat, the session is instantly halted. |
| Authoring | Create a fictional branch simulating a natural disaster. | "Were you able to find the relevant event family without frustration?" | If a Guided Mode user spends more than 3 minutes attempting to decipher the interface without taking action. |
| Advanced Usage | Modify the preparedness level of an existing event. | "How did the modified preparedness alter the 30-day projection?" | User fundamentally misunderstands the qualitative slider impact. |
| Portability | Export your scenario, clear the state, and import the template. | "Did the system clearly warn you before replacing your active branch?" | The system fails to present the difference-preview modal during import. |
Accessibility coverage criteria mandate that one hundred percent of interactive elements are reachable and operable via keyboard alone. Furthermore, testing must prove the absolute absence of keyboard traps within the application canvas or the modal structure12. Contrast ratios must be verified manually alongside automated testing suites.
Microcopy Library for Boundaries and Recovery
The microcopy ensures precise cognitive framing of the simulation's intent, setting rigid linguistic boundaries against misuse or predictive interpretation2.
| UI Context | Approved Microcopy String | Psychological Intent / Rationale |
|---|---|---|
| Fictional Activation | "Activating Simulation Branch. All subsequent data represents educational, deterministic fiction." | Reinforces the barrier between reality and serious gaming. |
| Safety Boundary (Error) | "Configuration Error: Input parameters cannot mimic precise real-world equivalents. Please utilize abstract scales." | Actively prevents the entry of specific yields or targets. |
| Uncertainty Framing | "Consequences shown represent a high-probability vector under selected assumptions, not a definitive prediction." | Enforces calibrated reasoning over false algorithmic precision. |
| Empty State (Compare) | "Select a divergent branch to compare systemic pressures." | Guides the user toward counterfactual exploration. |
| Recovery/Undo Action | "Return to Baseline. This will archive the current fictional branch and restore Current Statistics." | Provides a safe cognitive exit hatch from complex scenarios. |
| Import Preview Alert | "Template Analysis Complete. Fictional parameters identified. No unsafe data detected. Apply to current branch?" | Establishes trust in the sanitization pipeline. |
| Data Projection State | "Projecting systemic pressures across a selected temporal window..." | Avoids the word "predicting" entirely. |
Prioritized Implementation Backlog
The engineering and content teams will execute this architectural blueprint according to a strict priority matrix based on safety, structural dependency, and cognitive impact.
| Priority Tier | Component | Engineering Task Description | Rationale |
|---|---|---|---|
| Safe-Now | Core State Machine | Build the baseline, preview mode, and branch active transition logic. | Foundational logic required for all interaction. |
| Safe-Now | UI Shell Architecture | Construct the accessible modal with robust focus trapping and strict escape hierarchy. | Ensures accessibility compliance from day one. |
| Safe-Now | Orientation Sequence | Deploy the initial interface lock-out and fictional-boundary acknowledgment flow. | Mandatory for ethical deployment and user safety. |
| Prototype | Engine Hookup | Connect the interface sliders to the local deterministic response matrices. | Bridges the visual layer with the data model. |
| Prototype | Data Visualization | Build the abstracted flow diagrams and diverging bar charts for consequence communication. | Alleviates cognitive load during consequence review. |
| Prototype | SAVEstate Loop | Implement the private note field and debriefing drawer to support structured reflection. | Core to the pedagogical success of the serious game. |
| Review-Required | Event Taxonomy | Load the 75 event-family records for final dual-review against real-world tactical parallels. | Prevents accidental geopolitical sensitivity breaches. |
| Review-Required | Template Import | Deploy JSON serialization and rigorous parser testing against malicious HTML injections. | Secures the local environment against crafted exploits. |
| Reject | Server-Side State | Reject all proposals to save states externally. All data must remain strictly browser-local. | Preserves user privacy and prevents database contamination. |
| Reject | Real-World Overlays | Reject any attempts to overlay the 48 synthetic cells directly onto recognizable nation-state borders. | Violates the foundational safety and abstraction mandate. |
| Reject | Engagement Algos | Reject trending scenarios or algorithmic feeds designed to manipulate attention. | Misaligns with the serious gaming and eudaimonic design philosophy. |
Works cited
1. SAVEstate: A Method for Documenting Player Reflection in Digital Games \- arXiv, https://arxiv.org/html/2607.17128v1
2. Key Strategies to Manage Cognitive Load In Digital Products \- Think Design, https://think.design/blog/cognitive-load-in-ux-design/
3. Cognitive Load Theory in UI Design: A Practical Guide \- Aufait UX, https://www.aufaitux.com/blog/cognitive-load-theory-ui-design/
4. Designing Enterprise Dashboards with Cognitive Load Theory \- Fegno Technologies, https://www.fegno.com/designing-enterprise-dashboards-with-cognitive-load-theory/
5. FACILITATION MATTERS \- Diva-Portal.org, https://www.diva-portal.org/smash/get/diva2:745056/FULLTEXT02.pdf
6. Serious games as research instruments \- TU Delft Research Portal, https://pure.tudelft.nl/ws/files/84519528/Serious\_games\_as\_research\_instruments.pdf
7. Website Accessibility: The Ultimate Guide to Accessible Maps | FIREANT STUDIO, https://fireantstudio.com/insights/website-accessibility-the-ultimate-guide-to-accessible-maps/
8. Accessibility for custom widgets | Documentation \- Esri Developer \- ArcGIS Online, https://developers.arcgis.com/documentation/app-builders/low-code/arcgis-experience-builder/accessibility-for-custom-widgets/
9. Accessible Maps on the Web \- Equal Entry, https://equalentry.com/accessible-maps-on-the-web/
10. Using ARIA 1.0 and the WebKit Accessibility Node Inspector, https://webkit.org/blog/3302/aria-and-accessibility-inspector/
11. Building Accessible Custom Widgets in ArcGIS Experience Builder with Jimu UI, Calcite, and JavaScript Maps SDK Components \- Esri, https://www.esri.com/arcgis-blog/products/experience-builder/developers/building-accessible-custom-widgets-in-arcgis-experience-builder-with-jimu-ui-calcite-and-map-components
12. Accessible Web Mapping Apps \- GitHub Pages, https://arcgis.github.io/interactive-design/a11y/files/Accessible%20Web%20Mapping%20Apps\_2017.pdf
13. GIS accessibility guidance: Experience Builder \- Mass.gov, https://www.mass.gov/info-details/gis-accessibility-guidance-experience-builder
14. Guidelines for an effective design of serious games, https://journal.seriousgamessociety.org/index.php/IJSG/article/view/8
15. How to communicate and educate more effectively on natural risk issues to improve disaster risk management through serious games \- NHESS, https://nhess.copernicus.org/articles/25/3939/2025/
16. 12 Dashboard Design Principles For Better UX \- UX Pilot, https://uxpilot.ai/blogs/dashboard-design-principles
17. Dashboard UI Design: 3 Principles for Reducing Cognitive Load and Improving Usability, https://www.wandr.studio/blog/dashboard-ui-design
18. Serious Games Design Guidelines (EN) \- co.LAB, https://www.colab-project.ch/sites/default/files/2023-11/Serious%20Games%20Design%20Guidelines%20%28EN%29%20v1.0.pdf
19. Navigating the Serious Game Design Landscape: A Comprehensive Reference Document \- arXiv, https://arxiv.org/pdf/2404.10649