Files
SHiNE-server/docs/Blockchain/17_TEXT_Channel_Delete.md
AidarKC 83548a859f Починить сборку новой смены ключей
Исправлены compile blockers после доработки ротации ключей и DM.
2026-10-06 18:48:46 +03:00

71 lines
3.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# TEXT_CHANNEL_DELETE: soft-delete канала
`TEXT_CHANNEL_DELETE` — технический `TEXT`-блок линии канала, который помечает канал удалённым без удаления его истории или адреса.
## Код подтипа
- `type = 1` (`TEXT`)
- `subType = 92` (`TEXT_CHANNEL_DELETE`)
- `version = 1`
## Body
Используется обычный line-based `TextLineBody` канала:
```text
[4] lineCode = global block number корневого TECH_CREATE_CHANNEL
[4] prevLineNumber
[32] prevLineHash32
[4] thisLineNumber
[4] textLen = 0
```
Поле `text` обязано быть пустым. Блок участвует в той же строгой линии канала, что `TEXT_POST`, `TEXT_EDIT_POST`, `TEXT_REPOST`, `TEXT_CHANNEL_META` и контентные типы. Поэтому после удаления именно `TEXT_CHANNEL_DELETE` является текущим хвостом линии.
ANS-104 DataItem обязан содержать обычный channel index `c=<canonical_slug>`. Запись выполняется только через `AddBlock`.
## Семантика состояния
После валидного `TEXT_CHANNEL_DELETE` канал имеет состояние `deleted`. Физически ничего не удаляется:
- root канала и slug сохраняются;
- все старые блоки и сообщения остаются читаемыми;
- старые/прямые ссылки продолжают открывать канал;
- подписки сохраняются;
- slug не освобождается для создания нового канала.
Канал автоматически возвращается в активное состояние при следующей новой самостоятельной публикации одного из типов:
- `TEXT_POST (10)`
- `TEXT_REPOST (50)`
- `TEXT_ENTRYPOINT (100)`
- `TEXT_EXERCISE (110)`
- `TEXT_SERVICE (120)`
- `TEXT_COURSE (130)`
`TEXT_CHANNEL_META` и `TEXT_EDIT_POST` состояние удаления не снимают. Отдельного `CHANNEL_RESTORE` нет.
## SQL-проекция
`channel_names_state` хранит только производное текущее состояние:
```text
is_deleted BOOLEAN NOT NULL DEFAULT FALSE
deleted_at_ms BIGINT NOT NULL DEFAULT 0
deleted_block_number INTEGER
```
Для активного канала: `is_deleted=false`, `deleted_at_ms=0`, `deleted_block_number=NULL`.
Для удалённого: `is_deleted=true`, `deleted_at_ms` содержит timestamp delete-блока в миллисекундах, `deleted_block_number` — его глобальный номер.
Эти поля не являются источником истины: bootstrap/rebuild обязан детерминированно восстановить их из канонических blockchain-блоков. Это правило действует и для каналов, root которых создан в более раннем fork: логический владелец определяется по `login`, а физический `owner_bch_name` root сохраняется как часть selector канала.
## UI / counters
- обычные списки скрывают `deleted` каналы;
- профиль может запросить их через `includeDeleted=true`;
- сам канал остаётся доступен и помечается как удалённый;
- deleted-каналы не входят в обычные channel counters и общий unread;
- подписки при soft-delete не удаляются.