Полное покрытие кода

Эта страница объясняет, что именно покрыто документацией и где искать описание каждого участка проекта.

Уровни покрытия

Документация покрывает проект на трёх уровнях:

Уровень	Что покрывает	Где читать
Архитектурный	Потоки запросов, providers, routes, границы, внешние зависимости	Архитектура, Backend и API
Доменный	Каталог, roadmap, proxy pages, banners, admin, данные	Домены, Frontend и админка, Reference
Reference	Все основные папки, классы, resources, views, configs, migrations, helpers	Справочная база

Карта покрытия по корневым папкам

Путь	Покрытие	Основной раздел
bootstrap/*	Полностью	Bootstrap и провайдеры
routes/*	Полностью	Routes и middleware, Jobs/cron
config/*	Полностью по назначению	Config/env reference, Конфигурация и безопасность
app/Actions/*	Полностью по назначению	Auth, actions, services reference
app/Casts/*	Полностью по назначению	Helpers, casts, traits reference
app/Console/*	Полностью	Commands reference, Jobs/cron
app/Domains/*	Полностью по доменным зонам	Domains reference, Каталог, Roadmap, Proxy pages
app/Facades/*	Полностью	Auth, actions, services reference
app/Filament/*	Полностью списком и группами	Filament reference, Filament-админка
app/Helpers/*	Полностью по функциям/назначению	Helpers, casts, traits reference
app/Http/*	Полностью	Routes и middleware, Backend reference
app/Jobs/*	Полностью	Jobs, очереди и cron
app/Livewire/*	Полностью	Livewire reference, Livewire и partial SPA
app/Models/*	Полностью по группам и ключевым инвариантам	Models reference, Models and domain
app/Observers/*	Полностью	Models reference
app/Policies/*	Полностью	Config/security, Models reference
app/Providers/*	Полностью	Bootstrap и провайдеры
app/Services/*	Полностью	Auth, actions, services reference
app/Settings/*	Полностью	Config/env reference, Migrations and datamodel
app/Socialite/*	Полностью	Auth, actions, services reference
app/Traits/*	Полностью	Helpers, casts, traits reference
app/Types/*	Полностью	Helpers, casts, traits reference
app/View/*	Полностью	Views/assets reference, Proxy pages
database/*	Полностью по группам	Database reference, Migrations and datamodel
resources/*	Полностью по группам	Views/assets reference, Frontend overview
apps/docs/*	Полностью по работе с документацией	Как работать с этой документацией

Что считается “100% покрытием” здесь

В этой документации “100% покрытие” означает:

• каждый production-каталог проекта имеет описание назначения;
• каждая группа классов имеет объяснение роли;
• каждый важный поток имеет пошаговое описание;
• каждый Filament resource перечислен;
• каждая модельная группа перечислена;
• все helpers/casts/traits/types перечислены;
• все config-файлы перечислены;
• все migration/data слои объяснены;
• все views/assets группы перечислены;
• известные риски и side effects вынесены отдельно.

Это не построчный комментарий к каждой строке кода. Построчный комментарий был бы вреден: он быстро устареет и станет дублировать код. Вместо этого документация фиксирует назначение, владельца поведения, входы/выходы, side effects и сценарии изменения.

File-level coverage matrices

Полное пофайловое покрытие разнесено по матрицам:

• Coverage: app
• Coverage: database
• Coverage: resources
• Coverage: config routes bootstrap

В этих страницах перечислены все production-значимые файлы из app, database, resources, config, routes и bootstrap.

Где читать по задаче

Задача	Страница
Найти любой файл	Карта файлов проекта, Полный индекс файлов
Понять модель	Models reference
Понять админскую страницу	Filament reference
Понять Livewire component	Livewire reference
Понять helper/trait/cast	Helpers, casts, traits reference
Понять Blade/view/assets	Views/assets reference
Понять env/config	Config/env reference
Понять миграцию/таблицы	Database reference, Миграции и модель данных
Добавить продукт	How-to: работа с данными
Добавить roadmap программу	How-to: работа с данными
Добавить proxy page	How-to: работа с данными
Починить page cache	Поддержка и эксплуатация