60 lines
2.6 KiB
Markdown
60 lines
2.6 KiB
Markdown
# Удалённая PostgreSQL-база хоккейного проекта
|
||
|
||
Сборка работает **только** с удалённой PostgreSQL. Локальная SQLite отключена.
|
||
|
||
## 1. Создать отдельную базу и пользователя
|
||
|
||
Пример команд для администратора PostgreSQL:
|
||
|
||
```sql
|
||
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` и укажите реальные адреса:
|
||
|
||
```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 недоступен.
|
||
|
||
Проверка после запуска:
|
||
|
||
```text
|
||
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`, если их ещё нет.
|