Учёт фактического потребления ТЭР
Сервис хранит данные о фактическом потреблении зданиями электрической и тепловой энергии, загружает их из АИС ОИА ПЭО и показывает пользователю в интерфейсе.
1. Цель
Реализовать в Сервисе учёт фактического потребления ТЭР: данные о фактическом потреблении загружаются из АИС ОИА ПЭО и предоставляются для просмотра пользователю в интерфейсе.
Эпик реализует FR-5.7: Учёт фактического потребления.
2. Состав работ
2.1. Спецификация
| Задача | Предмет | Зависит от |
|---|---|---|
| S-1 | Загрузка и просмотр данных учёта — сквозной сценарий на бизнес-уровне. Выполнено | — |
| S-2 | Фактическое потребление ЭЭ, Фактическое потребление ТЭ, Учётный период (сущность). Выполнено | — |
| S-3 | Загрузка данных учёта. Выполнено | S-2 |
| S-4 | Вкладки «Расход ЭЭ» и «Расход ТЭ» и макет. Выполнено, макет согласован | S-2 |
| S-5 | Запрос расхода энергии, Хендлер запроса расхода энергии. Выполнено | S-4 |
| S-6 | Дополнение Вкладки «Расход ЭЭ» и «Расход ТЭ» ссылками на endpoint. Выполнено | S-5 |
2.2. Реализация backend
| Задача | Предмет | Зависит от |
|---|---|---|
| B-1 | Доменные сущности потребления ЭЭ и ТЭ, справочник учётных периодов | S-2 |
| B-2 | Конфигурации EF, миграция, индексы | B-1 |
| B-3 | Модели чтения таблиц данных учёта в AisReadDbContext (готова только RefPeriod), загрузка справочника учётных периодов и данных учёта в составе импорта |
S-3, B-2 |
| B-4 | Модель чтения Сервиса, запрос просмотра, право доступа на чтение | S-5, B-2 |
| B-5 | Первичная загрузка учётных периодов за прошлые годы | B-3 |
2.3. Реализация UI
| Задача | Предмет | Зависит от |
|---|---|---|
| U-1 | Вкладки «Расход ЭЭ» и «Расход ТЭ» на организационном объекте и на здании | S-6, B-4 |
3. Вне состава
Отчёты. Вывод фактического потребления в отчёты Сервиса в этом эпике не рассматривается.
Точки учёта как сущность Сервиса. Точки учёта существуют в АИС ОИА ПЭО и сводятся к зданию при загрузке; в Сервисе они не хранятся и на экране не показываются.
Ручной ввод и корректировка факта. Единственный источник данных учёта — АИС ОИА ПЭО; в Сервисе факт только читается.
Расчёты на основе факта. Фактические данные не участвуют в расчёте модели потребления и не влияют на класс энергоэффективности.
Иные виды ТЭР. Вода, газ и топливо в модуль не входят.
4. Акторы
| Роль | Что делает |
|---|---|
| Администратор Сервиса | Запускает импорт данных из АИС ОИА ПЭО, в составе которого загружаются данные учёта |
user (Пользователь) |
Просматривает данные учёта на вкладках «Расход ЭЭ» и «Расход ТЭ» |
Роль администратора Сервиса среди ролей Сервиса не описана: команда импорта существует, но ни за одной из трёх ролей не закреплена.
5. Acceptance criteria
| AC | Критерий |
|---|---|
| AC-L1 | На организационном объекте вкладки «Расход ЭЭ» и «Расход ТЭ» показывают потребление соответствующего ресурса за выбранный период по его зданиям, а при включённом переключателе «с потомками» — и по зданиям подчинённых объектов |
| AC-L2 | На здании те же вкладки показывают потребление ресурса этим зданием |
| AC-L3 | При открытии вкладки выбран период — календарный год, предшествующий текущему |
| AC-L4 | По каждому зданию выведен итог за год |
| AC-L5 | Значения показаны в единицах источника: ЭЭ в тыс. кВт·ч, ТЭ в Гкал |
| AC-L6 | Здания, по которым за выбранный период нет данных учёта, в перечне отсутствуют |
| AC-L7 | Вкладка здания без данных учёта за выбранный период показывает пустой перечень, а не ошибку |
| AC-X1 | Повторный импорт тех же месяцев не создаёт вторых записей по тому же зданию, месяцу и виду ТЭР |
Структурные связи
Реализует
Использует
- Доменная сущность Здание (сущность)
- Инфраструктура Импорт данных из АИС
- BC-модуль Фактическое потребление
Реализуется
- Use Case Загрузка данных учёта и их просмотр
Связанные артефакты
Документы
- Доменная сущность Учётный период (сущность)
- Доменная сущность Фактическое потребление ТЭ
- Доменная сущность Фактическое потребление ЭЭ
- Инфраструктура Загрузка данных учёта фактического потребления
- Компонент Вкладки «Расход ЭЭ» и «Расход ТЭ»
- API-контракт Запрос расхода энергии от сторонних источников
- FR FR-5.7: Требования к модулю «Учёт фактического потребления»
- Handler Хендлер запроса расхода энергии от сторонних источников
- Use Case Загрузка данных учёта и их просмотр
Термины
- Термин АИС ОИА ПЭО