# jovanandov/kontrolni-seznampvdexport architecture

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

- Interactive diagram: https://gitdiagram.com/jovanandov/kontrolni-seznampvdexport
- Repository: https://github.com/jovanandov/kontrolni-seznampvdexport

## Overview

Kontrolni seznam is a React/Django application for creating or reopening projects and completing checklists, with authentication and administrative settings. The principal flow runs from project selection through checklist questions and saved answers; a separate branch manages checklist types, imports, users, and settings. The README also documents XLSX/PDF support. Some backend and export paths are only partly sampled, so those capabilities are represented without asserting unshown call chains.

Main entry points: [`frontend/src/App.tsx`](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/App.tsx) (App routing), [`frontend/src/api/api.ts`](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/api/api.ts) (HTTP API client), [`frontend/src/pages/Settings.tsx`](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/Settings.tsx) (Settings and projects), [`backend/checklist/views.py`](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/views.py) (REST endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_app["App routing<br/>[App.tsx]"]
  node_auth["Authentication<br/>[AuthContext.tsx]"]
  node_login["Login and register<br/>[Login.tsx]"]
  node_api["HTTP API client<br/>[api.ts]"]
end

subgraph group_checklists["Checklist workflow"]
  node_start["Project start<br/>[StartChecklist.tsx]"]
  node_checklist["Checklist entry<br/>[Checklist.tsx]"]
  node_questions["Question answers"]
end

subgraph group_admin["Administration"]
  node_settings["Settings and projects<br/>[Settings.tsx]"]
  node_fileupload["Spreadsheet upload<br/>[FileUpload.tsx]"]
  node_jsonupload["JSON upload<br/>[JsonFileUpload.tsx]"]
end

subgraph group_backend["Backend services"]
  node_views["REST endpoints<br/>[views.py]"]
  node_serializers["API serializers<br/>[serializers.py]"]
  node_models["Domain records<br/>[models.py]"]
  node_database[("SQLite database")]
  node_backendurls["API routing<br/>[urls.py]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"checks access"| node_auth
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_start
node_app -->|"routes to"| node_checklist
node_auth -->|"calls"| node_api
node_login -->|"uses"| node_auth
node_start -->|"loads and creates"| node_api
node_checklist -->|"loads and saves"| node_api
node_questions -->|"saves answers"| node_api
node_app -->|"routes to"| node_settings
node_settings -->|"calls"| node_api
node_settings -->|"uses"| node_fileupload
node_settings -->|"uses"| node_jsonupload
node_api -->|"requests"| node_backendurls
node_backendurls -->|"routes to"| node_views
node_views -->|"serializes"| node_serializers
node_serializers -->|"maps records"| node_models
node_views -->|"queries and updates"| node_models
node_models -.->|"persists records"| node_database

click node_app "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/App.tsx"
click node_auth "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/context/AuthContext.tsx"
click node_login "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/Login.tsx"
click node_start "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/StartChecklist.tsx"
click node_checklist "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/Checklist.tsx"
click node_questions "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/components/SegmentQuestions.tsx"
click node_api "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/api/api.ts"
click node_settings "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/Settings.tsx"
click node_fileupload "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/components/FileUpload.tsx"
click node_jsonupload "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/components/JsonFileUpload.tsx"
click node_views "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/views.py"
click node_serializers "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/serializers.py"
click node_models "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/models.py"
click node_database "https://github.com/jovanandov/kontrolni-seznampvdexport/tree/main/backend"
click node_backendurls "https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/urls.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_app,node_auth,node_login,node_api,node_user toneBlue
class node_start,node_checklist,node_questions toneAmber
class node_settings,node_fileupload,node_jsonupload toneMint
class node_views,node_serializers,node_models,node_database,node_backendurls toneRose
```

## Components

### Frontend experience

- [App routing](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Authentication](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Login and register](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [HTTP API client](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/api/api.ts): `frontend/src/api/api.ts`

### Checklist workflow

- [Project start](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/StartChecklist.tsx): `frontend/src/pages/StartChecklist.tsx`
- [Checklist entry](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/Checklist.tsx): `frontend/src/pages/Checklist.tsx`
- [Question answers](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/components/SegmentQuestions.tsx): `frontend/src/components/SegmentQuestions.tsx`

### Administration

- [Settings and projects](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/pages/Settings.tsx): `frontend/src/pages/Settings.tsx`
- [Spreadsheet upload](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/components/FileUpload.tsx): `frontend/src/components/FileUpload.tsx`
- [JSON upload](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/frontend/src/components/JsonFileUpload.tsx): `frontend/src/components/JsonFileUpload.tsx`

### Backend services

- [REST endpoints](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/views.py): `backend/checklist/views.py`
- [API serializers](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/serializers.py): `backend/checklist/serializers.py`
- [Domain records](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/models.py): `backend/checklist/models.py`
- [SQLite database](https://github.com/jovanandov/kontrolni-seznampvdexport/tree/main/backend): `backend`
- [API routing](https://github.com/jovanandov/kontrolni-seznampvdexport/blob/main/backend/checklist/urls.py): `backend/checklist/urls.py`

### Other components

- **User**

## Connections

- User → App routing: uses
- App routing → Authentication: checks access (evidence: `frontend/src/App.tsx`)
- App routing → Login and register: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Project start: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Checklist entry: routes to (evidence: `frontend/src/App.tsx`)
- Authentication → HTTP API client: calls (evidence: `frontend/src/context/AuthContext.tsx`)
- Login and register → Authentication: uses (evidence: `frontend/src/pages/Login.tsx`)
- Project start → HTTP API client: loads and creates (evidence: `frontend/src/pages/StartChecklist.tsx`)
- Checklist entry → HTTP API client: loads and saves (evidence: `frontend/src/pages/Checklist.tsx`)
- Question answers → HTTP API client: saves answers (evidence: `frontend/src/components/SegmentQuestions.tsx`)
- App routing → Settings and projects: routes to (evidence: `frontend/src/App.tsx`)
- Settings and projects → HTTP API client: calls (evidence: `frontend/src/pages/Settings.tsx`)
- Settings and projects → Spreadsheet upload: uses (evidence: `frontend/src/pages/Settings.tsx`)
- Settings and projects → JSON upload: uses (evidence: `frontend/src/pages/Settings.tsx`)
- HTTP API client → API routing: requests
- API routing → REST endpoints: routes to (evidence: `backend/checklist/urls.py`)
- REST endpoints → API serializers: serializes (evidence: `backend/checklist/views.py`)
- API serializers → Domain records: maps records (evidence: `backend/checklist/serializers.py`)
- REST endpoints → Domain records: queries and updates (evidence: `backend/checklist/views.py`)
- Domain records → SQLite database: persists records (evidence: `backend/checklist/views.py`)
