Epic #16: Complete Spring Boot Workshop Adaptation for Enterprise Java Clients

.devcontainer/README.md

@@ -0,0 +1,189 @@
+# DevContainer Selection Guide
+
+This repository contains **3 devcontainer configurations** to support different workshop roles and technology stacks.
+
+## 🎯 Which Container Should I Use?
+
+When you open this repository in VS Code, you'll be prompted to select a devcontainer configuration. Choose based on your role:
+
+---
+
+### 1️⃣ **Workshop Maintainer** (Full Toolchain)
+
+**Location:** `.devcontainer/maintainer/`
+
+**Who should use this:**
+- Workshop authors and content creators
+- Facilitators preparing for dual-stack delivery
+- Contributors working on both .NET and Spring Boot examples
+- Anyone needing to build/test both implementations
+
+**What's included:**
+- ✅ .NET 9 SDK
+- ✅ Java 21 JDK (LTS)
+- ✅ Maven 3.9+ and Gradle 8+
+- ✅ Node.js 20 + Marp CLI (for presentations)
+- ✅ All VS Code extensions (C#, Java, Spring Boot, Markdown, Marp)
+- ✅ GitHub CLI
+
+**Builds:**
+- Both `TaskManager.sln` (.NET) and `src-springboot/` (Java)
+- All presentations and documentation
+- Full workshop materials
+
+---
+
+### 2️⃣ **.NET Participant** (Streamlined)
+
+**Location:** `.devcontainer/dotnet-participant/`
+
+**Who should use this:**
+- Workshop participants following the .NET track
+- Self-paced learners using C# examples
+- Developers working in .NET 9 environment
+
+**What's included:**
+- ✅ .NET 9 SDK
+- ✅ C# Dev Kit extension
+- ✅ GitHub Copilot extensions
+- ✅ Minimal overhead for fast startup
+
+**Auto-activates:**
+- `.github/instructions/dotnet.instructions.md` (automatically loads when editing C# files)
+
+**Builds:**
+- `TaskManager.sln` (.NET solution only)
+
+---
+
+### 3️⃣ **Spring Boot Participant** (Streamlined)
+
+**Location:** `.devcontainer/springboot-participant/`
+
+**Who should use this:**
+- Workshop participants following the Spring Boot track
+- Enterprise Java teams modernizing from Mule ESB
+- Self-paced learners using Java examples
+- Developers working in Spring Boot 3.x environment
+
+**What's included:**
+- ✅ Java 21 JDK (LTS)
+- ✅ Maven 3.9+ and Gradle 8+
+- ✅ Extension Pack for Java
+- ✅ Spring Boot Extension Pack
+- ✅ GitHub Copilot extensions
+- ✅ Minimal overhead for fast startup
+
+**Auto-activates:**
+- `.github/instructions/springboot.instructions.md` (automatically loads when editing files in src-springboot/)
+
+**Builds:**
+- `src-springboot/` (Spring Boot solution only)
+
+---
+
+## 🚀 How to Select
+
+### First Time Opening the Repository
+
+1. Open the repository in VS Code
+2. VS Code will detect multiple devcontainer configurations
+3. You'll see a prompt: **"Select a Dev Container configuration to use"**
+4. Choose based on the guidance above
+
+### Switching Between Containers
+
+1. Press `F1` or `Ctrl+Shift+P` (Windows/Linux) / `Cmd+Shift+P` (Mac)
+2. Type: **"Dev Containers: Rebuild and Reopen in Container"**
+3. Select the new container configuration
+4. Wait for container rebuild (1-5 minutes depending on container)
+
+---
+
+## 📋 Container Comparison
+
+| Feature | Maintainer | .NET Participant | Spring Boot Participant |
+|---------|-----------|------------------|------------------------|
+| **.NET 9 SDK** | ✅ | ✅ | ❌ |
+| **Java 21 JDK** | ✅ | ❌ | ✅ |
+| **Maven/Gradle** | ✅ | ❌ | ✅ |
+| **Marp CLI** | ✅ | ❌ | ❌ |
+| **All Extensions** | ✅ | .NET only | Java only |
+| **Build Time** | ~3-5 min | ~1-2 min | ~2-3 min |
+| **Container Size** | ~5 GB | ~2 GB | ~3 GB |
+| **Copilot Instructions** | Both | .NET | Spring Boot |
+
+---
+
+## 🛠️ Troubleshooting
+
+### "Which Container Should I Use?" Decision Tree
+
+```
+Are you creating workshop content or facilitating?
+├─ YES → Use Maintainer
+└─ NO → Are you following .NET or Spring Boot track?
+    ├─ .NET → Use .NET Participant
+    └─ Spring Boot → Use Spring Boot Participant
+```
+
+### Container Won't Build
+
+**Error:** "Failed to build devcontainer"
+
+**Solutions:**
+1. Ensure Docker Desktop is running
+2. Check available disk space (need 5+ GB free)
+3. Try rebuilding: `F1` → "Dev Containers: Rebuild Container"
+4. Clear Docker cache: `docker system prune -a`
+
+### Copilot Instructions Not Loading
+
+**Instructions now auto-load based on file context:**
+- `.github/instructions/dotnet.instructions.md` loads for `**/*.cs` files
+- `.github/instructions/springboot.instructions.md` loads for `src-springboot/**` files
+- No manual configuration needed - instructions activate automatically when you open files
+
+**If instructions aren't applying:**
+- Verify `.github/instructions/` directory exists
+- Check file has correct `applyTo:` frontmatter
+- Reload VS Code window: `F1` → "Developer: Reload Window"
+
+### Wrong Container Selected
+
+**To switch containers:**
+1. `F1` → "Dev Containers: Rebuild and Reopen in Container"
+2. Select correct configuration
+3. Wait for rebuild
+
+---
+
+## 📚 Next Steps
+
+### For .NET Participants
+1. Verify build: `dotnet build TaskManager.sln`
+2. Run tests: `dotnet test`
+3. Start with [Lab 1 (.NET)](../docs/labs/lab-01-tdd-with-copilot/dotnet.md)
+
+### For Spring Boot Participants
+1. Verify build: `mvn clean install -f src-springboot/pom.xml`
+2. Run tests: `mvn test -f src-springboot/pom.xml`
+3. Start with [Lab 1 (Spring Boot)](../docs/labs/lab-01-tdd-with-copilot/springboot.md)
+
+### For Maintainers
+1. Verify both builds work
+2. Test presentations: `marp --version`
+3. Review [Facilitator Guide](../docs/FACILITATOR_GUIDE.md)
+
+---
+
+## 🔗 Related Documentation
+
+- [Workshop README](../README.md) - Main workshop overview
+- [Pre-Workshop Checklist](../docs/PRE_WORKSHOP_CHECKLIST.md) - Setup requirements
+- [Pattern Translation Guide](../docs/guides/pattern-translation.md) - .NET ↔ Java mappings
+- [Facilitator Guide](../docs/FACILITATOR_GUIDE.md) - Delivery instructions
+
+---
+
+**Questions or issues?** Open an issue in the workshop repository.

.devcontainer/dotnet-participant/devcontainer.json

@@ -0,0 +1,42 @@
+// .NET Participant DevContainer - Streamlined for Workshop Participants
+// For participants following the .NET track
+{
+    "name": "AI Workshop - .NET Participant",
+    "image": "mcr.microsoft.com/devcontainers/dotnet:9.0-bookworm",
+
+    "features": {
+        "ghcr.io/devcontainers/features/github-cli:1": {
+            "version": "latest"
+        }
+    },
+
+    // Use 'postCreateCommand' to run commands after the container is created
+    "postCreateCommand": "dotnet build TaskManager.sln && dotnet dev-certs https --trust",
+
+    // Configure tool-specific properties
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "GitHub.copilot",
+                "GitHub.copilot-chat",
+                "humao.rest-client",
+                "ms-dotnettools.csdevkit",
+                "bierner.markdown-mermaid",
+                "marp-team.marp-vscode",
+                "yzhang.markdown-all-in-one"
+            ],
+            "settings": {
+                "github.copilot.advanced": {}
+            }
+        }
+    },
+
+    // Forward ports for .NET apps
+    "forwardPorts": [5000, 5001],
+    "portsAttributes": {
+        "5001": {
+            "protocol": "https",
+            "label": ".NET HTTPS"
+        }
+    }
+}

.devcontainer/maintainer/devcontainer.json

@@ -0,0 +1,94 @@
+// Workshop Maintainer DevContainer - Full Toolchain
+// For workshop authors and maintainers working with BOTH .NET and Spring Boot
+{
+    "name": "AI Workshop - Maintainer (Full Toolchain)",
+    "image": "mcr.microsoft.com/devcontainers/base:ubuntu-24.04",
+
+    "features": {
+        "ghcr.io/devcontainers/features/dotnet:1": {
+            "version": "9.0",
+            "installUsingApt": false
+        },
+        "ghcr.io/devcontainers/features/java:1": {
+            "version": "21",
+            "jdkDistro": "ms",
+            "installMaven": "true",
+            "installGradle": "true",
+            "mavenVersion": "3.9",
+            "gradleVersion": "8.5"
+        },
+        "ghcr.io/devcontainers/features/node:1": {
+            "version": "20",
+            "nodeGypDependencies": true
+        },
+        "ghcr.io/devcontainers/features/github-cli:1": {
+            "version": "latest"
+        },
+        "ghcr.io/devcontainers/features/git:1": {
+            "version": "latest"
+        }
+    },
+
+    // Use 'postCreateCommand' to run commands after the container is created
+    "postCreateCommand": "dotnet build TaskManager.sln && mvn clean install -f src-springboot/pom.xml -DskipTests && dotnet dev-certs https --trust && npm install -g @marp-team/marp-cli",
+
+    // Configure tool-specific properties
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                // GitHub Copilot
+                "GitHub.copilot",
+                "GitHub.copilot-chat",
+
+                // .NET Development
+                "ms-dotnettools.csdevkit",
+                "ms-dotnettools.csharp",
+
+                // Java Development
+                "vscjava.vscode-java-pack",
+                "vscjava.vscode-spring-boot-dashboard",
+                "vmware.vscode-spring-boot",
+                "vscjava.vscode-spring-initializr",
+                "vscjava.vscode-maven",
+                "vscjava.vscode-gradle",
+
+                // API Testing
+                "humao.rest-client",
+
+                // Documentation & Presentations
+                "bierner.markdown-mermaid",
+                "marp-team.marp-vscode",
+                "yzhang.markdown-all-in-one"
+            ],
+            "settings": {
+                "github.copilot.advanced": {},
+                "java.configuration.runtimes": [
+                    {
+                        "name": "JavaSE-21",
+                        "default": true
+                    }
+                ],
+                "java.jdt.ls.java.home": "/usr/local/sdkman/candidates/java/current"
+            }
+        }
+    },
+
+    // Forward ports for both .NET and Spring Boot apps
+    "forwardPorts": [5000, 5001, 8080, 8443],
+    "portsAttributes": {
+        "5001": {
+            "protocol": "https",
+            "label": ".NET HTTPS"
+        },
+        "5000": {
+            "label": ".NET HTTP"
+        },
+        "8080": {
+            "label": "Spring Boot HTTP"
+        },
+        "8443": {
+            "protocol": "https",
+            "label": "Spring Boot HTTPS"
+        }
+    }
+}