Назначение документа
Раздел описывает видимые поверхности приложения Farmchel Motiv: какие URL существуют вне админки, как устроено меню Filament после входа и что пользователь находит на типовых страницах. Инфраструктура и деплой — в MSP; HTTP API — в API.
Публичные и служебные URL
| Путь | Содержимое |
|---|---|
/ | Витрина внутренней платформы: быстрые ссылки на админку и разделы документации. |
/docs/* | Статический центр документов (этот сайт): Business, Структура, API, Стратегии, MSP. У каждой страницы указаны версия и дата изменения. |
/docs | Перенаправляет на /docs/business. |
/up | Служебная проверка живости приложения (Laravel). |
/admin | Точка входа Filament; после авторизации пользователь попадает на домашнюю страницу панели (/admin/motiv). |
/admin/login | Форма входа в админ-панель. |
/api/v1/… | Версионированный JSON API (Sanctum Bearer). Перечень операций см. API docs. |
Оболочка админ-панели (/admin)
Панель построена на Filament: слева — группы навигации (сворачиваемые секции), сверху на широких экранах — топбар с тем же логотипом и переходом на главную сайта.
- Бренд и домой по панели: клик по логотипу «Мотив» ведёт на дашборд
/admin/motiv. - «На сайт»: отдельная кнопка рядом с логотипом — переход на публичную главную
/. - Группы меню можно сворачивать и разворачивать; активный пункт подсвечивается.
- Учётная запись: меню пользователя Filament (профиль, выход).
Каталог
Операционный контур учёта юридических лиц, приложений в сторах, семантики и людей.
| Страница | URL | Содержимое |
|---|---|---|
| Компании | /admin/companies |
Кампании продвижения ключевых слов: список со вкладками по статусу; создание /admin/companies/create; просмотр карточки /admin/companies/{id}. |
| Приложения | /admin/store-apps |
Портфель приложений (store metadata, owner, компания, стратегия). Редактор, relation managers по кликам и ключам, заметки/аудит. |
| Ключевые слова | /admin/keywords |
Табличное управление ключевыми словами и привязками (фильтры, массовые действия по настройке ресурса). |
| Контакты | /admin/contacts |
Единая таблица контактов с фильтрами; операции согласно политике ресурса. |
Стратегии
Цепочка от сырого сигнала до оформленной стратегии и запусков. См. также документ «Библиотека стратегий».
| Страница | URL | Содержимое |
|---|---|---|
| Входящие сигналы | /admin/incoming-signals |
Очередь наблюдений из стора/аналитики до решения «оформляем в гипотезу/стратегию». |
| Гипотезы | /admin/hypotheses |
Проверяемые предположения до полноценной стратегии. |
| Стратегии | /admin/strategies |
Список стратегий; создание /admin/strategies/create; просмотр /admin/strategies/{id}; правка /admin/strategies/{id}/edit. На просмотре — связанные приложения, ключи, гипотезы, запуски (relation managers). |
Тесты Мотива
Один ресурс представлен тремя пунктами меню для разных срезов одной сущности.
| Страница | URL | Содержимое |
|---|---|---|
| Все тесты | /admin/motiv-tests | Полный список тестов мотива с фильтрами. |
| Активные тесты | /admin/motiv-tests/active | Преднастроенный список активных записей. |
| Решения | /admin/motiv-tests/decisions | Срез по решениям/этапам принятия решений. |
| Создание / правка | /admin/motiv-tests/create, /admin/motiv-tests/{id}/edit | Формы создания и редактирования карточки теста. |
Аналитика
| Страница | URL | Содержимое |
|---|---|---|
| Клики | /admin/click-analytics-rows |
Таблица строк аналитики кликов: импорт/экспорт (если включено в ресурсе), фильтры, статусы качества строк, связи с приложениями. |
Доступ и логи
| Страница | URL | Содержимое |
|---|---|---|
| Пользователи | /admin/users |
Учётные записи для входа в Filament и связь с компанией/ролями; создание и правка пользователей. |
| API-ключи | /admin/api-access-tokens |
Выпуск Sanctum personal access tokens для интеграций: кому выдан, scopes, даты создания и последнего использования, отзыв. |
| API Logs | /admin/api-request-logs |
Журнал HTTP-запросов к API: метод, путь, код ответа, длительность, пользователь и токен (для разборов и аудита). |
JSON-эндпоинт для выборки логов администратором также доступен по API (см. раздел API docs и политики доступа).
Документация (/docs)
Все страницы собраны из Blade-шаблонов в resources/views/docs. Общий каркас: шапка с переключателями разделов, блок метаданных (версия документа, дата изменения, статус, владелец), оглавление с якорями и основной текст.
- При существенном изменении процесса или структуры экранов обновляйте текст и увеличивайте версию в конфигурации страницы (
resources/views/docs/show.blade.php, массив$map). - Дату Изменено выставляйте на день согласования правок.
Код проекта (краткая отсылка)
Дерево каталогов app/, слои API, миграции и соглашения для разработчиков приведены в разделе MSP → Структура кода. Текущий документ специализируется на пользовательских экранах, а не на файловой структуре.