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 <cursoragent@cursor.com>
This commit is contained in:
1 parent
f1fe7a0cc1
commit
b919ca9033
1 file changed
+26
-22
@@ -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
|
||||
```
|
||||
|
||||
|
||||
Reference in new issue
Block a user