Jaki stos wybrać do platformy serwisowej

Potrzebujesz platformy wewnętrznej albo dashboardu operacyjnego i musisz zdecydować, na czym go zbudować. Dobieraj stos warstwa po warstwie: powłoka UI na ekrany i nawigację, warstwa danych dopasowana do tego, jak współdzielone i trwałe mają być rekordy, API domenowe, które pilnuje reguł biznesowych, oraz kanały, którymi praca wpada z zewnątrz. Platforma serwisowa jest dobrym przykładem, bo potrzebuje wszystkich czterech.
Dlaczego myśleć warstwami, a nie frameworkami
Większość dyskusji o stosie zaczyna się od nazwy frameworka. Przy platformach i dashboardach to zły koniec. Przydatne pytania są prostsze: kto zapisuje dane, jak długo muszą przetrwać, jakie reguły przenoszą rekord z jednego stanu do drugiego i skąd przychodzi nowa praca. Dashboard tylko do odczytu i system serwisowy mogą korzystać z tego samego frameworka UI, a pod spodem potrzebować zupełnie innych warstw.
Nasz przykład to producent, który sam serwisuje swoje maszyny u klientów. Klient dzwoni, gdy maszyna stanie, rozmowę odbiera asystent telefoniczny AI, a niewielki zespół serwisantów wyjeżdża z siedziby firmy. Biuro prowadzi wszystko w jednym systemie webowym.
Wspólnym fundamentem takiej pracy jest u nas OpenThings: zestaw narzędzi do budowania platform. Jest w nim to, co zwykle zjada pierwsze miesiące projektu: infrastruktura (u Ciebie na serwerach albo w Twojej chmurze), tożsamość (tenanci, jednorazowe logowanie, ograniczone role, ślad audytowy) oraz wersjonowane kontrakty, którymi mówią wszystkie moduły. Na tym siedzą moduły do ponownego użycia albo rozbudowy. Jeden z nich to serwis: zgłoszenia, plany techników, protokoły przeglądów i asystent telefoniczny, który rezerwuje wizyty.

Krok po kroku: jak złożyć stos
- Wybierz stos UI pod wiele ekranów i jedną ramę. Przykład korzysta z Next.js z App Routerem, Reacta, TypeScriptu i Tailwind CSS oraz biblioteki ikon. App Router daje grupy tras, więc każdy ekran za logowaniem dzieli jeden układ z ochroną dostępu. TypeScript trzyma typy domenowe, takie jak zgłoszenie, wizyta czy maszyna, w jednym miejscu, z którego korzystają i ekrany, i API. Tailwind czyta tokeny projektowe ze zmiennych CSS, więc kolory marki ustawiasz raz i używasz wszędzie.
- Zbuduj powłokę aplikacji raz i konfiguruj ją w każdym projekcie. Logowanie, zwijane menu boczne, które na małym ekranie staje się szufladą, przyklejony nagłówek z okruszkami, menu użytkownika, powiadomienia i kilka wariantów układu żyją w gotowej powłoce. Nazwa, logo, kolory, języki i lista pozycji menu są w jednym pliku konfiguracyjnym. Nowa platforma zaczyna się od kopii powłoki z uzupełnionym plikiem, więc już pierwszego dnia masz działającą aplikację z logowaniem. Teksty dla użytkownika idą przez słowniki, więc drugi język to ustawienie, a nie przepisywanie.
- Dopasuj warstwę danych do tego, kto zapisuje dane. Powłoka dashboardu może działać na typowanych modułach TypeScriptu dla danych referencyjnych i na pamięci przeglądarki dla stanu jednego użytkownika, na przykład zwiniętego menu. System serwisowy tak nie może. Biuro, serwisanci i asystent telefoniczny zapisują te same zgłoszenia, a rekordy muszą przetrwać restart. Przykład dodaje SQLite przez moduł bazy danych wbudowany w Node.js, schowany za cienką warstwą danych działającą tylko na serwerze, z tabelami na zgłoszenia, wizyty, rozmowy, zdarzenia rozmów i ustawienia. To jeden plik, bez dodatkowej usługi do utrzymania, i wystarcza dla jednego zespołu. Gdy z niego wyrośniesz, zmieniasz tylko warstwę danych.
- Rozpisz domenę, zanim dodasz ekrany. Najpierw zapisz cykl życia zgłoszenia. W przykładzie zgłoszenie powstaje w chwili rozpoczęcia rozmowy i kończy jako nowe (trzeba oddzwonić), zaplanowane, w realizacji, rozwiązane telefonicznie, zakończone albo przerwane, gdy rozmowa skończyła się bez wystarczających informacji. Zgłoszenie przechowuje maszynę i numer seryjny, problem, wykonane kroki checklisty, powiązaną wizytę, transkrypcję, podsumowanie i historię zdarzeń. Statyczne dane referencyjne, takie jak katalog maszyn, checklisty budowane z cech każdego modelu i lista serwisantów, mogą zostać w typowanych modułach, bo biuro rzadko je zmienia.
- Reguły biznesowe schowaj za API domenowym. Route handlery w tej samej aplikacji Next.js udostępniają zgłoszenia, wizyty, serwisantów, ustawienia i podsumowanie dla pulpitu. Tu, a nie w przeglądarce, żyje planowanie wizyt: terminy są sortowane według dnia, potem według odległości od siedziby albo od najbliższej wizyty zaplanowanej tego dnia, w granicach maksymalnej odległości z ustawień. Reguły po stronie serwera sprawiają, że każdy ekran i każdy kanał dostaje tę samą odpowiedź.
- Kanał telefoniczny dodaj jako integrację, a nie rdzeń. Asystent telefoniczny AI dostaje wąski zestaw akcji HTTP: rozpoczęcie rozmowy, wyszukanie maszyny, pobranie checklisty, sprawdzenie otwartego zgłoszenia po numerze seryjnym, pobranie wolnych terminów, rezerwacja wizyty, koniec rozmowy. Nigdy nie sięga bezpośrednio do bazy, a endpointy są zabezpieczone tokenem. Każda akcja zapisuje się jako zdarzenie rozmowy, więc strona zgłoszenia może pokazywać rozmowę na żywo, odpytując mały endpoint co sekundę lub dwie. Na końcu zgłoszenie przechodzi do stanu końcowego z dołączoną transkrypcją.
- Zbuduj ekrany na modelu. Pulpit pokazuje dzisiejsze liczby, ostatnie rozmowy z aktywną na górze i to, kto jest w trasie. Szczegóły zgłoszenia pokazują checklistę, transkrypcję, wizytę, historię i notatki. Kalendarz tygodniowy i miesięczny z mapą trasy, profile serwisantów, katalog produktów z checklistami i strona ustawień z numerem asystenta i regułami planowania domykają system.

Dwie warstwy widoczne w przykładzie
Sama powłoka to stos dashboardu: framework UI, typowane moduły i konfiguracja. Wystarcza do prototypów, widoków tylko do odczytu i demo z marką klienta. Platforma serwisowa dokłada dane operacyjne, cykl życia zgłoszenia, reguły kalendarza i tras oraz kanał przychodzący. To jest pełny przykład stosu: powłoka UI, dane operacyjne i kanały.

Kiedy ten stos pasuje, a kiedy sięgnąć po więcej
Taki stos aplikacji webowej pasuje do oprogramowania operacyjnego na zamówienie, wieloekranowych systemów dla jednego zespołu i portali klienta z jego marką, w których jeden kod obsługuje i UI, i API. Ruchomych części jest mało: jedna aplikacja, jeden plik bazy, jedno wdrożenie.
Po coś cięższego sięgnij, gdy te same reguły musi współdzielić kilka systemów, gdy obciążenie albo liczba równoczesnych zapisów przerasta jeden plik bazy, albo gdy rekordy należą już do ERP lub CRM. Wtedy platforma staje się klientem tego systemu albo osobnej usługi backendowej, a aplikacja webowa zostaje przy ekranach i powłoce.
Najczęstsze błędy
- Najpierw framework, na końcu model danych. Ekrany potem nie umieją pokazać przerwanej rozmowy ani wizyty zarezerwowanej przez asystenta.
- Współdzielone rekordy w pamięci przeglądarki. Działa na demo i psuje się, gdy z systemu skorzystają dwie osoby.
- Kolory, etykiety i nawigacja wpisane na sztywno. Każdy nowy projekt kopiuje wtedy ramę i z czasem się rozjeżdża. Trzymaj je w konfiguracji i słownikach.
- Kanał, który jest właścicielem danych. Asystent to jedna z dróg wejścia, obok biura i formularza na stronie. Zgłoszenia, wizyty i historia żyją w platformie, gdzie ludzie je przeglądają i poprawiają.
- Zapytania do bazy rozsiane po całym kodzie. Trzymaj je w jednej warstwie danych, wtedy zamiana SQLite na większą bazę to jedna zmiana.
Następny krok
Na jednej stronie zapisz, kto zapisuje każdy rodzaj rekordu, jak długo musi on przetrwać i które kanały tworzą nową pracę. Ta strona powie Ci, jakich warstw potrzebuje Twoja platforma. Jeśli wybierasz też, co zautomatyzować najpierw, zajrzyj do poradnika o tym, jak wybrać pierwszy proces dla agenta AI. Fundament, na którym te warstwy siadają, jest na stronie OpenThings.
Jeśli chcesz omówić stos dla swojej platformy, umów rozmowę na tej stronie i zacznij od warsztatu Discovery albo od strony głównej Rebels Software.