Настройка демо

Попробуйте Observer с полностью заполненной базой данных менее чем за 5 минут. Команда seed наполняет базу реалистичными тестовыми данными — люди, проекты, записи о помощи, история миграции, домохозяйства и многое другое — чтобы вы могли изучить все возможности без ручного ввода данных.

Быстрый старт#

git clone https://github.com/lbrty/observer.git
cd observer
just build
./observer setup
docker compose up -d
./observer migrate up
./observer seed
./observer serve

Откройте http://localhost:9000/health — вы должны увидеть {"status":"healthy"}.

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

cd packages/observer-web
bun install
bun run dev

Откройте http://localhost:5173 и войдите с admin@example.com / password.

Что создаёт команда seed#

Учётные данные по умолчанию#

Пользовательские параметры seed#

# Больше проектов и людей
./observer seed --projects 5 --people 200

# Воспроизводимые данные (одинаковый seed = одинаковый результат)
./observer seed --seed 42

Пошаговое описание#

1. Сборка#

just build

Компилирует бинарный файл observer.

2. Настройка#

./observer setup

Создаёт .env с разумными значениями по умолчанию, директории keys/ и data/uploads/, а также генерирует 4096-битную пару RSA-ключей для подписи JWT. Если .env уже существует, программа спросит перед перезаписью.

3. Запуск сервисов#

docker compose up -d

Запускает PostgreSQL и Redis в фоновом режиме.

4. Миграции#

./observer migrate up

Применяет все миграции базы данных.

5. Заполнение данными#

./observer seed

Заполняет базу данных демо-данными. Именно этот шаг превращает пустой экземпляр в рабочее демо, которое можно показать заинтересованным сторонам.

6. Запуск#

./observer serve

Запускает API-сервер на http://localhost:9000.

7. Фронтенд (опционально)#

cd packages/observer-web
bun install
bun run dev

Запускает веб-интерфейс на http://localhost:5173.

Сброс#

Чтобы удалить всё и начать заново:

docker compose down -v

Затем повторите с шага 3.