Привести документацию и TODO к production-структуре

2026-07-20 11:29:03 +04:00
parent daa516babe
commit 8208bb0b9d
55 changed files with 1229 additions and 2275 deletions
@@ -0,0 +1,29 @@
+# Запись блокчейнов в Arweave
+
+## Зачем
+
+Для будущей децентрализации нужно долговременное внешнее хранение блокчейнов, чтобы данные не зависели только от одного серверного диска.
+
+## Что сделать
+
+1. Определить, какие блокчейны и какие диапазоны блоков записываются в Arweave.
+2. Зафиксировать формат пачки блоков, метаданных, ссылок и контрольных хэшей.
+3. Добавить безопасный механизм публикации без хранения приватного JWK в git.
+4. Добавить проверку уже загруженных диапазонов, чтобы не плодить дубли.
+5. Описать восстановление блокчейна из Arweave при потере локальных данных.
+
+## Важные ограничения
+
+- Любое изменение формата блокчейна требует отдельного предупреждения и явного подтверждения пользователя.
+- Добавление данных в блокчейн должно выполняться только через `AddBlock`.
+- Секреты Arweave нельзя хранить в репозитории.
+
+## Документы, которые потом нужно обновить
+
+- `docs/Blockchain/README.md`;
+- `docs/Blockchain/CHANGELOG.md`;
+- документы deploy/секретов в `Deploy/`, если появятся новые параметры.
+
+## Статус
+
+Отложено до этапа децентрализации.