updates

README.md

@@ -0,0 +1,29 @@
+# Zone dashboard
+
+Home-server control UI served at https://zone.zainezq.com. Configuration is data-driven via [`data/manifest.json`](data/manifest.json).
+
+## Local development
+
+```bash
+cd /home/zaine/master-folder/org-platform/zone
+python3 -m http.server 8080
+# open http://127.0.0.1:8080 — API calls need org_backend on :9010 or will show offline
+```
+
+## Tests and CI
+
+```bash
+npm test
+```
+
+Gitea Actions runs `scripts/gated-analysis.ps1` (manifest schema, smell checks, tests).
+
+## Manifest
+
+- **links** — quick-nav cards (`platform` then `infra` groups)
+- **builds** — run/cancel/status/logs bindings to `org_backend` BuildController
+- **status** — health, uptime, last-runs endpoints
+
+Production loads enriched manifest from `GET /api/zone/manifest` (injections: `integrations`, `widgets`). Live widgets poll `GET /api/zone/status` (authoring queue, watcher, timesheet week summary).
+
+Timesheet SPA is served from [`../time-tracking/`](../time-tracking/) at `/time-tracking/` (nginx alias).