cmsPRO/.claude/commands/koniec-pracy.md

Wykonaj procedurę zakończenia pracy w projekcie cmsPRO. Wszystkie kroki wykonuj kolejno:

1. Testy

Uruchom php vendor/bin/phpunit. Jeśli testy nie przechodzą — napraw błędy przed kontynuowaniem.

2. Dokumentacja

Sprawdź czy zmiany wymagają aktualizacji:

• docs/PROJECT_STRUCTURE.md — struktura projektu, moduły, fazy refaktoryzacji
• docs/FORM_EDIT_SYSTEM.md — system formularzy (tylko jeśli zmiany dotyczyły formularzy)

Zaktualizuj tylko jeśli zmiany tego wymagają. Nie aktualizuj na siłę.

3. Migracje SQL

Jeśli były zmiany w bazie danych:

• Utwórz plik migrations/{version}.sql (np. migrations/1.694.sql)
• NIE w updates/ — build script sam wczyta z migrations/

4. Commit

Wykonaj git commit ze zmianami. Użyj konwencji z tego repo (patrz git log --oneline -5).

5. Paczka aktualizacji

Procedura budowania paczki:

a) Znajdź aktualną wersję w updates/versions.php ($current_ver = XXXX) b) Oblicz nową wersję: current_ver + 1 c) Zaktualizuj $current_ver w updates/versions.php na nową wartość d) Utwórz commit: build(update): paczka {wersja} — {krótki opis zmian} e) Utwórz git tag: git tag v{wersja} (format: v1.694, v1.695, ...) f) Uruchom build script:

powershell -ExecutionPolicy Bypass -File ./build-update.ps1 -FromTag v{poprzednia_wersja} -ToTag v{nowa_wersja} -ChangelogEntry "NEW - {opis zmian}"

g) Dodaj pliki paczki do ostatniego commita: git add updates/*/ver_{wersja}.* && git commit --amend

6. Push

Wykonaj git push && git push --tags. Jeśli auth fail (próbuj 3 razy, czasem jest błąd za pierwszym razem) — poinformuj użytkownika żeby uruchomił ! git push && git push --tags.

Podsumowanie

Na koniec wyświetl tabelkę:

Krok	Status
Testy	OK/FAIL
Dokumentacja	Zaktualizowana / Bez zmian
Migracje SQL	Utworzone / Nie dotyczy
Commit	hash
Paczka	ver_X.XXX.zip
Push	OK / Wymaga auth