tf_docs

Проект документации Terraform.

Репозиторий создан как основа для документации по проекту Terraform (провайдеры, модули, схемы, история изменений и т.д.).

Содержимое будет дополняться по мере развития проекта.

AI-ассистент документации

Сервис — обратный прокси статики документации и эндпоинт AI-ассистента.

📖 Полная документация ассистента (архитектура, поиск, безопасность, деплой, эмбеддинги v2, инциденты): llm_project/docs/ASSISTANT_ARCHITECTURE.md. Карта файлов проекта: llm_project/README.md.

Эндпоинт

POST /<stand>/_api/assist — тело {"question": "текст вопроса"}.

Ответ 200:

{
  "answer": "ответ по шаблону Роль/Задача/Контекст/Требования/Ограничения",
  "sources": [{"title": "...", "url": "/<stand>/..."}],
  "meta": {"model": "...", "resource_type": "nubes_...", "elapsed_ms": 1234}
}

Ошибки (JSON {"error": code, "message": ...}): 400/413/415 (невалидный ввод), 429 (rate-limit, Retry-After), 502 (bad_llm_output), 503 (busy / индекс недоступен).

Переменные окружения

Имя	По умолчанию	Назначение
VM_DOCS_BASE_URL	— (обязательна)	базовый URL статики (upstream)
LLM_BASE_URL	—	https://api.aillm.ru
LLM_API_KEY	—	ключ ЛЛМ (брать из Secret, не логировать)
LLM_MODEL	gpt-oss-120b	модель
ASSIST_MAX_CONCURRENT	4	семафор одновременных вызовов ЛЛМ
ASSIST_TOTAL_DEADLINE_MS	40000	общий дедлайн запроса
ASSIST_LLM_TIMEOUT_MS	25000	таймаут одного вызова ЛЛМ
ASSIST_RATE_PER_WINDOW	6	лимит запросов на IP за окно
ASSIST_RATE_WINDOW_MS	60000	окно rate-limit
ASSIST_REPLICAS	1	число реплик (для деления лимита)
ASSIST_MAX_BODY	2048	макс. размер тела запроса
ASSIST_TRUSTED_PROXY_CIDR	—	CIDR доверенного proxy (для X-Forwarded-For)