# Глоссарий

> Единый словарь Штурмана: один термин — одна строка. Канонические определения,
> чтобы все документы и контрибьюторы говорили на одном языке. Пополняем по мере
> появления новых терминов.

Статус: **v1 (наполнен).** Сгруппировано по областям; ссылки — на канонический документ-владелец.

---

## Машина, CAN, диагностика

| Термин | Определение |
|--------|-------------|
| **OBD-II** | Стандартный диагностический интерфейс авто (разъём + протоколы). Штурман читает PID/DTC — только read-запросы. |
| **PID** | Parameter ID — код запрашиваемого параметра OBD-II (скорость, обороты, температуры…). |
| **DTC** | Diagnostic Trouble Code — код неисправности (напр. `P0420`). Читается, НЕ сбрасывается (#2). |
| **CAN** | Controller Area Network — шина данных авто. **SocketCAN** — Linux-стек CAN; **vcan** — виртуальный CAN для dev-тестов. |
| **listen-only** | Пассивный приём CAN в silent-режиме: ноль TX, без ACK. Строжайшая форма read-only (hardware §4). |
| **Mode 01/03/07/09** | Стандартные read-режимы OBD-II (текущие данные / DTC / pending / vehicle-info). **Mode 04** (сброс DTC) и UDS-write — запрещены (#2). |
| **ELM327** | Популярный OBD-адаптер; полноценный CAN-узел → read-only держится software-дисциплиной (hardware §4). |
| **VSS** | Vehicle Signal Specification — таксономия сигналов машины (модель данных E / data-model). |
| **DBC** | Формат описания CAN-сообщений; per-vehicle маппинг сигналов (data-model §7, часть BSP). |
| **ECU** | Electronic Control Unit — блок управления узлом авто. Штурман с управляющими ECU не интегрируется (#1). |
| **AUTOSAR** | Отраслевой стандарт ПО для ECU. «Занятая клетка», в которую Штурман сознательно НЕ идёт (vision). |
| **AGL** | Automotive Grade Linux — тяжёлая OEM-ориентированная авто-ОС; Штурман легче и нишев под афтемаркет. |

## Платформа, IPC, UI

| Термин | Определение |
|--------|-------------|
| **D-Bus** | Шина control-plane: команды/события/свойства. НЕ для медиа-потоков (те — PipeWire/Wayland). |
| **Control plane / data plane** | D-Bus (управление) vs PipeWire/Wayland/V4L2 (высокополосные аудио/видео/графика). |
| **PipeWire** | Медиа-сервер аудио/видео (data-plane). **WirePlumber** — его сессионный менеджер и политика (ducking). |
| **Wayland** | Протокол композитинга. Shell = кастомный композитор на **smithay** (Rust); `cage` не годится (single-app). |
| **Slint** | Rust-native декларативный GPU-ускоренный UI-тулкит (рендер тайлов/экранов). |
| **Слот-модель** | Слоты Shell (home-грид / полноэкран / оверлей / статус-бар); ап вкладывает декларативный элемент **или** Wayland-поверхность (architecture §8, C §4). |
| **Capability** | Заявленное в манифесте плагина право на ресурс (`vehicle_read`, `network`, `audio_out`…); гейтится на своём канале (security-privacy §3). |
| **Intent** | Голосовая команда ассистента; плагины регистрируют intent-фразы + `IntentHandler` (D §6, plugin-sdk §4). |
| **Perm-Broker** | Единый грантодатель/портал разрешений: политика + runtime-гранты (architecture §7). |
| **App-Host** | Запускает/супервизит/песочит апы и плагины; настраивает прокси+sandbox из манифеста. |
| **bubblewrap** | Песочница апов/плагинов: namespaces, seccomp, минимальный FS-вид. |
| **Прокси (dbus-proxy / портал)** | Фильтрующий per-app D-Bus-прокси (грубая изоляция по сервису/методу); тонкую авторизацию делает сам сервис по `sender`. |
| **Манифест** | YAML-декларация плагина: `id`, capabilities, точки расширения (plugin-sdk §2). |
| **first-party / 3rd-party** | Наши апы в подписанном base-образе (auto-grant) vs сторонние в `/data` (install-ревью + sandbox). |

## Ассистент и аудио

| Термин | Определение |
|--------|-------------|
| **Wake-word** | Слово-активатор («Штурман»); движок openWakeWord (Apache-2.0). |
| **VAD / STT / TTS** | Voice Activity Detection (Silero) / распознавание речи (Vosk·Silero, офлайн) / синтез речи (Silero, офлайн). |
| **AEC** | Эхоподавление (`module-echo-cancel` / WebRTC APM): убирает свой TTS/медиа-выход из микрофона (H §4). |
| **ducking** | Временное понижение/пауза менее приоритетного звука; политика ролей поверх PipeWire (H §3). |
| **`media.role`** | Тег use-case PipeWire-потока (`media`/`phone_call`/`assistant_tts`/`nav_guidance`/`alert`) — основа арбитража аудио. |
| **Vehicle-context injection** | Подмешивание live-снимка данных машины в системный промпт ассистента — killer-фича (D §4). |
| **Driver memory** | Локальные `.md` о водителе/привычках/машине; не уходят в облако без явного согласия (D §7). |
| **RU-LLM** | Российские облачные LLM (GigaChat / YandexGPT), данные в РФ (152-ФЗ). |
| **provider-agnostic** | Сменный бэкенд за единым интерфейсом с авто-fallback (принцип #8). |

## Питание и загрузка

| Термин | Определение |
|--------|-------------|
| **ACC** | Сигнал зажигания (accessory). **IgnitionState** (off/accessory/running) — каноническое lifecycle-состояние, владелец B. |
| **Stage 0 / 1 / 2** | Фазы быстрого boot: **Stage 0** = загрузчик→splash (+ранний путь задней камеры); **Stage 1** (~3–5 c) = ядро-минимум→Shell первый кадр; **Stage 2** = фоновый прогрев (Vehicle-Data/Assistant/Media/Nav/Connectivity). architecture §6. |
| **MCU-копилот** | Маленький always-on МК: детект ACC, hold-up-секвенсинг, watchdog, sleep/wake (рек., hardware §3). |
| **hold-up** | Буфер энергии (supercap) на graceful shutdown при резком пропадании 12 В. |
| **power-safe** | Гарантия от corruption при резком обесточивании: RO-rootfs + atomic-write + graceful shutdown (A+B вместе, #5). |
| **load-shedding** | Сброс тяжёлых потребителей (усилитель/модем/подсветка) при power-loss → hold-up кормит только SoC+хранилище. |
| **PONR** | Point-of-no-return — момент unmount, после которого shutdown необратим (abort недоступен). |
| **watchdog** | Аппаратный таймер ребута зависшей системы (SoC-WDT + независимый MCU-backstop). |

## Хранилище, образ, OTA

| Термин | Определение |
|--------|-------------|
| **RK3588** | Целевой SoC-класс (8–16 ГБ, mainline-Linux, Panfrost GPU) — это же класс реальных автоголов. |
| **read-only rootfs + overlay** | Неизменяемая корневая ФС + volatile-tmpfs overlay; запись только в `/data` (power-safe, #5). |
| **`/data`** | Журналируемый RW-раздел; единственный писатель — Settings/State (durable-write контракт, A §3). |
| **A/B-слоты** | Два загружаемых юнита (kernel+dtb+initramfs+rootfs) для атомарного OTA с откатом. |
| **RAUC** | Инструмент атомарных подписанных A/B-обновлений (механизм/подпись — A, канал доставки — L). |
| **OTA** | Over-the-air обновления: signed bundle, bootcount + mark-good, rollback (v4). |
| **fscrypt** | At-rest шифрование чувствительных поддеревьев `/data` (память, токены, контакты, dashcam), eFuse-bound (v4). |
| **zram / OOM** | Сжатый swap в RAM (swap-на-flash запрещён) / out-of-memory-политика (защита Stage 1 critical set, A §8). |
| **secure boot** | Verified boot; якорь доверия — хэш ключа в OTP/eFuse, необратим (v4). |
| **BSP / HAL** | Board-support package / hardware abstraction layer — порт на другое железо/авто (DT + HAL-конфиг + DBC). |

## Связь и телефон

| Термин | Определение |
|--------|-------------|
| **BlueZ** | Linux BT-стек; адаптер/паринг — владелец Connectivity-core (G §3). GPL-демон через D-Bus (#12). |
| **ModemManager / NetworkManager** | Демоны модема (LTE/SIM) / сети (WiFi); обёртка — Connectivity-core. GPL-демоны через D-Bus. |
| **HFP** | Hands-Free Profile — BT-звонки (Phone-ап, роль `phone_call` в арбитре H). |
| **A2DP / AVRCP** | BT-аудио-стриминг (sink) / метаданные+транспорт — медиа (Media-ап, H §6). |
| **PBAP / MAP** | BT-доступ к контактам+журналу / сообщениям; local-first, 152-ФЗ (G §5). |
| **tethering** | Интернет от телефона (BT-PAN / WiFi-hotspot). **captive portal** — публичный WiFi с авторизацией (не «ложный online», G §2). |

## Безопасность и приватность

| Термин | Определение |
|--------|-------------|
| **152-ФЗ** | Российский закон о персональных данных: local-first, данные в РФ, явное отзываемое согласие. |
| **audit-log** | Нормативный локальный журнал доступа к чувствительному + cloud-egress (владелец A §9, просмотр — UI C). |
| **DMABUF / V4L2** | Zero-copy буфер GPU/видео (capture→encode/composite) / Linux video capture API. |
| **dashcam / surround** | Видеорегистратор (ring-buffer, fscrypt, отдельный носитель) / круговой обзор (композит N камер) — домен J. |
| **parktronic** | Парктроник: дистанция (CAN или не-CAN датчик) для оверлея/предупреждения поверх видео-вида. |