Демонстраційне налаштування

Спробуйте 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.