312 lines
19 KiB
Markdown
312 lines
19 KiB
Markdown
# 2026-05-02 — Дневник
|
||
|
||
## Enduro Trails — отладка прототипа (утро)
|
||
|
||
### Что делали
|
||
Долгая отладка карты грунтовок ЦФО на http://82.22.50.71:5558
|
||
|
||
### Проблемы и решения
|
||
|
||
#### 1. style.json не грузился (404 на /static/style.json)
|
||
- Путь в index.html был `/static/style.json`, а сервер отдаёт `/style.json`
|
||
- Исправлено: путь исправлен на `/style.json`
|
||
|
||
#### 2. Шрифты — demotiles.maplibre.org отдавал 404
|
||
- MapLibre зависал при инициализации
|
||
- Исправлено: переключили на `https://fonts.openmaptiles.org/{fontstack}/{range}.pbf`
|
||
|
||
#### 3. Невалидный фильтр в style.json
|
||
- `trails-path-bridleway` использовал expression синтаксис: `["in", ["get", "highway"], "literal", [...]]`
|
||
- MapLibre 4.x падал с ошибкой "Expected 2 arguments, but found 3"
|
||
- Исправлено: заменили на legacy синтаксис `["in", "highway", "path", "bridleway", "footway"]`
|
||
|
||
#### 4. Самописный MVT энкодер давал пустые тайлы
|
||
- WKB геометрия имеет тип `0x20000002` (SRID+LineString), не входил в список `(2, 1000002, 2147483650)`
|
||
- Исправлено: заменили самописный энкодер на `mapbox-vector-tile` v2.2.0 + `shapely`
|
||
|
||
#### 5. Треки смещались при зуме
|
||
- `quantize_bounds` передавался с буфером, координаты выходили за [0,4096]
|
||
- Исправлено: клиппинг строго по границе тайла через `shapely.ops.clip_by_rect`, `quantize_bounds=(west, south, east, north)` без буфера
|
||
|
||
#### 6. Y-координата перевёрнута
|
||
- `mapbox-vector-tile` v2.2.0 НЕ флипает Y по умолчанию
|
||
- MVT spec: Y=0 = север (верх)
|
||
- Исправлено: `y_coord_down=True` в encode
|
||
|
||
#### 7. index.html — дублирование window._map и незакрытые теги
|
||
- При рефакторинге initMap() файл был обрезан без `</script></body></html>`
|
||
- Исправлено: добавлены закрывающие теги
|
||
|
||
### Текущее состояние (10:09 UTC)
|
||
- Треки отображаются ✅
|
||
- OSM подложка работает ✅
|
||
- Смещение при зуме — частично исправлено, Слава говорит "стало лучше, но ещё сохраняется"
|
||
- `y_coord_down=True` применён, ждём подтверждения от Славы
|
||
|
||
### Технические детали
|
||
|
||
#### Стек на сервере (mva154, 82.22.50.71:5558)
|
||
- Docker контейнер `enduro-trails`
|
||
- FastAPI + uvicorn
|
||
- SQLite с индексами min_lon/max_lon/min_lat/max_lat
|
||
- `mapbox-vector-tile` v2.2.0, `shapely`
|
||
- БД: `/data/centralfederal.sqlite`, 1.1М треков
|
||
|
||
#### Доступ к серверу
|
||
- SSH: `sshpass -p 'пароль' ssh node@82.22.50.71` (пароль в .env как MVA154_PASSWORD)
|
||
- Контейнер: `docker exec enduro-trails ...`
|
||
- app.py на сервере: `/app/app.py` внутри контейнера
|
||
- Локальная копия: `/tmp/app_new.py` (актуальная версия)
|
||
|
||
#### Ключевые файлы
|
||
- `tasks/enduro-trails/prototype/static/style.json` — стили карты
|
||
- `tasks/enduro-trails/prototype/static/index.html` — фронтенд
|
||
- `/tmp/app_new.py` — актуальный app.py (нужно синхронизировать с workspace)
|
||
|
||
### Итоговое исправление (11:49 UTC) ✅
|
||
- Убран `clip_by_rect` в `build_mvt()` — треки отдаются целиком, MapLibre клипит на клиенте
|
||
- `y_coord_down=True` в `mapbox_vector_tile.encode` сохранён
|
||
- Слава подтвердил: треки перестали скакать при зуме
|
||
- TODO обновить PROJECT.md, TASK.md, онтологию
|
||
|
||
### TODO
|
||
- [ ] Синхронизировать `/tmp/app_new.py` с `tasks/enduro-trails/prototype/app.py`
|
||
- [ ] Обновить PROJECT.md и TASK.md для enduro-trails
|
||
- [ ] Обновить онтологию для проекта enduro-trails
|
||
|
||
### Обновлённый vibecode API key (11:27 UTC)
|
||
- Слава прислал новый ключ для провайдера vibecode: `[REDACTED]`
|
||
- Нужно обновить в `~/.openclaw/.env` (переменная `VIBECODE_API_KEY`)
|
||
|
||
|
||
## Enduro Trails — продолжение отладки (11:40-12:09 UTC)
|
||
|
||
### Скриншоты от Славы
|
||
- Прислал 2 пары скринов: z12.4 vs z11.8/12.0 — треки всё ещё смещаются при зуме
|
||
- "Опять пляшут" / "Ещё как прыгают!!!" — подтверждение что проблема не решена
|
||
- Ключевое наблюдение Славы: **"Треки же отражают дорогу, почему они смещаются"** — треки из OSM должны идеально ложиться на OSM подложку
|
||
|
||
### Диагностика
|
||
- Удаление `clip_by_rect` НЕ помогло — треки продолжали прыгать
|
||
- Причина: без клиппинга геометрия выходит за `quantize_bounds`, координаты >4096 ломают MapLibre
|
||
- **Найден корневой баг**: в WKB геометрии из БД координаты хранятся как `(lat, lon)`, а `wkb_to_coords()` читала их как `(lon, lat)`. Широта и долгота были перепутаны!
|
||
|
||
### Фикс (12:07 UTC)
|
||
- В `wkb_to_coords()`: `lat, lon = struct.unpack_from('<dd', data, offset)` → `coords.append((lon, lat))`
|
||
- Раньше было: `lon, lat = struct.unpack_from(...)` — неправильно, потому что БД хранит lat-first
|
||
- Файл обновлён в контейнере через docker cp + docker restart
|
||
|
||
### Статус: ожидает подтверждения
|
||
- Слава написал "Test" — видимо проверяет карту
|
||
- Ждём подтверждения что треки теперь ложатся на дороги OSM
|
||
|
||
### TODO
|
||
- [ ] Подтвердить визуально: треки совпадают с дорогами OSM при всех зумах
|
||
- [ ] Синхронизировать app.py с workspace: `tasks/enduro-trails/prototype/app.py`
|
||
- [ ] Обновить PROJECT.md и TASK.md для enduro-trails
|
||
- [ ] Обновить онтологию для проекта enduro-trails
|
||
|
||
|
||
## Enduro Trails — ревью прототипа (12:53 UTC)
|
||
- Слава попросил ревью — после серии горячих фиксов (clip_by_rect, y_coord_down, swap lat/lon) код запутан
|
||
- TODO: провести полное ревью app.py и index.html
|
||
# 2026-05-02 — Дневник
|
||
|
||
## Enduro Trails — отладка прототипа (утро)
|
||
|
||
### Что делали
|
||
Долгая отладка карты грунтовок ЦФО на http://82.22.50.71:5558
|
||
|
||
### Проблемы и решения
|
||
|
||
#### 1. style.json не грузился (404 на /static/style.json)
|
||
- Путь в index.html был `/static/style.json`, а сервер отдаёт `/style.json`
|
||
- Исправлено: путь исправлен на `/style.json`
|
||
|
||
#### 2. Шрифты — demotiles.maplibre.org отдавал 404
|
||
- MapLibre зависал при инициализации
|
||
- Исправлено: переключили на `https://fonts.openmaptiles.org/{fontstack}/{range}.pbf`
|
||
|
||
#### 3. Невалидный фильтр в style.json
|
||
- `trails-path-bridleway` использовал expression синтаксис: `["in", ["get", "highway"], "literal", [...]]`
|
||
- MapLibre 4.x падал с ошибкой "Expected 2 arguments, but found 3"
|
||
- Исправлено: заменили на legacy синтаксис `["in", "highway", "path", "bridleway", "footway"]`
|
||
|
||
#### 4. Самописный MVT энкодер давал пустые тайлы
|
||
- WKB геометрия имеет тип `0x20000002` (SRID+LineString), не входил в список `(2, 1000002, 2147483650)`
|
||
- Исправлено: заменили самописный энкодер на `mapbox-vector-tile` v2.2.0 + `shapely`
|
||
|
||
#### 5. Треки смещались при зуме
|
||
- `quantize_bounds` передавался с буфером, координаты выходили за [0,4096]
|
||
- Исправлено: клиппинг строго по границе тайла через `shapely.ops.clip_by_rect`, `quantize_bounds=(west, south, east, north)` без буфера
|
||
|
||
#### 6. Y-координата перевёрнута
|
||
- `mapbox-vector-tile` v2.2.0 НЕ флипает Y по умолчанию
|
||
- MVT spec: Y=0 = север (верх)
|
||
- Исправлено: `y_coord_down=True` в encode
|
||
|
||
#### 7. index.html — дублирование window._map и незакрытые теги
|
||
- При рефакторинге initMap() файл был обрезан без `</script></body></html>`
|
||
- Исправлено: добавлены закрывающие теги
|
||
|
||
### Текущее состояние (10:09 UTC)
|
||
- Треки отображаются ✅
|
||
- OSM подложка работает ✅
|
||
- Смещение при зуме — частично исправлено, Слава говорит "стало лучше, но ещё сохраняется"
|
||
- `y_coord_down=True` применён, ждём подтверждения от Славы
|
||
|
||
### Технические детали
|
||
|
||
#### Стек на сервере (mva154, 82.22.50.71:5558)
|
||
- Docker контейнер `enduro-trails`
|
||
- FastAPI + uvicorn
|
||
- SQLite с индексами min_lon/max_lon/min_lat/max_lat
|
||
- `mapbox-vector-tile` v2.2.0, `shapely`
|
||
- БД: `/data/centralfederal.sqlite`, 1.1М треков
|
||
|
||
#### Доступ к серверу
|
||
- SSH: `sshpass -p 'пароль' ssh node@82.22.50.71` (пароль в .env как MVA154_PASSWORD)
|
||
- Контейнер: `docker exec enduro-trails ...`
|
||
- app.py на сервере: `/app/app.py` внутри контейнера
|
||
- Локальная копия: `/tmp/app_new.py` (актуальная версия)
|
||
|
||
#### Ключевые файлы
|
||
- `tasks/enduro-trails/prototype/static/style.json` — стили карты
|
||
- `tasks/enduro-trails/prototype/static/index.html` — фронтенд
|
||
- `/tmp/app_new.py` — актуальный app.py (нужно синхронизировать с workspace)
|
||
|
||
### Итоговое исправление (11:49 UTC) ✅
|
||
- Убран `clip_by_rect` в `build_mvt()` — треки отдаются целиком, MapLibre клипит на клиенте
|
||
- `y_coord_down=True` в `mapbox_vector_tile.encode` сохранён
|
||
- Слава подтвердил: треки перестали скакать при зуме
|
||
- TODO обновить PROJECT.md, TASK.md, онтологию
|
||
|
||
### TODO
|
||
- [ ] Синхронизировать `/tmp/app_new.py` с `tasks/enduro-trails/prototype/app.py`
|
||
- [ ] Обновить PROJECT.md и TASK.md для enduro-trails
|
||
- [ ] Обновить онтологию для проекта enduro-trails
|
||
|
||
### Обновлённый vibecode API key (11:27 UTC)
|
||
- Слава прислал новый ключ для провайдера vibecode: `[REDACTED]`
|
||
- Нужно обновить в `~/.openclaw/.env` (переменная `VIBECODE_API_KEY`)
|
||
|
||
|
||
## Enduro Trails — продолжение отладки (11:40-12:09 UTC)
|
||
|
||
### Скриншоты от Славы
|
||
- Прислал 2 пары скринов: z12.4 vs z11.8/12.0 — треки всё ещё смещаются при зуме
|
||
- "Опять пляшут" / "Ещё как прыгают!!!" — подтверждение что проблема не решена
|
||
- Ключевое наблюдение Славы: **"Треки же отражают дорогу, почему они смещаются"** — треки из OSM должны идеально ложиться на OSM подложку
|
||
|
||
### Диагностика
|
||
- Удаление `clip_by_rect` НЕ помогло — треки продолжали прыгать
|
||
- Причина: без клиппинга геометрия выходит за `quantize_bounds`, координаты >4096 ломают MapLibre
|
||
- **Найден корневой баг**: в WKB геометрии из БД координаты хранятся как `(lat, lon)`, а `wkb_to_coords()` читала их как `(lon, lat)`. Широта и долгота были перепутаны!
|
||
|
||
### Фикс (12:07 UTC)
|
||
- В `wkb_to_coords()`: `lat, lon = struct.unpack_from('<dd', data, offset)` → `coords.append((lon, lat))`
|
||
- Раньше было: `lon, lat = struct.unpack_from(...)` — неправильно, потому что БД хранит lat-first
|
||
- Файл обновлён в контейнере через docker cp + docker restart
|
||
|
||
### Статус: ожидает подтверждения
|
||
- Слава написал "Test" — видимо проверяет карту
|
||
- Ждём подтверждения что треки теперь ложатся на дороги OSM
|
||
|
||
### TODO
|
||
- [ ] Подтвердить визуально: треки совпадают с дорогами OSM при всех зумах
|
||
- [ ] Синхронизировать app.py с workspace: `tasks/enduro-trails/prototype/app.py`
|
||
- [ ] Обновить PROJECT.md и TASK.md для enduro-trails
|
||
- [ ] Обновить онтологию для проекта enduro-trails
|
||
|
||
|
||
## Enduro Trails — ревью прототипа (12:53 UTC)
|
||
- Слава попросил ревью — после серии горячих фиксов (clip_by_rect, y_coord_down, swap lat/lon) код запутан
|
||
- TODO: провести полное ревью app.py и index.html
|
||
|
||
---
|
||
|
||
## Enduro Trails — полное ревью и план восстановления (13:07–13:57 UTC)
|
||
|
||
### Что сделано
|
||
- Прочитаны все файлы прототипа: `app.py` (из контейнера), `docker-compose.yml`, `static/index.html`, `static/style.json`, `scripts/parse.py`, `scripts/download.sh`
|
||
- Прочитаны требования: `TECHNICAL_SPEC.md`, `CONCEPT.md`, `PROJECT.md`, `TASK.md`
|
||
- Проведено полное ревью с сопоставлением требований и реализации
|
||
- Составлен план восстановления прототипа
|
||
- Составлено жёсткое ТЗ для Dev-агента
|
||
|
||
### Ключевые находки ревью
|
||
|
||
#### CRITICAL — workspace vs container расхождение
|
||
- workspace `app.py` был в мусорном состоянии: дубликаты функций, синтаксические ошибки
|
||
- контейнер содержал чистую рабочую версию
|
||
- **ИСПРАВЛЕНО**: workspace синхронизирован из контейнера
|
||
|
||
#### CRITICAL — parse.py не соответствует реальной схеме БД
|
||
- `parse.py` создаёт таблицу `trails` БЕЗ колонок `min_lon/max_lon/min_lat/max_lat`
|
||
- реальная БД имеет эти колонки + индекс `idx_trails_bbox`
|
||
- если запустить `parse.py` заново — получим несовместимую БД
|
||
- **НЕ ИСПРАВЛЕНО** — передаётся Dev-агенту
|
||
|
||
#### HIGH — layer toggles сломаны
|
||
- `layerGroups` в `index.html` ссылается на `trails-grade12`, `trails-grade345`
|
||
- в `style.json` таких слоёв нет — есть `trails-track`, `trails-asphalt`
|
||
- **НЕ ИСПРАВЛЕНО** — передаётся Dev-агенту
|
||
|
||
#### HIGH — popup не соответствует ТЗ
|
||
- `build_mvt()` в `app.py` не передаёт `length_m` и `mtb_scale` в props
|
||
- popup показывает неполные данные
|
||
- **НЕ ИСПРАВЛЕНО** — передаётся Dev-агенту
|
||
|
||
#### HIGH — POI без bbox-фильтра в SQL
|
||
- `SELECT ... FROM poi LIMIT 2000` без пространственного фильтра
|
||
- фильтрация в Python — неэффективно
|
||
- **НЕ ИСПРАВЛЕНО** — передаётся Dev-агенту
|
||
|
||
#### MEDIUM — нет валидации z/x/y
|
||
- tile endpoint принимает любые значения без проверки
|
||
- **НЕ ИСПРАВЛЕНО** — передаётся Dev-агенту
|
||
|
||
#### MEDIUM — docker-compose тяжёлый
|
||
- apt-get + pip install при каждом старте
|
||
- нет Dockerfile
|
||
- **НЕ ИСПРАВЛЕНО** — передаётся Dev-агенту
|
||
|
||
#### MEDIUM — весь фронт в одном index.html
|
||
- нет отдельных app.js / app.css как требует ТЗ
|
||
- **НЕ ИСПРАВЛЕНО** — передаётся Dev-агенту
|
||
|
||
### Состояние БД (реальное)
|
||
- 1,141,926 trails
|
||
- 14,882 POI
|
||
- колонки min_lon/max_lon/min_lat/max_lat есть
|
||
- индекс idx_trails_bbox есть
|
||
- Spatialite НЕ загружен — работает обычный SQLite + WKB + bbox columns
|
||
|
||
### Принятые решения по архитектуре тайлов
|
||
- без `clip_by_rect` — MapLibre клипит на клиенте
|
||
- `quantize_bounds` с буфером 10%
|
||
- `y_coord_down=True`
|
||
- WKB хранит координаты как (lat, lon) — читать нужно соответственно
|
||
|
||
### ТЗ для Dev-агента
|
||
Составлено полное ТЗ на стабилизацию прототипа v0.1:
|
||
- синхронизация source of truth
|
||
- исправление parse.py под реальную схему
|
||
- стабилизация app.py (валидация, props, POI bbox)
|
||
- починка frontend (toggles, popup, split js/css)
|
||
- smoke/regression checks
|
||
- обновление документации
|
||
|
||
**Definition of Done:**
|
||
1. `prototype/` — канонический рабочий код
|
||
2. `parse.py` создаёт БД совместимую с `app.py`
|
||
3. runtime не зависит от ручных правок в контейнере
|
||
4. tile endpoint стабильно работает
|
||
5. trail popup показывает нужные поля
|
||
6. layer toggles реально работают
|
||
7. есть минимальный regression/smoke набор
|
||
8. документация обновлена
|
||
|
||
### Следующий шаг
|
||
Слава подтвердил план и ТЗ. Нужно передать ТЗ Dev-агенту через `sessions_spawn`.
|