Omówienie starego koduSzkolenia z programowania

Omówienie odziedziczonego starego kodu z komentarzami

Realizacja od 1 dniaPoprawki w cenieKontrola jakości
Pakiety
Ochrona płatnościSzczegóły
  • Poprawki w ramach pakietu są bezpłatne.
  • Jeśli nie odpowiesz w ciągu 3 dni od dostarczenia pracy, zostanie ona zaakceptowana automatycznie.
Zamów · 32 €

Pieniądze są rezerwowane w chwili płatności i przekazywane dopiero po akceptacji pracy.

Omówienie odziedziczonego starego kodu z komentarzami

Przykładowy rezultat

Przykład dla pakietu Standard

Przegląd kodu: skrypt Python do importu zamówień dla małego sklepu internetowego

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

#LiniaWagaProblem
148WysokaTen sam CSV można zaimportować dwa razy; brak sprawdzania już przetworzonych ID zamówień. To najbardziej prawdopodobna przyczyna ujemnych stanów.
272Wysokaint(row["qty"]) wywala się na pustych wartościach lub "2.0" przy zamówieniach ze zwrotem.
395ŚredniaWyszukiwanie SKU rozróżnia wielkość liter: "gt-101" i "GT-101" to dla skryptu różne produkty.
4130ŚredniaPlik otwierany jest bez encoding="utf-8", więc w Windowsie psują się nazwy z polskimi znakami.
5201NiskaGoł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.

Klient: właściciel sklepu z herbatą, który napisał 310-liniowy skrypt Python importujący zamówienia z eksportu CSV do arkusza stanów magazynowych Zgłoszony problem: "Czasem stany schodzą poniżej zera, a przy niektórych plikach skrypt się wysypuje."

Klient i wszystkie dane są wymyślone.

O usłudze

Gdy przejmujesz kod po programiście, który odszedł, pierwszym zadaniem jest go zrozumieć: co robi każda część, które elementy od siebie zależą i których linii nikt nie powinien ruszać bez ostrożności. Czytamy wklejony kod, wyjaśniamy go prostymi słowami sekcja po sekcji i piszemy komentarze, które możesz dodać do plików. Zaznaczamy też martwy kod, ukryte efekty uboczne i ryzykowne miejsca, żebyś wiedział, gdzie uważać, zanim cokolwiek zmienisz.

Co obejmuje usługa

  • Co otrzymujeszPisemne omówienie na stronie zamówienia: mapa głównych funkcji i ich powiązań, proste wyjaśnienia, komentarze gotowe do wklejenia i lista ryzykownych miejsc z proponowanymi poprawkami. W pakiecie Premium także bezpieczna kolejność porządkowania kodu krok po kroku.
  • Mapa koduGłówne funkcje i ich powiązania
  • Proste wyjaśnieniaSekcja po sekcji
  • Gotowe komentarzeDo wklejenia w plikach
  • Ryzykowne miejscaEfekty uboczne, martwy kod, magiczne liczby
  • Proponowane poprawkiPoprawione fragmenty tam, gdzie trzeba

Jak to działa

  1. 1
    BriefWklejasz kod i opisujesz cel
  2. 2
    LekturaMapujemy i wyjaśniamy kod
  3. 3
    OmówienieOtrzymujesz wyjaśnienia i komentarze

Czego potrzebujemy od Ciebie

Odziedziczony kod wklejony jako tekst lub zrzuty ekranu, język i jego wersja, do czego służy system i co wkrótce musisz w nim zmienić.

Zapytamy Cię:

  • W jakim języku i wersji jest kod?
  • Co system robi dla twojej firmy?
  • Co musisz wkrótce zmienić lub dodać?
  • Czy jest jakaś dokumentacja lub notatki od poprzedniego programisty?

Porównaj pakiety

PakietyPodstawowyKod do 100 linii14 €StandardKod do 400 linii32 €PremiumDo 1000 linii z kolejnością porządkowania62 €
Termin1 dzień2 dni3 dni
Poprawki123
Linie kodudo 100do 400do 1000
Poprawione fragmentyTakTakTak
Kolejność porządkowania krok po krokuNieNieTak
Zamów PodstawowyZamów StandardZamów Premium

Ochrona płatności

Płacisz przy składaniu zamówienia, ale pieniądze są przekazywane tylko za zaakceptowaną pracę.

  • Stała cenaCena pakietu nie zmienia się po zapłacie.
  • Pieniądze są zarezerwowanePrzy płatności kwota jest tylko rezerwowana. Serwis otrzymuje ją dopiero po akceptacji pracy.
  • Sprawdzone przed dostarczeniemKażdy wynik przechodzi kontrolę jakości, zanim do Ciebie trafi, a przed akceptacją widzisz go na stronie zamówienia.
  • Bezpłatne poprawkiProś o poprawki w ramach briefu tyle razy, ile przewiduje pakiet.
  • Akceptacja po 3 dniachJeśli w ciągu 3 dni od dostarczenia pracy ani jej nie zaakceptujesz, ani nie poprosisz o poprawki, zostanie zaakceptowana automatycznie. Jeśli po dostarczeniu napiszesz na czacie zamówienia, zamówienie czeka; po naszej odpowiedzi możemy ponownie uruchomić odliczanie 3 dni i poinformujemy o tym na czacie.
  • Ponowne wykonanie lub pełny zwrot pieniędzyJeśli wynik nie odpowiada Twojemu briefowi, a poprawki tego nie naprawiły, lub praca trwa ponad dwa razy dłużej niż termin, napisz na czacie zamówienia: wykonamy pracę ponownie albo zwrócimy całą płatność.
Jak to działa →

Pytania i odpowiedzi

Czy uruchamiacie mój kod?

Nie. Uważnie go czytamy i analizujemy, jak się zachowuje, ale go nie uruchamiamy, więc przetestuj każdą proponowaną poprawkę we własnym projekcie.

Czy możecie przepisać go na nowoczesny język?

Ta usługa wyjaśnia i opisuje komentarzami twój kod oraz proponuje poprawki. Pełne przepisanie to osobny projekt programistyczny.

Kod jest bardzo stary. Czy to problem?

Nie. Stary PHP, makra VBA, klasyczne ASP i podobny kod to dokładnie to, do czego służy to omówienie.

Pakiety
Zamów · 32 €· 2 dni