Начало работы

Запустите за 5 минут#

Вам не нужен сервер, хостинг-провайдер или IT-отдел. Если у вас есть ноутбук с установленным Docker, вы можете увидеть Observer в работе прямо сейчас.

git clone https://github.com/lbrty/observer.git
cd observer
cp .env.example .env
just generate-keys
just docker-up
just run

Откройте http://localhost:9000/health в браузере. Если вы видите "status":"healthy", бэкенд работает.

Затем запустите веб-интерфейс:

just web-dev

Откройте http://localhost:5173 — перед вами Observer.

Что вы только что запустили#

• Бэкенд, обслуживающий API — отвечает за аутентификацию, хранение данных и отчёты
• Базу данных с таблицами для людей, домохозяйств, записей о поддержке, истории миграции, документов и домашних животных
• Веб-интерфейс с управлением проектами, ролевым доступом и встроенной отчётностью
• Автоматическую безопасность входа — токены ротируются при каждом обновлении сессии

Всё это работает на одной машине. В продакшене всё компилируется в один файл, который можно скопировать на любой сервер.

Готовы к реальному развёртыванию?#

Чтобы перейти от «пробую» к «моя команда пользуется этим каждый день», вам потребуется:

Никаких подписок. Никаких поплатежных тарифов. Никакой привязки к вендору. Вы владеете данными и развёртыванием.

Перейдите в раздел Развёртывание для пошаговой настройки продакшена.

Для разработчиков: локальная настройка#

Если вы хотите работать над самим Observer, вам понадобятся следующие инструменты:

1. Клонирование и установка зависимостей#

git clone https://github.com/lbrty/observer.git
cd observer
go mod download
bun install

2. Настройка окружения#

cp .env.example .env

Значения по умолчанию работают из коробки с предоставленным docker-compose.yml. Редактирование не требуется.

3. Генерация ключей подписи#

just generate-keys

Эта команда создаёт пару ключей, которую Observer использует для подписи токенов входа. Директория keys/ включена в gitignore — каждый разработчик генерирует свои ключи.

4. Запуск всего#

just docker-up    # запускает PostgreSQL и Redis
just run          # запускает бэкенд на :9000 (миграции выполняются автоматически)
just web-dev      # запускает фронтенд на :5173

Что-то не работает?#

Порт 5432 уже занят — Вероятно, у вас запущен локальный PostgreSQL. Остановите его или измените порт в docker-compose.yml.

«no such file or directory» для путей к ключам — Сначала нужно выполнить just generate-keys.

Миграция завершается с ошибкой «connection refused» — Контейнер базы данных может быть ещё не готов. Подождите несколько секунд после just docker-up и попробуйте снова.