LizaAlert (aka LA) – is a non-profit volunteer Search & Resque Organization, which helps to find and resque lost people across Russian Federation.
LizaAlert volunteers work hard on daily basis to save lives by arranging and speeding up lost-people searches.
This repo covers LA Searcher Bot. The bot officially is not a part of LA central IT solutions, however it is developed from the scratch & maintained by one of LA Searchers.
Core audience of the Bot – are LA Searches, that participate in numerous "field" searches in urban / rural / natural environments.
Bot works by several scenarios:
- It sends personalized notifications on the New Searches (and Searchers can immediately join the resque activity)
- It sends updates on the active searches (and Searches can stay up to date)
- Users can request a list of Active / the Latest searches
Every notification is personalized:
- User can choose his/her Region or list of Regions – and Bot sends only info from there
- User can enter "home coordinates" – and Bot will indicate direction & distance to a certain search
- User can tune the types of notifications – and only these types of messages will be sent
Bot works across the whole Russian Federation.
There is the enthusiasts Community for discussion of ideas and issues in the Bot.
Bot was created in mid 2021. As of January 2023 bot has +9700 active users, DAU (daily active users) +6000, daily messages +30000. Annual Growth Rate is 2X.
Bot is built as a parser of phpbb LA Forum, which wraps phpbb-styled information into customized notification for every user.
- UI: Telegram + Web-app LA Map
- Language: Python 3.10
- Git: GitHub
- CI/CD: GitHub Actions
- Infra: Google Cloud Platform
- Executors: Google Cloud Functions
- Message Broker: Google Pub/Sub
- Storage: Google Cloud SQL (Postgres), Cloud Storage, BigQuery
- Monitoring: Google Cloud Logging, Looker Studio
This repository covers only python scripts, which are sent to Google Cloud Functions and GitHub Actions Workflow files. Architecture of Google Cloud Functions
See a dedicated LA Searcher Bot contribution page.
TL;DR:
- contributions to the current Python-based repo are welcome via pull requests
- contribution to CI/CD, PSQL, GCP or
- improvement ideas – let's discuss in community chat.