← На главную

Как устроен Farmchel Hub

Ниже — бизнес-смысл системы и практическое описание админ-панели: что зачем нужно, где лежит код и как связаны части.

1. Бизнес-логика

Hub — это единая точка для LLM-агентов (настройки, промпты, правила) и CRM вокруг диалогов: кто написал, история сообщений, задачи и улучшения по продуктам.

  • Конечные пользователи общаются с ботами (например Telegram через OpenClaw). Их реплики и ответы можно сохранять в CRM через API — чтобы в админке был полный контекст.
  • Операторы / владельцы продукта заходят в веб-админку: смотрят диалоги, контакты, включают агентов, правят промпты и сервисы (каталог проектов/сервисов).
  • Интеграции (OpenClaw-плагины, скрипты) вызывают HTTP API: публичные POST для логирования диалогов или REST под API-ключом для задач, сервисов, агентов.

Итог: админка — для людей и учёта; API — для автоматизации и ботов. Один источник правды по контактам и диалогам.

2. Админка: разделы меню

Левое меню совпадает с логикой ниже (после входа на /admin).

Основное → Дашборд

Сводка и быстрый вход в разделы. Контроллер: App\Http\Controllers\Admin\DashboardController.

LLM

  • Агенты — карточки ботов (имя, статус, API-ключ для вызовов, привязка к ролям). Модель Agent.
  • Роли агентов — кто за что отвечает в орг. смысле.
  • Промпты — версии system/instructions и параметры модели по агенту.
  • Playbook — правила сценариев для агентов.

Маршрутизация и контроль

  • Правила роутинга — куда направлять запросы между агентами/каналами.
  • Логи — действия и события для разбора.
  • Качество — метрики/оценки работы LLM.
  • Инциденты — сбои и реакции (в т.ч. safe-stop).

Хаб (CRM)

  • Контакты — внешний id (например Telegram), имя, платформа.
  • Диалоги — цепочки сообщений user/assistant по контакту и агенту.
  • Сервисы — каталог проектов/сервисов (домены, репозитории, документация).
  • Улучшения, Задачи, Баги — процесс вокруг продукта, при необходимости привязка к сервису.

Система

  • Интеграции — учёт внешних сервисов.
  • Бэкапы — снимки конфигурации.
  • API ключи — ключи для доступа к защищённому REST (llm.api middleware).

3. Как это работает технически

  • Веб: маршруты в routes/web.php. Админка под middleware auth, префикс /admin. Шаблоны: resources/views/admin/, общий каркас — admin/layout.blade.php.
  • API: routes/api.php. Публичные POST /api/v1/bot/... для ботов; остальное REST под заголовками X-LLM-Key / Bearer.
  • Контроллеры: App\Http\Controllers\Admin\* (HTML), App\Http\Controllers\Api\* (JSON).
  • Модели и БД: app/Models, миграции в database/migrations.
  • HTTPS за прокси: в bootstrap/app.php настроено доверие к X-Forwarded-*, в AppServiceProvider при необходимости принудительный https для URL.

Дополнительно