refactor backend folder structure

README.md

@@ -52,23 +52,35 @@ The game implements a sophisticated real-time communication system using Socket.
 
 The project uses a clean, modular architecture with clear separation of concerns:
 
-### Backend Structure (`src/backend/`)
+### Backend Structure (`src/`)
 
-The backend has been refactored into focused modules for maintainability and scalability:
+The backend has been refactored into focused modules organized by domain for maintainability and scalability:
 
+#### **Main Orchestrator**
 - **index.js** - Main server orchestrator (69 lines) coordinating all modules
-- **socketHandlers.js** - Complete socket event processing system (400+ lines)
-- **broadcastManager.js** - Centralized communication and broadcasting management
-- **debugManager.js** - Debug mode and development utilities with production separation
+
+#### **Game Logic (`src/game/`)**
 - **game.js** - Game class with factory methods and proper configuration integration
-- **user.js** - User management class with statistics tracking
 - **dungeon.js** - Dungeon generation with centralized configuration system
-- **lightingAndFov.js** - Field of view calculations and lighting system
 - **player.js** - Player state management and movement logic
 - **monster.js** - Monster AI and behavior
+- **lightingAndFov.js** - Field of view calculations and lighting system
+- **rot.js** & **rot.min.js** - ROT.js library for roguelike mechanics
+
+#### **Network Communication (`src/network/`)**
+- **socketHandlers.js** - Complete socket event processing system (400+ lines)
+- **broadcastManager.js** - Centralized communication and broadcasting management
+
+#### **Database Operations (`src/db/`)**
 - **dbcalls.js** - Database operations for user data and game history
+- **user.js** - User management class with statistics tracking
+
+#### **Blockchain Integration (`src/rpc/`)**
 - **rpccalls.js** - Wownero blockchain RPC integration
 
+#### **Development Tools (`src/debug/`)**
+- **debugManager.js** - Debug mode and development utilities with production separation
+
 #### Modular Architecture Benefits
 - **Single Responsibility**: Each module has one clear purpose
 - **Dependency Injection**: Modules receive dependencies cleanly
@@ -173,13 +185,13 @@ The architecture supports adding spectator features with minimal changes:
 
 2. **Install dependencies**:
    ```bash
-   cd src/backend
+   cd src
    npm install
    ```
 
 3. **Start the backend server**:
    ```bash
-   cd src/backend
+   cd src
    node index.js
    ```
 
@@ -209,19 +221,27 @@ When running locally (localhost/127.0.0.1), the game includes debug features:
 ```
 wowngeon/
 ├── README.md                      # Project documentation
-├── src/backend/                   # Backend server code
+├── src/                           # Backend server code
 │   ├── index.js                  # Main server orchestrator (69 lines)
-│   ├── socketHandlers.js         # Socket event processing (400+ lines)
-│   ├── broadcastManager.js       # Communication management
-│   ├── debugManager.js           # Debug/production mode handling
-│   ├── game.js                   # Game logic with factory methods
-│   ├── user.js                   # User management class
-│   ├── dungeon.js                # Dungeon generation system
-│   ├── lightingAndFov.js         # Field of view calculations
-│   ├── player.js                 # Player state management
-│   ├── monster.js                # Monster AI
-│   ├── dbcalls.js                # Database operations
-│   └── rpccalls.js               # Blockchain RPC calls
+│   ├── package.json              # Node.js dependencies
+│   ├── game/                     # Game logic and mechanics
+│   │   ├── game.js               # Game class with factory methods
+│   │   ├── dungeon.js            # Dungeon generation system
+│   │   ├── player.js             # Player state management
+│   │   ├── monster.js            # Monster AI
+│   │   ├── lightingAndFov.js     # Field of view calculations
+│   │   ├── rot.js                # ROT.js library
+│   │   └── rot.min.js            # ROT.js minified
+│   ├── network/                  # Network communication
+│   │   ├── socketHandlers.js     # Socket event processing (400+ lines)
+│   │   └── broadcastManager.js   # Communication management
+│   ├── db/                       # Database operations
+│   │   ├── dbcalls.js            # Database operations
+│   │   └── user.js               # User management class
+│   ├── rpc/                      # Blockchain integration
+│   │   └── rpccalls.js           # Blockchain RPC calls
+│   └── debug/                    # Development tools
+│       └── debugManager.js       # Debug/production mode handling
 ├── html/                         # Frontend web interface
 │   ├── index.html                # Main game page
 │   ├── js/                       # Modular JavaScript

src/db/user.js

@@ -1,4 +1,4 @@
-const Game = require('./game'); // Ensure Game is required
+const Game = require('../game/game'); // Ensure Game is required
 
 // User class definition
 class User {

src/debug/debugManager.js

@@ -4,7 +4,7 @@
  * Keeps debug/development code separate from production logic
  */
 
-const rpc = require('./rpccalls.js');
+const rpc = require('../rpc/rpccalls.js');
 
 class DebugManager {
     constructor(broadcastManager) {

src/index.js

@@ -3,12 +3,12 @@ const path = require('path');
 var app = express();
 var http = require('http').Server(app);
 var io = require('socket.io')(http);
-var db = require('./dbcalls.js');
+var db = require('./db/dbcalls.js');
 
 // Import modular components
-const BroadcastManager = require('./broadcastManager');
-const DebugManager = require('./debugManager');
-const SocketHandlers = require('./socketHandlers');
+const BroadcastManager = require('./network/broadcastManager');
+const DebugManager = require('./debug/debugManager');
+const SocketHandlers = require('./network/socketHandlers');
 
 // Initialize modular components
 const broadcastManager = new BroadcastManager(io);
@@ -16,7 +16,7 @@ const debugManager = new DebugManager(broadcastManager);
 const activeGames = new Map(); // Maps socketId to Game objects
 const socketHandlers = new SocketHandlers(io, activeGames, broadcastManager, debugManager);
 // Configure static file serving
-const htmlPath = path.join(__dirname, '../../html');
+const htmlPath = path.join(__dirname, '../html');
 app.use(express.static(htmlPath));
 app.use(express.json()); // Parse JSON for API endpoints
 
@@ -50,7 +50,7 @@ io.on('connection', function(socket) {
 // Debug function for registered users
 function debugRegisteredUsers() {
     console.log("📊 REGISTERED USERS DEBUG:");
-    const allUsers = require('./user').getAllUsers();
+    const allUsers = require('./db/user').getAllUsers();
     console.log(`Total registered users: ${allUsers.length}`);
     allUsers.forEach(user => {
         console.log(`  - User ID: ${user.id}, Socket: ${user.socketId}, Client: ${user.clientId}`);

src/network/socketHandlers.js

@@ -3,8 +3,8 @@
  * Handles all socket.io event processing for the Wowngeon game server
  */
 
-const user = require('./user');
-const Game = require('./game');
+const user = require('../db/user');
+const Game = require('../game/game');
 
 class SocketHandlers {
     constructor(io, activeGames, broadcastManager, debugManager) {