From 6630de3c4f446cb87884a1a90c34432ba9c02ec4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=92=D0=B8=D0=BA=D1=82=D0=BE=D1=80?=
 <78488229+viktor138irk@users.noreply.github.com>
Date: Tue, 12 May 2026 02:16:33 +0900
Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D1=84=D0=B8=D0=BA=D1=81=D0=B8?=
 =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B0=D0=BB=20baseline=20runtime=20UI?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/RUNTIME_UI_BASELINE.md | 72 +++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 docs/RUNTIME_UI_BASELINE.md

diff --git a/docs/RUNTIME_UI_BASELINE.md b/docs/RUNTIME_UI_BASELINE.md
new file mode 100644
index 0000000..eb8db6f
--- /dev/null
+++ b/docs/RUNTIME_UI_BASELINE.md
@@ -0,0 +1,72 @@
+# DevConsole Runtime UI Baseline
+
+This document fixes the current production UI baseline for DevConsole.
+
+## Main rule
+
+The root route `/` must render:
+
+```text
+frontend/runtime.html
+```
+
+The file below is legacy and must not be used as the main UI:
+
+```text
+frontend/index.html
+```
+
+## Why
+
+`index.html` is the old editor-era interface. It contains legacy blocks that must not appear in the production runtime UI:
+
+- manual file editor;
+- GitHub settings panel in sidebar;
+- old Android device dropdown;
+- old combined logs.
+
+`runtime.html` is the active production runtime interface:
+
+- project cards;
+- clickable Android device cards;
+- selected device highlight;
+- runtime scenarios;
+- separated runtime log;
+- separated system/activity log under devices;
+- errors panel for AI;
+- system status panel;
+- project OTA settings modal.
+
+## Backend routing requirement
+
+`backend/main.py` must keep:
+
+```python
+@app.get('/')
+async def root():
+    return FileResponse(FRONTEND_DIR / 'runtime.html')
+```
+
+Optional runtime alias:
+
+```python
+@app.get('/runtime')
+async def runtime_page():
+    return FileResponse(FRONTEND_DIR / 'runtime.html')
+```
+
+## Development rule
+
+Frontend changes must be additive and targeted.
+
+Do not replace the whole `frontend/workspace.js` or `frontend/runtime.html` unless intentionally restoring from a known-good commit.
+
+Known-good runtime UI reference chain:
+
+```text
+008eae9 — GitHub-only runtime UI
+49a388c — system panel under log
+4b2bd2b — Android device model cards
+16a726c — separated system log under devices
+ec268a5 — root route switched to runtime.html
+```