From b919ca90333649437f0624576def3c8c59265e18 Mon Sep 17 00:00:00 2001 From: Joseph Spiker Date: Tue, 6 Oct 2026 03:48:30 -0400 Subject: [PATCH] docs: correct Project Structure in the beta README Evidence: spikersoft-backend@master SpikerSoft.GameServer/Zones/CampZone.cs:12 is a safe hub; DungeonZone.cs is a separate zone. Co-authored-by: Cursor --- README.md | 48 ++++++++++++++++++++++++++---------------------- 1 file changed, 26 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 0619a57..1f1152c 100644 --- a/README.md +++ b/README.md @@ -1062,8 +1062,10 @@ spikersoft-angular/ │ │ │ └── fleet-panel/ # Multi-robot fleet management │ │ ├── dungeon-crawler/ # Multiplayer RPG with stronghold PvE │ │ ├── chess/ # Chess (local, AI, online multiplayer) -│ │ ├── fishing-game/ # Fishing simulation -│ │ └── ... # Puzzle & learning games +│ │ ├── hex-tower-defence/ # Hex tower defence +│ │ ├── rpg-game/ # RPG +│ │ ├── snake-game/ # Snake +│ │ └── ... # github-snake, commit-snake, deploy-defender, duality, github-sweeper, hexatile, unified-game │ └── _services/ │ ├── game-server/ # GameServerService (WebSocket, commands, events) │ │ └── robot-program-cache.service.ts # Offline program editing @@ -1071,11 +1073,11 @@ spikersoft-angular/ │ ├── position/ # PositionService (open positions + auto ambassadors) │ └── team/ # TeamService (staff member profiles) ├── libraries/ # Buildable Nx libs grouped by layer (see Frontend Architecture section) -│ ├── domain/ # layer:domain — pure data + thin services bound to backend resources (11 libs) -│ │ ├── blog/ book/ child-account/ fundraiser/ geo/ mrz/ -│ │ └── photograph/ pre-registration/ profile/ sponsor/ users/ -│ ├── features/ # layer:feature — top-level user features w/ routes (32 libs) -│ │ ├── art-studio/ # Art Studio shell + all its views (43 subdirs) +│ ├── domain/ # layer:domain — pure data + thin services bound to backend resources (20 libs) +│ │ ├── art-studio/ blog/ book/ changelog/ child-account/ climbing/ family/ +│ │ └── fundraiser/ geo/ guides/ horticulture/ mail-metrics/ mrz/ photograph/ pre-registration/ profile/ sanctions/ skills/ sponsor/ users/ +│ ├── features/ # layer:feature — top-level user features w/ routes (47 libs) +│ │ ├── art-studio/ # Art Studio shell + all its views (37 subdirs) │ │ ├── photo-gallery/ # Personal photo gallery (wall/cards/map, bursts, lightbox) │ │ ├── geo-globe/ sponsor-cards/ status/ │ │ ├── dev-tools-csharp-runner/ # C# Playground wrapping shell (config + adapter) @@ -1084,26 +1086,26 @@ spikersoft-angular/ │ │ ├── dev-tools-reg-ex/ # Regex Playground (chapters + cheatsheet) │ │ ├── dev-tools-x86-playground/ ...# 20 dev-tools-* + blog, sponsor, fundraiser, ... │ │ └── … # see libraries/features/ for full list -│ ├── platform/ # layer:platform — cross-cutting infra (19 libs) +│ ├── platform/ # layer:platform — cross-cutting infra (23 libs) │ │ ├── language-runner/ # Language-agnostic playground SHELL (consumed by the wrapping shells) │ │ ├── lesson-catalog/ # Lesson catalog + prerequisites (8 languages) │ │ ├── progress-sync/ # Server↔in-browser router + offline IndexedDB queue │ │ ├── pyodide-runtime/ # Pyodide loader (Python in-browser) │ │ ├── clang-runtime/ # Browser Clang/LLD/WASI toolchain (C and C++ in-browser) -│ │ ├── content-locale/ playground-visual-progress/ anon-session/ -│ │ ├── monaco-editor/ tool-storage/ tool-file-menu/ intro-tour/ intro-launching/ +│ │ ├── content-locale/ playground-visual-progress/ anon-session/ currency/ error-reporting/ page-meta/ +│ │ ├── monaco-editor/ tool-storage/ tool-file-menu/ intro-tour/ quick-actions/ typing-sync/ │ │ └── js-step-debugger/ step-debugger-core/ activity-tracking-api/ activity-tracking-impl/ loading/ avif-encoder/ -│ ├── shared/ # layer:shared — small reusable units (7 libs) +│ ├── shared/ # layer:shared — small reusable units (11 libs) │ │ ├── lesson-platform/ # Cross-cluster contracts (PROGRESS_SYNC_PORT, SourceFile, ...) │ │ ├── lesson-panes/ # Lesson + tutorial + sidebar panes │ │ ├── practice-decks/ # Practice product source of truth (flashcards/knots/UML) -│ │ ├── api-config/ js-formatting-options/ save-load-dialogs/ -│ │ └── utils/ # crc32, file-hash -│ ├── ui/ # layer:ui — presentational atoms (7 libs) -│ │ └── avatar-stack/ award-chips/ confirm-dialog/ destination-chips/ image-paste/ mrz-crop/ user-picker/ +│ │ ├── api-config/ auth-roles/ js-formatting-options/ money/ save-load-dialogs/ staff-approvals/ typing-core/ +│ │ └── utils/ # crc32 +│ ├── ui/ # layer:ui — presentational atoms (12 libs) +│ │ └── avatar-stack/ award-chips/ confirm-dialog/ dashboard-charts/ destination-chips/ image-paste/ inbox-layout/ mrz-crop/ password-strength/ stat-tile/ status-visuals/ user-picker/ │ ├── game/ # layer:game — game runtime libs (3 libs) -│ │ ├── gl-hud/ # In-scene WebGL HUD framework (troika-three-text, no DOM) -│ │ ├── hex-tower-defence/ # Hex TD client (server-authoritative via SignalR hub) +│ │ ├── gl-hud/ # In-scene WebGL HUD framework (troika-three-text, plus one hidden HTML input for typing) +│ │ ├── hex-tower-defence/ # Hex TD client (solo reducer in-process; multiplayer over the SignalR hub) │ │ └── wasm-voxel/ # TypeScript Minecraft port (voxel engine) │ │ │ │ # Legacy top-level libs (pre-Phase-4 boundary refactor; tagged but not re-clustered) @@ -1125,7 +1127,8 @@ spikersoft-backend/ │ ├── Zones/ │ │ ├── SpaceZone.cs # Orbital mechanics, spacecraft physics │ │ ├── VoxelZone.cs # Block world, robot management -│ │ └── CampZone.cs # RPG zones (camp, dungeon, stronghold) +│ │ ├── CampZone.cs # Safe hub (merchants, quest board, spell practice; no combat damage) +│ │ └── DungeonZone.cs # The maze │ ├── Services/ │ │ ├── RobotExecutionEngine.cs # Robot instruction interpreter │ │ ├── MongoRobotProgramRepository.cs # Program persistence @@ -1134,7 +1137,8 @@ spikersoft-backend/ │ ├── MessagePackSerializer.cs # Binary protocol (v2) │ └── ConnectionManager.cs # WebSocket session management ├── SpikerSoft.Business/ # Business logic (CQRS + MediatR) — profile, sponsor, art studio, tracker, tm, … -│ └── Domain/GameServer/ # Game domain logic +│ ├── Domain/Game/ # Art loadouts and cosmetics +│ └── Domain/HexGame/ # Hex tower defence commands and queries ├── SpikerSoft.Business.CodeExecution/ # Lesson + grading bounded context (split out of Business) │ └── Domain/ │ ├── Lessons/ @@ -1145,7 +1149,7 @@ spikersoft-backend/ │ └── Hints/StudentCodeHintAnalyzer.cs # Pre-Roslyn pattern checks (+ per-language siblings) ├── SpikerSoft.Games.HexTowerDefence/ # Server-authoritative hex TD reducer (C# port of the TS game) ├── SpikerSoft.Wasm/ # .NET 10 WebAssembly bundle of Roslyn + lesson strategies -│ ├── WasmCompilerEntry.cs # [JSExport] surface (Ping, GetAttempt, ExecuteLessonCode, ExecuteFreePlayCode, AddReferenceImage) +│ ├── WasmCompilerEntry.cs # [JSExport] surface (Ping, AddReferenceImage, GetAttempt, ExecuteLessonCode, ExecuteFreePlayCode, ExecuteFreePlayCodeWithOptions) │ └── main.js # Worker boot script — pre-fetches PE bytes, feeds Roslyn ├── SpikerSoft.Common/ # Shared models and interfaces │ └── Models/ @@ -1154,9 +1158,9 @@ spikersoft-backend/ │ └── Mongos/ # MongoDB documents (incl. game state, lessons, userLessonProgress) ├── SpikerSoft.Contracts.SignalR/ # SignalR hub contracts ├── SpikerSoft.AI.MCPServer/ # AI/ML model server -├── SpikerSoft.EventHandlers.*/ # 28 distributed event processor/worker projects (incl. CodeExecution, ArtPipeProcessor, GpuCoordinator) +├── SpikerSoft.EventHandlers.*/ # 30 distributed event processor/worker projects (incl. CodeExecution, ArtPipeProcessor, GpuCoordinator, GpuHeartbeat, Mail) ├── SpikerSoft.Workers.*/ # Non-handler worker libs (Decompile, Notifications, Ocr) -├── *.Tests/ # Per-project test projects (36), collected by SpikerSoft.UnitTests.slnf +├── *.Tests/ # Per-project test projects (38), collected by SpikerSoft.UnitTests.slnf └── SpikerSoft.sln ```