Pokaż spis treści

Przygotowanie okresu

Import miesiąca

Import miesiąca jest bramą wejściową dla pracy księgowej. Operator wybiera paczkę ZIP w konwencji MM-YYYY.zip, a aplikacja rozpoznaje faktury, CAMT.052, statement bankowy i raporty RK, po czym rozdziela wynik na kroki wykonane automatycznie oraz pozycje do kontroli. To celowo nie jest automatyczne księgowanie: ekran przygotowuje materiał, ale decyzje księgowe zostają w dokumentach, banku, kasie i dekretach.

Wczytaj dokumentyRejestr dokumentówBank i CAMT.052

Workflow operatora

Operator otwiera dialog paczki, wybiera plik nazwany w konwencji MM-YYYY.zip i uruchamia akcję Wczytaj i przygotuj miesiąc. Skrypt kliencki sprawdza nazwę pliku jeszcze przed wysłaniem, a następnie przekazuje plik i miesiąc do /api/monthly-import/prepare. Po odpowiedzi ekran pokazuje dashboard: wykryte pliki, przygotowane rekordy, ostrzeżenia i zadania do wykonania ręcznie.

Import nie księguje wszystkiego automatycznie. Jego rolą jest przygotować materiał źródłowy i ograniczyć pracę ręczną, ale decyzje księgowe zostają przy użytkowniku: dokument trzeba sprawdzić, bank dopasować, RK zamknąć, a dekrety zatwierdzić.

Akcje na ekranie

  • Wczytaj i przygotuj miesiąc. Przesyła ZIP do endpointu prepare, wyciąga miesiąc z nazwy pliku, pokazuje status importu i nie pozwala kontynuować przy złej konwencji nazwy.

  • Otwórz dokumenty. Prowadzi do rejestru dokumentów, gdzie operator sprawdza rekordy przygotowane z paczki i uzupełnia brakujące dane.

  • Zamknij. Czyści widok dialogu bez kasowania przygotowanych danych, dzięki czemu import miesięczny nie jest mylony z operacją wycofania.

Jak paczka miesiąca przechodzi przez aplikację

flowchart TD
  A["Operator wybiera MM-YYYY.zip"] --> B{"Nazwa i format ZIP poprawne?"}
  B -->|Nie| C["Komunikat w dialogu: popraw nazwę albo wybierz ZIP"]
  B -->|Tak| D["/api/monthly-import/prepare"]
  D --> E["AnalyzeMonthlyPackageUseCase klasyfikuje pliki"]
  E --> F["CAMT.052: import banku i źródłowe dokumenty"]
  E --> G["PDF faktur: robocze dokumenty i załączniki"]
  E --> H["RK/PDF: przygotowanie kasy"]
  E --> I["Nieznane pliki: kontrola księgowej"]
  F --> J["Dashboard: zapisane, pominięte, do kontroli"]
  G --> J
  H --> J
  I --> J
  J --> K["Linki: dokumenty, bank, kasa, dekrety"]

Decyzje projektowe

Ta funkcja jest etapem orkiestracji, a nie księgowaniem. Dzięki temu import może być idempotentny na poziomie plików i bezpieczny dla danych księgowych. Najważniejsze ostrzeżenia trafiają na ekran od razu po analizie, a dalsze działania prowadzą do konkretnych modułów, które mają własne walidacje i audyt.