Уточнить удаление каналов и обновить версии

Доработана серверная и клиентская логика удаления публичных каналов.

Обновлена документация API и форматов блокчейна.
This commit is contained in:
AidarKC
2026-10-06 19:09:56 +03:00
parent 83548a859f
commit acd5d4406d
12 changed files with 84 additions and 23 deletions
@@ -127,7 +127,7 @@ public final class ChannelNameStateDAO {
SET is_deleted = ?, SET is_deleted = ?,
deleted_at_ms = ?, deleted_at_ms = ?,
deleted_block_number = ? deleted_block_number = ?
WHERE owner_bch_name = ? WHERE LOWER(owner_login) = LOWER(?)
AND channel_root_block_number = ? AND channel_root_block_number = ?
AND is_deleted IS DISTINCT FROM ? AND is_deleted IS DISTINCT FROM ?
"""; """;
@@ -135,7 +135,7 @@ public final class ChannelNameStateDAO {
ps.setBoolean(1, deleted); ps.setBoolean(1, deleted);
ps.setLong(2, deleted ? Math.max(0L, deletedAtMs) : 0L); ps.setLong(2, deleted ? Math.max(0L, deletedAtMs) : 0L);
if (deleted && deletedBlockNumber != null) ps.setInt(3, deletedBlockNumber); else ps.setNull(3, java.sql.Types.INTEGER); if (deleted && deletedBlockNumber != null) ps.setInt(3, deletedBlockNumber); else ps.setNull(3, java.sql.Types.INTEGER);
ps.setString(4, ownerBchName); ps.setString(4, loginOf(ownerBchName));
ps.setInt(5, rootBlockNumber); ps.setInt(5, rootBlockNumber);
ps.setBoolean(6, deleted); ps.setBoolean(6, deleted);
return ps.executeUpdate() > 0; return ps.executeUpdate() > 0;
@@ -17,6 +17,7 @@ import java.sql.ResultSet;
import java.util.ArrayList; import java.util.ArrayList;
import java.util.LinkedHashMap; import java.util.LinkedHashMap;
import java.util.List; import java.util.List;
import java.util.Locale;
import java.util.Map; import java.util.Map;
public final class ChannelNamesStateBootstrapper { public final class ChannelNamesStateBootstrapper {
@@ -48,7 +49,15 @@ public final class ChannelNamesStateBootstrapper {
SELECT login, bch_name, block_number, block_hash, block_bytes SELECT login, bch_name, block_number, block_hash, block_bytes
FROM blocks FROM blocks
WHERE msg_type = ? AND msg_sub_type = ? WHERE msg_type = ? AND msg_sub_type = ?
ORDER BY bch_name, block_number AND fork_number=shine_canonical_fork(
login,
(SELECT substring(blockchain_name from '([0-9]{3})$')::INTEGER
FROM solana_user_pda_current
WHERE LOWER(login)=LOWER(blocks.login)
LIMIT 1),
block_number
)
ORDER BY LOWER(login), block_number
"""; """;
try (Connection c = DbController.getInstance().getConnection()) { try (Connection c = DbController.getInstance().getConnection()) {
@@ -107,7 +116,7 @@ public final class ChannelNamesStateBootstrapper {
} }
String identity = ownerBch + "#" + blockNumber; String identity = ownerBch + "#" + blockNumber;
String ownerTypeSlug = ownerBch + "|" + channelTypeCode + "|" + slug; String ownerTypeSlug = ownerLogin.toLowerCase(Locale.ROOT) + "|" + channelTypeCode + "|" + slug;
String existing = slugToIdentity.putIfAbsent(ownerTypeSlug, identity); String existing = slugToIdentity.putIfAbsent(ownerTypeSlug, identity);
if (existing != null && !existing.equals(identity)) { if (existing != null && !existing.equals(identity)) {
conflicts.add("owner/type/slug=\"" + ownerTypeSlug + "\" conflicts: " + existing + " vs " + identity); conflicts.add("owner/type/slug=\"" + ownerTypeSlug + "\" conflicts: " + existing + " vs " + identity);
@@ -188,7 +197,15 @@ public final class ChannelNamesStateBootstrapper {
SELECT bch_name, block_number, block_bytes, msg_sub_type SELECT bch_name, block_number, block_bytes, msg_sub_type
FROM blocks FROM blocks
WHERE msg_type = ? AND msg_sub_type IN (?, ?, ?, ?, ?, ?, ?) WHERE msg_type = ? AND msg_sub_type IN (?, ?, ?, ?, ?, ?, ?)
ORDER BY bch_name, block_number AND fork_number=shine_canonical_fork(
login,
(SELECT substring(blockchain_name from '([0-9]{3})$')::INTEGER
FROM solana_user_pda_current
WHERE LOWER(login)=LOWER(blocks.login)
LIMIT 1),
block_number
)
ORDER BY LOWER(login), block_number
"""; """;
try (PreparedStatement ps = c.prepareStatement(sql)) { try (PreparedStatement ps = c.prepareStatement(sql)) {
ps.setInt(1, MSG_TYPE_TEXT); ps.setInt(1, MSG_TYPE_TEXT);
@@ -229,7 +246,15 @@ public final class ChannelNamesStateBootstrapper {
SELECT login, bch_name, block_number, block_bytes SELECT login, bch_name, block_number, block_bytes
FROM blocks FROM blocks
WHERE msg_type = ? AND msg_sub_type = ? WHERE msg_type = ? AND msg_sub_type = ?
ORDER BY bch_name, block_number AND fork_number=shine_canonical_fork(
login,
(SELECT substring(blockchain_name from '([0-9]{3})$')::INTEGER
FROM solana_user_pda_current
WHERE LOWER(login)=LOWER(blocks.login)
LIMIT 1),
block_number
)
ORDER BY LOWER(login), block_number
"""; """;
try (PreparedStatement ps = c.prepareStatement(sql)) { try (PreparedStatement ps = c.prepareStatement(sql)) {
ps.setInt(1, MSG_TYPE_TEXT); ps.setInt(1, MSG_TYPE_TEXT);
+2 -2
View File
@@ -1,2 +1,2 @@
client.version=1.14.10 client.version=1.14.11
server.version=1.12.10 server.version=1.12.11
@@ -34,6 +34,7 @@
- owner 32 bytes и равен текущему blockchain public key; - owner 32 bytes и равен текущему blockchain public key;
- обязательный тестовый tag `App=test5591`; - обязательный тестовый tag `App=test5591`;
- для channel block — `c=<canonical_channel_slug>`; - для channel block — `c=<canonical_channel_slug>`;
- `TEXT_CHANNEL_DELETE (type=1/subType=92/version=1)` является обычным line-based channel block с пустым text и тем же обязательным `c=<slug>`; отдельной операции API для удаления канала нет;
- `data` содержит SHiNE Frame v1 (`frameCode=1`). - `data` содержит SHiNE Frame v1 (`frameCode=1`).
## Основные ошибки ## Основные ошибки
+14 -2
View File
@@ -32,6 +32,8 @@
> `unreadCount` для канала считается по подписанному состоянию чтения канала. > `unreadCount` для канала считается по подписанному состоянию чтения канала.
> Для собственных каналов владельцу всегда возвращается `unreadCount = 0`, чтобы его собственные публикации не становились «новыми» для него самого. > Для собственных каналов владельцу всегда возвращается `unreadCount = 0`, чтобы его собственные публикации не становились «новыми» для него самого.
> Если для пары `ownerBlockchainName/channelName` ещё нет записи, канал временно считается полностью прочитанным. После появления записи новые публикации увеличивают `unreadCount` до продвижения курсора чтения. > Если для пары `ownerBlockchainName/channelName` ещё нет записи, канал временно считается полностью прочитанным. После появления записи новые публикации увеличивают `unreadCount` до продвижения курсора чтения.
>
> `ListSubscriptionsFeed` технически может возвращать soft-deleted каналы с `channel.deleted=true`, чтобы старые ссылки и selector канала продолжали разрешаться. Обычный UI скрывает такие строки. Для deleted-канала общий unread/counters не учитываются; сама подписка сохраняется.
--- ---
@@ -70,6 +72,9 @@
"avaSha256": "0123...", "avaSha256": "0123...",
"avaSize": 248193, "avaSize": 248193,
"metaUpdatedAtMs": 1760000000000, "metaUpdatedAtMs": 1760000000000,
"deleted": false,
"deletedAtMs": 0,
"deletedBlockNumber": null,
"personal": true, "personal": true,
"channelRoot": { "blockNumber": 0, "blockHash": "..." } "channelRoot": { "blockNumber": 0, "blockHash": "..." }
}, },
@@ -169,6 +174,9 @@
"avaSha256": "0123...", "avaSha256": "0123...",
"avaSize": 248193, "avaSize": 248193,
"metaUpdatedAtMs": 1760000000000, "metaUpdatedAtMs": 1760000000000,
"deleted": false,
"deletedAtMs": 0,
"deletedBlockNumber": null,
"subscribersCount": 128, "subscribersCount": 128,
"channelRoot": { "blockNumber": 123, "blockHash": "..." } "channelRoot": { "blockNumber": 123, "blockHash": "..." }
}, },
@@ -223,6 +231,8 @@
} }
``` ```
Для soft-deleted канала `channel.deleted=true`; `deletedAtMs` и `deletedBlockNumber` указывают последний delete-блок. В `metaEvents` delete-блоки возвращаются как `kind: "deleted"`. После новой самостоятельной публикации канал снова активен (`deleted=false`), при этом исторические `deleted` meta-events остаются частью истории.
--- ---
## 3) GetMessageThread ## 3) GetMessageThread
@@ -560,11 +570,13 @@ Returns lightweight public-channel cards for profile counters. `mode` is `owned`
{ {
"op": "ListUserProfileChannels", "op": "ListUserProfileChannels",
"requestId": "profile-ch-1", "requestId": "profile-ch-1",
"payload": { "login": "Alice", "mode": "owned", "limit": 100, "offset": 0 } "payload": { "login": "Alice", "mode": "owned", "includeDeleted": false, "limit": 100, "offset": 0 }
} }
``` ```
Channel items contain `ownerLogin`, `slug`, `displayName`, `avatarAr`, `ownerBlockchainName`, `rootBlockNumber`, and `rootBlockHashHex`. `includeDeleted` необязателен и по умолчанию равен `false`. При `true` ответ включает как активные, так и soft-deleted каналы.
Channel items contain `ownerLogin`, `slug`, `displayName`, `avatarAr`, `ownerBlockchainName`, `rootBlockNumber`, `rootBlockHashHex`, `deleted`, `deletedAtMs`, and `deletedBlockNumber`.
## Qualified likes (v18) ## Qualified likes (v18)
@@ -16,7 +16,7 @@
## Быстрая карта типов ## Быстрая карта типов
- `type=0` — TECH: HEADER, CREATE_CHANNEL, FORK. - `type=0` — TECH: HEADER, CREATE_CHANNEL, FORK.
- `type=1` — TEXT: POST/EDIT_POST/REPLY/EDIT_REPLY/RATING/REPOST/CHANNEL_META/ENTRYPOINT/EXERCISE/SERVICE/COURSE. - `type=1` — TEXT: POST/EDIT_POST/REPLY/EDIT_REPLY/RATING/REPOST/CHANNEL_META/CHANNEL_DELETE/ENTRYPOINT/EXERCISE/SERVICE/COURSE.
- `type=2` — REACTION: LIKE/UNLIKE. - `type=2` — REACTION: LIKE/UNLIKE.
- `type=3` — CONNECTION: FRIEND/CONTACT/FOLLOW/SPOUSE/PARENT/CHILD/SIBLING и обратные операции. - `type=3` — CONNECTION: FRIEND/CONTACT/FOLLOW/SPOUSE/PARENT/CHILD/SIBLING и обратные операции.
- `type=4` — USER_PROFILE: история полей профиля пользователя. - `type=4` — USER_PROFILE: история полей профиля пользователя.
@@ -73,7 +73,7 @@
Ссылка просто на любой существующий блок больше не считается допустимой. Это запрещает случайные или намеренные боковые ветки линии. Ссылка просто на любой существующий блок больше не считается допустимой. Это запрещает случайные или намеренные боковые ветки линии.
Для канала в одну линию входят все line-based события этого канала, включая обычные посты, `EDIT_POST`, `REPOST`, `CHANNEL_META` и контентные типы канала. Поэтому редактирование не создаёт отдельную боковую ветку. Для канала в одну линию входят все line-based события этого канала, включая обычные посты, `EDIT_POST`, `REPOST`, `CHANNEL_META`, `CHANNEL_DELETE` и контентные типы канала. Поэтому редактирование не создаёт отдельную боковую ветку.
## 6. Индексные ANS-104 теги ## 6. Индексные ANS-104 теги
+12 -6
View File
@@ -38,24 +38,30 @@ TEXT-тип хранит сообщения, материалы и редакт
- не отображается как обычное сообщение ленты; - не отображается как обычное сообщение ленты;
- применяется сервером к текущему состоянию канала. - применяется сервером к текущему состоянию канала.
8. `subType=100` — `TEXT_ENTRYPOINT` 8. `subType=92` — `TEXT_CHANNEL_DELETE`
- скрытый технический soft-delete канала;
- содержит line-поля и обязательный пустой `text`;
- становится хвостом той же линии канала;
- новый самостоятельный channel-пост автоматически делает канал активным снова; `CHANNEL_META` и `EDIT_POST` не оживляют канал.
9. `subType=100` — `TEXT_ENTRYPOINT`
- входная страница канала; - входная страница канала;
- line-based сообщение с тем же body, что у `TEXT_POST`; - line-based сообщение с тем же body, что у `TEXT_POST`;
- не редактируется через `TEXT_EDIT_POST`: новая версия создаётся новым `TEXT_ENTRYPOINT`. - не редактируется через `TEXT_EDIT_POST`: новая версия создаётся новым `TEXT_ENTRYPOINT`.
9. `subType=110` — `TEXT_EXERCISE` 10. `subType=110` — `TEXT_EXERCISE`
- line-based материал упражнения; - line-based материал упражнения;
- использует тот же body, что у `TEXT_POST`. - использует тот же body, что у `TEXT_POST`.
10. `subType=120` — `TEXT_SERVICE` 11. `subType=120` — `TEXT_SERVICE`
- line-based материал услуги / процедуры; - line-based материал услуги / процедуры;
- использует тот же body, что у `TEXT_POST`. - использует тот же body, что у `TEXT_POST`.
11. `subType=130` — `TEXT_COURSE` 12. `subType=130` — `TEXT_COURSE`
- line-based материал курса; - line-based материал курса;
- использует тот же body, что у `TEXT_POST`. - использует тот же body, что у `TEXT_POST`.
Подробная спецификация: [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md). Подробные спецификации: [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md) и [17_TEXT_Channel_Delete.md](./17_TEXT_Channel_Delete.md).
## Канонический target-формат TEXT ## Канонический target-формат TEXT
@@ -95,7 +101,7 @@ Login/fork для edit не подписываются: edit может ссыл
- Для `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` допустим `textLen=0`. - Для `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` допустим `textLen=0`.
- Такой edit трактуется как логическое удаление содержимого сообщения. - Такой edit трактуется как логическое удаление содержимого сообщения.
- Для удаления используется именно edit-блок; отдельного `DELETE`-подтипа нет. - Для удаления отдельного сообщения используется именно edit-блок; отдельного `DELETE`-подтипа сообщения нет. `TEXT_CHANNEL_DELETE=92` относится только к soft-delete всего канала.
## Вложения в текстовых сообщениях (`S:att v=1`) ## Вложения в текстовых сообщениях (`S:att v=1`)
+11
View File
@@ -1,3 +1,14 @@
## 2026-10-06 18:02 +0300 — Soft-delete каналов
- Базовый коммит-ориентир: `working tree`; изменение подготовлено как patch без нового git-коммита.
- Добавлен line-based `TEXT_CHANNEL_DELETE (type=1, subType=92, version=1)` с обязательным пустым text.
- `TEXT_CHANNEL_DELETE` становится обычным хвостом линии канала и сохраняет обязательный ANS-104 tag `c=<slug>`.
- В `channel_names_state` добавлены только `is_deleted`, `deleted_at_ms`, `deleted_block_number`; delete-hash отдельно не хранится.
- Новый самостоятельный `TEXT_POST/REPOST/ENTRYPOINT/EXERCISE/SERVICE/COURSE` автоматически оживляет канал; `TEXT_CHANNEL_META` и `TEXT_EDIT_POST` состояние удаления не меняют.
- Soft-deleted канал сохраняет root, slug, историю, старые ссылки и подписки; slug не освобождается. Обычные списки/counters/unread deleted-каналы скрывают, а `ListUserProfileChannels.includeDeleted=true` позволяет показать их в профиле.
- Bootstrap/rebuild восстанавливает delete-state из канонической истории с учётом segmented forks по логическому `login`, поэтому root из старого fork остаётся валидным.
- Схема PostgreSQL поднята до v31; добавлен безопасный переход v30 -> v31.
## 2026-10-02 — Transport namespace `test5591` ## 2026-10-02 — Transport namespace `test5591`
- Текущий ANS-104 namespace переключён с `test5590` на `test5591`: `App=test5591`; channel index теперь постоянный и не зависит от namespace: `c=<slug>`. - Текущий ANS-104 namespace переключён с `test5590` на `test5591`: `App=test5591`; channel index теперь постоянный и не зависит от namespace: `c=<slug>`.
+1
View File
@@ -5,6 +5,7 @@
## Основные документы ## Основные документы
- [`01_Common_Block_Format.md`](01_Common_Block_Format.md) — точный Frame v1, ANS-104, подпись, хэши и теги. - [`01_Common_Block_Format.md`](01_Common_Block_Format.md) — точный Frame v1, ANS-104, подпись, хэши и теги.
- [`17_TEXT_Channel_Delete.md`](17_TEXT_Channel_Delete.md) — soft-delete канала через `TEXT_CHANNEL_DELETE=92` и правила автоматического оживления.
- [`17_ANS104_Arweave_Transport.md`](17_ANS104_Arweave_Transport.md) — публикация блоков в Arweave и обратный импорт между серверами. - [`17_ANS104_Arweave_Transport.md`](17_ANS104_Arweave_Transport.md) — публикация блоков в Arweave и обратный импорт между серверами.
- [`sync-between-servers.md`](sync-between-servers.md) — межсерверная синхронизация и full-resync без файловой копии blockchain. - [`sync-between-servers.md`](sync-between-servers.md) — межсерверная синхронизация и full-resync без файловой копии blockchain.
- [`CHANGELOG.md`](CHANGELOG.md) — история изменений протокола. - [`CHANGELOG.md`](CHANGELOG.md) — история изменений протокола.
+4 -3
View File
@@ -102,17 +102,18 @@ async function resolveChannelSelector(route) {
const ownerUser = await authService.getUser(ownerLogin); const ownerUser = await authService.getUser(ownerLogin);
if (!ownerUser?.exists) throw new Error('Владелец канала не найден.'); if (!ownerUser?.exists) throw new Error('Владелец канала не найден.');
const ownerBlockchainName = String(ownerUser.blockchainName || ownerRef).trim();
const ownerFeed = await authService.listSubscriptionsFeed(ownerLogin, 500); const ownerFeed = await authService.listSubscriptionsFeed(ownerLogin, 500);
const ownedRows = Array.isArray(ownerFeed?.ownedChannels) ? ownerFeed.ownedChannels : []; const ownedRows = Array.isArray(ownerFeed?.ownedChannels) ? ownerFeed.ownedChannels : [];
const ownerLoginNormalized = ownerLogin.toLowerCase();
const row = ownedRows.find((item) => ( const row = ownedRows.find((item) => (
String(item?.channel?.channelName || '').trim().toLowerCase() === channelName.toLowerCase() String(item?.channel?.channelName || '').trim().toLowerCase() === channelName.toLowerCase()
&& String(item?.channel?.ownerBlockchainName || '').trim().toLowerCase() === ownerBlockchainName.toLowerCase() && String(item?.channel?.ownerLogin || '').trim().toLowerCase() === ownerLoginNormalized
)); ));
if (!row?.channel?.channelRoot) throw new Error('Канал не найден.'); if (!row?.channel?.channelRoot) throw new Error('Канал не найден.');
const rootBlockchainName = String(row.channel.ownerBlockchainName || ownerRef).trim();
return { return {
ownerBlockchainName, ownerBlockchainName: rootBlockchainName,
channelRootBlockNumber: Number(row.channel.channelRoot.blockNumber), channelRootBlockNumber: Number(row.channel.channelRoot.blockNumber),
channelRootBlockHash: normalizeHash(row.channel.channelRoot.blockHash), channelRootBlockHash: normalizeHash(row.channel.channelRoot.blockHash),
channelName, channelName,
+6 -2
View File
@@ -2371,9 +2371,11 @@ export class AuthService {
async listOwnChannelsForBlockchain(login, blockchainName) { async listOwnChannelsForBlockchain(login, blockchainName) {
const feed = await this.listSubscriptionsFeed(login, 500); const feed = await this.listSubscriptionsFeed(login, 500);
const own = feed?.ownedChannels || []; const own = feed?.ownedChannels || [];
const ownerLogin = String(login || '').trim().toLowerCase();
return own return own
.filter((item) => String(item?.channel?.ownerBlockchainName || '') === blockchainName) .filter((item) => String(item?.channel?.ownerLogin || '').trim().toLowerCase() === ownerLogin)
.map((item) => ({ .map((item) => ({
ownerBlockchainName: String(item?.channel?.ownerBlockchainName || '').trim(),
rootBlockNumber: Number(item?.channel?.channelRoot?.blockNumber), rootBlockNumber: Number(item?.channel?.channelRoot?.blockNumber),
rootBlockHash: normalizeHex32(item?.channel?.channelRoot?.blockHash, ZERO64), rootBlockHash: normalizeHex32(item?.channel?.channelRoot?.blockHash, ZERO64),
channelName: String(item?.channel?.channelName || ''), channelName: String(item?.channel?.channelName || ''),
@@ -2460,7 +2462,9 @@ export class AuthService {
if (!ownerBlockchainName || !Number.isInteger(lineCode) || lineCode < 0) { if (!ownerBlockchainName || !Number.isInteger(lineCode) || lineCode < 0) {
throw new Error('Invalid channel selector'); throw new Error('Invalid channel selector');
} }
if (ownerBlockchainName !== blockchainName) { const currentOwnerLogin = loginFromBlockchainNameValue(blockchainName).toLowerCase();
const selectorOwnerLogin = loginFromBlockchainNameValue(ownerBlockchainName).toLowerCase();
if (!currentOwnerLogin || !selectorOwnerLogin || currentOwnerLogin !== selectorOwnerLogin) {
throw new Error('Posting is allowed only to your own channels'); throw new Error('Posting is allowed only to your own channels');
} }