Модель данных

Сущности, связи и инварианты

Логическая модель future-продукта. На портале она реализована типами общее состояние; рабочая схема должна быть подтверждена техническим проектированием и миграциями.

API

Сущностей

Деньги

целые минимальные единицы

Источник истины

PostgreSQL (предложение)

ER-диаграмма ключевых сущностей

Связи между пользователем, календарём, деньгами и зарядкой

Диаграмма упрощена: показаны основные связи, влияющие на целостность денег и броней.

На узком экране прокручивается по горизонтали

Отрисовываем схему…

Полный список полей, связей и инвариантов приведён в карточках сущностей ниже.

Инварианты, которые нельзя терять

Один интервал — одна бронь

Уникальность внешнего события и транзакционная проверка пересечений.

Доступный баланс ≥ 0

Резерв не может превысить доступные средства; двойное удержание запрещено.

Проводка неизменяема

Корректировка создаёт отдельную компенсирующую запись с причиной.

Тарифный снимок

Сессия и бронь сохраняют версию тарифа; история не пересчитывается.

Идемпотентность

Повтор webhook/команды не создаёт второй эффект.

Неопределённость

Тайм-аут и неизвестный статус не превращаются в FINISHED/ACTIVE.

Аудит

Ручное действие фиксирует актора, роль, старое и новое значение, причину.

Телеметрия

Возраст данных определяется по времени измерения/получения; старые данные блокируют операции.

Каталог сущностей

Пользователи: 3Каталог: 3Календарь: 3Деньги: 5Зарядка: 3Поддержка: 2Система: 2

User

ПользовательПользователи

Учётная запись водителя, состояние входа и базовые настройки. Персональные данные минимизируются.

Поля

Поле	Тип	Заметка
id•	UUID	Внутренний стабильный идентификатор
phoneHash	string	Не хранить открытый номер без необходимости
status	enum	active / blocked / deleted
consentVersion	string	Последняя принятая версия согласия
pushEnabled	boolean	Разрешение на push
createdAt	timestamptz	Время создания в UTC

Связи

Vehicle · владеет (1 → N)
Consent · принимает (1 → N)
Reservation · создаёт (1 → N)

Инварианты

Нельзя показывать чужие операции
Удаление учитывает обязательное хранение финансовых документов

FR-002 FR-003 FR-018

Consent

СогласиеПользователи

Факт принятия конкретной версии юридического текста с временем и связью с пользователем.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор факта
userId•	UUID	Связь с пользователем
documentVersion	string	Версия текста
acceptedAt	timestamptz	Момент принятия
ipHash	string	Минимизированное доказательство при необходимости

Связи

User · принадлежит (N → 1)

Инварианты

Версия согласия не переписывается
Отзыв согласия не удаляет финансовые документы

FR-002

Vehicle

АвтомобильПользователи

Демонстрационный/пользовательский автомобиль с совместимым разъёмом и ограничением мощности.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
userId•	UUID	Владелец
name	string	Отображаемое название
connector	enum	Type 2 / Type 1
maxPowerKw	numeric	Ограничение мощности
isPrimary	boolean	Основной автомобиль

Связи

ChargingSession · используется в (1 → N)

Инварианты

Неполные параметры не блокируют просмотр каталога
Разъём проверяется до Start

FR-003 FR-012

Site

ПлощадкаКаталог

Место установки станции с адресом, координатами, часами и правилами доступа.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
address	string	Адрес площадки
coordinates	point	Координаты
hours	jsonb	Часы работы
accessRules	string	Правила доступа

Связи

Station · содержит (1 → N)

Инварианты

Часы площадки учитываются при доступности

FR-005

Station

СтанцияКаталог

Логическая/физическая зарядная станция и ссылка на внешнюю систему.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
siteId•	UUID	Площадка
name	string	Название
csmsId	string	Внешний идентификатор
status	enum	open / closed / maintenance
lastSeenAt	timestamptz	Последняя связь

Связи

Port · содержит (1 → N)
Site · находится на (N → 1)

Инварианты

Закрытая станция не предлагает запуск
Статус и возраст данных видны пользователю

FR-005

Port

Порт / разъёмКаталог

Физическая точка подключения с разъёмом, мощностью, QR и текущим статусом.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
stationId•	UUID	Станция
label	string	Номер/буква порта
connector	enum	Type 2 / Type 1
powerKw	numeric	Номинальная мощность
qr	string	Уникальный QR-идентификатор
status	enum	available / occupied / reserved / maintenance / stale / awaiting_release

Связи

PortAvailability · имеет (1 → N)
SlotHold · удерживается (1 → N)
ChargingSession · используется (1 → N)

Инварианты

Один порт не имеет двух активных сессий
QR однозначно сопоставлен порту

FR-004 FR-012 FR-017

TariffVersion

Версия тарифаДеньги

Версия тарифа с периодом действия и параметрами расчёта. Исторический снимок не переписывается.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор версии
version	string	Человекочитаемая версия
energyPrice	integer	Минимальные единицы
shortBookingPrice	integer	Стоимость короткой брони
plannedBookingPrice	integer	Стоимость плановой брони
effectiveFrom	timestamptz	Начало действия
status	enum	active / future / archived

Связи

Reservation · применяется к (1 → N)
ChargingSession · фиксируется в (1 → N)

Инварианты

Изменение тарифа не меняет начатую сессию
Деньги хранятся целыми единицами

FR-006 FR-011 FR-021

PortAvailability

Доступность портаКалендарь

Рассчитанная доступность порта/интервала и происхождение статуса.

Поля

Поле	Тип	Заметка
portId•	UUID	Порт
interval•	tstzrange	Интервал
status	enum	available / occupied / unknown
source	string	CSMS / датчик / оператор
measuredAt	timestamptz	Когда получено
confidence	enum	confirmed / estimated / unknown

Связи

Port · описывает (N → 1)
Incident · может создать (1 → N)

Инварианты

Неизвестный статус не отображается как свободный
Кэш не является источником истины

FR-004 FR-017

SlotHold

Удержание слотаКалендарь

Временная блокировка интервала до оплаты или истечения.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
portId•	UUID	Порт
interval	tstzrange	Интервал
status	enum	active / confirmed / cancelled / expired
expiresAt	timestamptz	Срок действия
price	integer	Стоимость брони

Связи

Reservation · превращается в (1 → 0..1)
Payment · оплачивается (1 → N)

Инварианты

Активный hold не блокирует слот бесконечно
Истечение освобождает интервал

FR-006 FR-007

Reservation

БроньКалендарь

Подтверждённое право на порт в интервале с применённым тарифом.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
holdId	UUID	Исходный hold
userId•	UUID	Пользователь
portId•	UUID	Порт
interval	tstzrange	Интервал
price	integer	Стоимость брони
status	enum	confirmed / completed / cancelled / expired
tariffVersionId	UUID	Применённый тариф

Связи

SlotHold · происходит из (1 → 1)
ChargingSession · связана с (1 → 0..1)
Payment · оплачена (1 → N)

Инварианты

На один интервал порта — одна подтверждённая бронь
Отмена освобождает интервал

FR-006 FR-008

Payment

ПлатёжДеньги

Попытка/операция оплаты с провайдером, внешним ID, статусом и ключом идемпотентности.

Поля

Поле	Тип	Заметка
id•	UUID	Внутренний идентификатор
providerId	string	Внешний ID
amount	integer	Минимальные единицы
status	enum	pending / confirmed / declined / refunded / reconciliation
idempotencyKey	string	Защита от повтора
correlationId	string	Связь событий
events	jsonb	История обработки

Связи

WalletEntry · создаёт (1 → 0..N)
Reservation · оплачивает (N → 1)

Инварианты

Повтор webhook не создаёт второй эффект
Сумма и заказ сверяются

FR-010 FR-022

WalletEntry

Проводка кошелькаДеньги

Неизменяемая запись движения EcoCoin с типом и происхождением.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
userId•	UUID	Пользователь
amount	integer	Положительная или отрицательная сумма
type	enum	topup / bonus / compensation / refund / booking / energy / admin_adjustment
relatedId	string	Бизнес-операция
reason	string	Обязательна для ручной корректировки

Связи

WalletHold · резервируется (1 → N)
Payment · связана (N → 0..1)

Инварианты

Запись не редактируется задним числом
Корректировка — отдельная компенсирующая проводка

FR-009 FR-011

WalletHold

Резерв кошелькаДеньги

Зарезервированная часть доступного баланса под бронь или энергию.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
amount	integer	Сумма резерва
status	enum	active / captured / released
relatedId	string	Связанная операция

Связи

WalletEntry · уменьшает доступный баланс (N → 1)
ChargingSession · обеспечивает (1 → 0..1)

Инварианты

Доступный баланс не становится отрицательным
Одна сумма не удерживается дважды

FR-009 FR-016

ChargingSession

Зарядная сессияЗарядка

Жизненный цикл зарядки с применённым тарифным снимком и итогом.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
reservationId	UUID	Связанная бронь
portId•	UUID	Порт
vehicleId	UUID	Автомобиль
status	enum	START_REQUESTED … RECONCILIATION_REQUIRED
requestedKwh	numeric	Запрошенный объём
energyKwh	numeric	Фактический объём
tariffVersionId	UUID	Снимок тарифа
finalAmount	integer	Итоговая сумма

Связи

MeterSample · имеет (1 → N)
Receipt · формирует (1 → 0..1)
Incident · может создать (1 → 0..N)

Инварианты

ACTIVE только после подтверждения станции
Тарифный снимок не меняется
Повторная финализация не дублирует проводку

FR-012 FR-013 FR-014 FR-016

MeterSample

ПоказаниеЗарядка

Показание энергии/мощности с внешним временем, временем получения и источником.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
sessionId•	UUID	Сессия
energyKwh	numeric	Значение
powerKw	numeric	Мощность
measuredAt	timestamptz	Время измерения
receivedAt	timestamptz	Время получения
source	enum	csms / demo

Связи

ChargingSession · относится к (N → 1)

Инварианты

Устаревание определяется по measuredAt/receivedAt
Отрицательное или уменьшающееся значение требует проверки

FR-014 FR-016

Command

Команда оборудованиюЗарядка

Start/Stop и другие команды с ID, статусом и результатом.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
sessionId	UUID	Сессия
type	enum	start / stop / extend
status	enum	pending / accepted / failed / unknown
idempotencyKey	string	Защита от повторной команды
correlationId	string	Связь с CSMS

Связи

ChargingSession · влияет на (N → 1)

Инварианты

Повтор не создаёт вторую команду
Неизвестный результат не считается успехом

FR-012 FR-013 FR-022

Receipt

ЧекДеньги

Кассовый документ/результат фискализации и история попыток.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
sessionId	UUID	Сессия
status	enum	forming / ready / error
amount	integer	Сумма
attempts	integer	Число попыток
lastError	string	Безопасное описание ошибки

Связи

ChargingSession · относится к (N → 1)

Инварианты

Ошибка чека не удаляет сессию
Повтор не дублирует документ

FR-016 FR-021

Incident

ИнцидентПоддержка

Разбор неисправности, конфликта или несверенной операции.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
type	string	Класс проблемы
severity	enum	low / medium / high
status	enum	open / investigating / resolved
relatedId	string	Объект
correlationId	string	Трассировка

Связи

ChargingSession · связан с (N → 1)
Port · связан с (N → 1)

Инварианты

Инцидент не подменяет финансовую операцию
Закрытие аудируется

FR-016 FR-017 FR-021

SupportTicket

ОбращениеПоддержка

Обращение клиента с контекстными связями и историей статусов.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
userId	UUID	Пользователь
category	string	Категория
status	enum	new / assigned / in_progress / resolved
stationId	UUID	Контекст станции
sessionId	UUID	Контекст сессии
assignee	string	Ответственный

Связи

User · создано (N → 1)

Инварианты

Поддержка видит только необходимый контекст
Назначение и статус аудируются

FR-020

Notification

УведомлениеСистема

Событие уведомления, канал, статус и связанный объект.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
userId	UUID	Получатель
channel	enum	in_app / push
status	enum	created / sent / failed / read
entityId	string	Связанный объект

Связи

User · адресовано (N → 1)

Инварианты

Отказ от push не скрывает in-app событие

FR-019

AuditEvent

Событие аудитаСистема

Кто, что, когда и почему изменил; старое и новое значение.

Поля

Поле	Тип	Заметка
id•	UUID	Идентификатор
actorId	string	Пользователь или система
role	string	Роль на момент действия
entityType	string	Тип объекта
entityId	string	ID объекта
oldValue/newValue	jsonb	Безопасные значения
reason	string	Причина ручного действия

Связи

Отдельная запись аудита

Инварианты

Аудит не редактируется
Секреты и OTP не попадают в аудит

FR-021 FR-022

Демо реализация ≠ рабочая схема

В портале сущности описаны TypeScript-типами и живут в клиентском общее состояние. Это позволяет показать корректные переходы и связанные ID, но не заменяет транзакции PostgreSQL, ограничения БД, миграции и проверку конкурентного доступа.