Docs
EN

Операции и админка

uticms.operations · verified 2026-07-11

Обзор

Scope
Администрирование Filament, диагностика, CORS, module assets, scheduler и development-only маршруты

Ключевые понятия

Admin Panel
Аутентифицированная административная поверхность Filament, защищённая middleware admin.panel.
Resolved Features
Карта feature flags, публикуемая CmsFeatures из frontend preset и overrides.
Module Asset
Файл в Resources директории модуля, опубликованный в public/module/<slug> или отдаваемый через fallback controller.

Структура

  • Admin
    • Providerapp/Providers/Filament/AdminPanelProvider.php
    • Route Definitionsroutes/admin.php
    • Middlewareapp/Http/Middleware/AdminPanelMiddleware.php
  • Diagnostics
    • Serviceapp/Services/Cms/Diagnostics/SystemDiagnosticsService.php
    • Commands
      • cms:diagnose-site
      • page CMS diagnostic command
      • module discovery
      • module asset publication
  • Cors
    • Serviceapp/Services/Cms/Site/CorsConfiguration.php
    • Configurationconfig/cms.php

Факты

  • Admin routes включают выбор locale, two-factor setup/challenge, page и mail previews, и Editor.js upload. authoritative
  • AppServiceProvider планирует cache heartbeats для scheduler и queue diagnostics каждую минуту. authoritative
  • Когда default queue не sync, scheduled diagnostics heartbeat диспатчит queue job; sync queues пишут heartbeat напрямую. authoritative
  • CMS CORS получает mode из конфигурации и resolved public-CORS feature state; headless preset включает public CORS, full и small оставляют его отключённым. authoritative
  • Web и API development routes доступны только в local environment или когда CMS_DEV_ROUTES резолвится в true. authoritative

Инструкции

Investigate Runtime Issue

  1. определить relevant resolved feature gate и active-module state
  2. изучить application logs и существующий diagnostic service или command
  3. проверить scheduler и queue heartbeat state, когда задействована фоновая работа
  4. проверить route middleware и CORS policy перед изменением публичной доступности

Правила

Architectural rule

Меняйте CORS через настроенную policy и resolved feature flags, а не hard-coding per-route headers.