# llm_project — карта файлов AI-ассистента

Всё, что связано с AI-ассистентом документации: планы, документация, тесты, диагностика.

## Главное

| Файл | Что |
|---|---|
| **[docs/ASSISTANT_ARCHITECTURE.md](docs/ASSISTANT_ARCHITECTURE.md)** | **Полная документация**: архитектура, API, поиск, безопасность, деплой, тесты, эмбеддинги v2, инциденты |
| **[docs/ROADMAP_AND_LIMITS.md](docs/ROADMAP_AND_LIMITS.md)** | **Дорожная карта, границы применимости, план тестирования (DevOps), варианты сбора данных** |
| [PLAN_docs_ai_assistant_STEPS.md](PLAN_docs_ai_assistant_STEPS.md) | План по шагам (11 этапов) |

## Диагностика и обоснования

| Файл | Что |
|---|---|
| [probe/RESULTS.md](probe/RESULTS.md) | Результаты live-проверки `api.aillm.ru` (response_format, reasoning_effort, лимиты) |
| [probe/probe_aillm.js](probe/probe_aillm.js) | Скрипт-пробник API |
| [golden/EVAL_1.md](golden/EVAL_1.md) | Оценка поиска на эталонном наборе |
| [golden/golden_questions.json](golden/golden_questions.json) | 28 эталонных вопросов с ожидаемыми страницами |
| [tests/ANALYSIS_bad_llm_output.md](tests/ANALYSIS_bad_llm_output.md) | Разбор отказов 502, причины и фиксы |

## Тесты и авто

| Файл | Что |
|---|---|
| [tests/run_e2e_live.js](tests/run_e2e_live.js) | Прогон 62 вопросов по живому эндпоинту (учёт 429) |
| [tests/redeploy.js](tests/redeploy.js) | Redeploy tf-docs через Nubes API |
| [tests/debug_bad_llm_output.js](tests/debug_bad_llm_output.js) | Захват сырого ответа LLM (диагностика) |
| [tests/RESULTS_LIVE.md](tests/RESULTS_LIVE.md) / .json | Результаты прогонов (5 итераций) |

## Как запускать

```bash
# прогон тестов на живом стенде
node llm_project/tests/run_e2e_live.js --stand nubes-test

# redeploy сервиса
node llm_project/tests/redeploy.js
```

## Связанные HowTo

- `~/nubes/HowTo/howto-publish-docs-site.md` — публикация сайта (виджет).
- `~/nubes/HowTo/howto-tf-docs-redeploy-api.md` — redeploy через API.
- `~/nubes/HowTo/howto-sync-to-vm213.md` — синк на ВМ 213.