Сервер: добавить новые TEXT типы и STATUS_ACTION

2026-08-09 18:59:59 +04:00
parent 43f54c90d2
commit d512442325
24 changed files with 1479 additions and 48 deletions
@@ -11,14 +11,16 @@
 - `12_REACTION_Blocks.md` — реакции (`type=2`).
 - `13_CONNECTION_Blocks.md` — связи/подписки (`type=3`).
 - `14_USER_PARAM_Blocks.md` — пользовательские параметры (`type=4`).
+- `15_STATUS_ACTION_Blocks.md` — статусные действия (`type=5`).

 ## Быстрая карта типов

 - `type=0` — TECH: HEADER, CREATE_CHANNEL.
- `type=1` — TEXT: POST/EDIT_POST/REPLY/EDIT_REPLY/REPOST.
+- `type=1` — TEXT: POST/EDIT_POST/REPLY/EDIT_REPLY/RATING/REPOST/CHANNEL_META/ENTRYPOINT/EXERCISE/SERVICE/COURSE.
 - `type=2` — REACTION: LIKE/UNLIKE.
 - `type=3` — CONNECTION: FRIEND/CONTACT/FOLLOW/SPOUSE/PARENT/CHILD/SIBLING и обратные операции.
 - `type=4` — USER_PARAM: key/value-параметры пользователя.
+- `type=5` — STATUS_ACTION: DONE_ONCE/INTERESTED/STARTED/IN_STUDY/COMPLETED/ABANDONED/LEARNED/CONFIRMED.

 ## Примечание

@@ -9,7 +9,7 @@
 Описание, человекочитаемое имя и аватар канала меняются только через скрытый технический блок:

 - `msg_type=1`
- `subType=70`
+- `subType=90`
 - `TEXT_CHANNEL_META`

 Спецификация: [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md).
@@ -1,6 +1,6 @@
 # TEXT блоки (`type=1`, `version=1`)

-TEXT-тип хранит сообщения и редактирования.
+TEXT-тип хранит сообщения, материалы и редактирования.

 ## Подтипы

@@ -21,24 +21,52 @@ TEXT-тип хранит сообщения и редактирования.
   - target на исходный REPLY + новый текст.
   - допускается пустой `text` для логического удаления сообщения (без физического удаления блока).

-5. `subType=30` — `TEXT_REPOST`
+5. `subType=30` — `TEXT_RATING`
+   - target-based отзыв на конкретный блок;
+   - содержит target (`toBlockchainName`, `toBlockGlobalNumber`, `toBlockHash32`) + текст отзыва;
+   - не является сообщением линии канала.
+
+6. `subType=50` — `TEXT_REPOST`
   - репост сообщения в линию канала;
   - содержит line-поля + target на оригинальное сообщение + текст комментария;
   - на текущем этапе продуктовой логики репост не редактируется (версии не накапливаются);
   - временно отключён для записи через `AddBlock` до будущей реализации репостов.

-6. `subType=70` — `TEXT_CHANNEL_META`
+7. `subType=90` — `TEXT_CHANNEL_META`
   - скрытый технический снимок профиля канала;
   - содержит line-поля + текст с тегами `SHiNE:title`/`SHiNE:avatar` и описанием;
   - не отображается как обычное сообщение ленты;
   - применяется сервером к текущему состоянию канала.

+8. `subType=100` — `TEXT_ENTRYPOINT`
+   - входная страница канала;
+   - line-based сообщение с тем же body, что у `TEXT_POST`;
+   - не редактируется через `TEXT_EDIT_POST`: новая версия создаётся новым `TEXT_ENTRYPOINT`.
+
+9. `subType=110` — `TEXT_EXERCISE`
+   - line-based материал упражнения;
+   - использует тот же body, что у `TEXT_POST`.
+
+10. `subType=120` — `TEXT_SERVICE`
+   - line-based материал услуги / процедуры;
+   - использует тот же body, что у `TEXT_POST`.
+
+11. `subType=130` — `TEXT_COURSE`
+   - line-based материал курса;
+   - использует тот же body, что у `TEXT_POST`.
+
 Подробная спецификация: [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md).

 ## Правило для edit

 `EDIT_POST` и `EDIT_REPLY` должны ссылаться на **оригинальный** блок, а не на предыдущий edit.

+Важно:
+
+- `TEXT_EDIT_POST` — технический edit для line-based сообщений канала;
+- `TEXT_EDIT_REPLY` — технический edit для reply-сообщений;
+- `TEXT_ENTRYPOINT` через `TEXT_EDIT_POST` не редактируется.
+
 ## Пустой text в edit

 - Для `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` допустим `textLen=0`.
@@ -0,0 +1,62 @@
+# STATUS_ACTION блоки (`type=5`, `version=1`)
+
+`STATUS_ACTION` хранит статусные действия пользователя по отношению к конкретному материалу.
+
+## Подтипы
+
+1. `subType=10` — `STATUS_DONE_ONCE`
+   - выполнил / прошёл один раз.
+
+2. `subType=20` — `STATUS_INTERESTED`
+   - заинтересовался материалом.
+
+3. `subType=30` — `STATUS_STARTED`
+   - начал.
+
+4. `subType=40` — `STATUS_IN_STUDY`
+   - находится в процессе полноценного изучения.
+
+5. `subType=50` — `STATUS_COMPLETED`
+   - завершил.
+
+6. `subType=60` — `STATUS_ABANDONED`
+   - бросил.
+
+7. `subType=70` — `STATUS_LEARNED`
+   - выучил упражнение / комплекс.
+
+8. `subType=80` — `STATUS_CONFIRMED`
+   - подтвердил чужой status-блок.
+
+## Формат body
+
+Все `STATUS_ACTION` используют один и тот же бинарный body-формат:
+
+```text
+[1]  toBlockchainNameLen (uint8)
+[N]  toBlockchainName UTF-8
+[4]  toBlockGlobalNumber
+[32] toBlockHash32
+[2]  textLenBytes (uint16)
+[M]  text UTF-8
+```
+
+Где:
+
+- `toBlockchainName` — блокчейн, в котором находится целевой материал;
+- `toBlockGlobalNumber` — номер целевого блока;
+- `toBlockHash32` — хэш целевого блока;
+- `text` — опциональное пояснение пользователя к статусу.
+
+## Правила
+
+- Каждый `STATUS_ACTION` всегда является target-based сообщением.
+- `STATUS_ACTION` не является line-based сообщением канала.
+- Текст может быть пустым: основной смысл задаётся самим `subType`.
+- Базовые статусы пользователь ставит сам за себя.
+- `STATUS_CONFIRMED` ставится другим человеком на конкретный status-блок.
+
+## Что не поддерживается
+
+- Отдельного `EDIT` для `STATUS_ACTION` нет.
+- Если нужно изменить смысл статуса, пишется новое статусное событие.
@@ -5,7 +5,7 @@
 ## Блок

 - `msg_type = 1`
- `subType = 70`
+- `subType = 90`
 - `msgVersion = 1`
 - body использует тот же бинарный формат line-текста, что и `TEXT_POST`: line-поля + `textLen` + UTF-8 текст.

@@ -1,5 +1,15 @@
 # История изменений документации блокчейна

+## 2026-08-09 18:55:16 +0400
+- Базовый коммит-ориентир: `43f54c9`.
+- Для первой итерации новых контентных типов обновлена карта `TEXT`-подтипов:
+  - `TEXT_RATING` добавлен как `subType=30` и трактуется как target-based отзыв на конкретный блок;
+  - `TEXT_REPOST` перенесён на `subType=50` и оставлен как отложенная заготовка;
+  - `TEXT_CHANNEL_META` перенесён на `subType=90`;
+  - добавлены line-based `TEXT_ENTRYPOINT (100)`, `TEXT_EXERCISE (110)`, `TEXT_SERVICE (120)`, `TEXT_COURSE (130)`.
+- Добавлен новый верхнеуровневый тип `STATUS_ACTION (type=5)` с подтипами `10/20/30/40/50/60/70/80`.
+- `CHANNEL_MEMBERSHIP` в текущую реализацию не включён и ведётся отдельно как отложенная тема.
+
 ## 2026-08-04 12:00:00 +0400
 - Базовый коммит-ориентир: `391b18a`.
 - Формат вложений расширен до `SHiNE:attach v=2` для опционального второго preview-файла: добавлены поля `previewAr` и `previewSha256` при сохранении совместимости со старыми `v=1`.
@@ -17,15 +17,17 @@
   Социальные связи (`msg_type=3`).
 7. [14_USER_PARAM_Blocks.md](./14_USER_PARAM_Blocks.md)
   Параметры пользователя (`msg_type=4`).
-8. [15_TEXT_Attachments.md](./15_TEXT_Attachments.md)
+8. [15_STATUS_ACTION_Blocks.md](./15_STATUS_ACTION_Blocks.md)
+   Статусные действия пользователя (`msg_type=5`).
+9. [16_TEXT_Attachments.md](./16_TEXT_Attachments.md)
   Вложения в TEXT-сообщениях через `SHiNE:attach v=1/v=2`, включая опциональные `previewAr/previewSha256` для видео и крупных изображений.
-9. [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md)
+10. [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md)
   Скрытый `TEXT_CHANNEL_META` для профиля канала.
-10. [01_Channel_Types_and_CreateChannel.md](./01_Channel_Types_and_CreateChannel.md)
+11. [01_Channel_Types_and_CreateChannel.md](./01_Channel_Types_and_CreateChannel.md)
   Типы каналов и формат `CreateChannelBody`.
-11. [02_Channel_Commands.md](./02_Channel_Commands.md)
+12. [02_Channel_Commands.md](./02_Channel_Commands.md)
   Команды в текстовых сообщениях каналов.
-12. [CHANGELOG.md](./CHANGELOG.md)
+13. [CHANGELOG.md](./CHANGELOG.md)
    Журнал изменений документации.

 ## Смежная документация