Moduł:StatystykiHistoryczne

Dokumentacja dla tego modułu może zostać utworzona pod nazwą Moduł:StatystykiHistoryczne/opis

local p = {}

-- =========================================================
-- MODUŁ: STATYSTYKIHISTORYCZNE
--
-- Łączne statystyki zawodników ze wszystkich
-- wprowadzonych sezonów.
--
-- KOSZYKÓWKA
--
-- Tabele:
-- 1. Mecze
-- 2. Punkty
-- 3. Minuty
-- 4. Asysty
-- 5. Zbiórki
-- 6. Bloki
--
-- Użycie:
--
-- {{#invoke:StatystykiHistoryczne|main
-- |druzyna=Enea Basket Poznań
-- |sezon_biezacy=2025/2026
-- }}
--
-- Zawodnicy występujący w ostatnim wprowadzonym
-- sezonie są wyróżniani pogrubieniem.
--
-- Jeżeli podany sezon bieżący nie ma jeszcze danych,
-- automatycznie używany jest ostatni sezon obecny
-- w bazie.
-- =========================================================


function p.main(frame)

    -- =====================================================
    -- PARAMETRY
    -- =====================================================

    local druzyna =
        mw.text.trim(
            frame.args.druzyna or ""
        )

    local sezonBiezacy =
        mw.text.trim(
            frame.args.sezon_biezacy or ""
        )


    -- =====================================================
    -- SPRAWDZENIE DRUŻYNY
    -- =====================================================

    if druzyna == "" then

        return
            "'''Błąd:''' nie podano parametru <code>druzyna</code>."

    end


    -- =====================================================
    -- BEZPIECZNE PRZYGOTOWANIE NAZW
    -- =====================================================

    local druzynaSQL =
        mw.ustring.gsub(
            druzyna,
            "'",
            "''"
        )


    local sezonSQL = ""

    if sezonBiezacy ~= "" then

        sezonSQL =
            mw.ustring.gsub(
                sezonBiezacy,
                "'",
                "''"
            )

    end


    -- =====================================================
    -- FUNKCJA LICZBOWA
    -- =====================================================

    local function liczba(value)

        return
            tonumber(value or 0)
            or 0

    end


    -- =====================================================
    -- USTALENIE SEZONU REFERENCYJNEGO
    --
    -- 1. Jeżeli podany sezon ma jakiekolwiek wpisy
    --    dla drużyny, używamy tego sezonu.
    --
    -- 2. Jeżeli nie ma w nim żadnych wpisów,
    --    szukamy ostatniego sezonu obecnego w bazie.
    --
    -- UWAGA:
    -- Nie sprawdzamy tutaj minuty > 0.
    -- Sam fakt istnienia wpisu w UdzialZawodnika
    -- oznacza, że zawodnik jest wpisany do danego sezonu.
    -- =====================================================

    local sezonWyroznienia = ""
    local znalezionoBiezacy = false


    -- =====================================================
    -- SPRAWDZENIE PODANEGO SEZONU
    -- =====================================================

    if sezonSQL ~= "" then

        local sprawdzenieSezonu =
            mw.ext.cargo.query(
                "UdzialZawodnika,Mecze",

                "UdzialZawodnika.zawodnik=zawodnik",

                {
                    join =
                        "UdzialZawodnika.mecz=Mecze.id",

                    where =
                        "UdzialZawodnika.druzyna='"
                        .. druzynaSQL
                        .. "'"
                        .. " AND Mecze.sezon='"
                        .. sezonSQL
                        .. "'",

                    groupBy =
                        "UdzialZawodnika.zawodnik",

                    limit = 5000
                }
            )


        if sprawdzenieSezonu
            and #sprawdzenieSezonu > 0 then

            sezonWyroznienia = sezonBiezacy
            znalezionoBiezacy = true

        end

    end


    -- =====================================================
    -- JEŻELI BRAK DANYCH DLA PODANEGO SEZONU
    -- SZUKAMY OSTATNIEGO WPROWADZONEGO SEZONU
    -- =====================================================

    if not znalezionoBiezacy then

        local sezony =
            mw.ext.cargo.query(
                "UdzialZawodnika,Mecze",

                "Mecze.sezon=sezon",

                {
                    join =
                        "UdzialZawodnika.mecz=Mecze.id",

                    where =
                        "UdzialZawodnika.druzyna='"
                        .. druzynaSQL
                        .. "'",

                    groupBy =
                        "Mecze.sezon",

                    orderBy =
                        "Mecze.sezon DESC",

                    limit = 100
                }
            )


        if sezony and #sezony > 0 then

            sezonWyroznienia =
                mw.text.trim(
                    sezony[1].sezon or ""
                )

        end

    end


    -- =====================================================
    -- POBRANIE ŁĄCZNYCH DANYCH STATYSTYCZNYCH
    -- =====================================================

    local fields = table.concat({

        "UdzialZawodnika.zawodnik=zawodnik",

        "COUNT(UdzialZawodnika.mecz)=mecze",

        "SUM(UdzialZawodnika.gol)=punkty",

        "SUM(UdzialZawodnika.minuty)=minuty",

        "SUM(UdzialZawodnika.asysta)=asysty",

        "SUM(UdzialZawodnika.zbiorka)=zbiorki",

        "SUM(UdzialZawodnika.blok)=bloki"

    }, ",")


    -- =====================================================
    -- WARUNEK
    -- =====================================================

    local where =
        "UdzialZawodnika.druzyna='"
        .. druzynaSQL
        .. "'"


    -- =====================================================
    -- ZAPYTANIE
    -- =====================================================

    local rows =
        mw.ext.cargo.query(
            "UdzialZawodnika",
            fields,
            {
                where = where,

                groupBy =
                    "UdzialZawodnika.zawodnik",

                limit = 5000
            }
        )


    -- =====================================================
    -- BRAK DANYCH
    -- =====================================================

    if not rows or #rows == 0 then

        return
            "''Brak danych statystycznych dla drużyny "
            .. druzyna
            .. ".''"

    end


    -- =====================================================
    -- AKTUALNI / OSTATNI ZAWODNICY
    --
    -- Zawodnik jest wyróżniony, jeżeli ma wpis
    -- w sezonie referencyjnym.
    --
    -- Nie wymagamy minuty > 0.
    -- =====================================================

    local aktualni = {}


    if sezonWyroznienia ~= "" then

        local sezonAktualnySQL =
            mw.ustring.gsub(
                sezonWyroznienia,
                "'",
                "''"
            )


        local currentRows =
            mw.ext.cargo.query(
                "UdzialZawodnika,Mecze",

                "UdzialZawodnika.zawodnik=zawodnik",

                {
                    join =
                        "UdzialZawodnika.mecz=Mecze.id",

                    where =
                        "UdzialZawodnika.druzyna='"
                        .. druzynaSQL
                        .. "'"
                        .. " AND Mecze.sezon='"
                        .. sezonAktualnySQL
                        .. "'",

                    groupBy =
                        "UdzialZawodnika.zawodnik",

                    limit = 5000
                }
            )


        if currentRows then

            for _, row in ipairs(currentRows) do

                local zawodnik =
                    mw.text.trim(
                        row.zawodnik or ""
                    )


                if zawodnik ~= "" then

                    aktualni[zawodnik] = true

                end

            end

        end

    end


    -- =====================================================
    -- PRZYGOTOWANIE DANYCH
    -- =====================================================

    local zawodnicy = {}


    for _, row in ipairs(rows) do

        local zawodnik =
            mw.text.trim(
                row.zawodnik or ""
            )


        if zawodnik ~= "" then

            table.insert(
                zawodnicy,
                {

                    zawodnik = zawodnik,

                    mecze =
                        liczba(row.mecze),

                    punkty =
                        liczba(row.punkty),

                    minuty =
                        liczba(row.minuty),

                    asysty =
                        liczba(row.asysty),

                    zbiorki =
                        liczba(row.zbiorki),

                    bloki =
                        liczba(row.bloki),

                    aktualny =
                        aktualni[zawodnik] or false

                }
            )

        end

    end


    -- =====================================================
    -- FORMATOWANIE MINUT
    --
    -- Cargo przechowuje wartość jako SEKUNDY.
    --
    -- Przykład:
    --
    -- 103775 sekund
    -- = 1729 minut i 35 sekund
    -- = 1729:35
    --
    -- Format:
    -- MM:SS
    --
    -- Pierwsza część NIE jest ograniczona do 59.
    -- =====================================================

    local function formatujMinuty(sekundy)

        local wartosc =
            tonumber(sekundy or 0)
            or 0


        wartosc =
            math.floor(
                wartosc + 0.5
            )


        local caleMinuty =
            math.floor(
                wartosc / 60
            )


        local pozostaleSekundy =
            wartosc % 60


        return string.format(
            "%d:%02d",
            caleMinuty,
            pozostaleSekundy
        )

    end


    -- =====================================================
    -- LINK DO ZAWODNIKA
    -- =====================================================

    local function linkZawodnika(row)

        local nazwa =
            row.zawodnik


        local tekst =
            "[["
            .. nazwa
            .. "|"
            .. nazwa
            .. "]]"


        -- -------------------------------------------------
        -- ZAWODNIK Z SEZONU REFERENCYJNEGO
        -- -------------------------------------------------

        if row.aktualny then

            tekst =
                "'''"
                .. tekst
                .. "'''"

        end


        return tekst

    end


    -- =====================================================
    -- SORTOWANIE
    -- =====================================================

    local funkcjeSortowania = {

        mecze = function(a, b)

            if a.mecze ~= b.mecze then

                return a.mecze > b.mecze

            end

            return a.zawodnik < b.zawodnik

        end,


        punkty = function(a, b)

            if a.punkty ~= b.punkty then

                return a.punkty > b.punkty

            end

            return a.zawodnik < b.zawodnik

        end,


        minuty = function(a, b)

            if a.minuty ~= b.minuty then

                return a.minuty > b.minuty

            end

            return a.zawodnik < b.zawodnik

        end,


        asysty = function(a, b)

            if a.asysty ~= b.asysty then

                return a.asysty > b.asysty

            end

            return a.zawodnik < b.zawodnik

        end,


        zbiorki = function(a, b)

            if a.zbiorki ~= b.zbiorki then

                return a.zbiorki > b.zbiorki

            end

            return a.zawodnik < b.zawodnik

        end,


        bloki = function(a, b)

            if a.bloki ~= b.bloki then

                return a.bloki > b.bloki

            end

            return a.zawodnik < b.zawodnik

        end

    }


    -- =====================================================
    -- DEFINICJA TABEL
    -- =====================================================

    local tabele = {

        {
            nazwa = "MECZE",
            pole = "mecze",

            format = function(v)

                return tostring(v)

            end
        },


        {
            nazwa = "PUNKTY",
            pole = "punkty",

            format = function(v)

                return tostring(v)

            end
        },


        {
            nazwa = "MINUTY",
            pole = "minuty",

            format = function(v)

                return formatujMinuty(v)

            end
        },


        {
            nazwa = "ASYSTY",
            pole = "asysty",

            format = function(v)

                return tostring(v)

            end
        },


        {
            nazwa = "ZBIÓRKI",
            pole = "zbiorki",

            format = function(v)

                return tostring(v)

            end
        },


        {
            nazwa = "BLOKI",
            pole = "bloki",

            format = function(v)

                return tostring(v)

            end
        }

    }


    -- =====================================================
    -- BUDOWANIE POJEDYNCZEJ TABELI
    -- =====================================================

    local function zbudujTabele(definicja)

        local lista = {}


        for _, zawodnik in ipairs(zawodnicy) do

            table.insert(
                lista,
                zawodnik
            )

        end


        table.sort(
            lista,
            funkcjeSortowania[
                definicja.pole
            ]
        )


        local wynik = {}


        -- -------------------------------------------------
        -- POCZĄTEK TABELI
        -- -------------------------------------------------

        table.insert(
            wynik,
            '{| class="wikitable" style="width:100%; text-align:center;"'
        )


        -- -------------------------------------------------
        -- TYTUŁ
        -- -------------------------------------------------

        table.insert(
            wynik,
            "|+ '''"
            .. definicja.nazwa
            .. "'''"
        )


        -- -------------------------------------------------
        -- NAGŁÓWKI
        -- -------------------------------------------------

        table.insert(
            wynik,
            "! Miejsce !! Zawodnik !! "
            .. definicja.nazwa
        )


        -- -------------------------------------------------
        -- WIERSZE
        -- -------------------------------------------------

        for i, zawodnik in ipairs(lista) do

            table.insert(
                wynik,
                "|-"
            )


            table.insert(
                wynik,
                "| "
                .. i