← Wszystkie projekty

Projekt własny · działająca aplikacja online

Angielska Faktura

Pełny produkt: dwa źródła KSeF, walidacja, angielska reprezentacja i zweryfikowany PDF.

Projekt własny AudytStrony — produkt, interfejs i zaplecze techniczne.

Rzeczywisty ekran startowy aplikacji Angielska Faktura
Mobilny ekran wyniku Angielskiej Faktury z dokumentem DEMO

01 / Kontekst

Zamienić polski dokument KSeF na czytelną angielską wizualizację bez ręcznego przepisywania i bez zmiany danych źródłowych.

Aplikacja przyjmuje XML FA(3) oraz odpowiadający mu oficjalny PDF. Dane biznesowe pochodzą z XML, a PDF potwierdza numer KSeF, link i QR. Portfolio używa wyłącznie syntetycznego dokumentu oznaczonego DEMO.

02 / Kluczowe decyzje

01

Dwa źródła, jedna kontrola

XML pozostaje źródłem danych biznesowych. Oficjalny PDF dostarcza dowód pochodzenia i identyfikatory KSeF.

02

Brak trwałego magazynu plików

Wejściowe pliki są czytane w pamięci i zwracany jest wynik PDF; baza przechowuje skróty HMAC i metadane portalu, nie treść faktur.

03

Weryfikacja także po renderze

Wynikowy PDF jest ponownie otwierany i sprawdzany pod kątem treści, stron, linków, QR i granic dokumentu.

04 / Architektura

Od wejścia do rezultatu.

  1. 01XML FA(3)dane biznesowe
  2. 02PDF KSeFnumer, link i QR
  3. 03Walidacjazgodność 1:1 i limity
  4. 04Mapowanieangielskie etykiety
  5. 05PDF A4render i ponowna kontrola
Next.js 16 + React 19FastAPI + Python 3.14defusedxml + PyMuPDF + zxing-cppReportLabSQLite dla metadanych portaluDocker + Cloudflare Tunnel

05 / Zakres

Co zostało wykonane

  • architektura produktu
  • UX/UI
  • frontend
  • API i silnik konwersji
  • parsery XML/PDF
  • walidacja KSeF
  • renderowanie i weryfikacja PDF
  • Docker i wdrożenie

Granice materiału

Co dokładnie pokazuję

  • Ekrany portfolio pokazują wyłącznie przygotowany dokument syntetyczny oznaczony DEMO.
  • Aplikacja tworzy angielską wizualizację; polski zapis KSeF i XML pozostają źródłem nadrzędnym.

Podstawa publikacji

  • repozytorium angielskafaktura_phase1
  • testy parserów, walidacji i renderowania
  • działająca aplikacja
  • syntetyczny pakiet demo sprawdzony prawdziwym silnikiem

Sprawdź samodzielnie

Otwórz produkt