> ## Content Index
> Fetch the complete content index at: https://www.rozhkov.me/llms.txt
> Use this file to discover other available public pages before exploring further.

# Реал-тайм сайти на Ruby on Rails без жодного рядка JS
- URL: https://www.rozhkov.me/real-time-application-with-ruby-on-rails-without-any-js/
- Published: 2023-03-22T08:49:00.000Z
- Updated: 2023-03-22T13:16:10.000Z
- Author: Vova Rozhkov
- Tags: проєкти, інструменти

## Інтегруємось з моно

Йдемо на <https://api.monobank.ua/>, скануємо QR код апкою, отримуємо ключ.

Далі встановлюємо [вебхук](https://api.monobank.ua/docs/#tag/Kliyentski-personalni-dani/paths/~1personal~1webhook/post), щоб отримувати транзакції.

Вебхук веде на ендпоїнт який дістає параметри транзакції та зберігає її:

```ruby
def respond(data)
  t = data.require(:statementItem).permit(:description, :amount, :comment, :balance, :time)
  t[:account] = data[:account]
  t[:transaction_id] = data[:statementItem][:id]
  MonoTransaction.create(t)
end
```

## Показуємо транзакції

Робимо сторінку, передаємо параметром `account` номер картки/банки, витягуємо по ньому всі транзакції та малюємо їх. Переглянути демо [](https://donate1024.org/mono%5Ftransactions?account=mN155%5FjWnu26Z1jLT2BgcTXOpwtPamA)[тут](https://donate1024.org/mono%5Fdashboards?account=vrFT09EZWLkn2f2ugX1ZQjag4ErDtD4).

## Додаємо інтерактивності

При створенні нової транзакції потрібно негайно якимось чином оновити сторінку. В Rails для цього вже все передбачено, нам знадобляться: [ActionCable](https://guides.rubyonrails.org/action%5Fcable%5Foverview.html) та [Hotwire](https://hotwired.dev/). За замовчуванням при створенні нового Rails-проєкту вони будуть додані та сконфігуровані.

ActionCable це клієнт-серверна ліба яка робить pub/sub у вашій апці. Під капотом там знаходяться Redis для сервера та вебсокети для клієнта. Коли ви додаєте собі це в проєкт, то ваша вебсторінка буде відкривати вебсокет з'єднання, та слухати що туди приходить.

Таким чином ми можемо одразу після створення транзакції записати щось у «канал», клієнт отримає нову інфу по вебсокету та за допомогою JS оновить HTML.

Але ж ми хочемо все робити без JS! На допомогу приходить Hotwire. Це бібліотека яка оперує поняттями *[фреймів](https://turbo.hotwired.dev/reference/frames)* та *[стримів](https://turbo.hotwired.dev/reference/streams)*.

*Фрейм* визначає на HTML сторінці будь-який шматочок та присвоює йому ідентифікатор.

Ось я загортаю список всіх транзакцій у фрейм:

```ruby
<%= turbo_frame_tag "mono_transactions" do %>
  <% @transactions.each do |transaction| %>
    <%= render partial: "mono_transaction", locals: { transaction: transaction } %>
  <% end %>
<% end %>
```

За допомогою *стриму* можна передати на клієнт спеціальні інструкції, які потім будуть виконані в рамках *фрейму.* Ці інструкції включають (але не обмежені) у себе: додати HTML елемент в початок або кінець фрейму, замінити, видалити, додати після такого-то елементу і так далі.

Нам потрібно додавати нотифікашку з транзакцією у початок списку.

Тут починається найцікавіше. Ми можемо згенерувати відповідний івент на сервері, а ActionCable подбає, щоб доставити його у браузер та викликати необхідний JS, щоб виконати необхідну нам дію.

Для того, щоб наша сторінка була підписана на стрим, нам необхідно додати відповідну інструкцію:

```
<%= turbo_stream_from "mono_transactions_#{@account}" %>
```

Цим ми кажемо «обробляти всі події які будуть приходити у канал під назвою `mono_transactions`.

Тепер, на бекенді, кажемо, щоб після створення транзакції відправили новий івент у відповідний канал:

```
after_create_commit do |transaction|
  broadcast_prepend_to "mono_transactions_#{transaction.account}",
                       partial: "mono_dashboards/mono_transaction",
                       locals: {transaction: transaction},
                       target: "mono_transactions"
end
```

`broadcast_prepend_to` означає що буде відправлене повідомлення з типом `prepend` у канал `mono_transactions_#{transaction.account}` та переданий маленький шматочок HTML відрендерений на сервері для обробки фреймом `mono_transactions`. `prepend` означає що HTML буде доданий першим до списку дочірних елементів фрейму.

Таким чином, ми з сервера посилаємо шматочок HTML який Hotwire обробить як треба. В нашому випадку — додасть нотифікашку.

Так само оновлюється значення суми на банці.

## Висновки

Ось так можна без жодного рядка JS робити інтерактивні сайти. Уважні та освічені читачі вже знають, що бібліотек та фреймворків, що працюють за таким принципом є декілька: найвідоміший це [Phoenix LiveView](https://elixirschool.com/blog/phoenix-live-view/), менш відомий це [HTMX](https://htmx.org/), поки що маловідомий [TwinSpark](https://github.com/piranha/twinspark-js) він пана Соловйова.