05 01 25

Документы: Описание БД и всех запросов актуализировал!

shine-server-db/src/main/java/shine/db/entities/SolanaUserEntry.java

@@ -3,15 +3,35 @@ package shine.db.entities;
 import java.util.Base64;
 
 /**
- * Локальная копия пользователя из Solana.
+ * SolanaUserEntry — локальная запись пользователя из Solana.
  *
- * Теперь:
+ * Таблица: solana_users
+ *
+ * Поля:
  *  - login     — PRIMARY KEY (TEXT)
- *  - bchName   — имя/идентификатор персонального блокчейна (TEXT)
- *  - loginKey  — публичный ключ логина
- *  - deviceKey — публичный ключ устройства
- *  - bchLimit  — лимит (может быть null)
+ *      Уникальный логин пользователя.
+ *
+ *  - deviceKey — TEXT NOT NULL
+ *      Публичный ключ устройства.
+ *      Поддерживаемые форматы:
+ *        • Base64 (32 байта)
+ *        • HEX (64 hex-символа)
+ *
+ *  - solanaKey — TEXT NULLABLE
+ *      Публичный ключ Solana-аккаунта пользователя (если используется).
+ *
+ * Назначение:
+ *  - хранение минимальной локальной информации о пользователе
+ *  - используется для:
+ *      • проверки подписи запросов
+ *      • привязки пользователя к блокчейну
+ *      • сопоставления login ↔ ключи
+ *
+ * ВАЖНО:
+ *  - deviceKey обязателен всегда
+ *  - solanaKey может отсутствовать (null)
  */
+
 public class SolanaUserEntry {
 
     private String login;      // TEXT PK