🐈 ShantiCat Controller

ShantiCat Controller — это Python-приложение для приёма BLE Advertising-пакетов от умного ошейника ShantiCat Collar, их декодирования и подготовки данных для последующего хранения, анализа и визуализации.

Проект является частью экосистемы ShantiCat.

Архитектура

                  +------------------+
                  | ShantiCat Collar |
                  +--------+---------+
                           |
                    BLE Advertising
                           |
                           ▼
               +----------------------+
               | BLE Collector        |
               +----------+-----------+
                          |
                          ▼
               +----------------------+
               | Protocol Decoder     |
               +----------+-----------+
                          |
                          ▼
               +----------------------+
               | CollarMeasurement    |
               +----------+-----------+
                          |
                          ▼
                  Последующая обработка

            +------------------------------+
            | TimescaleDB                  |
            | Анализ активности            |
            | Telegram Bot                 |
            | Web API                      |
            +------------------------------+

---

Установка

Клонируйте репозиторий:

git clone https://github.com/ShantiCat/ShantiCatController.git
cd ShantiCatController

Создайте виртуальное окружение:

python -m venv .venv

Активируйте его.

Windows:

.venv\Scripts\activate

Linux/macOS:

source .venv/bin/activate

Установите проект:

pip install -e .

---

Запуск

python -m shanti_cat_controller