Назначение

Страница <PageName> в <frontend app> реализует <операционный сценарий>.

Metadata

Поле	Значение
App	<admin-panel/operations-app/portal>
Route	<route>
Actor	<actor>
Permission	<permission or anonymous>
Статус	draft / approved / deprecated

Data Dependencies

Source	Query/Mutation	Client	Freshness
<service>	<operation>	<generated client>	<sla>

View Model

Поле	Тип	Источник	Empty State	Security
<field>	<type>	<source>	<behavior>	<masking>

UI States

• Loading: <description>;
• Empty: <description>;
• Error: <error codes>;
• Forbidden: <behavior>;
• Partial data: <behavior>;
• Optimistic update: <yes/no + rollback>.

Forms И Validation

• Zod schema: <schema>.
• Server validation mapping: <error.code -> field>.
• Sensitive fields: <none/list>.
• Unsaved changes behavior: <rule>.

Observability

• Frontend events: <events>;
• Error tracking: <tags>;
• Correlation: use X-Correlation-Id from API response;
• Performance budget: <if applicable>.

Tests

• permission guard;
• loading/empty/error states;
• validation;
• API error mapping;
• responsive layout where relevant;
• tenant scope behavior.

Обратные ссылки

Автоссылки: где используется этот документ.

• index.md (1): Шаблоны Документации