Aidar/SHiNE-server
SHA256
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
3068c3e2b8
SHiNE-server/Dev_Docs/Blockchain
History
AidarKC 87eec7e5c9 Зафиксировать успешную синхронизацию на тестовом сервере
2026-06-26 17:46:34 +04:00
..
00_Blockchain_Formats_and_Block_Types.md feat: добавить репосты сообщений в каналах и тредах 2026-05-21 16:16:26 +03:00
01_Channel_Types_and_CreateChannel.md docs(blockchain): актуализировать MVP-формат и правила изменения протокола 2026-05-19 00:23:10 +03:00
01_Common_Block_Format.md Split blockchain block-format docs by block type 2026-03-28 11:11:16 +03:00
02_Blockchain_Kinds_and_Lines.md docs(blockchain): актуализировать MVP-формат и правила изменения протокола 2026-05-19 00:23:10 +03:00
02_Channel_Commands.md docs(blockchain): актуализировать MVP-формат и правила изменения протокола 2026-05-19 00:23:10 +03:00
10_TECH_Blocks.md docs(blockchain): актуализировать MVP-формат и правила изменения протокола 2026-05-19 00:23:10 +03:00
11_TEXT_Blocks.md Отключить репосты и добавить Solana-модуль 2026-05-24 12:16:39 +03:00
12_REACTION_Blocks.md docs(blockchain): актуализировать MVP-формат и правила изменения протокола 2026-05-19 00:23:10 +03:00
13_CONNECTION_Blocks.md Добавить opinion-связи и обновить UI связей в профиле 2026-05-20 13:13:50 +03:00
14_USER_PARAM_Blocks.md Split blockchain block-format docs by block type 2026-03-28 11:11:16 +03:00
CHANGELOG.md Зафиксировать успешную синхронизацию на тестовом сервере 2026-06-26 17:46:34 +04:00
README.md Вернуть crash-safe запись AddBlock через tmp_bch 2026-06-26 17:05:37 +04:00
sync-between-servers.md Зафиксировать успешную синхронизацию на тестовом сервере 2026-06-26 17:46:34 +04:00

README.md

Документация блокчейна SHiNE (MVP)

Этот каталог описывает только текущий рабочий формат протокола для MVP.

Основные документы

  1. 01_Common_Block_Format.md
    Единый бинарный формат блока (Frame v0), подпись, базовые проверки.
  2. 02_Blockchain_Kinds_and_Lines.md
    Виды цепочек и правила line-полей.
  3. 10_TECH_Blocks.md
    Системные блоки (msg_type=0).
  4. 11_TEXT_Blocks.md
    Текстовые блоки (msg_type=1).
  5. 12_REACTION_Blocks.md
    Реакции (msg_type=2).
  6. 13_CONNECTION_Blocks.md
    Социальные связи (msg_type=3).
  7. 14_USER_PARAM_Blocks.md
    Параметры пользователя (msg_type=4).
  8. 01_Channel_Types_and_CreateChannel.md
    Типы каналов и формат CreateChannelBody.
  9. 02_Channel_Commands.md
    Команды в текстовых сообщениях каналов.
  10. CHANGELOG.md
    Журнал изменений документации.

Важные ограничения MVP

  • Каналы type=100 и type=200 присутствуют в формате, но сейчас не используются в UI.
  • Поддерживаемый рабочий сценарий UI на текущем этапе: stories (type=0) и public (type=1).

Обязательное сопровождение

  • При любом изменении формата/правил блокчейна в коде документы этого каталога обновляются в том же наборе изменений.
  • Обычный AddBlock сейчас пишет через <blockchainName>.tmp_bch, <blockchainName>.write_check и <blockchainName>.write_pending; эта схема и BlockchainTmpRecoveryOnStartup должны быть описаны в актуальной документации по синхронизации и recovery.
  • Каждое обновление документов фиксируется в CHANGELOG.md с датой/временем и хэшем коммита-основания.