From 444ef4b732bb40dfaf77e6865a5c0ca9f1c8694b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Tue, 14 Jul 2026 07:04:42 +0400
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=20=C2=AB?=
 =?UTF-8?q?=D0=9F=D0=BE=D0=B4=D0=B4=D0=B5=D1=80=D0=B6=D0=B8=D0=B2=D0=B0?=
 =?UTF-8?q?=D0=B5=D0=BC=D1=8B=D0=B5=20=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=82?=
 =?UTF-8?q?=D1=8B=C2=BB=20=D0=B2=20ARCHITECTURE.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ARCHITECTURE.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 4c8ee48..fa14ece 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -37,6 +37,20 @@ site/app.py  ──→  Flask (create_app)
 
 ---
 
+## Поддерживаемые форматы файлов
+
+| Формат | Обработка | Детали |
+|--------|-----------|--------|
+| **`.docx`** | → Markdown | Заголовки (H1–H3), **жирный**, *курсив*, таблицы (`python-docx`) |
+| **`.pdf`** | → Markdown | Текст + таблицы (`pdfplumber`), без форматирования |
+| **`.txt`** и прочие текстовые | → как есть | Декодируется UTF-8, ошибки заменяются `�` |
+| **`.zip`** | → распаковка | Файлы внутри обрабатываются рекурсивно. Защита от ZIP-бомб: ≤500 файлов, ratio ≤100:1, ≤500 MB |
+| **`.doc`** (бинарный) | ❌ не поддерживается | Возвращает заглушку `[DOC binary — not supported. Convert to .docx first.]` |
+
+Ограничение на размер загрузки: **200 MB** (`MAX_CONTENT_LENGTH`).
+
+---
+
 ## Двухпроходная обфускация
 
 ### Проход 1: сбор сущностей