AMG — ArtMap Georgia
Карта искусства и необычных городских объектов Грузии: муралы, стрит-арт, мозаики, бани, каньоны, канатки.
Прод: https://artmap-georgia.github.io/AMG/ Репозиторий: github.com/artmap-georgia/AMG
Структура
index.html вся логика сайта (MapLibre + PMTiles, офлайн через IndexedDB)
sw.js service worker (страницы и данные — network-first, остальное — cache-first)
privacy.html, license.html конфиденциальность; лицензии и атрибуция
fonts/ шрифты интерфейса (OFL), без внешнего CDN
icons/, manifest.webmanifest PWA; robots.txt, sitemap.xml, og-cover.jpg — SEO
data/ sites, artworks, artists, sources, cities, transit, experiences,
routes (готовые маршруты), offline-packs (офлайн-карты городов),
contributions (фид бота)
scripts/validate-.mjs проверки данных, «Впечатлений», маршрутов
scripts/extract-tiles.mjs нарезка офлайн-пакетов по data/offline-packs.json (CI)
scripts/split-artworks.mjs описания работ отдельным файлом (CI)
scripts/fetch-map-assets.mjs шрифты и спрайты карты → assets/ (CI)
scripts/build-vendor.mjs vendor/map-bundle.js из lock-файла
scripts/contrib-.mjs логика, шифрование и проход Telegram-бота; тесты contrib-test.mjs
scripts/e2e/ браузерные сценарии (вручную, не в CI)
.github/workflows/pages.yml сборка и публикация на GitHub Pages
.github/workflows/contrib-bot.yml бот @artmap_georgia_bot, дежурство 24/7 (long polling)
.github/ISSUE_TEMPLATE/ форма «Сообщить о проблеме»
docs/ отчёты, аудит, планы; RUNBOOK.md — эксплуатация; DESIGN.md — стиль
Локальная проверка
- Node.js 22+
- npm ci && npm run build:vendor && npm run build:assets
- node scripts/validate-data.mjs && node scripts/validate-experiences.mjs && node scripts/validate-routes.mjs
- node scripts/contrib-test.mjs
- Статический сервер с поддержкой Range (python -m http.server не подходит).
vendor/, assets/ и tiles/*.pmtiles в git не хранятся; тайлы собирает CI.
Деплой
push в main -> GitHub Actions -> GitHub Pages. Подробности и откат — docs/RUNBOOK.md.
Возможности
Карта с категориями и «Впечатлениями», поиск (ru/en/ka), офлайн-карты Тбилиси и 9 городов,
паспорт путешественника (штампы за «Я здесь»), «Мой день» и готовые маршруты (#route=, #ready=),
подтверждение точек через Telegram-бота, форма «Сообщить о проблеме», фото из Wikimedia Commons.
Правила работы с данными
- Источник истины — git; данные меняются проверяемыми скриптами, отчёт — в docs/.
- Перед правкой: snapshot, проверка дублей ID/координат, validate-*.
- Фото — только Wikimedia Commons со свободной лицензией; муралы — по разрешению (docs/2026-10-27-amg-photos-legal-sources.md).
- Секреты (токены, ключи) не хранятся в git и не публикуются; см. docs/RUNBOOK.md.
- Не перезаписывать untracked-файлы на zimablade без отдельного GO.
