Added a simple ui

docs/README.md

@@ -67,16 +67,18 @@ Open decisions:
 
 ### Read-Only Web UI
 
-Optional future module for checking status without controlling trading behavior.
+Optional module for checking status without controlling trading behavior.
 
-Possible scope:
+The initial implementation is documented in [read-only-ui.md](read-only-ui.md).
+It serves one backend-rendered page, reads Alpaca account state with `alpaca-py`,
+and caches snapshots in SQLite so normal page loads do not repeatedly call Alpaca.
 
-- current holdings;
-- latest signals;
-- recent orders;
-- account summary;
-- model version;
-- bot health and logs.
+Current scope:
+
+- three-month account performance summary;
+- account value chart with a `SPY` S&P 500 proxy comparison;
+- cash and equity portfolio table;
+- completed trades table.
 
 ## Near-Term Priorities