SHA256
58 lines
6.5 KiB
Markdown
58 lines
6.5 KiB
Markdown
# Архитектура SHiNE
|
||
|
||
Этот документ даёт общую карту продукта. Точные форматы, операции и инструкции находятся по ссылкам ниже. Состояние отдельных функций может отличаться между тестовым и production контурами; для изменения протокола сверяйтесь с кодом и профильной спецификацией.
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
UI[Браузерный UI] -->|HTTP / WebSocket| Server[Сервер SHiNE]
|
||
Wallet[Расширение кошелька] -->|Сессия и подписи| Server
|
||
ESP[ESP32 прототипы] -.->|Сценарии устройства| Server
|
||
Server --> DB[(PostgreSQL)]
|
||
Server <-->|Публикация и импорт блоков| Arweave[(Arweave)]
|
||
UI -->|PDA и транзакции| Solana[(Solana)]
|
||
Server -->|Чтение PDA / синхронизация| Solana
|
||
```
|
||
|
||
## Компоненты и границы
|
||
|
||
| Компонент | За что отвечает | Где смотреть детали |
|
||
| --- | --- | --- |
|
||
| `shine-UI/` | Браузерные экраны, локальное состояние, взаимодействие с сервером | `shine-UI/AGENTS.md`, `docs/UI-Design/README.md` |
|
||
| `SHiNE-server/` | HTTP/WS запросы, валидация, доставка сообщений и звонков, хранение | `SHiNE-server/AGENTS.md`, `docs/API/09_Operations_Index.md` |
|
||
| PostgreSQL | Локальные данные сервера и пользовательские блоки | `SHiNE-server/shine-server-db/`, `docs/Blockchain/README.md` |
|
||
| Arweave | Внешняя публикация и импорт подписанных пользовательских блоков | `docs/Blockchain/17_ANS104_Arweave_Transport.md` |
|
||
| Solana | Пользовательские PDA, регистрация и платёжные программы | `docs/Solana_Architecture/README.md`, `docs/Инициализация_Solana_регистрации/README.md` |
|
||
| `SHiNE-browser-plugin-wallet/` | Вход через сессию кошелька в браузере | `SHiNE-browser-plugin-wallet/README.md` |
|
||
| `ESP32/` | Прототипы устройств и прошивки | `ESP32/AGENTS.md` |
|
||
|
||
## Основные потоки
|
||
|
||
1. **Регистрация и подключение.** Клиент взаимодействует с Solana PDA и сервером; серверный адрес публикуется в PDA серверного аккаунта. Детали регистрации и её текущий статус: `docs/Инициализация_Solana_регистрации/README.md`, `docs/registration-v2/README.md`.
|
||
2. **Пользовательские блоки.** Клиент создаёт подписанный ANS-104 DataItem с SHiNE Frame v1. Сервер проверяет его при `AddBlock`, хранит локально в PostgreSQL и, в зависимости от режима публикации, передаёт в Arweave. Другие серверы могут импортировать опубликованные блоки. Точный формат и ограничения: `docs/Blockchain/README.md`.
|
||
3. **Личные сообщения.** Клиент формирует зашифрованное сообщение; сервер обслуживает доставку и локальное хранение, не получая ключ содержимого. Точные правила, формат и доставка: `docs/Personal_Messages/README.md`.
|
||
4. **Деплой.** Сборка основного сервера управляется корневым Gradle-проектом; эксплуатационные сценарии и отдельный Solana-модуль документированы раздельно: `deploy/README.md`, `shine-solana/shine/AGENTS.md`.
|
||
|
||
## Ограничения этой карты
|
||
|
||
Схема показывает связи компонентов, но не обещает доступность каждой функции на каждом контуре. Документы с названиями `TODO`, `Черновик`, `PROPOSED` и исторические отчёты не описывают действующий контракт. Если карта расходится с профильной спецификацией или кодом, расхождение нужно проверить и исправить по [правилам сопровождения](CONTRIBUTING_DOCS.md).
|
||
|
||
## Федеративные публичные и DM-файлы (16.11.2026)
|
||
|
||
- Публичные PR/Base58-файлы и аватарки ищутся на
|
||
`https://files.<access-домен автора>/<PiecesRoot>`; в публикации нет
|
||
дополнительного поля домена. Arweave и legacy `/files/<sha256>` не меняются.
|
||
- Новый DM v3 по отправителю определяется на `dm-files.<access-домен>`, а
|
||
в технической вставке сохраняется идентификатор, но не URL. Исторические DM
|
||
v3 с URL читаются. Про шифрование и срок хранения см.
|
||
`docs/Personal_Messages/Файлы_DM_v3_R2.md`.
|
||
- Access-домен клиента определяется через `GET /api/files/user-server?login=`.
|
||
Java использует `UserAccessServersCurrentDAO.findPrimaryByUserLogin()`:
|
||
синхронизированную PostgreSQL-проекцию Solana. Платный аккаунт — первый
|
||
access server пользовательской PDA, FREE_CERT — namespace default server.
|
||
Ответ `{serverLogin, serverUrl}`; клиент формирует домены сам.
|
||
- Client-cache исключительно в RAM, без TTL/IndexedDB. Одновременные обращения
|
||
объединяются; после ошибки файла повторный lookup не чаще раза в час на автора.
|
||
Успешная загрузка не запускает periodic validation.
|
||
- Смена access-сервера **не переносит** старые объекты R2: миграция файлов
|
||
должна быть выполнена отдельно до обновления маршрута пользователя.
|