Przegląd GDScript w Godot dla gier niezależnych

Co robi kod

1. Wczytuje orders.csv z eksportu sklepu.
2. Dla każdej pozycji zamówienia znajduje produkt po SKU w stock.xlsx i odejmuje ilość.
3. Zapisuje zaktualizowane stany i loguje sumy do import_log.txt.

Struktura jest czytelna, a funkcje dobrze nazwane. Większość problemów dotyczy danych wejściowych, które wyglądają inaczej, niż zakłada skrypt.

Błędy i słabe punkty

#	Linia	Waga	Problem
1	48	Wysoka	Ten sam CSV można zaimportować dwa razy; brak sprawdzania już przetworzonych ID zamówień. To najbardziej prawdopodobna przyczyna ujemnych stanów.
2	72	Wysoka	int(row["qty"]) wywala się na pustych wartościach lub "2.0" przy zamówieniach ze zwrotem.
3	95	Średnia	Wyszukiwanie SKU rozróżnia wielkość liter: "gt-101" i "GT-101" to dla skryptu różne produkty.
4	130	Średnia	Plik otwierany jest bez encoding="utf-8", więc w Windowsie psują się nazwy z polskimi znakami.
5	201	Niska	Gołe except: ukrywa prawdziwe błędy i sprawia, że log jest bezużyteczny.

Poprawione fragmenty

Problem 1: pomijanie już zaimportowanych zamówień

processed = load_processed_ids("processed_orders.txt")
for row in reader:
    if row["order_id"] in processed:
        continue
    # ... dotychczasowa logika ...
    processed.add(row["order_id"])
save_processed_ids("processed_orders.txt", processed)

Dlaczego: każde zamówienie jest uwzględniane raz, nawet jeśli uruchomisz skrypt ponownie na tym samym pliku.

Problem 2: bezpieczne odczytanie ilości

raw = (row.get("qty") or "").strip()
try:
    qty = int(float(raw))
except ValueError:
    log.warning("Zamówienie %s: błędna ilość %r, pominięto", row["order_id"], raw)
    continue

Dlaczego: pozycje zwrócone lub częściowe są pomijane z czytelną adnotacją, zamiast zatrzymywać cały import.

Problem 3: normalizacja SKU

sku = row["sku"].strip().upper()

To samo .strip().upper() zastosuj przy budowaniu słownika stanów.

Styl i czytelność

• process() ma 90 linii; podziel ją na read_orders, apply_to_stock, write_report.
• Zastąp "magiczne" numery kolumn (row[7]) nazwami nagłówków.

Przetestuj każdą poprawkę na kopii plików: przeczytaliśmy kod, ale go nie uruchamialiśmy.