ddadminandClaude Opus 4.6
ae4aee3f66
- Зачем:
- зафиксировать найденные проблемы demodb и план системной проверки эталона
до начала подготовки ветки main для студентов.
- Что:
- добавлен qa-plan.md — 6 блоков проверки пайплайна (чистый прогон,
идемпотентность, инкремент, многодневный, статика, граничные случаи).
- добавлен bookings_db_issues.md — 3 бага demodb (gen.connstr без credentials,
init_days=1 недостаточно, boarding_passes всегда пустая) и UX-проблема
с временем генерации.
- Проверка:
- документы, проверка не требуется.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
144 lines
6.3 KiB
Markdown
144 lines
6.3 KiB
Markdown
# Проблемы bookings-db (demodb)
|
||
|
||
> Дата обнаружения: 2026-03-08
|
||
> Зафиксированный коммит demodb: `d68de192850237719f09b47688d5f3fc94653ca6`
|
||
|
||
---
|
||
|
||
## 1. gen.connstr без credentials — генерация обрывается
|
||
|
||
### Симптом
|
||
|
||
После `make bookings-init` таблицы в demo-базе существуют, но **пустые**.
|
||
Повторные `make bookings-generate-day` тоже дают 0 строк.
|
||
|
||
### Корневая причина
|
||
|
||
`install.sql` из demodb хардкодит:
|
||
|
||
```sql
|
||
ALTER DATABASE demo SET gen.connstr = 'dbname=demo';
|
||
```
|
||
|
||
Без `user` и `password`. Makefile устанавливает правильный connstr
|
||
(с `user=bookings password=bookings`) **после** `install.sql`, но при повторном
|
||
`make bookings-init` порядок тот же: install.sql перезаписывает → Makefile
|
||
восстанавливает. Если что-то идёт не так между этими шагами, connstr остаётся
|
||
без credentials.
|
||
|
||
Далее цепочка:
|
||
1. `process_queue()` обрабатывает события (BOOKING, FLIGHT, VACUUM и т.д.)
|
||
2. Событие VACUUM вызывает `dblink_exec(gen.connstr, 'VACUUM ANALYZE')`
|
||
3. dblink без user → подключается как `postgres` → `FATAL: role "postgres" does not exist`
|
||
4. `process_queue()` ловит ошибку, логирует и **прекращает работу**
|
||
5. Генерация обрывается на 1-2 модельных днях → данных почти нет
|
||
|
||
### Диагностика
|
||
|
||
```sql
|
||
-- В psql к demo-базе:
|
||
SHOW gen.connstr;
|
||
-- Если "dbname=demo" без user → проблема подтверждена
|
||
|
||
SELECT * FROM gen.log ORDER BY at DESC LIMIT 5;
|
||
-- Искать: "could not establish connection" / "role postgres does not exist"
|
||
```
|
||
|
||
### Воркэраунд
|
||
|
||
```sql
|
||
-- Выполнить на bookings-db ПОСЛЕ install.sql:
|
||
ALTER DATABASE demo SET gen.connstr = 'dbname=demo user=bookings password=bookings';
|
||
-- Затем переподключиться к demo и запустить генерацию заново.
|
||
```
|
||
|
||
### Правильное решение
|
||
|
||
Один из вариантов:
|
||
- Патч `install.sql`, подставляющий credentials из ENV
|
||
- Обновление demodb до версии, где это исправлено
|
||
|
||
---
|
||
|
||
## 2. BOOKINGS_INIT_DAYS=1 — недостаточно для генерации данных
|
||
|
||
### Симптом
|
||
|
||
Даже при исправленном connstr, с `BOOKINGS_INIT_DAYS=1` (дефолт в Makefile)
|
||
`bookings.bookings` остаётся пустой.
|
||
|
||
### Корневая причина
|
||
|
||
Генератор demodb использует константы:
|
||
- `ROUTES_DURATION() = 1 month` — маршруты строятся на месяц вперёд
|
||
- `ROUTES_TAKE_EFFECT() = 2 months` — маршруты начинают действовать через 2 месяца
|
||
|
||
При `start_date=2017-01-01` и `init_days=1`:
|
||
- `end_date = 2017-01-02`
|
||
- Генератор успевает только INIT + BUILD ROUTES (маршруты на февраль-март)
|
||
- До создания бронирований не доходит → 0 строк
|
||
|
||
Проверено:
|
||
| init_days | bookings | boarding_passes | Время генерации |
|
||
|-----------|----------|-----------------|-----------------|
|
||
| 1 | 0 | 0 | ~1 сек |
|
||
| 30 | ~30 000 | 0 | ~1-2 мин |
|
||
| 90 | ? | ? (ожидаем >0) | ~10+ мин |
|
||
|
||
---
|
||
|
||
## 3. boarding_passes всегда пустая
|
||
|
||
### Симптом
|
||
|
||
Таблица `bookings.boarding_passes` ни разу не содержала данных.
|
||
|
||
### Корневая причина
|
||
|
||
Boarding passes создаются при событиях CHECK-IN и BOARDING, которые
|
||
генерируются при REGISTRATION рейса (~24ч до вылета). Рейсы начинаются
|
||
с 2017-02-01. Цепочка:
|
||
|
||
1. Нужны маршруты → появляются при init_days ≥ 1
|
||
2. Нужны рейсы → появляются при init_days ≥ 30
|
||
3. Нужны бронирования/сегменты → появляются при init_days ≥ 30
|
||
4. Нужна регистрация (за ~24ч до вылета) → init_days ≥ ~60
|
||
5. Нужны boarding events → init_days ≥ ~60
|
||
|
||
При init_days ≤ 30 генератор не доходит до дат регистрации.
|
||
При init_days ≥ 60 баг #1 (connstr) убивал генерацию раньше.
|
||
|
||
Возможно, есть и баг в самой версии demodb — требует проверки после
|
||
обновления.
|
||
|
||
---
|
||
|
||
## 4. UX: время генерации
|
||
|
||
Генерация данных занимает значительное время:
|
||
|
||
| init_days | Время | Достаточно для |
|
||
|-----------|------------|-----------------------|
|
||
| 30 | ~1-2 мин | bookings, но не bp |
|
||
| 60 | ~5 мин | предположительно bp |
|
||
| 90 | ~10+ мин | всех таблиц (?) |
|
||
|
||
Для студента ждать 10 мин при первом запуске — плохой UX.
|
||
|
||
### Альтернативы
|
||
|
||
1. **Готовый SQL-дамп** первых N дней (`pg_dump` → `pg_restore`, секунды)
|
||
2. **Docker image с предзаполненной БД** (ещё быстрее, 0 ожидания)
|
||
3. **Уменьшить масштаб** — найти параметры demodb для меньшего числа аэропортов/маршрутов
|
||
|
||
---
|
||
|
||
## Рекомендации (TODO)
|
||
|
||
- [ ] Обновить demodb до последнего коммита — проверить, исправлены ли баги
|
||
- [ ] Добавить патч для gen.connstr (если не исправлено upstream)
|
||
- [ ] Увеличить BOOKINGS_INIT_DAYS до 30-60
|
||
- [ ] Добавить валидацию после init (`make bookings-init` проверяет count > 0)
|
||
- [ ] Решить проблему UX с временем генерации (дамп или prebuilt image)
|
||
- [ ] Проверить, появляются ли boarding_passes при init_days=90 + исправленном connstr
|