Обзор
Talis предназначен для единого представления учётных и описательных записей, которые переносятся из одной информационной среды в другую. Формат описывает одну запись как набор именованных полей с понятными значениями, поэтому чтение не требует отдельных пояснений рядом с файлом.
Формат текстовый и самоописываемый: каждое значение стоит рядом со своим именем, пропущенные необязательные поля просто отсутствуют, а порядок строк не меняет смысла. Такое устройство сохраняет читаемость для человека и упрощает разбор программными средствами.
Формат обратно совместимый между минорными версиями: прежние читатели понимают новые записи, спокойно пропуская незнакомые поля, а новые читатели верно толкуют прежние записи. Номер версии внутри записи показывает, по каким правилам она составлена.
Текстовый
Запись состоит из строк с именами полей и значениями, её можно открыть и прочитать глазами.
Самоописываемый
Имена полей раскрывают смысл значений, отдельные таблицы расшифровки не нужны.
Версионируемый
Поле версии связывает запись с поколением описания и определяет состав полей.
Формат
Каждая запись Talis — это набор полей из таблицы ниже. Обязательные поля присутствуют всегда, необязательные добавляются по мере нужды. Значения в таблице иллюстративные.
| Поле | Тип | Описание |
|---|---|---|
| version | строка | Номер поколения описания, например 1.3. Определяет состав и толкование остальных полей. |
| record_id | строка | Отличительный знак записи, например r-2026-0001. Служит для различения записей между собой. |
| record_type | строка | Разновидность сведений в полезной нагрузке, например карточка или событие. |
| created_at | строка | Отметка времени создания записи, например 2026-03-12T10:00:00Z. Записывается единым способом. |
| payload | словарь | Полезная нагрузка: именованные значения, ради которых запись создана. |
| checksum | строка | Проверочное сочетание символов для выявления случайных искажений при переносе и хранении. |
| metadata | словарь | Добавочные сведения об окружении записи: пометки, язык описания, условия хранения. |
Правила чтения
Примеры
Ниже два образца структуры записи Talis. Это образцы строения, а не исполняемые указания. Значения вымышлены и служат лишь для показа расположения полей.
01 / Строки «ключ: значение»
version: 1.3 record_id: r-2026-0001 record_type: карточка created_at: 2026-03-12T10:00:00Z payload: title: Зелёная папка place: Зал три count: 4 checksum: 9f2c-41aa-77d1 metadata: lang: ru sheet: a
02 / Скобочная запись
{
"version": "1.3",
"record_id": "r-2026-0002",
"record_type": "событие",
"created_at": "2026-03-12T11:30:00Z",
"payload": {
"title": "Утренний обход",
"hall": "Зал три",
"seats": 12
},
"checksum": "c41d-09be-220a",
"metadata": {
"lang": "ru",
"sheet": "b"
}
}
Версии
Перечень поколений описания Talis от нового к раннему. Номер поколения всегда указан внутри записи в поле версии.
- v1.3 — 12.03.2026
Уточнены строение полезной нагрузки и правила записи проверочного сочетания.
- v1.2 — 15.07.2025
Добавлен словарь метаданных и разъяснено чтение незнакомых полей.
- v1.1 — 03.02.2025
Первая опубликованная версия.