Files

Nikita Kiselev adcca7cbc4 docs: document settings framework and telecart-pulse feature

Каркас системы настроек (docs/features/settings) и фича TeleCart Pulse
с heartbeat (docs/features/telecart-pulse); спека синхронизирована с opt-in.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-30 15:08:05 +03:00

3.5 KiB

Raw Blame History

docs/features — документация по фичам

Эта директория хранит описания фич проекта TeleCart: по одной поддиректории на фичу. Цель — дать агенту (и человеку) возможность быстро восстановить контекст по конкретной части системы, не перечитывая весь код: что фича делает, через какие точки входит, какие файлы за неё отвечают и как данные текут по слоям.

Вложенные CLAUDE.md подхватываются Claude Code автоматически при чтении файлов из их директории — поэтому индекс фичи читается «по требованию», когда работа касается этой фичи.

Структура

docs/features/
├── CLAUDE.md        # этот файл: конвенции + реестр фич
├── _TEMPLATE.md     # шаблон для новой фичи (копировать при описании)
└── <feature-slug>/
    └── CLAUDE.md    # индексный файл конкретной фичи

Конвенции

Имя папки — kebab-case, по сути фичи: cart, telegram-webhook, form-builder.
Один индекс на фичу — <feature-slug>/CLAUDE.md, заполняется по _TEMPLATE.md.
Ссылки на код — обязательны. Указывай реальные пути (module/.../src/Handlers/CartHandler.php) и action из карт маршрутов. Код — источник истины; документация лишь навигирует к нему.
Не дублируй код. Описывай назначение, поток и нюансы, а не построчный пересказ — он устареет.
Связывай фичи через ссылки на их папки (например [checkout](../checkout/CLAUDE.md)).
Если описанное в доке расходится с кодом — прав код; обнови доку.

Как добавить фичу

cp _TEMPLATE.md <feature-slug>/CLAUDE.md (создав папку).
Заполни секции шаблона, опираясь на реальный код.
Добавь строку в реестр ниже.

Реестр фич

Фича	Путь	Краткое описание
cart	cart/CLAUDE.md	Корзина: наполнение, просмотр, передача в оформление заказа
settings	settings/CLAUDE.md	Каркас настроек: форма в админке → хранение → чтение на backend
telecart-pulse	telecart-pulse/CLAUDE.md	Связка с SaaS: события кампаний и heartbeat (телеметрия окружения)

3.5 KiB Raw Blame History Unescape Escape