hockey_new/REMOTE_DATABASE.md

Удалённая PostgreSQL-база хоккейного проекта

Сборка работает только с удалённой PostgreSQL. Локальная SQLite отключена.

1. Создать отдельную базу и пользователя

Пример команд для администратора PostgreSQL:

CREATE USER hockey_app WITH PASSWORD 'CHANGE_ME';
CREATE DATABASE hockey OWNER hockey_app ENCODING 'UTF8';
\c hockey
GRANT USAGE, CREATE ON SCHEMA public TO hockey_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO hockey_app;
GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA public TO hockey_app;
ALTER DEFAULT PRIVILEGES IN SCHEMA public
  GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO hockey_app;
ALTER DEFAULT PRIVILEGES IN SCHEMA public
  GRANT USAGE, SELECT, UPDATE ON SEQUENCES TO hockey_app;

Если база и пользователь уже созданы, этот шаг не нужен.

2. Настроить .env

Скопируйте .env.example в .env и укажите реальные адреса:

WFL_DATABASE_URL=postgresql+psycopg://postgres:password@localhost:5432/wfl_db
HOCKEY_DATABASE_URL=postgresql+psycopg://postgres:password@localhost:5432/hockey

WFL_DATABASE_URL читает аккаунты WFL. HOCKEY_DATABASE_URL хранит все хоккейные матчи, справочники, статистику, настройки сессий и кэш API.

3. Запуск

При запуске программа:

1. проверяет соединение командой SELECT 1;
2. создаёт отсутствующие таблицы;
3. добавляет новые неключевые поля при обновлении версии;
4. прекращает запуск с понятной ошибкой, если PostgreSQL недоступен.

Проверка после запуска:

http://127.0.0.1:8000/api/hockey/database/status

В ответе должны быть ok: true, backend: postgresql, remote_only: true. Пароль базы в API и логах не показывается.

Состояние таймеров матчей

Начиная с BUILD 2026.07.20.5 основной таймер и активные удаления сохраняются в hockey_game_control_states отдельно для каждого game_external_id. При первом запуске сборка автоматически добавит столбцы timer_state_json и timer_state_updated_at, если их ещё нет.