도로 경로 기반 시뮬레이터 개선

README.md

@@ -24,7 +24,7 @@ Open:
 http://localhost:8080
 ```
 
-The web screen has a `샘플 위치` button that posts a demo location with the
+The web screen has a `샘플 전송` button that posts a demo location with the
 default `demo-token`.
 
 By default the server also runs a test simulator with 10 vehicles moving around
@@ -56,8 +56,11 @@ behind Synology Reverse Proxy.
 
 During early testing, keep `SIMULATOR_ENABLED=true` to show moving demo
 vehicles without Android phones. The simulator publishes fresh locations every
-`SIMULATOR_INTERVAL_MS` milliseconds. The web map interpolates between fresh
-positions so vehicles move smoothly instead of jumping between points.
+`SIMULATOR_INTERVAL_MS` milliseconds, 5000 ms by default. It follows cached
+Kakao Mobility road routes when `KAKAO_REST_API_KEY` is valid, uses OSRM road
+routes as a demo fallback, and only then falls back to an internal route.
+`SIMULATOR_SPEED_SCALE` defaults to 1 so the map movement stays close to the
+displayed vehicle speed.
 
 ## Maintenance Scripts
 
@@ -86,10 +89,14 @@ override it in `.env`:
 
 ```text
 KAKAO_JAVASCRIPT_KEY=<override_key>
+KAKAO_REST_API_KEY=<directions_key>
+OSRM_ROUTE_URL=https://router.project-osrm.org/route/v1/driving
 ```
 
-The REST API key and native app key are not needed for the current web map
-screen.
+The REST API key is used only by the server-side simulator to cache road route
+geometry from Kakao Mobility Directions. If the key has an IP allowlist, add the
+server/NAS public IP before expecting Kakao-based simulation. Until then, the
+server can still use OSRM road geometry for demo movement.
 
 In Kakao Developers, register every web origin that will open the control
 screen. Useful early entries are: