Dokumentacja AI-CARGO

Kompletny przewodnik po platformie AI-CARGO — pierwszym na świecie autopilocie w logistyce. Dowiedz się, jak korzystać z modułów, integracji i narzędzi AI.

Szybki start

Aby rozpocząć pracę z AI-CARGO:

1. Zarejestruj się — utwórz konto na stronie rejestracji
2. Zaloguj się — użyj adresu email i hasła
3. Przejdź do Dashboard — zobaczysz główny panel z podsumowaniem
4. Skonfiguruj firmę — dodaj dane firmy w Ustawieniach

AI-CARGO automatycznie przetwarza przychodzące emaile z zleceniami transportowymi. Wystarczy przekierować emaile na dedykowany adres.

Architektura

Platforma zbudowana jest na nowoczesnym stosie technologicznym:

Zlecenia

Modul zleceń to serce platformy. Obsługuje 93 kolumny danych na zlecenie transportowe, z pełną wirtualizacją kolumn dla wydajności.

Widoki

• Tabela — DataTable z 93 kolumnami, edycja inline, context menu, sortowanie i filtrowanie
• Karty — lista kart z rozwijanym akordeonem, smooth scroll

Funkcje

• Infinite scroll z paginacją server-side
• Filtrowanie po statusie, kontrahencie, porcie załadunku
• Wyszukiwanie globalne w 12 polach
• Edycja komórek inline (klik na komórkę)
• Context menu z akcjami

Flota i mapa

Modul floty pokazuje pojazdy na mapie w czasie rzeczywistym dzięki integracji z GBOX GPS. Dane odświeżane co 60 sekund.

• Mapa MapLibre GL z pozycjami pojazdów
• Clustery dla dużej liczby pojazdów
• Panel szczegółów pojazdu (kierowca, prędkość, status)
• Historia tras i pozycji

Komunikacja

Moduł komunikacji w stylu ClickUp — kanały z drzewkiem obiektów, wiadomości, dokumenty i tabele w jednym miejscu.

• Kanały z typami wiadomości (Message, Ogłoszenie, Pomysł, Aktualizacja)
• Tryb dokumentu w kanale z autozapisem
• Wbudowany arkusz kalkulacyjny
• Emoji picker i @wzmianki

Dokumenty

Edytor dokumentów oparty na TipTap z pełnym formatowaniem prose, slash commands (/), @wzmiankami i asystentem AI (Ctrl+J).

• Dokumenty i Wiki z folderami
• Szablony (Raport, Procedura, Notatka, Instrukcja, Checklist)
• Autozapis co 1.2 sekundy
• Historia wersji (snapshot co 5 minut)
• Udostępnianie przez link
• Eksport HTML i Markdown

Raporty

Automatyczne i ręczne raporty z danymi z platformy. Edycja inline typu, statusu, częstotliwości i formatu.

Kalendarz

Widoki Dzień, Tydzień i Miesiąc. Klik na pusty dzień otwiera dialog dodawania. Sheet podgląd wydarzeń dnia.

OCR i ekstrakcja danych

Pipeline automatycznego przetwarzania emaili z zleceniami:

1. Email odebrany — Resend webhook z weryfikacją Svix signature
2. Załączniki PDF — filtrowanie po MIME type, wykluczenie sygnatur
3. Mistral OCR — konwersja PDF na markdown (mistral-ocr-latest)
4. Gemini AI — ekstrakcja pól i mapowanie na kolumny orders.*
5. Zapis zlecenia — INSERT do bazy z statusem „przetwarzanie"

Asystent AI

Wbudowany czat AI dostępny na każdej stronie dashboardu. Obsługuje pytania o zlecenia, generowanie treści, tłumaczenia i analizę dokumentów.

• Kontekst rozmowy z historią
• Załączniki PDF/JPG/PNG/TXT
• Akcje w edytorze: kontynuuj, uprość, rozszerz, popraw gramatykę, tłumacz

Automatyczne przetwarzanie

System automatycznie generuje raporty przetworzenia zlecenia w formacie Markdown, zapisywane w katalogu zlecenia w Supabase Storage.

GBOX GPS (INELO)

Integracja z systemem GBOX firmy INELO do śledzenia pojazdów. Pozycje GPS synchronizowane do tabel vehicle_positions_live (aktualne) i vehicle_positions_points (historia).

Email (Resend)

Przychodzące emaile przetwarzane przez Resend Inbound webhook. Weryfikacja signature Svix, ekstrakcja załączników i treści, automatyczne tworzenie zleceń.

API

Endpointy REST w /api/ obsługujące wszystkie operacje platformy. Kluczowe endpointy chronione przez Vercel BotID (invisible CAPTCHA).