Unity U1: scaffold unity-client/ folder + README (Epic #45)

unity-client/README.md

@@ -0,0 +1,69 @@
+# Commander AI Lab — Unity Client
+
+Unity front-end for Commander AI Lab. Communicates with the FastAPI backend (`lab_api.py`) via REST API.
+
+## Requirements
+
+| Tool | Version |
+|---|---|
+| Unity | 2022 LTS (6000.0+) |
+| Render Pipeline | Universal Render Pipeline (URP) |
+| .NET | .NET Standard 2.1 |
+| Backend | Commander AI Lab FastAPI (port 8080) |
+
+## Setup
+
+1. Open Unity Hub
+2. Click **Add** → select this `unity-client/` folder
+3. Open the project in Unity 2022 LTS
+4. Install required packages via Package Manager (see `Packages/manifest.json`)
+5. Start the FastAPI backend: `python lab_api.py`
+6. Open the `MainMenu` scene and press Play
+
+## Folder Structure
+
+```
+unity-client/
+  Assets/
+    Scenes/           — All Unity scenes
+      MainMenu.unity
+      Collection.unity
+      DeckBuilder.unity
+      DeckGenerator.unity
+      Simulator.unity
+      Coach.unity
+      Scanner.unity
+      Training.unity
+      Precon.unity
+    Scripts/
+      Models/         — C# POCOs matching FastAPI response shapes
+      Services/       — ApiClient.cs, CardImageCache.cs
+      UI/             — Scene-specific controllers
+      Animation/      — CardAnimator.cs, BattlefieldAnimator.cs
+    Prefabs/
+      CardPrefab.prefab
+      DeckSlotPrefab.prefab
+      ChatBubble.prefab
+    Materials/        — URP materials + Shader Graphs
+    Textures/         — UI sprites, card back
+    Fonts/
+  Packages/           — Unity package manifest
+  ProjectSettings/    — Build settings, input system config
+```
+
+## Build Targets
+
+| Platform | Instructions |
+|---|---|
+| **Windows** | File → Build Settings → PC/Mac → Windows x86_64 |
+| **WebGL** | File → Build Settings → WebGL (requires Brotli compression) |
+| **Android** | File → Build Settings → Android (requires Android SDK) |
+| **iOS** | File → Build Settings → iOS (requires Xcode on Mac) |
+
+## API Configuration
+
+The default backend URL is `http://localhost:8080`. Change it from the **Settings** panel in the MainMenu scene or pass it as a WebGL URL parameter: `?server=http://your-server:8080`
+
+## GitHub Issues
+
+See Epic [#45](https://github.com/KoalaTrapLord/commander-ai-lab/issues/45) for full task breakdown.