SpbTechRun Hackathon

Решение Кейса №1 - построение городского помощника для жителей и гостей Санкт-Петербурга.

Архитектура построенного решения

Как запустить?

Заполнение параметров для запуска

В корне проекта есть файл .env.sample.

Создайте его копию и подложите ваши токены туда.

Запуск проекта

$ docker compose --env-file <ваш заполненный .env файл> up

ВАЖНО: Я настоятельно НЕ рекомендую пытаться запустить каждый сервис отдельно, так как для каждого из них нужно индивидуально подбирать настройки для локального запуска

Описание

Backend

Исходный код располагается в директории python/backend. В этой же директории вы можете ознакомиться с описанием этого сервиса в файле python/backend/README.md.

MCP сервер для "Я здесь живу"

Исходный код располагается в директории python/mcp. В этой же директории аналогично вы можете ознакомиться с описанием этого сервиса в файле python/mcp/README.md.

Telegram Bot

Исходный код располагается в директории java/spbtechbot. Описание этого сервиса располагается в файле java/spbtechbot/README.md.

Max Bot

Исходный код располагается в директории golang/spbtechmaxbot. Описание этого сервиса располагается в файле golang/spbtechmaxbot/README.md.

Базы данных

PostgreSQL

Для хранения истории сообщений пользователя используется PostgreSQL. Со схемой таблицы можно ознакомиться в файле db/001_tables.sql.

ChromaDB

В качестве векторного хранилища для RAG используется ChromaDB. Более подробное описание можно узнать в описании Backend-сервиса выше.