--- title: "Jak weryfikujemy dokumentację" description: "Metodologia weryfikacji treści, cytowania prawa, przeglądów eksperckich i zgłaszania błędów." url: https://numifyai.com/docs/jak-weryfikujemy review_status: internal updated: 2026-04-16 --- Ta strona opisuje, **jak powstaje i jest weryfikowana dokumentacja Numify AI**. Kompromis jest jednoznaczny: dokumentacja dotycząca zgodności z polskim prawem musi być albo **w 100 % poprawna i aktualna**, albo jawnie oznaczona jako niezweryfikowana. Zamiatanie błędów pod dywan nie wchodzi w grę. ## Pięć poziomów weryfikacji [#pięć-poziomów-weryfikacji] Każda strona dokumentacji nosi **badge statusu** u góry. Status jest zapisany we frontmatter pliku MDX i widoczny dla czytelnika. | Badge | Znaczenie | Kiedy | | -------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | | | Automatyczny szkic lub pierwsza wersja napisana przez inżyniera, **nie weryfikowana** | Pierwszy commit strony | | | Treść gotowa, oznaczona do weryfikacji pod kątem zgodności | Domyślny status dla stron zgodności, dopóki nie zostaną sprawdzone | | | Skonfrontowana z tekstem ustawy **oraz** implementacją w Numify | Po wewnętrznym przeglądzie | | | Zweryfikowana przez **doradcę podatkowego** lub **biegłego rewidenta** | Najwyższy poziom | | | Strona funkcji — pokryta działającymi testami | Strony opisujące konkretne funkcje Numify | Obecnie maksymalny poziom weryfikacji to — **nie współpracujemy jeszcze z żadnym doradcą podatkowym ani biegłym rewidentem na stałe.** Kiedy taka współpraca powstanie, strony sukcesywnie przejdą do . ## Jak cytujemy prawo [#jak-cytujemy-prawo] Każde stwierdzenie prawne musi mieć **konkretne źródło**. Nie piszemy „zgodnie z polskim prawem" bez podania artykułu. ### Hierarchia źródeł [#hierarchia-źródeł] 1. **Tekst ustawy na ISAP** (`isap.sejm.gov.pl`) — podstawowe źródło. Cytujemy: akt + artykuł + numer Dziennika Ustaw. Przykład: — klikalny link do ISAP z tekstem danego artykułu. 2. **Oficjalne interpretacje MF** — `podatki.gov.pl`, Krajowa Informacja Skarbowa. 3. **Orzecznictwo** — wyroki NSA i WSA z `orzeczenia.nsa.gov.pl`. Centralny rejestr cytowanych aktów znajduje się w pliku [`_meta/legal-acts.json`](https://github.com/kacperkwapisz/numifyai/blob/master/src/content/docs/_meta/legal-acts.json). Zawiera aktualne numery Dz.U. i linki do ISAP. ### Automatyczne oznaczanie zmian w prawie [#automatyczne-oznaczanie-zmian-w-prawie] Gdy ustawa zostanie znowelizowana: 1. Aktualizujemy wpis w `legal-acts.json`. 2. Każda strona cytująca dany akt dostaje automatycznie banner ⚠️ **„Podstawa prawna zaktualizowana — strona wymaga ponownej weryfikacji"**. 3. Status strony cofa się do . Dzięki temu **nigdy nie prezentujemy treści opartej na starym tekście ustawy bez ostrzeżenia**. ## Kto weryfikuje treści [#kto-weryfikuje-treści] Recenzenci są zapisani w pliku [`_meta/reviewers.json`](https://github.com/kacperkwapisz/numifyai/blob/master/src/content/docs/_meta/reviewers.json) wraz z: * imieniem i nazwiskiem, * rolą (inżynier, doradca podatkowy, biegły rewident, …), * numerem wpisu (np. wpis na listę doradców podatkowych) jeśli dotyczy, * maksymalnym poziomem weryfikacji, jaki mogą nadać. Obecni recenzenci: * **Kacper Kwapisz** — inżynier / właściciel produktu. Nie jest doradcą podatkowym. Może nadawać status maksymalnie . * **Redakcja Numify** — wewnętrzny proces redakcyjny, który porównuje treść strony z aktualnym tekstem ustawy w ISAP oraz z implementacją funkcji w kodzie produktu. Może nadawać status maksymalnie . Proces jest wspomagany narzędziami i nadzorowany przez właściciela produktu; nie zastępuje weryfikacji przez doradcę podatkowego ani biegłego rewidenta. ## Jak często przeglądamy treści [#jak-często-przeglądamy-treści] * **Strony zgodności z prawem**: minimum **raz na kwartał**, szczególnie po nowelizacjach ustaw. Pole `last_law_check` w frontmatter śledzi datę ostatniego sprawdzenia. * **Strony funkcji**: przy każdej zmianie kodu, której dotyczy artykuł. `` automatycznie pokazuje liczbę testów integracyjnych pokrywających daną funkcję. * **Koncepcje i poradniki**: raz na rok lub przy istotnych zmianach w produkcie. ## Zgłaszanie błędów [#zgłaszanie-błędów] Każda strona ma na dole link **„Zgłoś poprawkę ↗"** — otwiera issue na GitHubie z prefillowanym tytułem zawierającym ścieżkę pliku. Wszystkie issue są publiczne. Szczególnie prosimy o zgłoszenia, jeśli: * Cytowany artykuł ustawy został zmieniony. * Wynik podawany jako przykład jest niezgodny z aktualnymi stawkami lub limitami. * Opisana funkcja Numify działa inaczej niż dokumentujemy. ## Zastrzeżenie prawne [#zastrzeżenie-prawne] Numify AI jest narzędziem księgowym, nie kancelarią. Dokumentacja ma **charakter edukacyjny** i nie stanowi indywidualnej porady podatkowej ani prawnej. W sprawach skomplikowanych — szczególnie IP BOX, transakcji transgranicznych, reorganizacji spółek — **skontaktuj się z doradcą podatkowym**. ## Historia decyzji metodologicznych [#historia-decyzji-metodologicznych] * **2026-04-16**: uruchomienie dokumentacji. Startujemy z pięciostopniowym systemem weryfikacji, centralnym rejestrem aktów prawnych w `_meta/legal-acts.json` i publiczną listą recenzentów w `_meta/reviewers.json`. * **2026-04-16**: wprowadzenie recenzenta `numify-editorial` — wewnętrznego procesu redakcyjnego. Dzięki niemu strony zgodności mogą otrzymywać status bez konieczności ręcznego przeglądu przez Kacpra, przy zachowaniu tej samej metodyki (ISAP + kod produktu). Właściciel produktu może w każdym momencie wycofać lub podwyższyć status.