Skip to content
alekajiya
Open menu
All projects

Panel SMS: powiadomienia wysyłane z przeglądarki

3 min readProgramowanie

Nakładka WWW na moją bramkę SMS: wysyłka do numerów, kontaktów i grup, wysyłka zaplanowana, rozmowy, wspólna skrzynka i zapisy na powiadomienia z potwierdzeniem kodem SMS. Jeden kod działa w dwóch instancjach, każda z własną kartą SIM i wyglądem.

Technologies

  • Astro 7 SSR
  • TypeScript
  • Tailwind v4
  • DaisyUI v5
  • Lucide
  • PostgreSQL 16
  • Redis 7
  • Docker

Moja bramka SMS ma API dla systemów, ale ludzie potrzebują czegoś prostszego. Chcą wpisać numer albo wybrać grupę, napisać treść i zobaczyć, czy wiadomość doszła.

Tak powstał panel SMS, aplikacja WWW nałożona na bramkę. Nie rozmawia z modemem bezpośrednio, tylko z API bramki. Klucz API zna wyłącznie serwer panelu, a sama bramka jest dostępna tylko z sieci lokalnej.

Pulpit panelu SMS z powitaniem Dzień dobry, przyciskami Wyślij SMS, Rozmowy i Kontakty, kafelkami z dzisiejszym ruchem i stanem bramki: działa, sygnał 70 procent, karta SIM1, sieć zarejestrowana(enlarge)
Pulpit panelu: ruch z dzisiaj i stan bramki

Jeden kod, dwie instancje

Panel działa w dwóch miejscach: jako moja prywatna instancja i jako instancja instytucji, z jej znakiem i kolorami. Każda jest osobnym klientem bramki, z własną kartą SIM, kluczem API i webhookiem.

Nazwę, właściciela, wygląd startowy i połączenie z bramką opisuje plik konfiguracyjny instancji. Nowa wersja to tag w repozytorium, a obie instancje pobierają go same.

Wysyłka

Formularz wysyłki łączy kilka źródeł odbiorców i od razu pokazuje koszt w SMS-ach:

  • numery wpisane ręcznie, kontakty i całe grupy w dowolnym połączeniu, bez powtórzeń,
  • licznik znaków i części liczony tak samo jak w bramce, najwyżej 10 części,
  • wysyłka od razu albo w wybranym terminie, z możliwością anulowania,
  • postęp na żywo: czeka, wysłano, doręczono, nieudane,
  • ponowienie wysyłki tylko do odbiorców, do których się nie udało.

Polskie litery skracają SMS ze 160 do 70 znaków. Panel ostrzega o tym pod polem treści, więc łatwo zdecydować, czy warto pisać bez ogonków.

Formularz Wyślij SMS z polami na numery telefonów i treść, licznikiem znaków i części, nazwą wysyłki, wyborem Od razu albo W wybranym terminie oraz podsumowaniem liczby odbiorców i SMS-ów(enlarge)
Formularz wysyłki z licznikiem części i wyborem terminu

Rozmowy i wspólna skrzynka

Instancja ma jeden numer, więc skrzynka i rozmowy są wspólne dla wszystkich użytkowników. Archiwum i kosz każdy porządkuje dla siebie. Rozmowy grupują wiadomości według numeru i pozwalają odpowiedzieć z wątku.

Statusy wiadomości przychodzą z bramki podpisanym webhookiem. Gdy webhooka nie ma, panel co 30 sekund sprawdza historię bramki. Status może tylko rosnąć, więc spóźnione zdarzenie nie cofnie „doręczono” do „wysłano”.

Skrzynka z zakładkami Odebrane, Wysłane, Zaplanowane, Archiwum i Kosz, wyszukiwarką oraz przyciskami Do archiwum i Do kosza, na liście jedna wysłana wiadomość z rozmytym numerem(enlarge)
Skrzynka z folderami i wyszukiwaniem

Książka adresowa

Kontakty i grupy mogą być prywatne albo wspólne. Wspólne widzą wszyscy, a zmieniać je może autor albo administrator. Import i eksport CSV obsługuje średnik, bo tak zapisuje Excel, i pomija numery, które już są w książce.

Strona Kontakty z wyszukiwarką, przyciskami Nowy kontakt i Eksport CSV, formularzem nowego kontaktu z polem Wspólny oraz importem z pliku CSV(enlarge)
Kontakty z formularzem i importem CSV

Zapisy na powiadomienia

Grupę można otworzyć na publiczne zapisy. Wtedy ma własną stronę, okienko do osadzenia na innej stronie WWW i proste API. Tak instytucja może zbierać numery osób, które chcą dostawać powiadomienia SMS.

  • numer zawsze potwierdza kod SMS, a treść zgody jest zapisywana razem z zapisem,
  • limity na numer, adres IP i grupę chronią przed nabijaniem kosztów,
  • wypisanie odpowiedzią STOP albo na stronie wypisu, z potwierdzeniem SMS.

Bezpieczeństwo

  • hasła argon2id i sesje w Redis,
  • obowiązkowa weryfikacja dwuetapowa: aplikacja albo kod SMS, do tego kody zapasowe,
  • limit prób logowania i blokada czasowa,
  • role administratora i użytkownika,
  • dziennik zdarzeń przechowywany 12 miesięcy.

Wygląd i dostępność

Panel ma siedem zestawów wyglądu: paletę kolorów, kroje pisma i kształty. Administrator wybiera zestaw w Ustawieniach i od razu widzi podgląd w trybie jasnym i ciemnym. Tryb i wielkość tekstu każdy użytkownik ustawia sam.

Interfejs jest projektowany pod WCAG 2.2 AA. Kontrast kolorów wszystkich zestawów sprawdza skrypt przed każdym wydaniem.

Ustawienia wyglądu: lista zestawów Grafit, Las, Cegła, Atrament, Noc, Malina i zestaw instytucji, obok podgląd wybranego zestawu w trybie jasnym i ciemnym, niżej połączenie z bramką(enlarge)
Wybór zestawu wyglądu z podglądem w obu trybach

Statystyki

Statystyki pokazują wysłane wiadomości i części, skuteczność i średni czas doręczenia oraz szacunkowy koszt. Wykresy mają obok tabelę z danymi, czytelną także dla czytników ekranu. Dostępność bramki panel mierzy sam co 30 sekund.

Dobra wysyłka SMS nie kończy się na przycisku Wyślij. Ważne jest to, co dzieje się potem: czy wiadomość doszła, kto odpisał i czy ktoś chce się wypisać.
Aleksander Kowal

Stack

  • Astro 7 z renderowaniem po stronie serwera i własnym API,
  • TypeScript, Tailwind v4, DaisyUI v5 i ikony Lucide,
  • PostgreSQL 16 i Redis 7,
  • Docker, wdrożenie z tagu w repozytorium.

Was this useful?

New posts by e-mail

Every now and then, when a new post or project goes up. No ads.

Got an idea, a question or a comment? Write to me:Enable JavaScript to see the e-mail address

Comments

No comments yet. Be the first.

Click or scroll to zoom in. Drag to move around.Double tap or pinch to zoom in.

More projects

Local law register: five thousand acts in one search engine

Orders and resolutions were scattered across the BIP public information bulletin, signed packages from the document management system, a network drive and a paper archive. I built a register that joins these sources, shows each act's status, electronic signature and Official Journal publication, and points out gaps in the numbering.

SMS panel: notifications sent from the browser

A web front end for my SMS gateway: sending to numbers, contacts and groups, scheduled sending, conversations, a shared inbox and notification sign-ups confirmed with an SMS code. One codebase runs as two instances, each with its own SIM card and look.

My own SMS gateway: a GSM modem, two SIM cards and an API for many systems

My systems send text messages about interrupted streams, failing information boards and changes spotted by backups. Instead of paying for a commercial gateway, I built my own: a Quectel M95 modem, two SIM cards, a Python API, signed webhooks, delivery reports and a panel with two-factor login.