# ORIGUS Core 0.3.0

Центральный backend экосистемы ORIGUS.

## AI Provider Layer

Поддерживаются бесплатные/опциональные провайдеры:

- `groq` — основной; default `openai/gpt-oss-120b`;
- `gemini` — резерв;
- `openrouter` — аварийный резерв.

Core использует OpenAI Python SDK только как совместимый HTTP client. Наличие
платного OpenAI API не требуется.

### Маршрутизация

`GET /api/ai/providers`

`POST /api/ai/providers/configure`

`POST /api/ai/providers/{provider}/test`

`POST /api/ai/settings`

Fallback по умолчанию выключен. Это сознательное решение: рабочие данные не
должны автоматически отправляться другому провайдеру без явного разрешения.

## Knowledge Base

`POST /api/knowledge/snapshots/{id}/analyze`

Перед AI Core выполняет локальную проверку полноты. Если текст ссылается на
статьи/приложения, которых в сохранённой копии нет, источник получает
`source_incomplete`, и юридические правила из такой копии не строятся.

Полные документы разбиваются на небольшие фрагменты. Это позволяет работать с
free-tier token limits и не отправлять весь большой документ одним запросом.

Все AI-извлечённые правила получают `review_required`.