# micha1bak/inteligentny-asystent-urzednika architecture

> Architecture diagram of the GitHub repository micha1bak/inteligentny-asystent-urzednika, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/micha1bak/inteligentny-asystent-urzednika
- Repository: https://github.com/micha1bak/inteligentny-asystent-urzednika

## Overview

To aplikacja dla urzędników obsługujących wnioski o dostęp do informacji publicznej. Główny przebieg prowadzi od wgrania wniosku i odczytu jego treści, przez ewidencję, terminy, kwerendy wydziałowe i propozycję odpowiedzi, po akceptację, anonimizację oraz eksport pisma. Osobne gałęzie obsługują archiwum spraw i wersjonowaną bazę wiedzy. Krawędzie opierają się na pokazanych wywołaniach, indeksie źródeł i README; dla niesamplowanych tras zależności oznaczono jako niezweryfikowane.

Main entry points: [`src/inteligentny_asystent_urzednika/app.py`](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/app.py) (FastAPI), [`frontend/src/App.tsx`](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/App.tsx) (Aplikacja i trasy), [`frontend/src/lib/api.ts`](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/lib/api.ts) (Klient API), [`frontend/src/pages/SzczegolyWniosku.tsx`](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/SzczegolyWniosku.tsx) (Szczegóły sprawy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Interfejs urzędnika"]
  node_appui["Aplikacja i trasy<br/>[App.tsx]"]
  node_calendar["Kalendarz spraw<br/>[Wnioski.tsx]"]
  node_caseui["Szczegóły sprawy"]
  node_newcase["Dodawanie wniosku<br/>[NowyWniosek.tsx]"]
  node_session["Sesja urzędnika<br/>[sesja.tsx]"]
  node_api_client["Klient API<br/>[api.ts]"]
end

subgraph group_casework["Obsługa wniosków"]
  node_deadline["Obliczanie terminów<br/>[terminy.ts]"]
  node_intake["Odczyt dokumentów<br/>[ocr_llm.py]"]
  node_case_store[("Rejestr wniosków<br/>[baza_wnioskow.py]")]
  node_similarity["Podobne sprawy<br/>[podobienstwo.py]"]
  node_departments["Dobór wydziału<br/>[wydzialy.py]"]
  node_proposal["Ocena i projekt<br/>[propozycja.py]"]
end

subgraph group_knowledge["Wiedza i precedensy"]
  node_archive[("Archiwum odpowiedzi<br/>[archiwum.py]")]
  node_knowledge_base["Baza wiedzy<br/>[wiedza.py]"]
  node_legal_docs["Akty prawne<br/>[przepisy.py]"]
  node_knowledge_update["Analiza zmian<br/>[analiza_aktu.py]"]
end

subgraph group_documents["Dokumenty i prywatność"]
  node_redact_ui["Anonimizacja dokumentu<br/>[Anonimizacja.tsx]"]
  node_redaction["Wykrywanie danych<br/>[anonimizacja.py]"]
  node_letter["Składanie pisma<br/>[pismo.py]"]
  node_export["Eksport DOCX/TXT<br/>[eksport.py]"]
end

subgraph group_platform["API i dane"]
  node_backend["FastAPI<br/>[app.py]"]
  node_llm_client["Klient modelu<br/>[groq_klient.py]"]
end

node_clerk(("Urzędnik"))
node_llm_service{{"Groq lub model lokalny"}}

node_clerk -->|"obsługuje"| node_appui
node_appui -->|"pokazuje"| node_calendar
node_appui -->|"pokazuje"| node_caseui
node_appui -->|"pokazuje"| node_newcase
node_appui -->|"sprawdza sesję"| node_session
node_calendar -->|"wylicza terminy"| node_deadline
node_newcase -.->|"wysyła wniosek"| node_api_client
node_caseui -.->|"obsługuje sprawę"| node_api_client
node_session -->|"sprawdza logowanie"| node_api_client
node_api_client -->|"wywołuje API"| node_backend
node_backend -->|"czyta i zapisuje"| node_case_store
node_backend -->|"przekazuje plik"| node_intake
node_backend -->|"zleca propozycję"| node_proposal
node_backend -.->|"obsługuje archiwum"| node_archive
node_backend -.->|"uruchamia analizę"| node_knowledge_update
node_backend -->|"udostępnia wyszukiwanie"| node_legal_docs
node_backend -.->|"udostępnia sugestie"| node_redaction
node_backend -.->|"udostępnia eksport"| node_export
node_backend -.->|"obsługuje wydziały"| node_departments
node_proposal -->|"buduje zapytanie"| node_llm_client
node_llm_client -.->|"wysyła zapytanie"| node_llm_service
node_proposal -->|"wypełnia wzór"| node_letter
node_proposal -->|"korzysta z kontekstu"| node_knowledge_base
node_knowledge_base -->|"wyszukuje podobne"| node_similarity
node_archive -->|"anonimizuje wpisy"| node_redaction
node_knowledge_update -.->|"proponuje zmiany"| node_knowledge_base
node_redact_ui -->|"pobiera sugestie"| node_api_client
node_caseui -.->|"szuka precedensów"| node_similarity
node_caseui -.->|"proponuje wydział"| node_departments
node_letter -.->|"dostarcza pismo"| node_export

click node_appui "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/App.tsx"
click node_calendar "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/Wnioski.tsx"
click node_caseui "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/SzczegolyWniosku.tsx"
click node_newcase "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/NowyWniosek.tsx"
click node_session "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/sesja.tsx"
click node_api_client "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/lib/api.ts"
click node_deadline "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/lib/terminy.ts"
click node_intake "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/konwersja/ocr_llm.py"
click node_case_store "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/baza_wnioskow.py"
click node_similarity "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/podobienstwo.py"
click node_departments "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/wydzialy.py"
click node_proposal "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/propozycja.py"
click node_archive "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/archiwum.py"
click node_knowledge_base "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/wiedza.py"
click node_legal_docs "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/przepisy.py"
click node_knowledge_update "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/analiza_aktu.py"
click node_redact_ui "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/Anonimizacja.tsx"
click node_redaction "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/anonimizacja.py"
click node_letter "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/wzor/pismo.py"
click node_export "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/wzor/eksport.py"
click node_backend "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/app.py"
click node_llm_client "https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/groq_klient.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_appui,node_calendar,node_caseui,node_newcase,node_session,node_api_client toneBlue
class node_deadline,node_intake,node_case_store,node_similarity,node_departments,node_proposal toneAmber
class node_archive,node_knowledge_base,node_legal_docs,node_knowledge_update toneMint
class node_redact_ui,node_redaction,node_letter,node_export toneRose
class node_backend,node_llm_client,node_clerk,node_llm_service toneIndigo
```

## Components

### Interfejs urzędnika

- [Aplikacja i trasy](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Kalendarz spraw](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/Wnioski.tsx): `frontend/src/pages/Wnioski.tsx`
- [Szczegóły sprawy](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/SzczegolyWniosku.tsx): `frontend/src/pages/SzczegolyWniosku.tsx`
- [Dodawanie wniosku](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/NowyWniosek.tsx): `frontend/src/pages/NowyWniosek.tsx`
- [Sesja urzędnika](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/sesja.tsx): `frontend/src/sesja.tsx`
- [Klient API](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### Obsługa wniosków

- [Obliczanie terminów](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/lib/terminy.ts): `frontend/src/lib/terminy.ts`
- [Odczyt dokumentów](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/konwersja/ocr_llm.py): `src/inteligentny_asystent_urzednika/konwersja/ocr_llm.py`
- [Rejestr wniosków](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/baza_wnioskow.py): `src/inteligentny_asystent_urzednika/baza_wnioskow.py`
- [Podobne sprawy](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/podobienstwo.py): `src/inteligentny_asystent_urzednika/podobienstwo.py`
- [Dobór wydziału](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/wydzialy.py): `src/inteligentny_asystent_urzednika/wydzialy.py`
- [Ocena i projekt](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/propozycja.py): `src/inteligentny_asystent_urzednika/propozycja.py`

### Wiedza i precedensy

- [Archiwum odpowiedzi](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/archiwum.py): `src/inteligentny_asystent_urzednika/archiwum.py`
- [Baza wiedzy](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/wiedza.py): `src/inteligentny_asystent_urzednika/wiedza.py`
- [Akty prawne](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/przepisy.py): `src/inteligentny_asystent_urzednika/przepisy.py`
- [Analiza zmian](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/analiza_aktu.py): `src/inteligentny_asystent_urzednika/analiza_aktu.py`

### Dokumenty i prywatność

- [Anonimizacja dokumentu](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/frontend/src/pages/Anonimizacja.tsx): `frontend/src/pages/Anonimizacja.tsx`
- [Wykrywanie danych](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/anonimizacja.py): `src/inteligentny_asystent_urzednika/anonimizacja.py`
- [Składanie pisma](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/wzor/pismo.py): `src/inteligentny_asystent_urzednika/wzor/pismo.py`
- [Eksport DOCX/TXT](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/wzor/eksport.py): `src/inteligentny_asystent_urzednika/wzor/eksport.py`

### API i dane

- [FastAPI](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/app.py): `src/inteligentny_asystent_urzednika/app.py`
- [Klient modelu](https://github.com/micha1bak/inteligentny-asystent-urzednika/blob/main/src/inteligentny_asystent_urzednika/groq_klient.py): `src/inteligentny_asystent_urzednika/groq_klient.py`

### Other components

- **Urzędnik**
- **Groq lub model lokalny**

## Connections

- Urzędnik → Aplikacja i trasy: obsługuje (evidence: `frontend/src/App.tsx`)
- Aplikacja i trasy → Kalendarz spraw: pokazuje (evidence: `frontend/src/App.tsx`)
- Aplikacja i trasy → Szczegóły sprawy: pokazuje (evidence: `frontend/src/App.tsx`)
- Aplikacja i trasy → Dodawanie wniosku: pokazuje (evidence: `frontend/src/App.tsx`)
- Aplikacja i trasy → Sesja urzędnika: sprawdza sesję (evidence: `frontend/src/App.tsx`)
- Kalendarz spraw → Obliczanie terminów: wylicza terminy (evidence: `frontend/src/pages/Wnioski.tsx`)
- Dodawanie wniosku → Klient API: wysyła wniosek
- Szczegóły sprawy → Klient API: obsługuje sprawę (evidence: `frontend/src/pages/SzczegolyWniosku.tsx`)
- Sesja urzędnika → Klient API: sprawdza logowanie (evidence: `frontend/src/sesja.tsx`)
- Klient API → FastAPI: wywołuje API (evidence: `README.md`)
- FastAPI → Rejestr wniosków: czyta i zapisuje (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- FastAPI → Odczyt dokumentów: przekazuje plik (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- FastAPI → Ocena i projekt: zleca propozycję (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- FastAPI → Archiwum odpowiedzi: obsługuje archiwum (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- FastAPI → Analiza zmian: uruchamia analizę (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- FastAPI → Akty prawne: udostępnia wyszukiwanie (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- FastAPI → Wykrywanie danych: udostępnia sugestie (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- FastAPI → Eksport DOCX/TXT: udostępnia eksport (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- FastAPI → Dobór wydziału: obsługuje wydziały (evidence: `src/inteligentny_asystent_urzednika/app.py`)
- Ocena i projekt → Klient modelu: buduje zapytanie (evidence: `src/inteligentny_asystent_urzednika/propozycja.py`)
- Klient modelu → Groq lub model lokalny: wysyła zapytanie
- Ocena i projekt → Składanie pisma: wypełnia wzór (evidence: `src/inteligentny_asystent_urzednika/propozycja.py`)
- Ocena i projekt → Baza wiedzy: korzysta z kontekstu (evidence: `src/inteligentny_asystent_urzednika/propozycja.py`)
- Baza wiedzy → Podobne sprawy: wyszukuje podobne (evidence: `src/inteligentny_asystent_urzednika/wiedza.py`)
- Archiwum odpowiedzi → Wykrywanie danych: anonimizuje wpisy (evidence: `src/inteligentny_asystent_urzednika/archiwum.py`)
- Analiza zmian → Baza wiedzy: proponuje zmiany
- Anonimizacja dokumentu → Klient API: pobiera sugestie (evidence: `frontend/src/pages/Anonimizacja.tsx`)
- Szczegóły sprawy → Podobne sprawy: szuka precedensów
- Szczegóły sprawy → Dobór wydziału: proponuje wydział
- Składanie pisma → Eksport DOCX/TXT: dostarcza pismo
