From 0640e7d47fb1de9e92836fe597e35962d5737894 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Wed, 15 Jul 2026 15:11:11 +0400
Subject: [PATCH] =?UTF-8?q?docs:=20=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=82=20?=
 =?UTF-8?q?=D0=B8=D0=BC=D1=91=D0=BD=20=D1=81=D0=BA=D0=B0=D1=87=D0=B8=D0=B2?=
 =?UTF-8?q?=D0=B0=D0=B5=D0=BC=D1=8B=D1=85=20=D1=84=D0=B0=D0=B9=D0=BB=D0=BE?=
 =?UTF-8?q?=D0=B2=20=D0=B2=20=D0=B0=D1=80=D1=85=D0=B8=D1=82=D0=B5=D0=BA?=
 =?UTF-8?q?=D1=82=D1=83=D1=80=D1=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 0a35cbb..8722d36 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -296,6 +296,21 @@ send_file(BytesIO(zip_data), mimetype="application/zip")
 HTTP 200 + ZIP-архив
 ```
 
+### Имена скачиваемых файлов
+
+Формат: `drhider_YYYY-MM-DD_HH-MM-SS.zip` и `mapping_YYYY-MM-DD_HH-MM-SS.csv`
+
+Время — московское (UTC+3). Генерируется на сервере в момент запроса:
+
+```python
+# api_bp.py — download() / csv_download()
+ts = (datetime.now() + timedelta(hours=3)).strftime("%Y-%m-%d_%H-%M-%S")
+download_name=f"drhider_{ts}.zip"   # → Content-Disposition
+download_name=f"mapping_{ts}.csv"   # → Content-Disposition
+```
+
+Фронтенд (JS) читает имя из заголовка `Content-Disposition`, **не** хардкодит.
+
 ---
 
 ## Принципы