Projekt semestralny

Projekt semestralny to pełnoprawna aplikacja webowa, którą tworzysz wspólnie z partnerem. W przeciwieństwie do miniprojektu, masz większy zakres funkcjonalności, ale też wsparcie drugiej osoby i możliwość podziału zadań.

Element	A (3.0)	B (4.0-5.0)	C (5.0-6.0)
Formularz HTML	✓	✓	✓
Walidacja PHP	✓	✓	✓
Zapis do JSON/TXT	✓	✓	✓
Odczyt i wyświetlanie	✓	✓	✓
Podstawowy CSS	✓	✓	✓
Min. 2 elementy JS	✓	✓	✓
README.md	✓	✓	✓
Historia operacji (log)		✓	✓
Filtrowanie / sortowanie		✓	✓
Podział na pliki PHP		✓	✓
Komunikaty sukcesu / błędu		✓	✓
Rozbudowana walidacja		✓	✓
Sesje PHP		✓	✓
System ról (admin/user)			✓
Autoryzacja (hasła hashowane)			✓
MVC-lite			✓
Raporty i statystyki			✓
Zaawansowana walidacja biznesowa			✓

1. Dobierzcie się w zespół (2 osoby)

2. Otrzymajcie temat (losowanie przez nauczyciela)

3. Zadeklarujcie wariant (A, B lub C)

4. Zaplanujcie strukturę aplikacji

   • Jakie formularze i widoki?
   • Jakie dane i ich struktura?
   • Jak podzielicie pracę?
   • Jaki harmonogram?

5. Podzielcie zadania

   • Kto robi co?
   • Jak będziecie synchronizować kod?
   • Kiedy spotkania robocze?

6. Zaimplementujcie funkcjonalność

   • Zacznijcie od struktury i formularzy
   • Dodajcie walidację PHP
   • Zaimplementujcie zapis/odczyt
   • Dodajcie JavaScript
   • Integrujcie swoje części

7. Przetestujcie projekt

   • Sprawdźcie wszystkie scenariusze
   • Przetestujcie błędne dane
   • Sprawdźcie na innym komputerze
   • Upewnijcie się, że działa bez Waszego środowiska

8. Przygotujcie dokumentację

   • README.md z opisem projektu
   • Instrukcja uruchomienia
   • Opis podziału pracy
   • Wybrany wariant

9. Oddajcie w terminie

   • Spakujcie do .zip
   • Nazwa: [KLASA]_projekt_[temat]_[nazwisko1]-[nazwisko2].zip

• Folderprojekt-semestralny/

  • index.php - strona główna
  • README.md - dokumentacja projektu
  • Folderdata/

    • dane.json - główny plik z danymi
    • historia.json - log operacji (dla B/C)
  • Folderlib/

    • functions.php - funkcje pomocnicze
    • validation.php - walidacja (dla B/C)
  • Folderviews/

    • header.php - nagłówek strony
    • footer.php - stopka strony
    • formularz.php - widok formularza
    • lista.php - widok listy danych
  • Foldercss/

    • style.css - style główne
  • Folderjs/

    • app.js - skrypty JavaScript

Kryterium	Punkty	Co to znaczy?
Realizacja wymagań	35	Czy aplikacja działa zgodnie z tematem i wariantem?
Poprawność kodu	20	Czy kod jest czytelny, logiczny, bez błędów?
Walidacja i bezpieczeństwo	15	Czy dane są walidowane? Czy output jest zabezpieczony?
JavaScript	10	Czy są min. 2 sensowne elementy JS?
Dokumentacja (README)	10	Czy README jest kompletne i pomocne?
Współpraca w zespole	10	Czy podział pracy był sprawiedliwy? Czy obaj rozumieją kod?
SUMA	100

Jak dobrze współpracować?

Komunikacja:

• Ustalcie sposób komunikacji (Discord, Teams, spotkania na żywo)
• Regularnie informujcie się o postępach
• Mówcie o problemach od razu - nie ukrywajcie ich

Podział pracy:

• Podzielcie funkcjonalności sprawiedliwie
• Każdy powinien pisać zarówno PHP jak i JS
• Nie dzielcie na “backend” i “frontend” - to zbyt niski poziom projektu

Integracja:

• Ustalcie wspólną strukturę plików od początku
• Synchronizujcie kod regularnie
• Testujcie razem przed oddaniem

• Dobry podział
• Zły podział

Osoba A:

• Formularz dodawania + walidacja
• Zapis do pliku
• JavaScript: podgląd na żywo

Osoba B:

• Lista/wyświetlanie danych
• Filtrowanie/sortowanie
• JavaScript: potwierdzenia akcji

Wspólnie:

• Struktura projektu
• Styl CSS
• README
• Testowanie

Wykorzystajcie cotygodniowe lekcje!

Nie czekajcie do ostatniego dnia! Podczas każdej lekcji możecie:

1. Pokazać postępy - nawet mały fragment kodu
2. Zadać pytania - wyjaśnić wątpliwości
3. Skonsultować rozwiązanie - uzyskać feedback
4. Przetestować - sprawdzić czy działa na innym komputerze
5. Zintegrować kod - połączyć swoje części

1. Tydzień 1-2: Otrzymanie tematu, planowanie, podział pracy, struktura projektu

2. Tydzień 3-4: Implementacja wariantu A (podstawowa funkcjonalność)

3. Tydzień 5-6: Rozbudowa o wariant B (jeśli wybraliście), integracja kodu

4. Tydzień 7: Funkcje wariantu C (jeśli celujecie wysoko), dopracowanie

5. Tydzień 8: Testowanie, dokumentacja, przygotowanie do obrony

• Zapoznaj się z zasadami ogólnymi i wzorcową strukturą
• Przejrzyj 20 tematów do losowania
• Sprawdź checklistę przed oddaniem projektu