v0.14.15-fix

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.14.14**.
+HTTP and WebSocket API for GREE Controller **0.14.15**.
 
 [← Main documentation](../README.md)
 
@@ -239,7 +239,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.14.14",
+  "version": "0.14.15",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -302,7 +302,7 @@ Returns the initial Web UI snapshot:
   "control_plan": {"generated_at": "2026-09-04T08:00:00Z", "zones": [], "rules": []},
   "control_plan_revision": 42,
   "system": {
-    "version": "0.14.14",
+    "version": "0.14.15",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -312,6 +312,7 @@ Returns the initial Web UI snapshot:
     "simulator_count": 0,
     "bind": "0.0.0.0:8787",
     "base_path": "/",
+    "public_chart_base_url": "http://192.168.1.20:8787",
     "gree_interface": "auto",
     "gree_received_frames": 809,
     "gree_received_frames_by_device": {}
@@ -327,7 +328,7 @@ Returns the initial Web UI snapshot:
 
 `GET /charts/custom/:token` renders only the shared chart, without the dashboard. `GET /api/public/charts/custom/:token` returns only the series configured for that share and is intentionally unauthenticated. Possession of the unguessable share URL is the authorization for this narrow read-only endpoint.
 
-In Home Assistant add-on ingress, the Web UI builds the copied URL against the direct add-on host and bound HTTP port (normally `8787`) instead of the `/api/hassio_ingress/...` prefix. Standalone installations use their current origin and configured base path.
+In the Home Assistant add-on, TCP `8787` is the fixed internal application/ingress port. The startup script validates that Supervisor reports the same `ingress_port`; a manually modified mismatched package fails fast instead of starting partially. For generated links, the add-on discovers the primary Home Assistant host IPv4 through the Supervisor API and publishes `http://<HA-IP>:8787/charts/custom/...` by default. The optional `public_chart_base_url` add-on setting overrides that base for reverse proxies or unusual routing. Standalone installations use their current origin/configured base path and therefore follow any port configured in `GREE_CONTROLLER_BIND`.
 
 ### `GET /api/system/info`