Добавить лицензию CC0 1.0

This commit is contained in:
AidarKC
2026-11-16 23:50:28 +03:00
parent 548160f7f8
commit c477560632
39 changed files with 901 additions and 138 deletions
+23 -19
View File
@@ -511,21 +511,19 @@
"op": "ClientErrorLog",
"requestId": "err-001",
"payload": {
"errorId": "ERR-A7F29C1201CD",
"clientVersion": "20261116-client-error-reporting-v1",
"kind": "global_error",
"message": "TypeError: client exception",
"message": "TypeError: failed",
"stack": "...",
"sourceUrl": "https://shineup.me/app.js",
"lineNumber": 10,
"columnNumber": 20,
"route": "/channels",
"href": "https://shineup.me",
"route": "#/channel-view/own-0",
"href": "https://shineup.me/#/channel-view/own-0",
"userAgent": "...",
"clientTs": 1774700000123,
"requestOp": "GetChannelMessages",
"requestIdRef": "GetChannelMessages-123",
"contextJson": "{\"pageVisibility\":\"visible\",\"pageId\":\"channels\"}"
"contextJson": "{\"screen\":\"channels\"}"
}
}
```
@@ -547,19 +545,7 @@
### Специфические коды ошибок `ClientErrorLog`
- `400 / BAD_FIELDS` — нет `message` или превышены ограничения размеров полей.
- `200` + `payload.accepted=false` — отчёт **не записан** из-за ограничений частоты; повторов и очереди нет.
### Диагностика SHiNE UI v1 (16.11.2026)
- Критические JS-ошибки и неожиданные ответы WS API (статус `500–599`, кроме `507`) отправляются **автоматически**, без переключателя в инструментах разработчика; обычные `4xx` не считаются багом.
- Транспорт: только текущий WebSocket `ClientErrorLog`, без отдельного HTTP и без локальной очереди. При отсутствии соединения отчёт не отправляется; клиент не утверждает обратное.
- Серверный журнал: `logs/client-errors.log` (Logback `client.frontend`, без дублирования в `app.log`); ежедневная/размерная ротация, история 14 дней, до 150 MB суммарно. Диагностика звонков `CallDeliveryReport` остаётся в своём журнале.
- Поля `errorId` и `clientVersion` необязательные для внешних клиентов; `errorId` связывает уведомление пользователя с записью в журнале.
- Для необработанных ошибок/сбоев UI клиент передаёт тип исключения и кадры стека, но **не произвольный текст исключения**, который может содержать данные переписки. Клиент отбрасывает произвольный `context`, оставляя только технические поля: `pageId`, `reasonType`, `pageProtocol`, `timeoutMs`, `code`, `status`, `pendingOps`. URL передаются без query/hash, приватные ключи, содержимое сообщений, пароли и токены не должны включаться. Сервер дополнительно очищает и ограничивает строки; **не следует отправлять конфиденциальные данные даже при ручном вызове API**.
- Сервер ограничивает частоту: до 60 отчётов с одного IP и 1200 всего за 60 секунд; длины полей ограничены, число источников ограничено. IP используется временно для ограничения частоты и не записывается в отдельный журнал.
- Уведомление «отчёт принят» показывается только при `status=200` и `accepted=true`. Это означает, что сервер принял отчёт на обработку, но не является долговременной гарантией записи на диск.
- Отправка диагностики не инициирует повтор исходной операции, в том числе блокчейн-платежа или доната.
- `400 / BAD_FIELDS` — обязательные поля ошибки не заполнены.
---
@@ -644,3 +630,21 @@
- `SendSignal` нужен для доверенных межсессионных сигналов одного пользователя, включая `remote AddBlock via homeserver session`.
- `GetCallIceConfig` нужен для WebRTC-звонков и требует авторизации.
- `ClientErrorLog`, `ClientDebugLog`, `CallDeliveryReport` используются для диагностики клиента и звонков.
## GET `/api/files/user-server?login=<user@namespace>` (16.11.2026)
Публичный, read-only resolver файлового сервера пользователя. Работает на
access-сервере просмотрщика, без сессии; читает локальную синхронизированную
PostgreSQL-проекцию Solana через `UserAccessServersCurrentDAO.findPrimaryByUserLogin()`.
Отдельный Solana RPC на каждый просмотр вложения не выполняется.
Пример ответа 200:
```json
{"serverLogin":"node2@shine","serverUrl":"node2.example.net"}
```
404 — пользователь/маршрут не найдены; 400 — некорректный логин;
503 — база/справочник недоступны. Все ответы `Cache-Control: no-store`,
`Access-Control-Allow-Origin: *`; клиент хранит маршрут только в RAM.
DNS-имя `serverUrl` используется для построения
`https://files.<hostname>/<PR>` и `https://dm-files.<hostname>/<FileID>`.
Для нового типа R2 нет дополнительных полей в блокчейне.
+28 -3
View File
@@ -1,6 +1,6 @@
# HTTP API зашифрованных файлов личных сообщений
> **Текущий протокол DM v3 (2026-11):** новые вложения отправляются напрямую в R2 `shine-dm` после `POST /api/dm-files/prepare`; скачиваются по `https://dm-files.shineup.me/<Base58(SHA-256(ciphertext))>`. Большие файлы шифруются по 8 МиБ AES-256-GCM, список объектов находится в зашифрованном манифесте; BitTorrent v2 используется только в старых DM v2. Ниже разделы `PUT /dm-files/{fileId}` и `GET /dm-files/{fileId}` описывают **legacy** локальный сервер для v1/v2, а не новый R2. Полный текущий контракт см. `docs/Personal_Messages/Файлы_DM_v3_R2.md`.
> **Текущий протокол DM v3 (2026-11):** новые вложения отправляются напрямую в R2 `shine-dm` после `POST /api/dm-files/prepare`; скачиваются по `https://dm-files.<домен access-сервера отправителя>/<Base58(SHA-256(ciphertext))>`. Большие файлы шифруются по 8 МиБ AES-256-GCM, список объектов находится в зашифрованном манифесте; BitTorrent v2 используется только в старых DM v2. Ниже разделы `PUT /dm-files/{fileId}` и `GET /dm-files/{fileId}` описывают **legacy** локальный сервер для v1/v2, а не новый R2. Полный текущий контракт см. `docs/Personal_Messages/Файлы_DM_v3_R2.md`.
> **Статистика v42:** сервер при успешной выдаче presigned URL или обнаружении уже существующего шифротекста добавляет запись в `dm_file_uploads` (`user_login`, `file_hash`, `file_size_bytes`, `requested_at`, `disposition`). Каждая зашифрованная часть/манифест — отдельный объект, имена и MIME исходного файла не сохраняются. **Запись не доказывает успешный PUT.** Шифрование, DM-протокол и клиент не изменяются.
@@ -16,7 +16,7 @@ HTTP API не получает исходное имя файла, MIME-тип
3. считает `SHA-256(ciphertext)`;
4. переводит 32-byte hash в Base58 — это `fileId` и имя файла на диске сервера;
5. для нового v3 загружает ciphertext напрямую в R2 (ниже описан legacy v1/v2);
6. помещает URL, key, IV, исходное имя/MIME/размер в `<S:file...>` внутри plaintext DM;
6. помещает ID ciphertext, key, IV, исходное имя/MIME/размер в `<S:file...>` (новый v3 без URL) внутри plaintext DM;
7. обычный механизм E2EE DM шифрует эту техническую вставку отдельно для отправителя и получателя.
Следствие: сервер файлов не знает AES-key и не может расшифровать вложение.
@@ -121,6 +121,31 @@ Caddy/Nginx должен проксировать `/dm-files/*` в тот же J
Новые зашифрованные вложения загружаются браузером прямо в R2. Клиент посылает JSON `{ "fileId": "Base58_SHA256(ciphertext)", "size": 12345 }` и подписанные заголовки `X-Shine-Session-Id`, `X-Shine-Time-Ms`, `X-Shine-Signature`. Строка Ed25519-подписи: `DM_R2_PREPARE_V1:{sessionId}:{fileId}:{size}:{timeMs}`. Сервер подтверждает существование объекта или выдаёт `uploadUrl` и `requiredHeaders` с условием `If-None-Match: *`.
Максимальный размер одного ciphertext-объекта — 8 МиБ + 16 байт. Подписанный PUT действителен 30 минут. Загрузка не идёт через Java. Новый URL скачивания: `https://dm-files.shineup.me/<fileId>`; GET публичный, но объект содержит только AES-GCM ciphertext. R2 объект содержит `Content-Type: application/octet-stream`; исходный MIME хранится внутри зашифрованного `<S:file;v=3...>`.
Максимальный размер одного ciphertext-объекта — 8 МиБ + 16 байт. Подписанный PUT действителен 30 минут. Загрузка не идёт через Java. Новый URL скачивания: `https://dm-files.<домен access-сервера отправителя>/<fileId>`; GET публичный, но объект содержит только AES-GCM ciphertext. R2 объект содержит `Content-Type: application/octet-stream`; исходный MIME хранится внутри зашифрованного `<S:file;v=3...>`.
Доступ к R2 требует настроек `r2.dmBucket=shine-dm` и серверных `R2_ENDPOINT`, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`. Рекомендуется lifecycle rule **14 дней**. Кэш CDN допускается и может продлить доступность ciphertext после удаления из R2. Сервер не гарантирует соответствие загруженных байтов hash: читающий клиент проверяет `Base58(SHA-256(ciphertext))`. Полный формат DM v3 описан в `docs/Personal_Messages/Файлы_DM_v3_R2.md`.
## 10. Федеративное R2-хранилище (16.11.2026)
У каждого access-сервера свои две корзины R2. Новый DM v3 не сохраняет полный URL в
технической вставке `<S:file>`: передаются `id` (Base58 SHA-256 ciphertext),
ключи/IV и необходимые метаданные, а также новое поле `at` — время завершения
загрузки в миллисекундах Unix. Имя файлового домена вычисляется по отправителю:
`dm-files.<DNS-имя access-сервера>`. Клиент узнаёт адрес через общий `GET
/api/files/user-server?login=<senderLogin>` на своём access-сервере (из
синхронизированной PostgreSQL-проекции Solana). В RAM кэшируется соответствие
логин → сервер; при ошибке файла допускается один повторный поиск в час на
пользователя. Для DM v3 с ранее сохранённым `url` этот URL по-прежнему читается.
Формат бинарного E2EE-контейнера не меняется.
Сервер-владелец R2 получает DNS-адрес из собственной server-PDA в синхронизированной
PostgreSQL по `server.SHiNE.login`. `POST /api/dm-files/prepare` автоматически возвращает
`fileUrl` в формате `https://dm-files.<домен>/<id>` для проверки конфликтов при PUT.
Отдельный R2 public URL в конфигурации не нужен. Публичный адрес файла
должен поддерживать CORS GET/HEAD, а корзина R2 — прямой браузерный доступ.
Для **новых R2 DM v3** после 14 дней от `at` клиент не делает скачивание и
показывает сообщение об истечении срока. Для ранних v3 без `at` используется
время сообщения. Это UX-гарантия клиента, а не физическое удаление: Cloudflare
R2 lifecycle необходимо настроить отдельно. Старые локальные DM v1/v2 не
помечаются истёкшими, поскольку для них не настроен R2 lifecycle.
+1 -1
View File
@@ -5,7 +5,7 @@
Новые публичные файлы и аватары используют **BitTorrent v2 Pieces Root**, закодированный **Base58** (32 байта; строка обычно 43–44 символа). Идентификатор не зависит от имени и MIME. Клиент вычисляет корень по подготовленным байтам. Содержимое файла **не проходит через Java**.
- R2 bucket: `shine-files`.
- Публичный GET: `https://files.shineup.me/<PR>` (ключ объекта = `PR`, без расширения).
- Публичный GET: `https://files.<домен access-сервера автора>/<PR>` (ключ объекта = `PR`, без расширения).
- Предпросмотр публичных изображений и видео использует прямой URL. Картинки `loading="lazy"`; публичные видео получают `src` только у видимой области через `IntersectionObserver` и запрашивают метаданные после входа в область. В старом браузере используется обычная загрузка metadata.
- Отдельных preview-файлов нет. Скачивание/просмотр медиаконтента выполняет сам браузер (в том числе HTTP Range, если доступен).
- Тип определяется по `mm`, затем по расширению `nm`; HTTP `Content-Type` объекта задаётся при PUT. Неизвестные файлы — `application/octet-stream`.