init: add contract definitions and database schema with migrations skeleton

2026-04-04 22:42:16 +03:00
parent 1681a694d3
commit 879418b5a9
14 changed files with 251 additions and 8 deletions
--- a/contract/readme.md
+++ b/contract/readme.md
@@ -0,0 +1,18 @@
+## Контракты
+
+В системе используются два независимых контракта:
+
+### 1. Ingest (devices → backend)
+
+- поток сырых данных
+- оптимизирован под запись
+- минимальный размер сообщений
+- формат: telemetry / event
+
+### 2. API (backend → mobile)
+
+- агрегированные данные
+- оптимизирован под чтение
+- формат зависит от UI (графики, таблицы, статусы)
+
+⚠️ Эти контракты НЕ обязаны совпадать