feat(platform): complete the Gelios external data loop

2026-07-20 20:45:05 +03:00
parent def9a24e0d
commit 8a7465cf0e
66 changed files with 5730 additions and 123 deletions
@@ -0,0 +1,20 @@
+# Gelios provider package v3
+
+Version 3 describes the production REST transport used by the L2 workflow:
+`GET https://api.geliospro.com/api/v1/units`. The provider credential keeps the
+Gelios access/refresh pair inside native NDC L2 Credentials; n8n refreshes the
+access token at request time and exposes neither secret to the graph. The
+normalized output is the immutable provider-neutral Data Product
+`fleet.positions.current.v2@2.0.0`.
+
+The product adds four orthogonal state facets owned by L2 semantic mapping:
+
+- `availability_state`: `online`, `offline`, `unknown`;
+- `motion_state`: `moving`, `stationary`, `unknown`;
+- `position_state`: `valid`, `low_quality`, `missing`;
+- `freshness_state`: `fresh`, `stale`.
+
+`state_policy_version` identifies the mapping policy that produced the facets.
+`operational_status` remains in the product as a backwards-compatible coarse
+state; presentation classes, colours, pin proportions and label geometry remain
+Foundry-owned and are never part of this provider package.