Packages and apps

• api - js api to add whitewater objects to yandex map (see INTEGRATION_ru.md)
• backend - map backend provides river and whitewater information from database
• config - package installs common configuration file of project
• cron - utilites for periodical execution:
  • backup - script for database backup
  • catalog-sync - synchronize database with remote reports and catalogs
  • db-clean - tool for cleaning old data from db
  • log-notifications - creates notification when objects (rivers, spots, etc.) were changed
  • meteo - tool for weather data fetch in configured points
  • notifier - sends reports to email
  • spot-sort - inactive spot ordering tool. Calculates order index for each spot relying on the rivar track(s)
  • vodinfo-eye - tool for water level data fetching from gis.vodinfo.ru
• cron2 - gocron-based scheduler daemon with rest api (for web ui)
• data - utilities for OSM xml parsing
• db - database migrations package
• frontend - wwmap site and backoffice frontend
• lib - not a package - common go sources
• t-cache - app for caching of slow tiles

Packaging

Run debuild -us -uc in directory containing debian folder

Installation

1. Install postgres and postgis
2. Create database user wwmap and db wwmap owned by created user. Enable postgis extension on db wwmap:

CREATE ROLE wwmap_group;
CREATE ROLE wwmap LOGIN
  NOSUPERUSER INHERIT NOCREATEDB NOCREATEROLE NOREPLICATION;
CREATE DATABASE wwmap WITH OWNER = wwmap_group ENCODING = 'UTF8';
GRANT wwmap_group TO wwmap;
\password wwmap
\c wwmap
CREATE EXTENSION postgis;

3. Install wwmap-config and change WWMAP_POSTGRES_PASSWORD with real password of wwmap user in file /etc/wwmap/config.yaml
4. Install migrate: https://github.com/golang-migrate/migrate/tree/master/cmd/migrate
5. Install wwmap-db and run wwmap-db-upgrade up
6. Install wwmap-backend and run service wwmap-backend start
7. Install wwmap-t-cache and run service wwmap-t-cache start
8. Install nginx and remove all from sites-enabled.
9. Install wwmap-frontend, wwmap-api and run service nginx restart
10. In file /etc/wwmap/config.yaml set real yandex disk credentials in the backup section. Install pyyaml python package:

LC_ALL='ru_RU.UTF-8' pip install pyyaml

9. Install wwmap-cron

Integration with any site

See INTEGRATION_ru.md