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

docs/API/04_Add_Block_to_Blockchain_API.md

@@ -88,6 +88,8 @@
 - `limit_exceeded`
 - `chain_resync_in_progress` — цепочка временно заблокирована полным resync
 - `repost_disabled` — репосты временно отключены до будущей реализации
+- `entrypoint_edit_forbidden` — `TEXT_ENTRYPOINT` нельзя редактировать через `TEXT_EDIT_POST`
+- `status_confirmed_target_must_be_status_action` — `STATUS_CONFIRMED` должен ссылаться на статусный блок
 - `bad_channel_meta_line`, `channel_not_found`, `bad_channel_meta_*`, `channel_meta_*_too_long` — ошибки `TEXT_CHANNEL_META`
 - `internal_error`
 
@@ -104,8 +106,13 @@
    - `TEXT_EDIT_POST (11)`
    - `TEXT_REPLY (20)`
    - `TEXT_EDIT_REPLY (21)`
-   - `TEXT_REPOST (30)` — формат зарезервирован, но новые блоки временно отклоняются с `repost_disabled`
-   - `TEXT_CHANNEL_META (70)` — скрытый технический снимок профиля канала
+   - `TEXT_RATING (30)` — target-based отзыв на конкретный блок
+   - `TEXT_REPOST (50)` — формат зарезервирован, но новые блоки временно отклоняются с `repost_disabled`
+   - `TEXT_CHANNEL_META (90)` — скрытый технический снимок профиля канала
+   - `TEXT_ENTRYPOINT (100)` — входная страница канала
+   - `TEXT_EXERCISE (110)` — line-based материал упражнения
+   - `TEXT_SERVICE (120)` — line-based материал услуги / процедуры
+   - `TEXT_COURSE (130)` — line-based материал курса
 
 3. **REACTION (type=2)**
    - `REACTION_LIKE (1)`
@@ -135,6 +142,16 @@
 5. **USER_PARAM (type=4)**
    - `USER_PARAM_TEXT_TEXT (1)`
 
+6. **STATUS_ACTION (type=5)**
+   - `STATUS_DONE_ONCE (10)`
+   - `STATUS_INTERESTED (20)`
+   - `STATUS_STARTED (30)`
+   - `STATUS_IN_STUDY (40)`
+   - `STATUS_COMPLETED (50)`
+   - `STATUS_ABANDONED (60)`
+   - `STATUS_LEARNED (70)`
+   - `STATUS_CONFIRMED (80)`
+
 ## 6. Практические payload-форматы для каналов и вложений
 
 `AddBlock` не имеет отдельных JSON-полей для вложений, аватаров или человекочитаемого имени канала. Клиент собирает бинарный блок нужного типа, а новые данные кладёт в текстовые поля тела блока по правилам blockchain-формата.
@@ -173,7 +190,7 @@
 
 ### Изменение профиля канала
 
-Последующие изменения аватара, человекочитаемого имени или описания канала пишутся отдельным скрытым `TEXT_CHANNEL_META (subType=70)`.
+Последующие изменения аватара, человекочитаемого имени или описания канала пишутся отдельным скрытым `TEXT_CHANNEL_META (subType=90)`.
 
 Текстовое содержимое body использует тот же формат полного снимка профиля:
 

docs/Blockchain/00_Blockchain_Formats_and_Block_Types.md

@@ -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.
 
 ## Примечание
 

docs/Blockchain/02_Channel_Commands.md

@@ -9,7 +9,7 @@
 Описание, человекочитаемое имя и аватар канала меняются только через скрытый технический блок:
 
 - `msg_type=1`
-- `subType=70`
+- `subType=90`
 - `TEXT_CHANNEL_META`
 
 Спецификация: [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md).

docs/Blockchain/11_TEXT_Blocks.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`.

docs/Blockchain/15_STATUS_ACTION_Blocks.md

@@ -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` нет.
+- Если нужно изменить смысл статуса, пишется новое статусное событие.

docs/Blockchain/16_TEXT_Channel_Meta.md

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

docs/Blockchain/CHANGELOG.md

@@ -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`.

docs/Blockchain/README.md

@@ -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)
     Журнал изменений документации.
 
 ## Смежная документация