eugene-admin/iot_skeleton
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init: add contract definitions and database schema with migrations skeleton

Browse Source
This commit is contained in:
eugene-admin
2026-04-04 22:42:16 +03:00
parent 1681a694d3
commit 879418b5a9
14 changed files with 251 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
contract/ingest/common.schema.json Normal file
View File

@@ -0,0 +1,37 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "contract/ingest/common.schema.json",
"type": "object",
"required": ["v", "id", "type", "ts", "deviceId", "payload"],
"additionalProperties": false,
"properties": {
"v": {
"type": "integer",
"const": 1
},
"id": {
"type": "string",
"minLength": 1
},
"type": {
"type": "string",
"enum": ["telemetry", "event"]
},
"ts": {
"type": "integer",
"minimum": 1600000000000,
"description": "Unix time in milliseconds (UTC)"
},
"deviceId": {
"type": "string",
"minLength": 1
},
"payload": {
"type": "object"
},
"meta": {
"type": "object",
"additionalProperties": true
}
}
}

38
contract/ingest/event.schema.json Normal file
View File

@@ -0,0 +1,38 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "contract/ingest/event.schema.json",
"allOf": [
{ "$ref": "contract/ingest/common.schema.json" },
{
"type": "object",
"properties": {
"type": {
"const": "event"
},
"payload": {
"type": "object",
"required": ["name"],
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Event identifier, e.g. device.overheat"
},
"severity": {
"type": "string",
"enum": ["debug", "info", "warn", "error", "fatal"]
},
"message": {
"type": "string"
},
"data": {
"type": "object",
"additionalProperties": true
}
}
}
}
}
]
}

46
contract/ingest/telemetry.schema.json Normal file
View File

@@ -0,0 +1,46 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "contract/ingest/telemetry.schema.json",
"allOf": [
{ "$ref": "contract/ingest/common.schema.json" },
{
"type": "object",
"properties": {
"payload": {
"type": "object",
"required": ["measurements"],
"additionalProperties": false,
"properties": {
"measurements": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["metric", "value"],
"additionalProperties": false,
"properties": {
"metric": {
"type": "string",
"minLength": 1
},
"value": {
"type": ["number", "string", "boolean"]
},
"unit": {
"type": "string"
},
"source": {
"type": "string"
},
"ts": {
"type": "integer"
}
}
}
}
}
}
}
}
]
}