Lekcja 27: Projekt koncowy - realizacja (3)

Finalizacja projektu - ostatni szlif

To ostatnia lekcja na prace nad kodem. Nastepna lekcja to prezentacje! Dzis skupiamy sie na: dopracowaniu detali, testowaniu i dokumentacji.

1. Czyszczenie kodu (Code Cleanup)

# PRZED - brudny kod:
def f(x):
    y=[]
    for i in range(len(x)):
        if x[i]%2==0:
            y.append(x[i])
    return y

# PO - czysty kod:
def filtruj_parzyste(liczby):
    """Zwraca liste zawierajaca tylko parzyste liczby."""
    parzyste = []
    for liczba in liczby:
        if liczba % 2 == 0:
            parzyste.append(liczba)
    return parzyste

2. Checklist przed oddaniem

• ☐ Program uruchamia sie bez bledow
• ☐ Wszystkie glowne funkcje dzialaja poprawnie
• ☐ Obsluga blednych danych wejsciowych (try/except, walidacja)
• ☐ Kod jest skomentowany i czytelny
• ☐ Kazda funkcja ma docstring
• ☐ Nazwy zmiennych i funkcji sa opisowe
• ☐ Brak zakomentowanego "smieci" kodu
• ☐ Brak tymczasowych print() do debugowania
• ☐ Dokumentacja jest napisana
• ☐ Prezentacja jest przygotowana

3. Szablon dokumentacji

"""
========================================
[TYTUL PROJEKTU]
========================================
Autor: [Imie i Nazwisko]
Klasa: III [litera]
Data: [data]
Jezyk: Python 3.x

OPIS:
[2-3 zdania opisujace, co robi program]

WYMAGANIA:
- Python 3.8 lub nowszy
- [wymagane biblioteki]

URUCHOMIENIE:
  python nazwa_programu.py

INSTRUKCJA UZYTKOWANIA:
1. [krok 1]
2. [krok 2]
3. [krok 3]

STRUKTURA PROJEKTU:
- nazwa_programu.py  - glowny plik programu
- dane.json          - plik z danymi
- wyniki.txt         - plik z wynikami
- README.txt         - dokumentacja

LISTA FUNKCJI:
- main()            - glowna funkcja programu
- wczytaj_dane()    - wczytuje dane z pliku
- przetworz()       - przetwarza dane
- zapisz_wyniki()   - zapisuje wyniki do pliku

ZNANE OGRANICZENIA:
- [ograniczenie 1]
- [ograniczenie 2]

MOZLIWE ROZWINIECIA:
- [pomysl na rozszerzenie 1]
- [pomysl na rozszerzenie 2]
========================================
"""

4. Przygotowanie prezentacji

Na nastepnej lekcji bedziesz prezentowal projekt. Przygotuj:

• Slajd 1: Tytul, autor, klasa
• Slajd 2: Cel projektu - jaki problem rozwiazuje?
• Slajd 3: Uzyte technologie i narzedzia
• Slajd 4-5: Demo programu (pokaz na zywo lub zrzuty ekranu)
• Slajd 6: Ciekawy fragment kodu
• Slajd 7: Wyzwania i czego sie nauczylem/am
• Slajd 8: Podsumowanie i mozliwosci rozwoju