Ленинград под Огнём

Интерактивная историческая карта артиллерийских и авиа-ударов Ленинграда в период Блокады.

• Планирование
• Разработка
  • Сборка и Начало Работы
  • Исходные Данные
    • Исторические Данные
    • Тестовые Данные

Планироавние

Текущие задачи находятся в проекте Ленинград под Огнём

Разработка

Сборка и Начало Работы

Убедиться, что используется правильная версия node.js:

nvm use

Прогнать тесты:

npm run test

Собрать проект:

npm run build

Результаты сборки будут доступны в директории ./build. Проект на данный момент не использует никакой бэкенд, все исторические данные зашиты во фронт. Чтобы задеплоить приложение достаточно статически сёрвить содержимое папки ./build по URL /. Например команды cd ./build && python3 -m http.server <port> должно быть достаточно, чтобы приложение стало доступно по соответствующему порту.

Запустить dev-сервер с динамической подгрузкой изменений:

npm run dev

Локальный dev-сервер будет доступен по следующему по http://localhost:9999/

Исходные Данные

Артиллерийские удары, отображаемые на карте, находятся в файле ./src/data.ts. Данный файл генерируется программно по исходным данным.

Исторические Данные

Пока не реализовано. В данном разделе будет описано:

1. В каком формате хранятся исходные исторические данные
2. Как на их основе генерируется файл ./src/data.ts

Тестовые Данные

Поскольку реальные исторические данные по артиллерийским ударам на начальном этапе разработки не доступны, для целей тестирования приложения файл ./src/data.ts содержит случайные тестовые данные.

Чтобы сгенерировать тестовые данные надо выполнить:

rm src/data.ts
npm run generate:fake-data

Чтобы сгенерировать тестовые данные заданного объема в generate:fake-data можно передать необходимое количество событий:

npm run generate:fake-data -- 10000

Адреса домов для тестовых данных берутся из файла src/processing/spb-houses.ts, который также генерируется програмно:

rm src/processing/spb-houses.ts
npm run generate:spb-houses

Команда generate:spb-houses скачивает гео-данные OpenStreetMap по Санкт-Петербургу (в формате OSM) в папку ./data, извлекает известные адреса домов вместе с координатами и записывает их в src/processing/spb-houses.ts.

Исходные гео-данные по Санкт-Петербургу изначально получены с помощью сервиса BBike, перепакованы в zip-архив и выложены для скачивания по адресу https://stepan-anokhin.github.io/data/spb-geodata.osm.zip, откуда их забирает скрипт generate:spb-houses.