Case study · AI i automatyzacja
Taxonaut: automatyzacja księgowości dla polskich JDG
Self-hosted automatyczny księgowy dla polskiej JDG: faktury na wejściu, deklaracje podatkowe na wyjściu, z regułami jako danymi i wielopoziomowym przetwarzaniem LLM.
- Branża
- Księgowość i podatki
- Czas realizacji
- 8 tygodni, w toku
- Rok
- 2026
- Usługi
- Inżynieria produktu, Integracja AI, Research regulacyjny
Problem
Polski przedsiębiorca na JDG przepala co miesiąc godziny na tę samą pętlę: zebrać faktury, zaklasyfikować koszty, policzyć ZUS i zaliczkę na PIT, wypełnić urzędowe formularze i nie przegapić terminu. Księgowi biorą miesięczny ryczałt za coś, co przez większość miesięcy jest deterministyczną papierologią. Gotowe SaaS-y automatyzują fragmenty, trzymają twoje dane jako zakładnika i dalej każą przepisywać liczby do rządowych portali.
Co zbudowaliśmy
Self-hosted platformę automatyzacji, która traktuje księgowość jak pipeline: dokumenty i wyciągi bankowe wchodzą, a wychodzą gotowe do złożenia deklaracje i przypomnienia o płatnościach.
Cały system niosą trzy decyzje projektowe:
- Reguły jako dane, nie kod. Polskie przepisy podatkowe zmieniają się co rok. Stawki, progi, wersje formularzy i reguły obliczeń żyją w wersjonowanych tabelach bazy z datami obowiązywania, więc zmiana przepisu to migracja danych, nie redeploy. Stawki na 2026 czysto współistnieją z historią 2025.
- Dokumenty do złożenia od ręki. Każdy artefakt kierowany do urzędu jest walidowany względem aktualnego oficjalnego schematu. Twarda zasada: jeśli nie da się go złożyć bez ręcznego przepisywania, to jest bug.
- Wielopoziomowe przetwarzanie LLM. Masowa robota, jak ekstrakcja pól z faktur, jedzie na tanich i szybkich modelach przez gateway. Decyzje krytyczne, jak niejednoznaczna klasyfikacja kosztu z konsekwencjami podatkowymi, trafiają do kolejki dla modelu frontier i są przetwarzane asynchronicznie przez job queue. Jakość tam, gdzie ma znaczenie, koszty tam, gdzie ich miejsce.
Architektura
FastAPI plus PostgreSQL (multi-tenant z izolacją na poziomie wierszy), workery Celery i scheduler dla cyklu miesięcznego, do tego bot na Telegramie do zbierania dokumentów i przypomnień: fotografujesz fakturę, system ją parsuje, klasyfikuje i księguje. Serwis przypomnień pilnuje ustawowych terminów i upomina się z rosnącą natarczywością.
Dlaczego to ważne
To wzorzec dla całej klasy biznesów: regulowana, powtarzalna, napędzana terminami papierologia, w której poprawność nie podlega negocjacji. Reguły jako dane plus wyjścia walidowane schematami plus wielopoziomowe AI to szablon, który przenosimy do dowolnej domeny ciężkiej od compliance.