/ plans / radicle-issues / 017-create-websocket-server.md
017-create-websocket-server.md
 1  ---
 2  title: "MC-017: Create WebSocket Server on VPS"
 3  labels: ["feat", "backend", "phase-2"]
 4  assignee: null
 5  ---
 6  
 7  ## Tracer Bullet
 8  
 9  ✅ WebSocket server sends initial snapshot and updates every 1 second
10  
11  ## Context
12  
13  Node.js WebSocket server simulates mission assets on VPS.
14  
15  ## Acceptance Criteria
16  
17  - [ ] Node.js project created on VPS
18  - [ ] ws package installed
19  - [ ] server.js creates asset simulation
20  - [ ] Initial snapshot sent on connection
21  - [ ] Updates broadcast every 1000ms
22  - [ ] Server starts on port 8080
23  
24  ## Implementation Steps
25  
26  1. On VPS: mkdir mission-ws-server && cd mission-ws-server
27  2. npm init -y && npm install ws
28  3. Create server.js with asset array
29  4. Add WebSocket onconnection handler
30  5. Add 1-second interval to broadcast updates
31  6. Start server: node server.js
32  
33  ## Notes
34  
35  - Assets move slightly each tick (simulated movement)
36  - Assets randomly trigger alerts
37  - Battery decreases over time