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`, **не** хардкодит.
+
 ---
 
 ## Принципы