From acd5d4406dc695419e649fe90f64d50789d82fd3d7a83e6340dea6be0593b7cf Mon Sep 17 00:00:00 2001 From: AidarKC Date: Tue, 6 Oct 2026 19:09:56 +0300 Subject: [PATCH] =?UTF-8?q?=D0=A3=D1=82=D0=BE=D1=87=D0=BD=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20=D1=83=D0=B4=D0=B0=D0=BB=D0=B5=D0=BD=D0=B8=D0=B5=20?= =?UTF-8?q?=D0=BA=D0=B0=D0=BD=D0=B0=D0=BB=D0=BE=D0=B2=20=D0=B8=20=D0=BE?= =?UTF-8?q?=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D1=82=D1=8C=20=D0=B2=D0=B5=D1=80?= =?UTF-8?q?=D1=81=D0=B8=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Доработана серверная и клиентская логика удаления публичных каналов. Обновлена документация API и форматов блокчейна. --- .../shine/db/dao/ChannelNameStateDAO.java | 4 +-- .../ChannelNamesStateBootstrapper.java | 33 ++++++++++++++++--- VERSION.properties | 4 +-- docs/API/04_Add_Block_to_Blockchain_API.md | 1 + docs/API/06_Channels_Read_API.md | 16 +++++++-- .../00_Blockchain_Formats_and_Block_Types.md | 2 +- .../02_Blockchain_Kinds_and_Lines.md | 2 +- docs/Blockchain/11_TEXT_Blocks.md | 18 ++++++---- docs/Blockchain/CHANGELOG.md | 11 +++++++ docs/Blockchain/README.md | 1 + shine-UI/js/pages/channel-about-view.js | 7 ++-- shine-UI/js/services/auth-service.js | 8 +++-- 12 files changed, 84 insertions(+), 23 deletions(-) diff --git a/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/ChannelNameStateDAO.java b/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/ChannelNameStateDAO.java index a74be973..f24e3e0f 100644 --- a/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/ChannelNameStateDAO.java +++ b/SHiNE-server/shine-server-db/src/main/java/shine/db/dao/ChannelNameStateDAO.java @@ -127,7 +127,7 @@ public final class ChannelNameStateDAO { SET is_deleted = ?, deleted_at_ms = ?, deleted_block_number = ? - WHERE owner_bch_name = ? + WHERE LOWER(owner_login) = LOWER(?) AND channel_root_block_number = ? AND is_deleted IS DISTINCT FROM ? """; @@ -135,7 +135,7 @@ public final class ChannelNameStateDAO { ps.setBoolean(1, deleted); 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); - ps.setString(4, ownerBchName); + ps.setString(4, loginOf(ownerBchName)); ps.setInt(5, rootBlockNumber); ps.setBoolean(6, deleted); return ps.executeUpdate() > 0; diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/ChannelNamesStateBootstrapper.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/ChannelNamesStateBootstrapper.java index bc4acd06..4da1a6d1 100644 --- a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/ChannelNamesStateBootstrapper.java +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/ChannelNamesStateBootstrapper.java @@ -17,6 +17,7 @@ import java.sql.ResultSet; import java.util.ArrayList; import java.util.LinkedHashMap; import java.util.List; +import java.util.Locale; import java.util.Map; public final class ChannelNamesStateBootstrapper { @@ -48,7 +49,15 @@ public final class ChannelNamesStateBootstrapper { SELECT login, bch_name, block_number, block_hash, block_bytes FROM blocks 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()) { @@ -107,7 +116,7 @@ public final class ChannelNamesStateBootstrapper { } String identity = ownerBch + "#" + blockNumber; - String ownerTypeSlug = ownerBch + "|" + channelTypeCode + "|" + slug; + String ownerTypeSlug = ownerLogin.toLowerCase(Locale.ROOT) + "|" + channelTypeCode + "|" + slug; String existing = slugToIdentity.putIfAbsent(ownerTypeSlug, identity); if (existing != null && !existing.equals(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 FROM blocks 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)) { ps.setInt(1, MSG_TYPE_TEXT); @@ -229,7 +246,15 @@ public final class ChannelNamesStateBootstrapper { SELECT login, bch_name, block_number, block_bytes FROM blocks 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)) { ps.setInt(1, MSG_TYPE_TEXT); diff --git a/VERSION.properties b/VERSION.properties index 7b8863ba..97d507e9 100644 --- a/VERSION.properties +++ b/VERSION.properties @@ -1,2 +1,2 @@ -client.version=1.14.10 -server.version=1.12.10 +client.version=1.14.11 +server.version=1.12.11 diff --git a/docs/API/04_Add_Block_to_Blockchain_API.md b/docs/API/04_Add_Block_to_Blockchain_API.md index ce14c5e3..ce2bd0f4 100644 --- a/docs/API/04_Add_Block_to_Blockchain_API.md +++ b/docs/API/04_Add_Block_to_Blockchain_API.md @@ -34,6 +34,7 @@ - owner 32 bytes и равен текущему blockchain public key; - обязательный тестовый tag `App=test5591`; - для channel block — `c=`; +- `TEXT_CHANNEL_DELETE (type=1/subType=92/version=1)` является обычным line-based channel block с пустым text и тем же обязательным `c=`; отдельной операции API для удаления канала нет; - `data` содержит SHiNE Frame v1 (`frameCode=1`). ## Основные ошибки diff --git a/docs/API/06_Channels_Read_API.md b/docs/API/06_Channels_Read_API.md index 33da7c92..9ffb53ca 100644 --- a/docs/API/06_Channels_Read_API.md +++ b/docs/API/06_Channels_Read_API.md @@ -32,6 +32,8 @@ > `unreadCount` для канала считается по подписанному состоянию чтения канала. > Для собственных каналов владельцу всегда возвращается `unreadCount = 0`, чтобы его собственные публикации не становились «новыми» для него самого. > Если для пары `ownerBlockchainName/channelName` ещё нет записи, канал временно считается полностью прочитанным. После появления записи новые публикации увеличивают `unreadCount` до продвижения курсора чтения. +> +> `ListSubscriptionsFeed` технически может возвращать soft-deleted каналы с `channel.deleted=true`, чтобы старые ссылки и selector канала продолжали разрешаться. Обычный UI скрывает такие строки. Для deleted-канала общий unread/counters не учитываются; сама подписка сохраняется. --- @@ -70,6 +72,9 @@ "avaSha256": "0123...", "avaSize": 248193, "metaUpdatedAtMs": 1760000000000, + "deleted": false, + "deletedAtMs": 0, + "deletedBlockNumber": null, "personal": true, "channelRoot": { "blockNumber": 0, "blockHash": "..." } }, @@ -169,6 +174,9 @@ "avaSha256": "0123...", "avaSize": 248193, "metaUpdatedAtMs": 1760000000000, + "deleted": false, + "deletedAtMs": 0, + "deletedBlockNumber": null, "subscribersCount": 128, "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 @@ -560,11 +570,13 @@ Returns lightweight public-channel cards for profile counters. `mode` is `owned` { "op": "ListUserProfileChannels", "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) diff --git a/docs/Blockchain/00_Blockchain_Formats_and_Block_Types.md b/docs/Blockchain/00_Blockchain_Formats_and_Block_Types.md index 34658197..9c8808b0 100644 --- a/docs/Blockchain/00_Blockchain_Formats_and_Block_Types.md +++ b/docs/Blockchain/00_Blockchain_Formats_and_Block_Types.md @@ -16,7 +16,7 @@ ## Быстрая карта типов - `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=3` — CONNECTION: FRIEND/CONTACT/FOLLOW/SPOUSE/PARENT/CHILD/SIBLING и обратные операции. - `type=4` — USER_PROFILE: история полей профиля пользователя. diff --git a/docs/Blockchain/02_Blockchain_Kinds_and_Lines.md b/docs/Blockchain/02_Blockchain_Kinds_and_Lines.md index 7d99c722..f27df962 100644 --- a/docs/Blockchain/02_Blockchain_Kinds_and_Lines.md +++ b/docs/Blockchain/02_Blockchain_Kinds_and_Lines.md @@ -73,7 +73,7 @@ Ссылка просто на любой существующий блок больше не считается допустимой. Это запрещает случайные или намеренные боковые ветки линии. -Для канала в одну линию входят все line-based события этого канала, включая обычные посты, `EDIT_POST`, `REPOST`, `CHANNEL_META` и контентные типы канала. Поэтому редактирование не создаёт отдельную боковую ветку. +Для канала в одну линию входят все line-based события этого канала, включая обычные посты, `EDIT_POST`, `REPOST`, `CHANNEL_META`, `CHANNEL_DELETE` и контентные типы канала. Поэтому редактирование не создаёт отдельную боковую ветку. ## 6. Индексные ANS-104 теги diff --git a/docs/Blockchain/11_TEXT_Blocks.md b/docs/Blockchain/11_TEXT_Blocks.md index 56bf7de8..9e4f00bf 100644 --- a/docs/Blockchain/11_TEXT_Blocks.md +++ b/docs/Blockchain/11_TEXT_Blocks.md @@ -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`; - не редактируется через `TEXT_EDIT_POST`: новая версия создаётся новым `TEXT_ENTRYPOINT`. -9. `subType=110` — `TEXT_EXERCISE` +10. `subType=110` — `TEXT_EXERCISE` - line-based материал упражнения; - использует тот же body, что у `TEXT_POST`. -10. `subType=120` — `TEXT_SERVICE` +11. `subType=120` — `TEXT_SERVICE` - line-based материал услуги / процедуры; - использует тот же body, что у `TEXT_POST`. -11. `subType=130` — `TEXT_COURSE` +12. `subType=130` — `TEXT_COURSE` - line-based материал курса; - использует тот же 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 @@ -95,7 +101,7 @@ Login/fork для edit не подписываются: edit может ссыл - Для `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` допустим `textLen=0`. - Такой edit трактуется как логическое удаление содержимого сообщения. -- Для удаления используется именно edit-блок; отдельного `DELETE`-подтипа нет. +- Для удаления отдельного сообщения используется именно edit-блок; отдельного `DELETE`-подтипа сообщения нет. `TEXT_CHANNEL_DELETE=92` относится только к soft-delete всего канала. ## Вложения в текстовых сообщениях (`S:att v=1`) diff --git a/docs/Blockchain/CHANGELOG.md b/docs/Blockchain/CHANGELOG.md index 37037e38..d5e05b4b 100644 --- a/docs/Blockchain/CHANGELOG.md +++ b/docs/Blockchain/CHANGELOG.md @@ -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=`. +- В `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` - Текущий ANS-104 namespace переключён с `test5590` на `test5591`: `App=test5591`; channel index теперь постоянный и не зависит от namespace: `c=`. diff --git a/docs/Blockchain/README.md b/docs/Blockchain/README.md index c092b507..e26ce663 100644 --- a/docs/Blockchain/README.md +++ b/docs/Blockchain/README.md @@ -5,6 +5,7 @@ ## Основные документы - [`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 и обратный импорт между серверами. - [`sync-between-servers.md`](sync-between-servers.md) — межсерверная синхронизация и full-resync без файловой копии blockchain. - [`CHANGELOG.md`](CHANGELOG.md) — история изменений протокола. diff --git a/shine-UI/js/pages/channel-about-view.js b/shine-UI/js/pages/channel-about-view.js index 093551e4..0b462641 100644 --- a/shine-UI/js/pages/channel-about-view.js +++ b/shine-UI/js/pages/channel-about-view.js @@ -102,17 +102,18 @@ async function resolveChannelSelector(route) { const ownerUser = await authService.getUser(ownerLogin); if (!ownerUser?.exists) throw new Error('Владелец канала не найден.'); - const ownerBlockchainName = String(ownerUser.blockchainName || ownerRef).trim(); const ownerFeed = await authService.listSubscriptionsFeed(ownerLogin, 500); const ownedRows = Array.isArray(ownerFeed?.ownedChannels) ? ownerFeed.ownedChannels : []; + const ownerLoginNormalized = ownerLogin.toLowerCase(); const row = ownedRows.find((item) => ( 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('Канал не найден.'); + const rootBlockchainName = String(row.channel.ownerBlockchainName || ownerRef).trim(); return { - ownerBlockchainName, + ownerBlockchainName: rootBlockchainName, channelRootBlockNumber: Number(row.channel.channelRoot.blockNumber), channelRootBlockHash: normalizeHash(row.channel.channelRoot.blockHash), channelName, diff --git a/shine-UI/js/services/auth-service.js b/shine-UI/js/services/auth-service.js index 09c2b7a9..62d39655 100644 --- a/shine-UI/js/services/auth-service.js +++ b/shine-UI/js/services/auth-service.js @@ -2371,9 +2371,11 @@ export class AuthService { async listOwnChannelsForBlockchain(login, blockchainName) { const feed = await this.listSubscriptionsFeed(login, 500); const own = feed?.ownedChannels || []; + const ownerLogin = String(login || '').trim().toLowerCase(); return own - .filter((item) => String(item?.channel?.ownerBlockchainName || '') === blockchainName) + .filter((item) => String(item?.channel?.ownerLogin || '').trim().toLowerCase() === ownerLogin) .map((item) => ({ + ownerBlockchainName: String(item?.channel?.ownerBlockchainName || '').trim(), rootBlockNumber: Number(item?.channel?.channelRoot?.blockNumber), rootBlockHash: normalizeHex32(item?.channel?.channelRoot?.blockHash, ZERO64), channelName: String(item?.channel?.channelName || ''), @@ -2460,7 +2462,9 @@ export class AuthService { if (!ownerBlockchainName || !Number.isInteger(lineCode) || lineCode < 0) { 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'); }