fix: yield to event loop after each SSE write to flush socket

The for-await loop over OpenAI stream chunks runs synchronously when
data is buffered, causing res.write() calls to queue without flushing.
Add setImmediate yield after each progress event so the event loop
reaches its I/O phase and pushes data to the network immediately.

.gitattributes

@@ -0,0 +1,6 @@
+# Единые правила переносов строк для всех машин
+* text=auto eol=lf
+
+# Windows-скрипты — исключение, им нужен CRLF
+*.bat text eol=crlf
+*.cmd text eol=crlf

.gitignore

@@ -18,3 +18,8 @@ Thumbs.db
 coverage/
 
 jan_feb.json
+jan-feb.json
+history.xlsx
+match_analysis.py
+match_report.txt
+statements/

Dockerfile.backend

@@ -5,6 +5,11 @@ COPY package.json package-lock.json* ./
 COPY shared ./shared
 COPY backend ./backend
 
+# Увеличенные таймауты для нестабильной сети
+RUN npm config set fetch-retry-mintimeout 20000 && \
+    npm config set fetch-retry-maxtimeout 120000 && \
+    npm config set fetch-timeout 300000
+
 RUN npm install
 
 FROM node:20-alpine AS build
@@ -25,6 +30,7 @@ ENV NODE_ENV=production
 COPY --from=build /app/backend/dist ./dist
 COPY --from=build /app/backend/package.json ./package.json
 COPY --from=build /app/node_modules ./node_modules
+COPY --from=build /app/backend/node_modules/ ./node_modules/
 COPY backend/.env .env
 
 EXPOSE 3000

Dockerfile.frontend

@@ -9,6 +9,11 @@ COPY package.json package-lock.json* tsconfig.json* ./
 COPY shared ./shared
 COPY frontend ./frontend
 
+# Увеличиваем таймауты и повторы для нестабильной сети
+RUN npm config set fetch-retry-mintimeout 20000 && \
+    npm config set fetch-retry-maxtimeout 120000 && \
+    npm config set fetch-timeout 300000
+
 # Устанавливаем зависимости из корня
 RUN npm install
 

backend/.env.example

@@ -10,3 +10,14 @@ APP_USER_PASSWORD=changeme
 SESSION_TIMEOUT_MS=10800000
 
 PORT=3000
+
+# Ключ OpenAI API для конвертации PDF-выписок в JSON (опционально)
+# Без него импорт PDF будет недоступен (503)
+LLM_API_KEY=
+
+# Базовый URL API LLM (опционально). По умолчанию https://api.openai.com
+# Примеры: Ollama — http://localhost:11434/v1, Azure — https://YOUR_RESOURCE.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT
+LLM_API_BASE_URL=
+
+# Имя модели LLM (опционально). Для OpenAI: gpt-4o-mini. Для Ollama: qwen2.5:7b, qwen3:7b
+LLM_MODEL=

backend/README.md

@@ -45,6 +45,8 @@ npm run dev -w backend
 | `APP_USER_PASSWORD`  | `changeme`     | Пароль для входа в приложение               |
 | `SESSION_TIMEOUT_MS` | `10800000`     | Таймаут сессии по бездействию (3 часа)      |
 | `PORT`               | `3000`         | Порт HTTP-сервера                           |
+| `LLM_API_KEY`        | —              | Ключ OpenAI API для конвертации PDF в JSON; без него импорт PDF возвращает 503 |
+| `LLM_API_BASE_URL`   | `https://api.openai.com/v1` | Адрес LLM API (OpenAI-совместимый); для локальной модели, напр. Ollama: `http://localhost:11434/v1` |
 
 ## Структура проекта
 
@@ -61,6 +63,7 @@ backend/src/
 ├── services/
 │   ├── auth.ts             — login / logout / me
 │   ├── import.ts           — валидация, fingerprint, direction, атомарный импорт
+│   ├── pdfToStatement.ts   — конвертация PDF → JSON 1.0 через LLM (OpenAI)
 │   ├── transactions.ts     — список с фильтрами + обновление (categoryId, comment)
 │   ├── accounts.ts         — список счетов, обновление алиаса
 │   ├── categories.ts       — список категорий (фильтр isActive)
@@ -90,7 +93,7 @@ backend/src/
 
 | Метод  | URL                        | Описание                                |
 |--------|----------------------------|-----------------------------------------|
-| POST   | `/api/import/statement`    | Импорт банковской выписки (JSON 1.0)    |
+| POST   | `/api/import/statement`    | Импорт банковской выписки (PDF или JSON 1.0; PDF конвертируется через LLM) |
 
 ### Транзакции
 

backend/package.json

@@ -6,7 +6,9 @@
     "dev": "tsx watch src/app.ts",
     "build": "tsc",
     "start": "node dist/app.js",
-    "migrate": "tsx src/db/migrate.ts"
+    "migrate": "tsx src/db/migrate.ts",
+    "migrate:prod": "node dist/db/migrate.js",
+    "test:llm": "tsx src/scripts/testLlm.ts"
   },
   "dependencies": {
     "@family-budget/shared": "*",
@@ -14,6 +16,9 @@
     "cors": "^2.8.6",
     "dotenv": "^17.3.1",
     "express": "^5.2.1",
+    "multer": "^2.1.1",
+    "openai": "^6.27.0",
+    "pdf-parse": "1.1.1",
     "pg": "^8.19.0",
     "uuid": "^13.0.0"
   },
@@ -21,6 +26,7 @@
     "@types/cookie-parser": "^1.4.10",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
+    "@types/multer": "^2.1.0",
     "@types/node": "^25.3.3",
     "@types/pg": "^8.18.0",
     "@types/uuid": "^10.0.0",

backend/src/config.ts

@@ -18,4 +18,13 @@ export const config = {
   appUserPassword: process.env.APP_USER_PASSWORD || 'changeme',
 
   sessionTimeoutMs: parseInt(process.env.SESSION_TIMEOUT_MS || '10800000', 10),
+
+  /** API-ключ для LLM (OpenAI или совместимый). Обязателен для конвертации PDF. */
+  llmApiKey: process.env.LLM_API_KEY || '',
+
+  /** Базовый URL API LLM. По умолчанию https://api.openai.com. Для Ollama: http://localhost:11434/v1 */
+  llmApiBaseUrl: process.env.LLM_API_BASE_URL || undefined,
+
+  /** Имя модели LLM. Для OpenAI: gpt-4o-mini. Для Ollama: qwen2.5:7b, qwen3:7b и т.п. */
+  llmModel: process.env.LLM_MODEL || 'gpt-4o-mini',
 };

backend/src/db/migrate.ts

@@ -133,6 +133,49 @@ const migrations: { name: string; sql: string }[] = [
         AND NOT EXISTS (SELECT 1 FROM category_rules LIMIT 1);
     `,
   },
+  {
+    name: '004_seed_category_rules_extended',
+    sql: `
+      INSERT INTO category_rules (pattern, match_type, category_id, priority, requires_confirmation)
+      SELECT pattern, match_type, category_id, priority, requires_confirmation
+      FROM (VALUES
+        ('STOLOVAYA', 'contains', (SELECT id FROM categories WHERE name = 'Общепит' LIMIT 1), 25, false),
+        ('KOFEJNYA', 'contains', (SELECT id FROM categories WHERE name = 'Общепит' LIMIT 1), 25, false),
+        ('JEFFREY S COFFEESHOP', 'contains', (SELECT id FROM categories WHERE name = 'Общепит' LIMIT 1), 25, false),
+        ('TA TORRRO GRIL', 'contains', (SELECT id FROM categories WHERE name = 'Общепит' LIMIT 1), 25, false),
+        ('OUSHEN FRENDS', 'contains', (SELECT id FROM categories WHERE name = 'Общепит' LIMIT 1), 25, false),
+        ('mkad', 'contains', (SELECT id FROM categories WHERE name = 'Авто' LIMIT 1), 20, false),
+        ('RNAZK', 'contains', (SELECT id FROM categories WHERE name = 'Авто' LIMIT 1), 20, false),
+        ('IP SHEVELEV', 'contains', (SELECT id FROM categories WHERE name = 'Авто' LIMIT 1), 20, false),
+        ('PAVELETSKAYA', 'contains', (SELECT id FROM categories WHERE name = 'Проезд' LIMIT 1), 25, false),
+        ('CPPK-', 'contains', (SELECT id FROM categories WHERE name = 'Проезд' LIMIT 1), 25, false),
+        ('MOS.TRANSPORT', 'contains', (SELECT id FROM categories WHERE name = 'Проезд' LIMIT 1), 25, false),
+        ('Lab4uru', 'contains', (SELECT id FROM categories WHERE name = 'Здоровье' LIMIT 1), 25, false),
+        ('APTEKA', 'contains', (SELECT id FROM categories WHERE name = 'Здоровье' LIMIT 1), 20, false),
+        ('IP SHARAFETDINOV', 'contains', (SELECT id FROM categories WHERE name = 'Арчи' LIMIT 1), 25, false),
+        ('ZOOMAGAZIN CHETYRE LAP', 'contains', (SELECT id FROM categories WHERE name = 'Арчи' LIMIT 1), 25, false),
+        ('VKUSVILL', 'contains', (SELECT id FROM categories WHERE name = 'Продукты' LIMIT 1), 20, false),
+        ('GLOBUS', 'contains', (SELECT id FROM categories WHERE name = 'Продукты' LIMIT 1), 20, false),
+        ('VERNYJ', 'contains', (SELECT id FROM categories WHERE name = 'Продукты' LIMIT 1), 20, false),
+        ('GOLD APPLE', 'contains', (SELECT id FROM categories WHERE name = 'Косметика' LIMIT 1), 25, false),
+        ('SPIRITFIT', 'contains', (SELECT id FROM categories WHERE name = 'Спорт' LIMIT 1), 25, false),
+        ('insanity', 'contains', (SELECT id FROM categories WHERE name = 'Спорт' LIMIT 1), 25, false),
+        ('anta-sport', 'contains', (SELECT id FROM categories WHERE name = 'Спорт' LIMIT 1), 25, false),
+        ('VANYAVPN', 'contains', (SELECT id FROM categories WHERE name = 'Подписки' LIMIT 1), 25, false),
+        ('ГРАНЛАЙН', 'contains', (SELECT id FROM categories WHERE name = 'Подписки' LIMIT 1), 20, false),
+        ('Мобильная связь', 'contains', (SELECT id FROM categories WHERE name = 'Подписки' LIMIT 1), 25, false),
+        ('OSTROVOK', 'contains', (SELECT id FROM categories WHERE name = 'Отпуск' LIMIT 1), 25, false),
+        ('sutochno', 'contains', (SELECT id FROM categories WHERE name = 'Отпуск' LIMIT 1), 25, false),
+        ('УФК', 'contains', (SELECT id FROM categories WHERE name = 'Штрафы' LIMIT 1), 30, false),
+        ('ГИБДД', 'contains', (SELECT id FROM categories WHERE name = 'Штрафы' LIMIT 1), 30, false),
+        ('Поступление заработной платы', 'contains', (SELECT id FROM categories WHERE name = 'Поступления' LIMIT 1), 30, false),
+        ('avito', 'contains', (SELECT id FROM categories WHERE name = 'Поступления' LIMIT 1), 25, false),
+        ('Init payout', 'contains', (SELECT id FROM categories WHERE name = 'Поступления' LIMIT 1), 25, false)
+      ) AS v(pattern, match_type, category_id, priority, requires_confirmation)
+      WHERE category_id IS NOT NULL
+        AND EXISTS (SELECT 1 FROM categories LIMIT 1);
+    `,
+  },
 ];
 
 export async function runMigrations(): Promise<void> {

backend/src/db/pool.ts

@@ -7,4 +7,5 @@ export const pool = new Pool({
   database: config.db.database,
   user: config.db.user,
   password: config.db.password,
+  connectionTimeoutMillis: 5000,
 });

backend/src/routes/import.ts

@@ -1,13 +1,125 @@
 import { Router } from 'express';
+import multer from 'multer';
 import { asyncHandler } from '../utils';
 import { importStatement, isValidationError } from '../services/import';
+import {
+  convertPdfToStatementStreaming,
+  isPdfConversionError,
+} from '../services/pdfToStatement';
+
+const upload = multer({
+  storage: multer.memoryStorage(),
+  limits: { fileSize: 15 * 1024 * 1024 },
+});
+
+function isPdfFile(file: { mimetype: string; originalname: string }): boolean {
+  const name = file.originalname.toLowerCase();
+  return (
+    file.mimetype === 'application/pdf' ||
+    name.endsWith('.pdf')
+  );
+}
+
+function isJsonFile(file: { mimetype: string; originalname: string }): boolean {
+  const name = file.originalname.toLowerCase();
+  return (
+    file.mimetype === 'application/json' ||
+    name.endsWith('.json')
+  );
+}
+
+function sseWrite(res: import('express').Response, data: Record<string, unknown>) {
+  res.write(`data: ${JSON.stringify(data)}\n\n`);
+}
 
 const router = Router();
 
 router.post(
   '/statement',
+  upload.single('file'),
   asyncHandler(async (req, res) => {
-    const result = await importStatement(req.body);
+    const file = req.file;
+    if (!file) {
+      res.status(400).json({
+        error: 'BAD_REQUEST',
+        message: 'Файл не загружен',
+      });
+      return;
+    }
+
+    if (!isPdfFile(file) && !isJsonFile(file)) {
+      res.status(400).json({
+        error: 'BAD_REQUEST',
+        message: 'Допустимы только файлы PDF или JSON',
+      });
+      return;
+    }
+
+    if (isPdfFile(file)) {
+      res.setHeader('Content-Type', 'text/event-stream');
+      res.setHeader('Cache-Control', 'no-cache');
+      res.setHeader('Connection', 'keep-alive');
+      res.setHeader('X-Accel-Buffering', 'no');
+      res.socket?.setNoDelay(true);
+      res.flushHeaders();
+
+      try {
+        const converted = await convertPdfToStatementStreaming(
+          file.buffer,
+          (stage, progress, message) => {
+            sseWrite(res, { stage, progress, message });
+          },
+        );
+
+        if (isPdfConversionError(converted)) {
+          sseWrite(res, {
+            stage: 'error',
+            message: converted.message,
+          });
+          res.end();
+          return;
+        }
+
+        const result = await importStatement(converted);
+        if (isValidationError(result)) {
+          sseWrite(res, {
+            stage: 'error',
+            message: (result as { message: string }).message,
+          });
+          res.end();
+          return;
+        }
+
+        sseWrite(res, {
+          stage: 'done',
+          progress: 100,
+          result,
+        });
+      } catch (err) {
+        console.error('SSE import error:', err);
+        sseWrite(res, {
+          stage: 'error',
+          message: 'Внутренняя ошибка сервера',
+        });
+      }
+
+      res.end();
+      return;
+    }
+
+    // JSON files — synchronous response as before
+    let body: unknown;
+    try {
+      body = JSON.parse(file.buffer.toString('utf-8'));
+    } catch {
+      res.status(400).json({
+        error: 'BAD_REQUEST',
+        message: 'Некорректный JSON-файл',
+      });
+      return;
+    }
+
+    const result = await importStatement(body);
     if (isValidationError(result)) {
       res.status((result as { status: number }).status).json({
         error: (result as { error: string }).error,

backend/src/scripts/testLlm.ts

@@ -0,0 +1,42 @@
+/**
+ * Тестовый запрос к LLM серверу.
+ * Запуск: npm run test:llm
+ */
+import OpenAI from 'openai';
+import { config } from '../config';
+
+async function main() {
+  if (!config.llmApiKey || config.llmApiKey.trim() === '') {
+    console.error('Ошибка: LLM_API_KEY не задан в .env');
+    process.exit(1);
+  }
+
+  const openai = new OpenAI({
+    apiKey: config.llmApiKey,
+    ...(config.llmApiBaseUrl && { baseURL: config.llmApiBaseUrl }),
+  });
+
+  const url = config.llmApiBaseUrl || 'https://api.openai.com/v1';
+  console.log('LLM сервер:', url);
+  console.log('Модель:', config.llmModel);
+  console.log('---');
+
+  try {
+    const completion = await openai.chat.completions.create({
+      model: config.llmModel,
+      messages: [{ role: 'user', content: 'Ответь одним словом: какой цвет у неба?' }],
+      temperature: 0,
+      max_tokens: 50,
+    });
+
+    const content = completion.choices[0]?.message?.content;
+    console.log('Ответ:', content || '(пусто)');
+    console.log('---');
+    console.log('OK');
+  } catch (err) {
+    console.error('Ошибка:', err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+
+main();

backend/src/services/pdfToStatement.ts

@@ -0,0 +1,302 @@
+import OpenAI from 'openai';
+import { config } from '../config';
+import type { StatementFile } from '@family-budget/shared';
+
+const PDF2JSON_PROMPT = `Ты — конвертер банковских выписок. Твоя задача: извлечь данные из текста банковской выписки ниже и вернуть строго один валидный JSON-объект в формате ниже. Никакого текста до или после JSON, только сам объект.
+
+## Структура выходного JSON
+
+{
+  "schemaVersion": "1.0",
+  "bank": "<название банка из выписки>",
+  "statement": {
+    "accountNumber": "<номер счёта, только цифры, без пробелов>",
+    "currency": "RUB",
+    "openingBalance": <число в копейках, целое>,
+    "closingBalance": <число в копейках, целое>,
+    "exportedAt": "<дата экспорта в формате ISO 8601 с offset, например 2026-02-27T13:23:00+03:00>"
+  },
+  "transactions": [
+    {
+      "operationAt": "<дата и время операции в формате ISO 8601 с offset>",
+      "amountSigned": <число: положительное для прихода, отрицательное для расхода; в копейках>,
+      "commission": <число, целое, >= 0, в копейках>,
+      "description": "<полное описание операции из выписки>"
+    }
+  ]
+}
+
+## Правила конвертации
+
+1. Суммы — всегда в копейках (рубли × 100). Пример: 500,00 ₽ → 50000, -1234,56 ₽ → -123456.
+2. amountSigned: приход — положительное, расход — отрицательное.
+3. operationAt — дата и время, если не указано — 00:00:00, offset +03:00 для МСК.
+4. commission — если не указана — 0.
+5. description — полный текст операции как в выписке.
+6. accountNumber — только цифры, без пробелов и дефисов.
+7. openingBalance / closingBalance — в копейках.
+8. bank — краткое название (VTB, Sberbank, Тинькофф).
+9. exportedAt — дата формирования выписки.
+10. transactions — хронологический порядок.
+
+## Требования
+
+- transactions не должен быть пустым.
+- Все числа — целые.
+- Даты — ISO 8601 с offset.
+- currency всегда "RUB".
+- schemaVersion всегда "1.0".`;
+
+export interface PdfConversionError {
+  status: number;
+  error: string;
+  message: string;
+}
+
+export function isPdfConversionError(r: unknown): r is PdfConversionError {
+  return (
+    typeof r === 'object' &&
+    r !== null &&
+    'status' in r &&
+    'error' in r &&
+    'message' in r
+  );
+}
+
+// Lazy-loaded so the app starts even if pdf-parse is missing from node_modules.
+let _pdfParse: ((buf: Buffer) => Promise<{ text: string }>) | undefined;
+function getPdfParse() {
+  if (!_pdfParse) {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    _pdfParse = require('pdf-parse') as (buf: Buffer) => Promise<{ text: string }>;
+  }
+  return _pdfParse;
+}
+
+export async function convertPdfToStatement(
+  buffer: Buffer,
+): Promise<StatementFile | PdfConversionError> {
+  if (!config.llmApiKey || config.llmApiKey.trim() === '') {
+    return {
+      status: 503,
+      error: 'SERVICE_UNAVAILABLE',
+      message: 'Конвертация PDF недоступна: не задан LLM_API_KEY',
+    };
+  }
+
+  let text: string;
+  try {
+    const result = await getPdfParse()(buffer);
+    text = result.text || '';
+  } catch (err) {
+    console.error('PDF extraction error:', err);
+    return {
+      status: 400,
+      error: 'BAD_REQUEST',
+      message: 'Не удалось обработать PDF-файл',
+    };
+  }
+
+  if (!text || text.trim().length === 0) {
+    return {
+      status: 400,
+      error: 'BAD_REQUEST',
+      message: 'Не удалось извлечь текст из PDF',
+    };
+  }
+
+  const openai = new OpenAI({
+    apiKey: config.llmApiKey,
+    ...(config.llmApiBaseUrl && { baseURL: config.llmApiBaseUrl }),
+    timeout: 5 * 60 * 1000,
+  });
+
+  try {
+    const completion = await openai.chat.completions.create({
+      model: config.llmModel,
+      messages: [
+        { role: 'system', content: PDF2JSON_PROMPT },
+        { role: 'user', content: `Текст выписки:\n\n${text}` },
+      ],
+      temperature: 0,
+      max_tokens: 32768,
+    });
+
+    const content = completion.choices[0]?.message?.content?.trim();
+    if (!content) {
+      return {
+        status: 422,
+        error: 'VALIDATION_ERROR',
+        message: 'Результат конвертации пуст',
+      };
+    }
+
+    return parseConversionResult(content);
+  } catch (err) {
+    console.error('LLM conversion error:', err);
+    return {
+      status: 502,
+      error: 'BAD_GATEWAY',
+      message: extractLlmErrorMessage(err),
+    };
+  }
+}
+
+export type ProgressStage = 'pdf' | 'llm' | 'import';
+export type OnProgress = (stage: ProgressStage, progress: number, message: string) => void;
+
+const LLM_PROGRESS_MIN = 10;
+const LLM_PROGRESS_MAX = 98;
+const LLM_PROGRESS_RANGE = LLM_PROGRESS_MAX - LLM_PROGRESS_MIN;
+const THROTTLE_MS = 300;
+
+function yieldToEventLoop(): Promise<void> {
+  return new Promise(resolve => setImmediate(resolve));
+}
+
+export async function convertPdfToStatementStreaming(
+  buffer: Buffer,
+  onProgress: OnProgress,
+): Promise<StatementFile | PdfConversionError> {
+  if (!config.llmApiKey || config.llmApiKey.trim() === '') {
+    return {
+      status: 503,
+      error: 'SERVICE_UNAVAILABLE',
+      message: 'Конвертация PDF недоступна: не задан LLM_API_KEY',
+    };
+  }
+
+  onProgress('pdf', 2, 'Извлечение текста из PDF...');
+  await yieldToEventLoop();
+
+  let text: string;
+  try {
+    const result = await getPdfParse()(buffer);
+    text = result.text || '';
+  } catch (err) {
+    console.error('PDF extraction error:', err);
+    return {
+      status: 400,
+      error: 'BAD_REQUEST',
+      message: 'Не удалось обработать PDF-файл',
+    };
+  }
+
+  if (!text || text.trim().length === 0) {
+    return {
+      status: 400,
+      error: 'BAD_REQUEST',
+      message: 'Не удалось извлечь текст из PDF',
+    };
+  }
+
+  onProgress('pdf', 8, 'Текст извлечён, отправка в LLM...');
+  await yieldToEventLoop();
+
+  const openai = new OpenAI({
+    apiKey: config.llmApiKey,
+    ...(config.llmApiBaseUrl && { baseURL: config.llmApiBaseUrl }),
+    timeout: 5 * 60 * 1000,
+  });
+
+  try {
+    const stream = await openai.chat.completions.create({
+      model: config.llmModel,
+      messages: [
+        { role: 'system', content: PDF2JSON_PROMPT },
+        { role: 'user', content: `Текст выписки:\n\n${text}` },
+      ],
+      temperature: 0,
+      max_tokens: 32768,
+      stream: true,
+    });
+
+    const expectedChars = Math.max(2_000, Math.min(text.length * 2, 30_000));
+
+    let accumulated = '';
+    let charsReceived = 0;
+    let lastEmitTime = 0;
+
+    for await (const chunk of stream) {
+      const delta = chunk.choices[0]?.delta?.content;
+      if (delta) {
+        accumulated += delta;
+        charsReceived += delta.length;
+
+        const now = Date.now();
+        if (now - lastEmitTime >= THROTTLE_MS) {
+          const ratio = Math.min(1, charsReceived / expectedChars);
+          const llmProgress = Math.min(
+            LLM_PROGRESS_MAX,
+            Math.round(ratio * LLM_PROGRESS_RANGE + LLM_PROGRESS_MIN),
+          );
+          onProgress('llm', llmProgress, 'Конвертация через LLM...');
+          lastEmitTime = now;
+          // Let the event loop flush socket writes to the network
+          await yieldToEventLoop();
+        }
+      }
+    }
+
+    onProgress('llm', LLM_PROGRESS_MAX, 'LLM завершил, обработка результата...');
+    await yieldToEventLoop();
+
+    const content = accumulated.trim();
+    if (!content) {
+      return {
+        status: 422,
+        error: 'VALIDATION_ERROR',
+        message: 'Результат конвертации пуст',
+      };
+    }
+
+    return parseConversionResult(content);
+  } catch (err) {
+    console.error('LLM streaming error:', err);
+    return {
+      status: 502,
+      error: 'BAD_GATEWAY',
+      message: extractLlmErrorMessage(err),
+    };
+  }
+}
+
+function extractLlmErrorMessage(err: unknown): string {
+  const raw = String(
+    (err as Record<string, unknown>)?.message ??
+    (err as Record<string, Record<string, unknown>>)?.error?.message ?? '',
+  );
+  if (/context.length|n_ctx|too.many.tokens|maximum.context/i.test(raw)) {
+    return 'PDF-файл слишком большой для обработки. Попробуйте файл с меньшим количеством операций или используйте модель с большим контекстным окном.';
+  }
+  if (/timeout|timed?\s*out|ETIMEDOUT|ECONNREFUSED/i.test(raw)) {
+    return 'LLM-сервер не отвечает. Проверьте, что сервер запущен и доступен.';
+  }
+  return 'Временная ошибка конвертации';
+}
+
+function parseConversionResult(content: string): StatementFile | PdfConversionError {
+  const jsonMatch = content.match(/\{[\s\S]*\}/);
+  const jsonStr = jsonMatch ? jsonMatch[0] : content;
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(jsonStr);
+  } catch {
+    return {
+      status: 422,
+      error: 'VALIDATION_ERROR',
+      message: 'Результат конвертации не является валидным JSON',
+    };
+  }
+
+  const data = parsed as Record<string, unknown>;
+  if (data.schemaVersion !== '1.0') {
+    return {
+      status: 422,
+      error: 'VALIDATION_ERROR',
+      message: 'Результат конвертации не соответствует схеме 1.0',
+    };
+  }
+
+  return parsed as StatementFile;
+}

docs/backlog/api_import.md

@@ -2,7 +2,7 @@
 
 ## Назначение
 
-Эндпоинт принимает банковскую выписку в формате JSON 1.0 (см. `format.md`) и атомарно импортирует транзакции в БД.
+Эндпоинт принимает банковскую выписку (PDF или JSON) и атомарно импортирует транзакции в БД.
 
 ## Метод и URL
 
@@ -16,7 +16,15 @@
 
 ## Тело запроса
 
-JSON строго по схеме 1.0 (`format.md`). Content-Type: `application/json`.
+**Content-Type:** `multipart/form-data`. Поле: `file`.
+
+Допустимые типы файлов:
+- **PDF** — банковская выписка. Конвертируется в JSON 1.0 через LLM (требуется `LLM_API_KEY`).
+- **JSON** — файл по схеме 1.0 (см. `format.md`).
+
+При другом типе файла — `400 Bad Request`: «Допустимы только файлы PDF или JSON».
+
+Пример структуры JSON 1.0:
 
 ```json
 {
@@ -207,6 +215,8 @@ accountNumber|operationAt|amountSigned|commission|normalizedDescription
 | Код | Ситуация                                                                 |
 |-----|--------------------------------------------------------------------------|
 | 200 | Импорт выполнен успешно                                                  |
-| 400 | Невалидный JSON или нарушение структуры схемы 1.0                        |
+| 400 | Файл не загружен; неверный тип (не PDF и не JSON); некорректный JSON; ошибка извлечения текста из PDF |
 | 401 | Нет действующей сессии                                                   |
-| 422 | Семантическая ошибка валидации (некорректные данные, ошибка при вставке)  |
+| 422 | Семантическая ошибка валидации; результат конвертации PDF не соответствует схеме 1.0 |
+| 502 | Ошибка LLM при конвертации PDF                                           |
+| 503 | Конвертация PDF недоступна (не задан LLM_API_KEY)                       |

frontend/nginx.conf

@@ -3,6 +3,22 @@ server {
     root /usr/share/nginx/html;
     index index.html;
 
+    # Import endpoint — SSE streaming, long timeout, no buffering
+    location /api/import {
+        proxy_pass http://family-budget-backend:3000;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_cookie_path / /;
+        proxy_connect_timeout 5s;
+        proxy_read_timeout 600s;
+        proxy_buffering off;
+        gzip off;
+        client_max_body_size 15m;
+    }
+
     # API — проксируем на backend (сервис из docker-compose)
     location /api {
         proxy_pass http://family-budget-backend:3000;

frontend/src/App.tsx

@@ -1,5 +1,6 @@
 import { Routes, Route, Navigate } from 'react-router-dom';
 import { useAuth } from './context/AuthContext';
+import { ImportProvider } from './context/ImportContext';
 import { Layout } from './components/Layout';
 import { LoginPage } from './pages/LoginPage';
 import { HistoryPage } from './pages/HistoryPage';
@@ -18,6 +19,7 @@ export function App() {
   }
 
   return (
+    <ImportProvider>
       <Layout>
         <Routes>
           <Route path="/" element={<Navigate to="/history" replace />} />
@@ -27,5 +29,6 @@ export function App() {
           <Route path="*" element={<Navigate to="/history" replace />} />
         </Routes>
       </Layout>
+    </ImportProvider>
   );
 }

frontend/src/api/client.ts

@@ -53,6 +53,40 @@ async function request<T>(url: string, options: RequestInit = {}): Promise<T> {
   return res.json();
 }
 
+async function requestFormData<T>(url: string, formData: FormData): Promise<T> {
+  const res = await fetch(url, {
+    method: 'POST',
+    body: formData,
+    credentials: 'include',
+    // Do not set Content-Type — browser sets multipart/form-data with boundary
+  });
+
+  if (res.status === 401) {
+    let body: ApiError;
+    try {
+      body = await res.json();
+    } catch {
+      body = { error: 'UNAUTHORIZED', message: 'Сессия истекла' };
+    }
+    if (!url.includes('/api/auth/login')) {
+      onUnauthorized?.();
+    }
+    throw new ApiException(401, body);
+  }
+
+  if (!res.ok) {
+    let body: ApiError;
+    try {
+      body = await res.json();
+    } catch {
+      body = { error: 'UNKNOWN', message: res.statusText };
+    }
+    throw new ApiException(res.status, body);
+  }
+
+  return res.json();
+}
+
 export const api = {
   get: <T>(url: string) => request<T>(url),
 
@@ -62,6 +96,9 @@ export const api = {
       body: body != null ? JSON.stringify(body) : undefined,
     }),
 
+  postFormData: <T>(url: string, formData: FormData) =>
+    requestFormData<T>(url, formData),
+
   put: <T>(url: string, body: unknown) =>
     request<T>(url, { method: 'PUT', body: JSON.stringify(body) }),
 

frontend/src/api/import.ts

@@ -2,7 +2,83 @@ import type { ImportStatementResponse } from '@family-budget/shared';
 import { api } from './client';
 
 export async function importStatement(
-  file: unknown,
+  file: File,
 ): Promise<ImportStatementResponse> {
-  return api.post<ImportStatementResponse>('/api/import/statement', file);
+  const formData = new FormData();
+  formData.append('file', file);
+  return api.postFormData<ImportStatementResponse>(
+    '/api/import/statement',
+    formData,
+  );
+}
+
+export interface SseProgressEvent {
+  stage: 'pdf' | 'llm' | 'import';
+  progress: number;
+  message: string;
+}
+
+export interface SseDoneEvent {
+  stage: 'done';
+  progress: 100;
+  result: ImportStatementResponse;
+}
+
+export interface SseErrorEvent {
+  stage: 'error';
+  message: string;
+}
+
+export type SseEvent = SseProgressEvent | SseDoneEvent | SseErrorEvent;
+
+export async function importStatementStream(
+  file: File,
+  onEvent: (event: SseEvent) => void,
+): Promise<void> {
+  const formData = new FormData();
+  formData.append('file', file);
+
+  const res = await fetch('/api/import/statement', {
+    method: 'POST',
+    body: formData,
+    credentials: 'include',
+  });
+
+  if (!res.ok) {
+    let msg = 'Ошибка импорта';
+    try {
+      const body = await res.json();
+      if (body.message) msg = body.message;
+    } catch { /* use default */ }
+    onEvent({ stage: 'error', message: msg });
+    return;
+  }
+
+  const reader = res.body?.getReader();
+  if (!reader) {
+    onEvent({ stage: 'error', message: 'Streaming не поддерживается' });
+    return;
+  }
+
+  const decoder = new TextDecoder();
+  let buffer = '';
+
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+
+    buffer += decoder.decode(value, { stream: true });
+
+    const lines = buffer.split('\n');
+    buffer = lines.pop() ?? '';
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed.startsWith('data: ')) continue;
+      try {
+        const parsed = JSON.parse(trimmed.slice(6)) as SseEvent;
+        onEvent(parsed);
+      } catch { /* skip malformed lines */ }
+    }
+  }
 }

frontend/src/components/ImportModal.tsx

@@ -2,6 +2,7 @@ import { useState, useRef } from 'react';
 import type { ImportStatementResponse } from '@family-budget/shared';
 import { importStatement } from '../api/import';
 import { updateAccount } from '../api/accounts';
+import { useImport } from '../context/ImportContext';
 
 interface Props {
   onClose: () => void;
@@ -9,41 +10,70 @@ interface Props {
 }
 
 export function ImportModal({ onClose, onDone }: Props) {
-  const [result, setResult] = useState<ImportStatementResponse | null>(null);
+  const { importState, startImport, clearImport } = useImport();
-  const [error, setError] = useState('');
+
-  const [loading, setLoading] = useState(false);
+  const [jsonResult, setJsonResult] = useState<ImportStatementResponse | null>(null);
+  const [jsonError, setJsonError] = useState('');
+  const [jsonLoading, setJsonLoading] = useState(false);
   const [alias, setAlias] = useState('');
   const [aliasSaved, setAliasSaved] = useState(false);
   const fileRef = useRef<HTMLInputElement>(null);
 
+  const result = importState.result ?? jsonResult;
+  const error = importState.error || jsonError;
+  const loading = importState.active || jsonLoading;
+
   const handleFileChange = async (
     e: React.ChangeEvent<HTMLInputElement>,
   ) => {
     const file = e.target.files?.[0];
     if (!file) return;
 
-    setLoading(true);
+    const name = file.name.toLowerCase();
-    setError('');
+    const type = file.type;
-    setResult(null);
+    const isPdf = type === 'application/pdf' || name.endsWith('.pdf');
+    const isJson = type === 'application/json' || name.endsWith('.json');
 
+    if (!isPdf && !isJson) {
+      setJsonError('Допустимы только файлы PDF или JSON');
+      return;
+    }
+
+    setJsonError('');
+    setJsonResult(null);
+
+    if (isPdf) {
+      startImport(file);
+      return;
+    }
+
+    setJsonLoading(true);
     try {
-      const text = await file.text();
+      const resp = await importStatement(file);
-      const json = JSON.parse(text);
+      setJsonResult(resp);
-      const resp = await importStatement(json);
-      setResult(resp);
     } catch (err: unknown) {
-      if (err instanceof SyntaxError) {
-        setError('Некорректный JSON-файл');
-      } else {
       const msg =
         err instanceof Error ? err.message : 'Ошибка импорта';
-        setError(msg);
+      setJsonError(msg);
-      }
     } finally {
-      setLoading(false);
+      setJsonLoading(false);
     }
   };
 
+  const handleClose = () => {
+    if (importState.active) {
+      if (window.confirm('Импорт продолжится в фоне. Закрыть окно?')) {
+        onClose();
+      }
+    } else {
+      onClose();
+    }
+  };
+
+  const handleDone = () => {
+    onDone();
+  };
+
   const handleSaveAlias = async () => {
     if (!result || !alias.trim()) return;
     try {
@@ -54,12 +84,21 @@ export function ImportModal({ onClose, onDone }: Props) {
     }
   };
 
+  const stageLabel = (stage: string) => {
+    switch (stage) {
+      case 'pdf': return 'Извлечение текста...';
+      case 'llm': return 'Конвертация через LLM...';
+      case 'import': return 'Сохранение в базу...';
+      default: return 'Обработка...';
+    }
+  };
+
   return (
-    <div className="modal-overlay" onClick={onClose}>
+    <div className="modal-overlay" onClick={handleClose}>
       <div className="modal" onClick={(e) => e.stopPropagation()}>
         <div className="modal-header">
           <h2>Импорт выписки</h2>
-          <button className="btn-close" onClick={onClose}>
+          <button className="btn-close" onClick={handleClose}>
             &times;
           </button>
         </div>
@@ -67,25 +106,42 @@ export function ImportModal({ onClose, onDone }: Props) {
         <div className="modal-body">
           {error && <div className="alert alert-error">{error}</div>}
 
-          {!result && (
+          {!result && !importState.active && (
             <div className="import-upload">
-              <p>Выберите JSON-файл выписки (формат 1.0)</p>
+              <p>Выберите файл выписки (PDF или JSON, формат 1.0)</p>
               <input
                 ref={fileRef}
                 type="file"
-                accept=".json"
+                accept=".pdf,.json,application/pdf,application/json"
                 onChange={handleFileChange}
                 className="file-input"
+                disabled={loading}
               />
-              {loading && (
+              {jsonLoading && (
                 <div className="import-loading">Импорт...</div>
               )}
             </div>
           )}
 
+          {importState.active && (
+            <div className="import-upload">
+              <div className="import-progress-modal">
+                <div className="import-progress-modal-bar">
+                  <div
+                    className="import-progress-modal-fill"
+                    style={{ width: `${importState.progress}%` }}
+                  />
+                </div>
+                <p className="import-progress-modal-label">
+                  {stageLabel(importState.stage)} {importState.progress}%
+                </p>
+              </div>
+            </div>
+          )}
+
           {result && (
             <div className="import-result">
-              <div className="import-result-icon">&check;</div>
+              <div className="import-result-icon" aria-hidden="true">✓</div>
               <h3>Импорт завершён</h3>
               <table className="import-stats">
                 <tbody>
@@ -145,16 +201,15 @@ export function ImportModal({ onClose, onDone }: Props) {
 
         <div className="modal-footer">
           {result ? (
-            <button className="btn btn-primary" onClick={onDone}>
+            <button className="btn btn-primary" onClick={handleDone}>
               Готово
             </button>
           ) : (
             <button
               className="btn btn-secondary"
-              onClick={onClose}
+              onClick={handleClose}
-              disabled={loading}
             >
-              Отмена
+              {importState.active ? 'Свернуть' : 'Отмена'}
             </button>
           )}
         </div>

frontend/src/components/Layout.tsx

@@ -1,6 +1,70 @@
-import { useState, type ReactNode } from 'react';
+import { useState, useEffect, useRef, useCallback, type ReactNode } from 'react';
 import { NavLink } from 'react-router-dom';
 import { useAuth } from '../context/AuthContext';
+import { useImport } from '../context/ImportContext';
+
+function ImportProgressBar() {
+  const { importState, clearImport, openModal } = useImport();
+  const [visible, setVisible] = useState(false);
+  const hideTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
+
+  const isActive = importState.active;
+  const isDone = importState.stage === 'done';
+  const isError = importState.stage === 'error';
+  const showBar = isActive || isDone || isError;
+
+  useEffect(() => {
+    if (showBar) {
+      setVisible(true);
+      if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
+    }
+    if (isDone || isError) {
+      hideTimerRef.current = setTimeout(() => {
+        setVisible(false);
+        clearImport();
+      }, 10_000);
+    }
+    return () => {
+      if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
+    };
+  }, [showBar, isDone, isError, clearImport]);
+
+  const handleClick = useCallback(() => {
+    if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
+    openModal();
+    setVisible(false);
+  }, [openModal]);
+
+  if (!visible) return null;
+
+  const barClass = isError
+    ? 'import-progress-bar import-progress-bar--error'
+    : isDone
+      ? 'import-progress-bar import-progress-bar--done'
+      : 'import-progress-bar';
+
+  const labelText = isError
+    ? `Ошибка импорта: ${importState.message}`
+    : isDone && importState.result
+      ? `Импорт завершён — ${importState.result.imported} операций`
+      : `${importState.message} ${importState.progress}%`;
+
+  return (
+    <div className={barClass}>
+      <div
+        className="import-progress-bar__fill"
+        style={{ width: `${isDone ? 100 : importState.progress}%` }}
+      />
+      <button
+        type="button"
+        className={`import-progress-label ${isDone || isError ? 'import-progress-label--clickable' : ''}`}
+        onClick={isDone || isError ? handleClick : undefined}
+      >
+        {labelText}
+      </button>
+    </div>
+  );
+}
 
 export function Layout({ children }: { children: ReactNode }) {
   const { user, logout } = useAuth();
@@ -10,6 +74,8 @@ export function Layout({ children }: { children: ReactNode }) {
 
   return (
     <div className="layout">
+      <ImportProgressBar />
+
       <button
         type="button"
         className="burger-btn"

frontend/src/context/ImportContext.tsx

@@ -0,0 +1,114 @@
+import {
+  createContext,
+  useContext,
+  useState,
+  useCallback,
+  useRef,
+  type ReactNode,
+} from 'react';
+import type { ImportStatementResponse } from '@family-budget/shared';
+import { importStatementStream, type SseEvent } from '../api/import';
+
+export interface ImportProgress {
+  active: boolean;
+  stage: string;
+  progress: number;
+  message: string;
+  result?: ImportStatementResponse;
+  error?: string;
+}
+
+interface ImportContextValue {
+  importState: ImportProgress;
+  showModal: boolean;
+  openModal: () => void;
+  closeModal: () => void;
+  startImport: (file: File) => void;
+  clearImport: () => void;
+}
+
+const INITIAL: ImportProgress = {
+  active: false,
+  stage: '',
+  progress: 0,
+  message: '',
+};
+
+const ImportContext = createContext<ImportContextValue | null>(null);
+
+export function ImportProvider({ children }: { children: ReactNode }) {
+  const [importState, setImportState] = useState<ImportProgress>(INITIAL);
+  const [showModal, setShowModal] = useState(false);
+  const runningRef = useRef(false);
+
+  const openModal = useCallback(() => setShowModal(true), []);
+  const closeModal = useCallback(() => setShowModal(false), []);
+
+  const startImport = useCallback((file: File) => {
+    if (runningRef.current) return;
+    runningRef.current = true;
+
+    setImportState({
+      active: true,
+      stage: 'pdf',
+      progress: 0,
+      message: 'Загрузка файла...',
+    });
+
+    importStatementStream(file, (event: SseEvent) => {
+      if (event.stage === 'done') {
+        setImportState({
+          active: false,
+          stage: 'done',
+          progress: 100,
+          message: 'Импорт завершён',
+          result: event.result,
+        });
+        runningRef.current = false;
+      } else if (event.stage === 'error') {
+        setImportState({
+          active: false,
+          stage: 'error',
+          progress: 0,
+          message: event.message,
+          error: event.message,
+        });
+        runningRef.current = false;
+      } else {
+        setImportState({
+          active: true,
+          stage: event.stage,
+          progress: event.progress,
+          message: event.message,
+        });
+      }
+    }).catch((err) => {
+      setImportState({
+        active: false,
+        stage: 'error',
+        progress: 0,
+        message: err instanceof Error ? err.message : 'Ошибка импорта',
+        error: err instanceof Error ? err.message : 'Ошибка импорта',
+      });
+      runningRef.current = false;
+    });
+  }, []);
+
+  const clearImport = useCallback(() => {
+    setImportState(INITIAL);
+  }, []);
+
+  return (
+    <ImportContext.Provider value={{
+      importState, showModal, openModal, closeModal, startImport, clearImport,
+    }}>
+      {children}
+    </ImportContext.Provider>
+  );
+}
+
+export function useImport(): ImportContextValue {
+  const ctx = useContext(ImportContext);
+  if (!ctx) throw new Error('useImport must be used within ImportProvider');
+  return ctx;
+}

frontend/src/pages/HistoryPage.tsx

@@ -18,6 +18,7 @@ import { TransactionTable } from '../components/TransactionTable';
 import { Pagination } from '../components/Pagination';
 import { EditTransactionModal } from '../components/EditTransactionModal';
 import { ImportModal } from '../components/ImportModal';
+import { useImport } from '../context/ImportContext';
 import { toISODate } from '../utils/format';
 
 const PARAM_KEYS = [
@@ -125,7 +126,7 @@ export function HistoryPage() {
   const [accounts, setAccounts] = useState<Account[]>([]);
   const [categories, setCategories] = useState<Category[]>([]);
   const [editingTx, setEditingTx] = useState<Transaction | null>(null);
-  const [showImport, setShowImport] = useState(false);
+  const { showModal: showImport, openModal: openImport, closeModal: closeImport, clearImport } = useImport();
 
   useEffect(() => {
     getAccounts().then(setAccounts).catch(() => {});
@@ -197,7 +198,8 @@ export function HistoryPage() {
   };
 
   const handleImportDone = () => {
-    setShowImport(false);
+    closeImport();
+    clearImport();
     fetchData();
     getAccounts().then(setAccounts).catch(() => {});
   };
@@ -208,7 +210,7 @@ export function HistoryPage() {
         <h1>История операций</h1>
         <button
           className="btn btn-primary"
-          onClick={() => setShowImport(true)}
+          onClick={openImport}
         >
           Импорт выписки
         </button>
@@ -262,7 +264,7 @@ export function HistoryPage() {
 
       {showImport && (
         <ImportModal
-          onClose={() => setShowImport(false)}
+          onClose={closeImport}
           onDone={handleImportDone}
         />
       )}

frontend/src/styles/index.css

@@ -1058,6 +1058,152 @@ textarea {
   font-weight: 500;
 }
 
+/* Import progress bar in modal */
+.import-progress-modal {
+  padding: 20px 0;
+}
+
+.import-progress-modal-bar {
+  height: 8px;
+  background: var(--color-border);
+  border-radius: 4px;
+  overflow: hidden;
+  margin-bottom: 10px;
+}
+
+.import-progress-modal-fill {
+  height: 100%;
+  background: linear-gradient(90deg, var(--color-primary), #6366f1);
+  border-radius: 4px;
+  transition: width 0.3s ease;
+  position: relative;
+}
+
+.import-progress-modal-fill::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(
+    90deg,
+    transparent 0%,
+    rgba(255, 255, 255, 0.3) 50%,
+    transparent 100%
+  );
+  animation: shimmer 1.5s infinite;
+}
+
+.import-progress-modal-label {
+  text-align: center;
+  color: var(--color-text-secondary);
+  font-size: 14px;
+}
+
+/* ================================================================
+   Import progress bar (fixed top, Layout)
+   ================================================================ */
+
+.import-progress-bar {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  z-index: 300;
+  height: 4px;
+  background: var(--color-border);
+}
+
+.import-progress-bar--done {
+  background: var(--color-success-light);
+}
+
+.import-progress-bar--error {
+  background: var(--color-danger-light);
+}
+
+.import-progress-bar__fill {
+  height: 100%;
+  border-radius: 0 2px 2px 0;
+  transition: width 0.3s ease;
+  position: relative;
+  background: linear-gradient(90deg, var(--color-primary), #6366f1);
+}
+
+.import-progress-bar__fill::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(
+    90deg,
+    transparent 0%,
+    rgba(255, 255, 255, 0.4) 50%,
+    transparent 100%
+  );
+  animation: shimmer 1.5s infinite;
+}
+
+.import-progress-bar--done .import-progress-bar__fill {
+  background: var(--color-success);
+}
+
+.import-progress-bar--done .import-progress-bar__fill::after {
+  animation: none;
+}
+
+.import-progress-bar--error .import-progress-bar__fill {
+  background: var(--color-danger);
+  width: 100% !important;
+}
+
+.import-progress-bar--error .import-progress-bar__fill::after {
+  animation: none;
+}
+
+@keyframes shimmer {
+  0% {
+    transform: translateX(-100%);
+  }
+  100% {
+    transform: translateX(100%);
+  }
+}
+
+.import-progress-label {
+  position: fixed;
+  top: 6px;
+  right: 16px;
+  z-index: 301;
+  background: var(--color-surface);
+  border: 1px solid var(--color-border);
+  border-radius: 16px;
+  padding: 4px 14px;
+  font-size: 12px;
+  font-weight: 500;
+  color: var(--color-text-secondary);
+  box-shadow: var(--shadow-sm);
+  white-space: nowrap;
+  cursor: default;
+  font-family: inherit;
+}
+
+.import-progress-label--clickable {
+  cursor: pointer;
+}
+
+.import-progress-label--clickable:hover {
+  background: var(--color-bg);
+  border-color: var(--color-border-hover);
+}
+
+.import-progress-bar--done .import-progress-label {
+  color: var(--color-success);
+  border-color: var(--color-success);
+}
+
+.import-progress-bar--error .import-progress-label {
+  color: var(--color-danger);
+  border-color: var(--color-danger);
+}
+
 /* ================================================================
    Tabs
    ================================================================ */

package-lock.json

@@ -22,6 +22,9 @@
         "cors": "^2.8.6",
         "dotenv": "^17.3.1",
         "express": "^5.2.1",
+        "multer": "^2.1.1",
+        "openai": "^6.27.0",
+        "pdf-parse": "1.1.1",
         "pg": "^8.19.0",
         "uuid": "^13.0.0"
       },
@@ -29,6 +32,7 @@
         "@types/cookie-parser": "^1.4.10",
         "@types/cors": "^2.8.19",
         "@types/express": "^5.0.6",
+        "@types/multer": "^2.1.0",
         "@types/node": "^25.3.3",
         "@types/pg": "^8.18.0",
         "@types/uuid": "^10.0.0",
@@ -36,6 +40,28 @@
         "typescript": "^5.9.3"
       }
     },
+    "backend/node_modules/debug": {
+      "version": "3.2.7",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz",
+      "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.1"
+      }
+    },
+    "backend/node_modules/pdf-parse": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/pdf-parse/-/pdf-parse-1.1.1.tgz",
+      "integrity": "sha512-v6ZJ/efsBpGrGGknjtq9J/oC8tZWq0KWL5vQrk2GlzLEQPUDB1ex+13Rmidl1neNN358Jn9EHZw5y07FFtaC7A==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^3.1.0",
+        "node-ensure": "^0.0.0"
+      },
+      "engines": {
+        "node": ">=6.8.1"
+      }
+    },
     "frontend": {
       "name": "@family-budget/frontend",
       "version": "0.1.0",
@@ -1394,6 +1420,16 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/multer": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@types/multer/-/multer-2.1.0.tgz",
+      "integrity": "sha512-zYZb0+nJhOHtPpGDb3vqPjwpdeGlGC157VpkqNQL+UU2qwoacoQ7MpsAmUptI/0Oa127X32JzWDqQVEXp2RcIA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/express": "*"
+      }
+    },
     "node_modules/@types/node": {
       "version": "25.3.3",
       "resolved": "https://registry.npmjs.org/@types/node/-/node-25.3.3.tgz",
@@ -1512,6 +1548,12 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/append-field": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/append-field/-/append-field-1.0.0.tgz",
+      "integrity": "sha512-klpgFSWLW1ZEs8svjfb7g4qWY0YS5imI82dTg+QahUvJ8YqAY0P10Uk8tTyh9ZGuYEZEMaeJYCF5BFuX552hsw==",
+      "license": "MIT"
+    },
     "node_modules/baseline-browser-mapping": {
       "version": "2.10.0",
       "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.0.tgz",
@@ -1583,6 +1625,23 @@
         "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
       }
     },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "license": "MIT"
+    },
+    "node_modules/busboy": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/busboy/-/busboy-1.6.0.tgz",
+      "integrity": "sha512-8SFQbg/0hQ9xy3UNTB0YEnsNBbWfhf7RtnzpL7TkBiTBRfrQ9Fxcnz7VJsleJpyp6rVLvXiuORqjlHi5q+PYuA==",
+      "dependencies": {
+        "streamsearch": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=10.16.0"
+      }
+    },
     "node_modules/bytes": {
       "version": "3.1.2",
       "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
@@ -1651,6 +1710,21 @@
         "node": ">=6"
       }
     },
+    "node_modules/concat-stream": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz",
+      "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==",
+      "engines": [
+        "node >= 6.0"
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^3.0.2",
+        "typedarray": "^0.0.6"
+      }
+    },
     "node_modules/content-disposition": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.0.1.tgz",
@@ -2470,6 +2544,68 @@
       "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
       "license": "MIT"
     },
+    "node_modules/multer": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/multer/-/multer-2.1.1.tgz",
+      "integrity": "sha512-mo+QTzKlx8R7E5ylSXxWzGoXoZbOsRMpyitcht8By2KHvMbf3tjwosZ/Mu/XYU6UuJ3VZnODIrak5ZrPiPyB6A==",
+      "license": "MIT",
+      "dependencies": {
+        "append-field": "^1.0.0",
+        "busboy": "^1.6.0",
+        "concat-stream": "^2.0.0",
+        "type-is": "^1.6.18"
+      },
+      "engines": {
+        "node": ">= 10.16.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/multer/node_modules/media-typer": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
+      "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/multer/node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/multer/node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/multer/node_modules/type-is": {
+      "version": "1.6.18",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
+      "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
+      "license": "MIT",
+      "dependencies": {
+        "media-typer": "0.3.0",
+        "mime-types": "~2.1.24"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
     "node_modules/nanoid": {
       "version": "3.3.11",
       "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
@@ -2498,6 +2634,12 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/node-ensure": {
+      "version": "0.0.0",
+      "resolved": "https://registry.npmjs.org/node-ensure/-/node-ensure-0.0.0.tgz",
+      "integrity": "sha512-DRI60hzo2oKN1ma0ckc6nQWlHU69RH6xN0sjQTjMpChPfTYvKZdcQFfdYK2RWbJcKyUizSIy/l8OTGxMAM1QDw==",
+      "license": "MIT"
+    },
     "node_modules/node-releases": {
       "version": "2.0.27",
       "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.27.tgz",
@@ -2547,6 +2689,27 @@
         "wrappy": "1"
       }
     },
+    "node_modules/openai": {
+      "version": "6.27.0",
+      "resolved": "https://registry.npmjs.org/openai/-/openai-6.27.0.tgz",
+      "integrity": "sha512-osTKySlrdYrLYTt0zjhY8yp0JUBmWDCN+Q+QxsV4xMQnnoVFpylgKGgxwN8sSdTNw0G4y+WUXs4eCMWpyDNWZQ==",
+      "license": "Apache-2.0",
+      "bin": {
+        "openai": "bin/cli"
+      },
+      "peerDependencies": {
+        "ws": "^8.18.0",
+        "zod": "^3.25 || ^4.0"
+      },
+      "peerDependenciesMeta": {
+        "ws": {
+          "optional": true
+        },
+        "zod": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/parseurl": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
@@ -2931,6 +3094,20 @@
         "react-dom": ">=16.6.0"
       }
     },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
     "node_modules/recharts": {
       "version": "2.15.4",
       "resolved": "https://registry.npmjs.org/recharts/-/recharts-2.15.4.tgz",
@@ -3034,6 +3211,26 @@
         "node": ">= 18"
       }
     },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
     "node_modules/safer-buffer": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
@@ -3213,6 +3410,23 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/streamsearch": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/streamsearch/-/streamsearch-1.1.0.tgz",
+      "integrity": "sha512-Mcc5wHehp9aXz1ax6bZUyY5afg9u2rv5cqQI3mRrYkGC8rW2hM02jWuwjtL++LS5qinSyhj2QfLyNsuc+VsExg==",
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
     "node_modules/tiny-invariant": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/tiny-invariant/-/tiny-invariant-1.3.3.tgz",
@@ -3278,7 +3492,6 @@
       "os": [
         "aix"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3296,7 +3509,6 @@
       "os": [
         "android"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3314,7 +3526,6 @@
       "os": [
         "android"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3332,7 +3543,6 @@
       "os": [
         "android"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3350,7 +3560,6 @@
       "os": [
         "darwin"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3368,7 +3577,6 @@
       "os": [
         "darwin"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3386,7 +3594,6 @@
       "os": [
         "freebsd"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3404,7 +3611,6 @@
       "os": [
         "freebsd"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3422,7 +3628,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3440,7 +3645,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3458,7 +3662,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3476,7 +3679,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3494,7 +3696,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3512,7 +3713,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3530,7 +3730,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3548,7 +3747,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3566,7 +3764,6 @@
       "os": [
         "linux"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3584,7 +3781,6 @@
       "os": [
         "netbsd"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3602,7 +3798,6 @@
       "os": [
         "netbsd"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3620,7 +3815,6 @@
       "os": [
         "openbsd"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3638,7 +3832,6 @@
       "os": [
         "openbsd"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3656,7 +3849,6 @@
       "os": [
         "openharmony"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3674,7 +3866,6 @@
       "os": [
         "sunos"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3692,7 +3883,6 @@
       "os": [
         "win32"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3710,7 +3900,6 @@
       "os": [
         "win32"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3728,7 +3917,6 @@
       "os": [
         "win32"
       ],
-      "peer": true,
       "engines": {
         "node": ">=18"
       }
@@ -3789,6 +3977,12 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/typedarray": {
+      "version": "0.0.6",
+      "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz",
+      "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==",
+      "license": "MIT"
+    },
     "node_modules/typescript": {
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
@@ -3850,6 +4044,12 @@
         "browserslist": ">= 4.21.0"
       }
     },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "license": "MIT"
+    },
     "node_modules/uuid": {
       "version": "13.0.0",
       "resolved": "https://registry.npmjs.org/uuid/-/uuid-13.0.0.tgz",

pdf2json.md

@@ -1,5 +1,3 @@
-# Промпт для конвертации PDF банковской выписки в JSON
-
 Ты — конвертер банковских выписок. Твоя задача: извлечь данные из прикреплённого PDF банковской выписки и вернуть строго один валидный JSON-объект в формате ниже. Никакого текста до или после JSON, только сам объект.
 
 ## Структура выходного JSON