# Подбор — маркетплейс рекрутеров

> Подбор (podbor.site) — рекрутерский маркетплейс: заказчики размещают вакансии, рекрутеры откликаются с ценой и сроком, заказчик выбирает исполнителя в чате. Комиссия 0%, монетизация — фиксированная дневная подписка рекрутера (49 ₽/день). AI-помощник доступен 24/7.

## Описание

Подбор соединяет две стороны:
- **Заказчики (CUSTOMER)** — создают вакансии (заголовок, описание, категория, бюджет, дедлайн), получают 5–15 откликов за сутки, выбирают одного рекрутера, общаются в чате, закрывают вакансию и оставляют отзыв.
- **Рекрутеры (RECRUITER)** — просматривают открытую ленту, откликаются (цена + срок + сообщение), ждут выбора заказчика, работают в чате, получают оплату напрямую от заказчика.

Платформа не участвует в расчётах, не берёт комиссию. Все заказчики подтверждают email и бюджет.

## Основные разделы

- [Главная](https://podbor.site/#/) — лендинг, KPI, лента вакансий
- [Все вакансии](https://podbor.site/#/feed) — открытая лента с фильтрами
- [Как это работает](https://podbor.site/#/support) — поддержка и FAQ
- [Договор-оферта](https://podbor.site/#/terms) — юридические документы
- [Политика ПД](https://podbor.site/#/privacy) — политика обработки персональных данных
- [Вход](https://podbor.site/#/login) — авторизация
- [Регистрация](https://podbor.site/#/register) — регистрация заказчика/рекрутера

## API для агентов

Базовый URL: `https://podbor.site`

### Публичные (без авторизации)
- `GET /api/vacancies?search=&category=&budgetMax=&sort=&page=&size=` — список открытых вакансий (публичный)
- `GET /api/vacancies/{id}` — вакансия детально
- `GET /api/vacancy-categories` — 28 категорий (IT, бухгалтерия, управление и т.д.)
- `GET /api/recruiters/{id}` — публичный профиль рекрутера
- `GET /api/customers/{id}` — публичный профиль заказчика
- `GET /api/users/{id}/reviews?page=&size=` — отзывы
- `GET /api/public/settings` — метаданные сайта (бренд, тарифы, статистика, support)
- `GET /api/oauth/providers` — OAuth провайдеры (yandex, mail)
- `GET /v3/api-docs` — OpenAPI 3 спецификация (JSON)
- `GET /sitemap.xml` — карта сайта
- `GET /llms.txt` — этот файл

### AI-помощник (анонимный доступ разрешён)
- `POST /api/ai/chat` — JSON чат с AI (tool-calling + RAG по вакансиям/профилям)
- `POST /api/ai/chat/stream` — потоковый NDJSON
- `POST /api/ai/chat/reset` — сброс контекста

AI умеет (через tools): регистрировать/логинить пользователя, искать вакансии, создавать/закрывать вакансии (для заказчиков), откликаться/отзывать (для рекрутеров), управлять профилем, искать рекрутеров. Мутирующие операции требуют подтверждения словами "да"/"подтверждаю".

### Требующие авторизации (JWT в httpOnly cookie `jwt`, CSRF `X-XSRF-TOKEN`)
- `POST /api/vacancies` — создать вакансию (CUSTOMER)
- `PATCH /api/vacancies/{id}` — обновить
- `POST /api/vacancies/{id}/close` — закрыть (COMPLETED/EXTERNAL/CANCELLED)
- `GET /api/vacancies/{id}/responses` — отклики на вакансию
- `POST /api/vacancies/{id}/responses` — откликнуться (RECRUITER)
- `GET /api/conversations/{id}` + `/messages` — чат
- `GET /api/notifications` — уведомления
- `GET /api/balance/history` — история списаний (рекуртер)

Полная спецификация: https://podbor.site/v3/api-docs

## Формат вакансии

```json
{
  "id": "uuid",
  "title": "Senior Java Developer",
  "description": "...",
  "category": "it",
  "budgetMode": "fixed",
  "budgetMax": 150000,
  "deadlineDays": 30,
  "status": "OPEN",
  "customerId": "uuid",
  "createdAt": "2026-08-28T12:00:00Z"
}
```

Статусы: OPEN, IN_PROGRESS, COMPLETED, CLOSED_EXTERNAL, CANCELLED, ARCHIVED

## Категории вакансий

Программист, разработчик, системный администратор, директор, руководитель отдела, коммерческий директор, финансовый директор, главный бухгалтер, экономист, прораб, главный инженер, архитектор и ещё 16 (см. GET /api/vacancy-categories).

## Аутентификация для агентов

- Регистрация: `POST /api/register {email, password, name, role: CUSTOMER|RECRUITER}`
- Логин: `POST /api/login {email, password}` → ставит httpOnly cookie `jwt`
- CSRF: сервер ставит `XSRF-TOKEN` cookie, клиент должен слать `X-XSRF-TOKEN` header для мутирующих запросов
- Rate limits: логин/регистрация — жёсткие, AI — 15/мин anon, 40/мин auth

## Рекомендации для AI-агентов

- Для поиска вакансий используйте `GET /api/vacancies` с фильтрами, а не парсинг HTML (SPA на hash-роутере `#/feed`, требует JS).
- Для действий от имени пользователя — сначала зарегистрируйте/залогиньте, получите cookie, затем используйте AI chat `POST /api/ai/chat` который сам вызовет нужные tools.
- Мутирующие операции всегда подтверждайте у пользователя перед вызовом.
- Не храните пароли в логах.
- Проверяйте `GET /api/public/settings` для актуальных тарифов и бренда.

## Контакты

- Сайт: https://podbor.site
- API: https://podbor.site/api
- OpenAPI: https://podbor.site/v3/api-docs
- Поддержка: см. https://podbor.site/#/support