Współtworzenie

Konfiguracja środowiska deweloperskiego

1. Utwórz fork i sklonuj

   git clone https://github.com/sqrcz/numerik.git
   cd numerik

2. Zainstaluj zależności PHP

   composer install

3. Uruchom zestaw testów

   composer test

Lokalne sprawdzenia

Polecenie	Opis
composer test	Zestaw testów PHPUnit
composer test:cover	PHPUnit z raportami pokrycia HTML + Clover
composer stan	PHPStan na poziomie 10
composer cs-fix	PHP CS Fixer — automatyczne formatowanie kodu
composer cs-check	PHP CS Fixer — tylko sprawdzanie (używane w CI)
composer mutation	Testy mutacyjne Infection
composer check	cs-check + stan + test po kolei

Uruchom composer check przed otwarciem PR, aby wykryć wszystkie problemy lokalnie.

Dodawanie nowego identyfikatora

Dodanie nowego identyfikatora (np. Dowód Osobisty, IBAN PL) wymaga zmian w kilku miejscach:

• Utwórz src/ValueObjects/NewIdentifier.php (klasa readonly implementująca IdentifierInterface)
• Utwórz src/Identifiers/NewIdentifierIdentifier.php (implementuje ValidatorInterface i ParserInterface; przyjmuje bool $strict = true)
• Dodaj nowe przypadki ValidationFailureReason jeśli identyfikator wprowadza nowe typy błędów
• Dodaj metodę fabryczną do src/Numerik.php (Numerik::newIdentifier(bool $strict = true))
• Dodaj tests/Fixtures/NewIdentifierFixtures.php z metodami statycznymi ::valid() i ::invalid()
• Dodaj testy jednostkowe walidatora, parsera i obiektu wartości
• Dodaj stronę identyfikatora w docs/src/content/docs/identifiers/ i docs/src/content/docs/pl/identifiers/
• Zaktualizuj CHANGELOG.md

Styl commitów

Używaj Conventional Commits:

feat: add Dowód Osobisty validation
fix: correct PESEL checksum for 2100s birth dates
docs: update REGON algorithm description
test: add NIP fixtures for invalid tax office codes
chore: update PHPStan to 2.x

Proces pull requestów

1. Utwórz gałąź od main (np. feature/dowod-osobisty).
2. Wprowadź zmiany.
3. Upewnij się, że composer check przechodzi.
4. Otwórz PR względem main i wypełnij szablon.

Notatka

main odrzuca bezpośrednie zmiany, wszystko musi przejść przez dedykowane gałęzie. PR-y przechodzą przez reguły ochrony gałęzi, CI musi zakończyć się sukcesem przed scaleniem.

Zgłaszanie błędu

Użyj szablonu Bug Report na GitHub.

Luki w zabezpieczeniach

Prosimy nie otwierać publicznego zgłoszenia. Zgłoś przez prywatny system zgłoszeń GitHub. Zobacz SECURITY.md.