Replace .NET solutions with Java/Spring Boot equivalents

Convert all workshop step solutions from .NET/Blazor WASM to
Java 21/Spring Boot 3.4.2/Thymeleaf to match the workshop's
target audience of Java developers.

Each step progressively builds on the previous:
- step-00: Java baseline (socops project + .github)
- step-01: Add copilot-instructions.md for Java/Spring Boot
- step-02: Add .editorconfig with Java-specific rules
- step-03: Enhanced README with Java commands and stack
- step-04: Cyberpunk neon UI theme (game.html + app.css)
- step-05: Tech-life themed icebreaker questions
- step-06: Scavenger Hunt mode (new model, endpoint, template)
- step-07: Card Deck mode (3D flip cards, match tracking)
- finished: Complete solution (identical to step-07)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: brunoborges

.solutions/finished/.editorconfig

@@ -1,4 +1,4 @@
-# EditorConfig for C# projects
+# EditorConfig for Java projects
 # https://editorconfig.org
 
 root = true
@@ -11,82 +11,31 @@ charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
 
-[*.cs]
-# Organize usings
-dotnet_sort_system_directives_first = true
-dotnet_separate_import_directive_groups = false
-
-# this. and Me. preferences
-dotnet_style_qualification_for_field = false:suggestion
-dotnet_style_qualification_for_property = false:suggestion
-dotnet_style_qualification_for_method = false:suggestion
-dotnet_style_qualification_for_event = false:suggestion
-
-# Language keywords vs BCL types preferences
-dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
-dotnet_style_predefined_type_for_member_access = true:suggestion
-
-# Parentheses preferences
-dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent
-dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent
-
-# Modifier preferences
-dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion
-
-# Expression-level preferences
-dotnet_style_object_initializer = true:suggestion
-dotnet_style_collection_initializer = true:suggestion
-dotnet_style_prefer_auto_properties = true:suggestion
-dotnet_style_prefer_conditional_expression_over_assignment = true:suggestion
-dotnet_style_prefer_conditional_expression_over_return = true:suggestion
-
-# Null-checking preferences
-dotnet_style_coalesce_expression = true:suggestion
-dotnet_style_null_propagation = true:suggestion
-dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion
-
-# var preferences
-csharp_style_var_for_built_in_types = true:suggestion
-csharp_style_var_when_type_is_apparent = true:suggestion
-csharp_style_var_elsewhere = true:suggestion
-
-# Expression-bodied members
-csharp_style_expression_bodied_methods = when_on_single_line:suggestion
-csharp_style_expression_bodied_constructors = false:suggestion
-csharp_style_expression_bodied_operators = when_on_single_line:suggestion
-csharp_style_expression_bodied_properties = true:suggestion
-csharp_style_expression_bodied_indexers = true:suggestion
-csharp_style_expression_bodied_accessors = true:suggestion
-csharp_style_expression_bodied_lambdas = true:suggestion
-csharp_style_expression_bodied_local_functions = when_on_single_line:suggestion
-
-# Pattern matching preferences
-csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
-csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
-
-# Null-checking preferences
-csharp_style_throw_expression = true:suggestion
-csharp_style_conditional_delegate_call = true:suggestion
-
-# Code block preferences
-csharp_prefer_braces = true:suggestion
+[*.java]
+# Java code style enforcement via EditorConfig
+# Indent with 4 spaces (standard Java convention)
+indent_size = 4
 
-# Unused parameters
-dotnet_code_quality_unused_parameters = all:warning
+# Max line length (Google Java Style = 100, Oracle = 120)
+max_line_length = 120
 
-# Async/await preferences
-csharp_style_prefer_async_over_sync = true:warning
+[*.xml]
+indent_size = 4
 
-# IDE warnings
-dotnet_diagnostic.IDE0051.severity = warning  # Remove unused private member
-dotnet_diagnostic.IDE0052.severity = warning  # Remove unread private member
-dotnet_diagnostic.IDE0059.severity = warning  # Unnecessary assignment
-dotnet_diagnostic.IDE0060.severity = warning  # Remove unused parameter
-dotnet_diagnostic.CS1998.severity = warning   # Async method lacks await
-dotnet_diagnostic.CS4014.severity = warning   # Call not awaited
+[*.{yml,yaml}]
+indent_size = 2
 
-[*.{json,yml,yaml}]
+[*.{json,properties}]
 indent_size = 2
 
 [*.md]
 trim_trailing_whitespace = false
+
+[pom.xml]
+indent_size = 4
+
+[*.html]
+indent_size = 4
+
+[*.css]
+indent_size = 4

.solutions/finished/.github/copilot-instructions.md

@@ -4,51 +4,58 @@
 
 Before committing any changes, ensure:
 
-- [ ] `dotnet build` passes with no errors
-- [ ] `dotnet test` passes (when tests exist)
-- [ ] Code follows C# conventions (PascalCase for public members)
+- [ ] `./mvnw clean package` passes with no errors
+- [ ] `./mvnw test` passes (when tests exist)
+- [ ] Code follows Java conventions (camelCase for methods/fields, PascalCase for classes)
 - [ ] No unused variables or imports
 
 ## Project Overview
 
-**Soc Ops** is a Social Bingo game built with Blazor WebAssembly (.NET 10). Players find people who match questions to mark squares and get 5 in a row.
+**Soc Ops** is a Social Bingo game built with Spring Boot 3.4.2, Thymeleaf, and vanilla JavaScript. Players find people who match questions to mark squares and get 5 in a row.
 
 ## Architecture
 
 ```
-SocOps/
-├── Components/     # Reusable Blazor components
-│   ├── BingoBoard.razor
-│   ├── BingoSquare.razor
-│   ├── BingoModal.razor
-│   ├── GameScreen.razor
-│   └── StartScreen.razor
-├── Models/         # Data models (BingoSquareData, GameState)
-├── Services/       # Business logic
-│   ├── BingoGameService.cs    # State management
-│   └── BingoLogicService.cs   # Game logic
-├── Data/           # Static data (Questions.cs)
-├── Pages/          # Routable pages (Home.razor)
-└── wwwroot/        # Static assets & CSS
+socops/
+├── src/main/java/com/socops/
+│   ├── SocOpsApplication.java       # Spring Boot entry point
+│   ├── web/
+│   │   └── BingoRestController.java # Serves pages & REST endpoints
+│   ├── model/
+│   │   ├── BingoCell.java           # Single tile record
+│   │   ├── PlayPhase.java           # Game phase enum
+│   │   └── WinningStreak.java       # Winning line record
+│   ├── service/
+│   │   └── BoardAssembler.java      # Board generation & game logic
+│   └── data/
+│       └── IcebreakerPrompts.java   # Static question bank
+├── src/main/resources/
+│   ├── templates/game.html          # Thymeleaf template (all UI)
+│   ├── static/css/app.css           # Tailwind-like utility CSS
+│   └── application.properties       # Server config (port 8080)
+└── src/test/java/com/socops/
+    └── service/BoardAssemblerTests.java  # Unit tests
 ```
 
 ## Key Commands
 
 ```bash
-dotnet build SocOps/SocOps.csproj  # Build
-dotnet run --project SocOps       # Run dev server (port 5166)
-dotnet test                        # Run tests
+cd socops
+./mvnw clean package              # Build
+./mvnw spring-boot:run            # Run dev server (port 8080)
+./mvnw test                       # Run tests
 ```
 
 ## Styling
 
-Uses custom CSS utility classes (Tailwind-like) in `wwwroot/css/app.css`:
+Uses custom CSS utility classes (Tailwind-like) in `src/main/resources/static/css/app.css`:
 - Layout: `.flex`, `.grid`, `.items-center`
 - Spacing: `.p-4`, `.mb-2`, `.mx-auto`
 - Colors: `.bg-accent`, `.bg-marked`, `.text-gray-700`
 
 ## State Management
 
-- `BingoGameService` manages game state with event-driven updates
-- State persisted to localStorage via JSInterop
-- Components subscribe to `OnStateChanged` event
+- Server generates board via REST API (`/api/bingo/fresh-board`)
+- Client-side JavaScript manages game state with localStorage persistence
+- Single-page app with lobby, active game, and victory views
+- Thymeleaf renders the initial HTML; JS handles all interactivity

.solutions/finished/.github/instructions/css-utilities.instructions.md

@@ -1,11 +1,11 @@
 ---
-description: CSS utility classes and styling practices for this Blazor project.
+description: CSS utility classes and styling practices for this Spring Boot project.
 ---
 
 # CSS Styling Practices
 
 ## Overview
-This project uses custom CSS utility classes (similar to Tailwind) defined in `wwwroot/css/app.css`. These provide consistent, composable styling without external dependencies.
+This project uses custom CSS utility classes (similar to Tailwind) defined in `src/main/resources/static/css/app.css`. These provide consistent, composable styling without external dependencies.
 
 ## Available Utilities
 
@@ -74,7 +74,7 @@ This project uses custom CSS utility classes (similar to Tailwind) defined in `w
 4. **Keep specificity low**: Utility classes should be single-purpose
 
 ## Example Component Styling
-```razor
+```html
 <div class="flex flex-col items-center justify-center min-h-full bg-gray-50">
     <button class="px-6 py-3 bg-accent text-white rounded-lg font-semibold">
         Start Game

.solutions/finished/.github/instructions/frontend-design.instructions.md

@@ -8,7 +8,7 @@ You tend to converge toward generic, "on distribution" outputs. In frontend desi
 Focus on:
 - Typography: Choose fonts that are beautiful, unique, and interesting. Avoid generic fonts like Arial and Inter; opt instead for distinctive choices that elevate the frontend's aesthetics.
 - Color & Theme: Commit to a cohesive aesthetic. Use CSS variables for consistency. Dominant colors with sharp accents outperform timid, evenly-distributed palettes. Draw from IDE themes and cultural aesthetics for inspiration.
-- Motion: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for Blazor components. Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions.
+- Motion: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for Thymeleaf templates. Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions.
 - Backgrounds: Create atmosphere and depth rather than defaulting to solid colors. Layer CSS gradients, use geometric patterns, or add contextual effects that match the overall aesthetic.
 
 Avoid generic AI-generated aesthetics:

.solutions/finished/.github/prompts/setup.prompt.md

@@ -7,8 +7,8 @@ tools: ['vscode/openSimpleBrowser', 'execute/runTask', 'execute/runInTerminal',
 Your goal is to successfully build and run the workspace as local development environment.
 
 ## Checklist
-- [ ] Required dependencies (.NET 10 SDK) installed and verified
-- [ ] Build task functional
-- [ ] Dev server running (dotnet run)
+- [ ] Required dependencies (Java 21 JDK) installed and verified
+- [ ] Build task functional (Maven build)
+- [ ] Dev server running (./mvnw spring-boot:run)
 - [ ] Site open in browser preview
 - [ ] Short engaging welcome tour for the workspace

.solutions/finished/.github/workflows/deploy.yml

@@ -3,6 +3,7 @@ name: Deploy to GitHub Pages
 on:
   push:
     branches: [main]
+  workflow_dispatch:
 
 permissions:
   contents: read
@@ -22,25 +23,32 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: actions/setup-dotnet@v4
+      - name: Setup Java 21
+        uses: actions/setup-java@v4
         with:
-          dotnet-version: '10.0.x'
+          distribution: 'temurin'
+          java-version: '21'
 
-      - name: Restore dependencies
-        run: dotnet restore SocOps/SocOps.csproj
-      
-      - name: Build
-        run: dotnet publish SocOps/SocOps.csproj -c Release -o release --nologo
+      - name: Build Spring Boot App
+        run: |
+          cd socops
+          ./mvnw clean package -DskipTests -q
       
-      - name: Change base-tag in index.html
+      - name: Prepare deployment
         run: |
-          sed -i 's/<base href="\/" \/>/<base href="\/${{ github.event.repository.name }}\/" \/>/g' release/wwwroot/index.html
+          mkdir -p ./_site
+          
+          # Copy docs (workshop guide) to deployment root
+          cp -r docs/* ./_site/
+          
+          # Prevent Jekyll processing
+          touch ./_site/.nojekyll
       
       - uses: actions/configure-pages@v4
 
       - uses: actions/upload-pages-artifact@v3
         with:
-          path: release/wwwroot
+          path: _site
 
       - name: Deploy to GitHub Pages
         id: deployment

.solutions/finished/README.md

@@ -4,69 +4,77 @@
 
 Soc Ops is an interactive social bingo game designed for in-person mixers, team events, and conferences. Find people who match the prompts, mark your card, and race to get 5 in a row!
 
-<p align="center">
-  <img src="https://github.com/user-attachments/assets/2c6d0c33-72ec-47e8-b6bc-20837e7d830b" alt="Start Screen" width="300" />
-  <img src="https://github.com/user-attachments/assets/4785afd4-c22a-4b1c-9b78-64d426c599e9" alt="Game Board" width="300" />
-</p>
-
 ## ✨ Features
 
 - 🎲 **Randomized boards** — Every player gets a unique arrangement
-- 💾 **Auto-save progress** — Pick up where you left off
+- 💾 **Auto-save progress** — Pick up where you left off (localStorage)
 - 🏆 **Bingo detection** — Automatic win detection for rows, columns, and diagonals
 - 🎉 **Celebration modal** — Confetti-worthy victory screen
 - 📱 **Mobile-first** — Works great on phones at events
 
 ## 🚀 Quick Start
 
 ### Prerequisites
-- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
+- [Java 21 JDK](https://adoptium.net/) or higher
+- [Apache Maven 3.9+](https://maven.apache.org/) (or use the included Maven Wrapper)
 
 ### Run Locally
 ```bash
-cd SocOps
-dotnet run
-# Open http://localhost:5166
+cd socops
+./mvnw spring-boot:run
+# Open http://localhost:8080
 ```
 
 ### Build
 ```bash
-dotnet build SocOps/SocOps.csproj
+cd socops
+./mvnw clean package
+```
+
+### Test
+```bash
+cd socops
+./mvnw test
 ```
 
 ## 🎨 Customize Your Game
 
 ### Change Questions
-Edit `SocOps/Data/Questions.cs` to add your own icebreaker prompts:
-```csharp
-public static readonly List<string> QuestionsList = new()
-{
+Edit `socops/src/main/java/com/socops/data/IcebreakerPrompts.java` to add your own icebreaker prompts:
+```java
+public static final List<String> ALL_PROMPTS = List.of(
     "has a pet",
     "speaks more than 2 languages",
     "your custom question here",
-    // ... 24+ questions for a full board
-};
+    // ... 24 questions for a full board
+);
 ```
 
 ### Workshop Guide
 👉 Follow the [Lab Guide](.lab/GUIDE.md) for a hands-on workshop experience with GitHub Copilot agents.
 
 ## 🛠️ Tech Stack
 
-- **Framework**: Blazor WebAssembly (.NET 10)
+- **Runtime**: Java 21
+- **Framework**: Spring Boot 3.4.2 with Thymeleaf
 - **Styling**: Custom CSS utilities (Tailwind-inspired)
-- **State**: Scoped services with localStorage persistence
+- **State**: Client-side JavaScript with localStorage persistence
+- **Build**: Apache Maven with Maven Wrapper
 - **Deployment**: GitHub Pages via Actions
 
 ## 📁 Project Structure
 
 ```
-SocOps/
-├── Components/     # BingoBoard, BingoSquare, Modals
-├── Models/         # Game state & data models
-├── Services/       # Game logic & state management
-├── Data/           # Question bank
-└── wwwroot/        # Static assets
+socops/
+├── src/main/java/com/socops/
+│   ├── web/            # Controllers & REST endpoints
+│   ├── model/          # Game records & enums
+│   ├── service/        # Board assembly & game logic
+│   └── data/           # Question bank
+├── src/main/resources/
+│   ├── templates/      # Thymeleaf templates
+│   └── static/         # CSS & static assets
+└── src/test/           # Unit tests
 ```
 
 ## 🚢 Deployment