v0.0.45: тестовый API process_names — обфускация файлов по именам (только при валидном TEST_INPUT_DIR)

2026-08-19 14:47:16 +04:00
parent 2224e20bde
commit 8d7a7dfaf6
3 changed files with 116 additions and 1 deletions
@@ -0,0 +1,57 @@
+# v0.0.45 — тестовый API process_names (обфускация по именам файлов) — 2026-08-19
+
+**Дата:** 2026-08-19
+**Версия:** 0.0.44 → 0.0.45
+
+---
+
+## Суть
+
+Тестовый endpoint для curl: обфускация файлов по ИМЕНАМ из локальной папки
+сервера (не таскать файлы каждый раз).
+
+## Использование
+
+```bash
+# На сервере задана папка TEST_INPUT_DIR (env), в ней лежат входные файлы.
+curl -X POST https://drhider.../api/process_names \
+  -H "Content-Type: application/json" \
+  -d '{"files": ["0144-03-2023_отчет об оценке.pdf", "test.pdf"]}' \
+  -o result.zip
+```
+
+Ответ: ZIP с обфусцированными .md + mapping.csv.
+
+## Поведение (по требованию)
+
+- **Если `TEST_INPUT_DIR` не задан ИЛИ невалиден (не директория) — endpoint
+  возвращает 404** (как будто API нет).
+- Имена файлов — только **basename** (защита от path traversal).
+- Файл читается из `TEST_INPUT_DIR/<basename>`; если нет → 404.
+
+## Изменения
+
+### `site/routes/api_bp.py`
+- `import os` добавлен.
+- Глобальные `TEST_INPUT_DIR = os.environ.get("TEST_INPUT_DIR", "").strip()`
+  и `_TEST_API_ENABLED = bool(TEST_INPUT_DIR) and os.path.isdir(TEST_INPUT_DIR)`.
+- Endpoint `POST /api/process_names`:
+  - 404 если `_TEST_API_ENABLED` false;
+  - читает JSON `{"files": [...]}`;
+  - basename + проверка файла в TEST_INPUT_DIR;
+  - `obfuscate_files(all_files, llm_client=LLMClient())`;
+  - возврат ZIP (`send_file`).
+
+### `site/app.py`
+- `VERSION = "0.0.45"`.
+
+## Проверка
+- Без `TEST_INPUT_DIR` → 404.
+- С валидной папкой → 200, ZIP `['t.md', 'mapping.csv']`.
+- Path traversal (`../../etc/passwd`) → 404 «файл не найден».
+- Невалидная папка → 404.
+- `py_compile` — OK.
+
+## Примечание
+- Endpoint тестовый. На проде включать только при необходимости (задать TEST_INPUT_DIR).
+- В тесте локально LLM недоступен (нет ключа) — «LLM NER failed» ожидаемо; на проде ключ есть.