Отчет/Export: <Название Отчета>
Назначение
Опиши бизнес-цель отчета или export-а, пользователей, decision value и owning service/app.
Классификация
| Поле | Значение |
|---|
| Тип отчета | Dashboard / CSV / XLSX / PDF / API export |
| Аудитория | <admin/partner/finance/compliance> |
| Чувствительность | <Internal/PII/Sensitive/Financial> |
| Freshness SLA | <real-time/minutes/hours/day> |
| Retention | <duration> |
Доступ
| Actor | Permission | Tenant/Brand scope | Audit |
|---|
<Actor> | <permission.name> | <scope rule> | <ReadSensitive/ExportSensitive> |
Исходные Source Data
| Источник | Владелец | Тип | Freshness | Join key |
|---|
<entity/event/projection/fact> | <service> | <source of truth/read model/ClickHouse fact> | <SLA> | <TenantId + key> |
Фильтры <ReportFilterModel>
| Поле | Тип | Обязательность | Default | Ограничения |
|---|
TenantId | TenantId | Да | Identity claims | Required |
<FilterName> | <Type> | Да/Нет | <default> | <range/enum/reference id> |
Строка Отчета <ReportRowModel>
| Поле | Тип | Обязательность | Расчет | Masking |
|---|
<ColumnName> | <Type> | Да/Нет | <source/calculation> | <rule> |
Модель Totals <ReportTotalsModel>
| Поле | Тип | Обязательность | Расчет | Precision |
|---|
<TotalName> | decimal | Да | <formula> | <scale/rounding/CurrencyId> |
Формат Export-а
| Column | Заголовок | Тип | Формат | Nullable | Источник |
|---|
<ColumnName> | <Заголовок> | <Type> | <format> | Да/Нет | <ReportRowModel.Field> |
Процесс Генерации
- Проверить permission, tenant scope, brand scope и export limits.
- Провалидировать
<ReportFilterModel>.
- Создать
<ExportJob> или выполнить synchronous query согласно лимиту размера.
- Прочитать source data с documented freshness SLA.
- Сформировать
<ReportRowModel> и <ReportTotalsModel>.
- Записать audit record и безопасную ссылку на файл, если export async.
Лимиты
| Лимит | Значение | Ошибка |
|---|
| Max rows | <number> | <ErrorCode> |
| Max date range | <duration> | <ErrorCode> |
| Concurrent exports | <number per actor/tenant> | <ErrorCode> |
Наблюдаемость
| Тип | Правило |
|---|
| Metrics | <duration/rows/file size/errors> |
| Logs | <started/generated/downloaded/expired/failed> |
| Traces | correlationId, tenantId, exportJobId |
Обратные ссылки
Автоссылки: где используется этот документ.