Jak weryfikujemy dokumentację
Metodologia weryfikacji treści, cytowania prawa, przeglądów eksperckich i zgłaszania błędów.
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
Każda strona dokumentacji nosi badge statusu u góry. Status jest zapisany we frontmatter pliku MDX i widoczny dla czytelnika.
| Badge | Znaczenie | Kiedy |
|---|---|---|
| Szkic | Automatyczny szkic lub pierwsza wersja napisana przez inżyniera, nie weryfikowana | Pierwszy commit strony |
| Do weryfikacji | Treść gotowa, oznaczona do weryfikacji pod kątem zgodności | Domyślny status dla stron zgodności, dopóki nie zostaną sprawdzone |
| Zweryfikowane wewnętrznie | Skonfrontowana z tekstem ustawy oraz implementacją w Numify | Po wewnętrznym przeglądzie |
| Zweryfikowane przez eksperta | Zweryfikowana przez doradcę podatkowego lub biegłego rewidenta | Najwyższy poziom |
| Źródło: Numify | Strona funkcji — pokryta działającymi testami | Strony opisujące konkretne funkcje Numify |
Obecnie maksymalny poziom weryfikacji to Zweryfikowane wewnętrznie — nie współpracujemy jeszcze z żadnym doradcą podatkowym ani biegłym rewidentem na stałe. Kiedy taka współpraca powstanie, strony sukcesywnie przejdą do Zweryfikowane przez eksperta.
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ł
- Tekst ustawy na ISAP (
isap.sejm.gov.pl) — podstawowe źródło. Cytujemy: akt + artykuł + numer Dziennika Ustaw. Przykład: UoR, art. 14 — klikalny link do ISAP z tekstem danego artykułu. - Oficjalne interpretacje MF —
podatki.gov.pl, Krajowa Informacja Skarbowa. - Orzecznictwo — wyroki NSA i WSA z
orzeczenia.nsa.gov.pl.
Centralny rejestr cytowanych aktów znajduje się w pliku
_meta/legal-acts.json.
Zawiera aktualne numery Dz.U. i linki do ISAP.
Automatyczne oznaczanie zmian w prawie
Gdy ustawa zostanie znowelizowana:
- Aktualizujemy wpis w
legal-acts.json. - Każda strona cytująca dany akt dostaje automatycznie banner ⚠️ „Podstawa prawna zaktualizowana — strona wymaga ponownej weryfikacji".
- Status strony cofa się do Do weryfikacji.
Dzięki temu nigdy nie prezentujemy treści opartej na starym tekście ustawy bez ostrzeżenia.
Kto weryfikuje treści
Recenzenci są zapisani w pliku
_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 Zweryfikowane wewnętrznie.
- 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 Zweryfikowane wewnętrznie. 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
- Strony zgodności z prawem: minimum raz na kwartał, szczególnie
po nowelizacjach ustaw. Pole
last_law_checkw frontmatter śledzi datę ostatniego sprawdzenia. - Strony funkcji: przy każdej zmianie kodu, której dotyczy artykuł.
<ServiceRef>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
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
Informacje mają charakter edukacyjny
Dokumentacja nie zastępuje porady doradcy podatkowego ani biegłego rewidenta. W sprawach szczegółowych skontaktuj się ze specjalistą. Jak weryfikujemy dokumentację ↗
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
- 2026-04-16: uruchomienie dokumentacji. Startujemy z pięciostopniowym
systemem weryfikacji, centralnym rejestrem aktów prawnych w
_meta/legal-acts.jsoni 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 Zweryfikowane wewnętrznie 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.