Документація

Запустіть Gyrator у себе

Один бінарний файл, інтерфейс усередині. SQLite за замовчуванням, Postgres — коли треба. Працює на невеликому сервері чи ноутбуці.

Шаблони

Форми команд: які групи оцінюють одна одну і хто оцінює результат.

Приватність

Що збирається, хто що бачить і що ніколи не залишає ваш сервер.

Представники працівників

Пояснення на одну сторінку для профспілок і рад працівників.

Ліцензія

Apache-2.0 і разова ліцензія на чесному слові для компаній.

Встановлення через Docker

git clone https://gitlab.com/kiosan/gyrator.git && cd gyrator
docker build -t gyrator .
docker run -p 8080:8080 -v gyrator:/data gyrator

Відкрийте http://localhost:8080, створіть першого адміністратора, створіть команду з шаблону, додайте людей і відкрийте опитування.

Збірка з коду

Потрібні Rust (stable) і Node 22.

npm --prefix web ci && npm --prefix web run build   # інтерфейс, вбудовується в бінарний файл
cargo run --release -p gyrator                       # http://localhost:8080

Налаштування

Змінні оточення або файл .env у робочій теці. Справжні змінні оточення мають перевагу над файлом.

Змінна Що робить
DATABASE_URL За замовчуванням sqlite://gyrator.db?mode=rwc; для Postgres — postgres://user:pass@host/db
BIND Адреса, на якій слухати, за замовчуванням 0.0.0.0:8080
SECURE_COOKIES 1, коли застосунок працює через HTTPS
PUBLIC_URL Адреса в посиланнях у листах, напр. https://gyrator.example.org
RESEND_API_KEY, RESEND_FROM Надсилати кожному його посилання, коли відкривається опитування, через Resend. Відправник має бути на домені, підтвердженому в Resend
ANTHROPIC_API_KEY Claude готує питання до ретро з агрегатів; без ключа питання беруться з правил
GYRATOR_AI_MODEL Модель для питань до ретро, за замовчуванням claude-opus-5-5
DEMO 1 дозволяє будь-кому створити акаунт, з денними лімітами на листи й виклики моделі. Для публічного демо; на власному сервері не вмикайте

Опитування від початку до кінця

  1. Налаштування. Створіть команду з шаблону, додайте людей у кожну групу і вкажіть мету проєкту.
  2. Відкрийте опитування. Кожен отримує власне посилання — з Налаштувань або листом. Акаунтів для учасників немає.
  3. Відповіді. Близько п’яти хвилин на телефоні; форма стейкхолдера — приблизно хвилина.
  4. Закрийте й читайте. Результати відкриваються після закриття опитування: зв’язки з обох боків, куди йдуть зусилля, внутрішній стан, мережа співпраці й мета. Біля кожного числа — n.
  5. Ретро. Візьміть питання на ретроспективу команди. За кілька циклів часова шкала покаже кожен індекс відносно власної норми команди.

Резервні копії

Усе зберігається в одній базі. Для SQLite копіюйте файл у томі /data (або gyrator.db); для Postgres — звичні дампи.