Backend / Web App

System Geomonitoringu Cen Paliw

Aplikacja webowa dla kierowców do monitorowania cen na paliwa i AdBlue na stacjach. System wykorzystuje lokalizację GPS i mapę, aby pokazać stacje w pobliżu oraz informacje o nich.

Moja rola: Backend Developer

Baza danych: PostgreSQL (EF Core)

Backend: .NET 10 / ASP.NET Core Web API

Frontend: -

1. O projekcie i celach biznesowych

Tir-X to specjalistyczna aplikacja geomonitoringowa stworzona z myślą o sektorze transportu i logistyki (TSL) – kierowcach zawodowych, kurierach, spedytorach oraz zarządcach flot transportowych. Drastyczne wahania cen oleju napędowego (ON) oraz płynu AdBlue na trasach tranzytowych generują ogromne koszty operacyjne. Tir-X rozwiązuje ten problem poprzez geolokalizację GPS w czasie rzeczywistym oraz crowdsourcing – umożliwiając kierowcom wyszukiwanie najtańszych stacji w promieniu trasy i bieżącą weryfikację stawek paliwowych.

2. Zastosowana architektura (.NET 10 & Clean Architecture)

Część backendowa została zaprojektowana w oparciu o zasady Clean Architecture (Onion Architecture), gwarantując pełną separację logiki biznesowej od warstwy dostępu do danych i frameworka:

Podział warstwowy (Modular Monolith): Projekt podzielono na 5 niezależnych bibliotek: TirX.Domain (encje, enumy, czyste reguły domenowe), TirX.Application (kontrakty serwisów, DTO Request/Response), TirX.Infrastructure (implementacja EF Core, PgDbContext), TirX.Commons (klasy rozszerzeń) oraz TirX.API (kontrolery REST, autoryzacja).
Baza danych i EF Core: Relacyjna baza PostgreSQL zarządzana przez Entity Framework Core z automatycznym mechanizmem aplikowania migracji podczas startu aplikacji (Code-First) oraz centralną konfiguracją encji (Fluent API).
Bezpieczeństwo i produkcyjne JWT: Dwuetapowa konfiguracja uwierzytelniania JWT. Aplikacja posiada wbudowane zabezpieczenie, które w środowisku produkcyjnym blokuje start serwera, jeśli klucz sekretny nie został zdefiniowany w zmiennych środowiskowych.
Standaryzacja API: Pełna dokumentacja kontraktów REST udostępniona w środowisku deweloperskim poprzez interaktywny SwaggerUI (OpenAPI).

3. Kluczowe funkcjonalności

Geolokalizacja GPS & Mapa stacji: Filtrowanie i prezentacja stacji benzynowych w okolicy z podziałem na ceny poszczególnych paliw (ON, Pb95, Pb98, LPG) oraz AdBlue.
Crowdsourcing i walidacja cen: Moduł zgłaszania aktualnych cen przez kierowców w terenie z mechanizmem potwierdzania stawek przez pozostałych użytkowników (ochrona przed dezinformacją).
Zaawansowany system uprawnień (RBAC): Dedykowane uprawnienia dla kierowców, dyspozytorów flot oraz panel administracyjny do weryfikacji i edycji danych stacji.
Ergonomia pracy w trasie: Wsparcie dla trybu ciemnego (Dark Mode kluczowy dla kierowców jadących nocą), interfejs wielojęzyczny oraz pełna responsywność pod smartfony.