Pakiety PL/SQL

Logika biznesowa żyje w katalogu latest/package/ — ok. 381 plików (.pks specyfikacje + .pkb ciała), czyli ok. 190 pakietów. Poniżej mapa wg domen, konwencje i pakiety o największym ciężarze.

Konwencje nazewnictwa

Pakiety trzymają się kilku spójnych wzorców sufiksów/prefiksów:

Domeny biznesowe

Faktury i fakturowanie

• FAKTURA_TRA_PKG — rdzeń faktur transportowych (specyfikacja, KSeF, synchronizacja BSC).
• FAKTURY_PKG — faktury niekosztowe/transportowe, druk, wysyłka mailem, KSeF.
• FAKTURY_BSC_PKG, FAKTURA_WLSP_PKG (multi-company), SAMOFAKTUROWANIE_PKG.

KSeF (Krajowy System e-Faktur)

• KSEF_SEND_PKG, KSEF_SEND_BATCH_PKG, KSEF_SEND_ONLINE_PKG — wysyłka (wsadowa i online).
• KSEF_AUTH_PKG — autentykacja i tokeny.
• KSEF_INV_FETCH_PKG / KSEF_INV_FETCH_BATCH_PKG — pobieranie faktur zakupowych.
• KSEF_KOSZYK_PKG — koszyk faktur, dopasowanie do zleceń, korekty.
• KSEF_SEND_STATUS_PKG, KSEF_UTIL_PKG.

→ Pełny opis: Integracja KSeF.

Zlecenia transportowe

• NOWE_ZLECENIE_PKG — pełny cykl życia zlecenia (CRUD, towary, adresy, walidacje).
• ZLECENIE_GPS_PKG — routing, tracking, dystans.
• REALIZACJA_PKG, ZLECENIE_WERYFIKACJA_PKG, ZLECENIE_KOMUNIKACJA_PKG.

BBS — giełda/tablica ofert

• BBS_GUI_PKG — UI: rezerwacja, edycja, akceptacja ofert.
• BBS_NEGOCJACJE_PKG — negocjacje, renegocjacje, potwierdzenia.
• BBS_OFERTA_PKG, BBS_S_ADRESY_PKG, BBS_S_MIEJSCE_PKG.

Flota

• FLOTA_MOCKUP_PKG, FLOTA_GUI_PKG — pojazdy, naczepy, kierowcy.
• SAM_SAMOCHODY_PKG — koszty: amortyzacja, km, zużycie.
• FUEL_CARDS_PKG / KARTY_FLOTOWE_PKG, DZIERZAWY_PKG.

Kontrahenci i CRM

• KONTRAHENT_GUI_PKG, KONTRAHENT_PKG — wyszukiwanie, RODO, compliance (OCP, wadium), CRUD.
• ADRESY_PKG, PODMIOT_PKG, CRM_ZDARZENIA_PKG.

Windykacja

• WINDYKACJA_PKG — sprawy, przypisanie do operatora, statusy.
• RAPORT_WINDYKACJI_PKG, ZAJECIE_EGZEKUCYJNE_PKG.

Parametry finansowe i rozliczenia

• PARAM_FIN_PKG — taryfy, marża sekcji, saldo przewoźnika.
• FORWARD_FEE_PKG, ROZLICZENIA_WEW_PKG, SALDO_PRZEWOZNIK_PKG, KURSY_WALUT_PKG.

Integracje i synchronizacja

• KAMSOFT_SYNC_PKG — synchronizacja faktur do KAMSOFT.
• EVAN_API_WRAPPER_PKG — wrapper EVAN API (limity zapytań) wykorzystywany przez ORDS.
• GUS_API_PKG, KREPTD_API_PKG, TRANS_API_PKG.

Najcięższe / najbardziej centralne pakiety

Wzorce architektoniczne

• Warstwowość: UI (*_GUI_PKG) → logika/zapytania (*_MOCKUP_PKG, *_UTIL_PKG) → rdzeń domeny → dostęp do danych (f_get_*_row zwracające %rowtype).
• Batch: pakiety *_BATCH_PKG z procedurami typu p_create_proc, p_add_data, p_check_data, p_save_reports oraz tabelami *_PROC / *_DET / *_SUBPROC / *_CNF.
• Stan APEX: kolekcje (APEX_COLLECTION) i odczyt stanu sesji przez v('P...') / kontekst.
• Integracje: powtarzalny zestaw *_AUTH_PKG + *_SEND_PKG + *_FETCH_PKG + *_UTIL_PKG.
• Audyt: HISTORIA_ZMIAN_PKG (zmiany jako JSON, sterowane triggerami), REJESTR_NOT_PKG.