ICity — доступная карта Казахстана

ICity помогает людям с инвалидностью и всем, кому трудно передвигаться по городу, — на кресле-коляске, с тростью или ходунками, с детской коляской, незрячим, слабовидящим и глухим — заранее узнать, как добраться до места без лестниц, высоких бордюров и других барьеров.

Сайт: https://inclusivecity.uk/

Что умеет

• Маршрут пешком под ваш профиль — проверка ступеней, подземных переходов и уклонов; если на пути барьер, предлагается обход.
• Общественный транспорт — автобусы, троллейбусы, маршрутки и трамваи, в том числе с пересадкой; отметки о доступности остановок.
• Такси — оценка цены по официальному тарифу Яндекс Go вашего города и заказ в Яндекс Go или inDrive.
• Доступные места рядом — пандусы, лифты, доступные туалеты, парковки для людей с инвалидностью, тактильная плитка, звуковые светофоры.
• Жалобы на барьеры — с фото и подтверждениями жителей, модерацией, статистикой и готовым обращением в акимат.
• 22 города Казахстана — Алматы, Астана, Шымкент и все областные центры.
• Для всех — русский, казахский и английский; крупный шрифт, высокий контраст, тёмная тема, текстовый режим без карты и голосовые подсказки.

Данные о городе берутся из открытых источников (OpenStreetMap) и дополняются сообщениями самих жителей.

Готово к деплою «из коробки»: сервер написан на чистом Node.js без единой npm-зависимости, поэтому не нужен даже npm install — только node server.js.

Что внутри

• public/index.html — карта (Leaflet + тайлы OSM), построение маршрутов (OSRM), поиск мест (Nominatim), открытые данные о доступности (Overpass API). Все эти три сервиса — публичные, бесплатные и не требуют ключей.
• public/admin.html — панель модератора: одобрить / отклонить / удалить присланный отчёт о барьере.
• server.js — бэкенд: отдаёт статику и API для приёма/хранения отчётов (JSON-файл data/reports.json + фото в uploads/).

Вход и регистрация (Supabase)

Аккаунты хранятся в Supabase (бесплатный план), а не на диске Render, поэтому не пропадают при деплое.

1. https://supabase.com → New project. В Project Settings → API скопируйте Project URL и ключ anon public.
2. В Render → сервис → Environment добавьте SUPABASE_URL и SUPABASE_ANON_KEY.
3. В Supabase Authentication → URL Configuration: Site URL https://inclusivecity.uk, Redirect URLs https://inclusivecity.uk/account* и https://inclusivecity.onrender.com/account*.
4. Google: в Google Cloud Console создайте OAuth Client ID (Web application) с redirect URI https://<ref>.supabase.co/auth/v1/callback, затем вставьте Client ID и Secret в Supabase Authentication → Providers → Google.
5. Встроенная почта Supabase отправляет лишь несколько писем в час — для реального запуска подключите свой SMTP в Authentication → Emails → SMTP Settings.
6. Телефон и SMS-коды: в Authentication → Providers → Phone включите провайдер и подключите SMS-сервис (Twilio, MessageBird, Vonage или Textlocal — у него свой аккаунт, SMS платные). Для бесплатной проверки там же можно задать тестовые номера с постоянным кодом (Test Phone Numbers and OTPs), SMS на них не отправляются.

Как устроен вход (public/login.html): регистрация по телефону (код из SMS) или по почте (ссылка в письме), вход по телефону или почте с паролем, «Забыли пароль?» — для телефона код в SMS и новый пароль, для почты — ссылка на /account?reset=1.

Apple (нужен Apple Developer, $99/год) и eGov пока показаны как «скоро».

ИИ-помощник «Серік»

Кнопка «Серік» на карте открывает чат: гид по доступному городу и бережная поддержка (выслушать, дыхание, заземление, план поездки; при кризисе — номера 112, 150, 111). Ответы можно слушать голосом, вопросы — задавать голосом.

1. На https://console.anthropic.com создайте API-ключ (Settings → API Keys) и пополните баланс.
2. В Render → сервис → Environment добавьте ANTHROPIC_API_KEY с этим ключом и сохраните.
3. По желанию: ASSISTANT_MODEL (по умолчанию claude-haiku-5-5 — самая дешёвая модель).

Сервер ограничивает 40 сообщений в час с одного IP, чтобы ключ не расходовался впустую.

Фото и отзывы заведений

В карточке места (кафе, аптека, ТЦ…) прямо на сайте показываются фото, рейтинг и отзывы — без перехода в 2ГИС. Источник — официальный Google Places API (New); ключ хранится только на сервере, фото отдаются через /api/place-photo.

1. В Google Cloud Console создайте проект, включите Places API (New) и привяжите платёжный аккаунт (у Google есть бесплатный месячный лимит запросов; сервер кэширует каждое место на неделю).
2. Создайте API-ключ и ограничьте его только Places API (New).
3. В Render → Environment добавьте GOOGLE_PLACES_KEY.

Без ключа карточка показывает свободные фото из Wikimedia Commons (по тегам OSM image, wikimedia_commons, wikidata).

Телефоны и сайты заведений (бесплатно)

В OpenStreetMap телефон указан лишь у малой части заведений, поэтому карточка места дополняет контакты из открытых данных Overture Maps (слой places, лицензия CDLA-Permissive-2.0, бесплатно). GitHub Actions (.github/workflows/places.yml, вкладка Actions → «Places from Overture» → Run workflow; потом сам 1-го числа) запускает tools/overture_places.py и кладёт public/places/<город>.json. Карточка находит место по названию в радиусе ~180 м.

Такси и инватакси своего города

В разделе «Такси» показываются только службы того города, откуда вы едете: заказ Яндекс Go по телефону, службы такси из OpenStreetMap (tools/osm_taxi.py, workflow «Taxi from OSM», раз в месяц) и номера инватакси (таблица INVATAXI в public/index.html: карточки 2ГИС и публикации акиматов и СМИ 2024–2026; номера только из старого справочника помечены «мог измениться»). Номера стоит перепроверять раз в несколько месяцев.

Для жителей

• Мои места — дом, работа, любимые места и маршруты в один тап.
• Пошаговая навигация голосом и вибрацией, с предупреждениями о лестницах и перестроением маршрута.
• Погода на маршруте — в гололёд выбираются пологие пути, прогноз снега, дождя и жары на время пути.
• Карта без интернета — «Настройки → Карта без интернета → Скачать город».
• Отзывы о доступности мест с галочками и фото, помощь волонтёров (из SOS), мои жалобы со статусом и уведомлениями.
• Рейтинг районов (меню) — оценка 0–100 и теплокарта; Туалет — ближайший доступный туалет; Поделиться поездкой.

Отзывы, просьбы о помощи и жалобы хранятся в data/ и копируются в Cloudflare KV, если заданы CF_ACCOUNT_ID, CF_KV_NAMESPACE_ID, CF_API_TOKEN (без них на бесплатном Render данные стираются при каждом деплое).

Профиль передвижения

Выбирается в «Настройках» (первый раздел) и на странице аккаунта /account — там он сохраняется в аккаунте (user_metadata.mobility в Supabase) и подхватывается на других устройствах. В панели «Куда едем?» — только строка «Профиль: … Изменить».

Глобус

Если отдалить карту до уровня материков, вместо плоского «атласа» появляется Земля в космосе (three.js r128, текстуры NASA Blue Marble и Earth at Night из пакета three-globe на jsDelivr): звёзды, Солнце, Луна, ночные огни. Землю можно крутить и приближать; приблизили или нажали на точку города — снова обычная карта.

Голосовые подсказки для незрячих

Настройки → «Голосовые подсказки» (или пункт в меню «три линии»): первое касание произносит название кнопки или поля, второе — нажимает; окна и результаты объявляются голосом. Это для тех, у кого не включён экранный диктор; с VoiceOver и TalkBack сайт работает и без этого режима.

Запуск локально

node server.js

Откройте http://localhost:3000 — карта. http://localhost:3000/admin — модерация (токен по умолчанию change-me-please, обязательно смените через переменную окружения ADMIN_TOKEN перед реальным использованием).

ADMIN_TOKEN=мой-секретный-токен PORT=3000 node server.js

Деплой на Render (бесплатно, ~3 минуты)

1. Загрузите содержимое этой папки в новый репозиторий на GitHub (можно приватный).
2. Зайдите на https://render.com → New → Web Service → подключите репозиторий.
3. Параметры:
   • Build Command: оставьте пустым (зависимостей нет)
   • Start Command: node server.js
   • Plan: Free
4. В разделе Environment добавьте переменную ADMIN_TOKEN со своим секретным значением.
5. Create Web Service — через пару минут получите ссылку вида https://inclusivecity-xxxx.onrender.com.

В репозитории уже лежит render.yaml — Render может подхватить конфигурацию автоматически при выборе Blueprint.

⚠️ Важно про хранение данных на бесплатном плане

Бесплатный план Render не даёт постоянный диск — при каждом передеплое или перезапуске сервиса файлы data/reports.json и uploads/ обнуляются. Для MVP и демонстрации это некритично, но для реальной эксплуатации выберите один из вариантов:

• Платный план Render с Persistent Disk (в render.yaml есть закомментированный пример — раскомментируйте и примонтируйте data/ и uploads/).
• Деплой на Railway (https://railway.app, платно — от $5/мес) — там можно подключить Volume и примонтировать его на /app/data и /app/uploads, данные переживут перезапуски.
• Переезд с JSON-файла на настоящую БД (например, бесплатный Postgres от Render/Neon/Supabase) — это следующий логичный шаг роста проекта.

Деплой на Railway (альтернатива с постоянным хранилищем)

1. https://railway.app → New Project → Deploy from GitHub repo.
2. Railway сам определит Node.js и запустит npm start.
3. Добавьте переменную окружения ADMIN_TOKEN.
4. Во вкладке Volumes создайте том и примонтируйте на /app/data (и при желании второй — на /app/uploads), чтобы отчёты и фото не терялись между деплоями.
5. Во вкладке Settings → Networking сгенерируйте публичный домен.

Как пользоваться панелью модерации

Откройте <ваш-домен>/admin, введите токен из ADMIN_TOKEN. Новые отчёты приходят со статусом «на проверке» и не видны на публичной карте, пока вы их не одобрите.

Технические ограничения, о которых стоит знать

• Карта использует три внешних публичных API (тайлы OSM, Overpass, Nominatim, роутинг через routing.openstreetmap.de). Это open-source демо-серверы — бесплатные, но без SLA и с лимитами на частоту запросов. Для серьёзной нагрузки стоит поднять свой инстанс Overpass/Nominatim или подключить платный геосервис (например, Mapbox, Google Maps, 2ГИС API).
• Хранилище отчётов — простой JSON-файл. Подходит для сотен-тысяч записей; при росте нагрузки стоит перейти на Postgres/SQLite.
• Загруженные фото хранятся на диске сервера как есть, без сжатия/ресайза — при большом потоке отчётов стоит добавить оптимизацию изображения или переезд на объектное хранилище (S3-совместимое).
• ИИ-распознавание типа барьера по фото (упомянуто в интерфейсе) — задел на будущее, сейчас не реализовано: пользователь указывает тип вручную.

Лицензия

Все права защищены — см. LICENSE. Код открыт только для просмотра; копировать и размещать его на других сайтах без разрешения нельзя.