Nikita Kiselev
d621baae45
Introduce docs/features/ with an index (conventions + feature registry), a per-feature template, and a filled cart example. Reference the structure from the root CLAUDE.md so context can be restored per feature on demand. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
<Название фичи>
Скопируй этот файл в
docs/features/<feature-slug>/CLAUDE.mdи заполни секции. Удали подсказки в кавычках после заполнения. Не оставляй пустых «TODO».
Назначение
1–3 предложения: какую задачу решает фича и для кого (SPA-покупатель / админ / системное).
Точки входа
actionиз карт маршрутов и где они объявлены. Таблица:
| action | Метод | Где объявлен |
|---|---|---|
exampleAction |
Handler::method |
src/routes.php или bastion/routes.php |
Ключевые файлы по слоям
Путь от корня репозитория. Только то, что реально относится к фиче.
- Handler:
module/.../src/Handlers/XxxHandler.php— валидация, вызов сервиса,JsonResponse. - Service:
module/.../src/Services/XxxService.php— бизнес-логика. - Model / данные:
module/.../src/Models/Xxx.phpили таблицы БД. - Фронтенд:
frontend/spa/...илиfrontend/admin/...(store, view, компоненты). - Регистрация в DI:
src/ServiceProviders/...(если есть нестандартная привязка).
Поток данных
Кратко: запрос → слои → ответ. Можно списком шагов или стрелками.
Связанные фичи
Ссылки на соседние папки:
[checkout](../checkout/CLAUDE.md).
Нюансы и подводные камни
Неочевидное: ограничения PHP 7.4, особенности OpenCart-реестра, кэш, edge-cases, известные баги.