Сервер: дочистить PostgreSQL runtime и документацию

2026-07-27 18:01:15 +04:00
parent b5116474c7
commit 618a30c2ab
20 changed files with 47 additions and 46 deletions
@@ -9,7 +9,7 @@

 - загрузка идёт через **серверный Arweave-кошелёк**;
 - лимит на пользователя: по умолчанию `3` загрузки за всё время;
- лимит хранится в SQLite-таблице `test_free_avatar_uploads`;
+- лимит хранится в PostgreSQL-таблице `test_free_avatar_uploads`;
 - если лимит исчерпан, сервер возвращает понятную ошибку;
 - загружать можно только маленький итоговый файл аватара, по умолчанию до `128 KB`.

@@ -550,7 +550,7 @@ SYNC_POLL_INTERVAL_SECONDS=300
 3. выделить lifecycle-сервис с `awaitReady()`;
 4. реализовать вычисление `users_economy_config_pda`;
 5. реализовать polling истории по сигнатурам;
-6. добавить новые SQLite-таблицы;
+6. добавить runtime-таблицы PostgreSQL;
 7. добавить запись в `current` и `history`;
 8. добавить periodic guard раз в 5 минут;
 9. сохранить отдельный `main` для запуска как процесса.
@@ -1,17 +1,16 @@
 shine-server-bd — это библиотека реалезующая всю работу с БД:

-хранит пользователей/сессии/параметры/кэш IP→гео и данные блокчейна (состояние + блоки), предоставляя единый SqliteDbController для соединений, набор DAO под каждую таблицу (Singleton, методы с Connection для транзакций и без Connection — сами открывают/закрывают), и простые entity-модели как контейнеры данных для маппинга ResultSet↔Java.
+хранит пользователей/сессии/параметры/кэш IP→гео и данные блокчейна (состояние + блоки), предоставляя единый PostgreSQL runtime-контроллер соединений, набор DAO под каждую таблицу (Singleton, методы с Connection для транзакций и без Connection — сами открывают/закрывают), и простые entity-модели как контейнеры данных для маппинга ResultSet↔Java.

 Логика структуры классов (в двух словах):

-shine.db.SqliteDbController — один вход в БД: читает db.path, при отсутствии файла создаёт БД, выдаёт новые Connection и настраивает PRAGMA.
-shine.db.DatabaseInitializer — разовая сборка схемы (таблицы + индексы).
+shine.db.DbController / shine.db.PostgresDbController — вход в runtime БД: читает `db.url/db.user/db.password`, подключается только к PostgreSQL и выдаёт новые `Connection`.
+shine.db.DatabaseInitializer — проверяет наличие `db_schema_version` и при пустой БД автоматически накатывает `postgres/schema_v1.sql`.


 shine.db.entities.* — POJO-модели строк таблиц (без логики, только поля/геттеры/сеттеры + иногда удобные методы вроде getClientKeyByte()).
 shine.db.dao.* — DAO по таблицам: ActiveSessionsDAO, SolanaUsersDAO, UserParamsDAO, IpGeoCacheDAO, BlockchainStateDAO, BlocksDAO; плюс “сервисные” DAO:

 UserCreateDAO — атомарная регистрация пользователя в транзакции (BEGIN IMMEDIATE + rollback/commit).
-// Временное решение позволяющее регистрировать новых пользователей
-// атомарно и добавляет запись и в solana_users и в BlockchainState
-
+// Временное runtime-решение, позволяющее регистрировать новых пользователей
+// атомарно и добавляющее запись в runtime-таблицы сервера.
@@ -62,7 +62,7 @@

 ## Что не входит в v1

- удаление legacy SQLite-классов;
+- полная зачистка legacy-документации, старых названий и TODO-хвостов;
 - переименование Java DAO/классов `*V2` в runtime-коде;
 - перенос прямых SQL-запросов из хэндлеров в DAO/service;
 - переключение всего runtime-кода на новый `DbProvider`.
@@ -4,4 +4,6 @@ shine-server-config

 Настройки:
 server.port=7070 — порт запуска сервера
-db.path=data/shine.sqlite — путь к SQLite базе данных
+db.url=jdbc:postgresql://127.0.0.1:5432/shine_server_db — JDBC URL PostgreSQL
+db.user=shine_server — пользователь PostgreSQL
+db.password=... — пароль пользователя PostgreSQL