Версия источника: 93129dd470a134cabdf15a353da6633362f2b0fe
Синхронизировано: 2026-11-19T04:53:50.014Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/93129dd470a134cabdf15a353da6633362f2b0fe

<a id="interface-order-financial-history"></a>

# Снимок заказа и история денег

## Коротко

Сохраняйте состав и цены принятого заказа. Объясняйте начисления, полученные оплаты, возвраты, задолженность и переплату отдельными строками с источником и причиной.

## Плохо

```text
Старый заказ берёт текущую цену товара.
В списке отображается −100 без причины.
Оператор считает это возвратом.
Ремонт изменяет исходную операцию.
```

## Хорошо

```text
Снимок заказа: SKU, цена, скидка, валюта.
Оплата, возврат и корректировка раздельны.
В строке видно итог и причину расхождения.
Исправление добавлено новой версией.
```

## Почему

Цена в каталоге и проведённая операция меняются по разным основаниям. Отрицательное число может быть возвратом, ошибкой единиц, скидкой или дефектом тестовых данных. Причина определяется фактами и журналом.

## Когда применять

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

### Требования

- Храните версию состава с идентификатором и снимком названия, артикула, варианта, количества, единицы, цены, скидки, валюты и согласованных условий. Публичная ссылка на товар может храниться отдельно. Удаление товара не переписывает снимок.
- Начислено за заказ, получено, возвращено, долг, переплата и ожидаемые операции имеют разные поля. Зафиксируйте формулу по состояниям, валютам, типам и знакам. Суммы показывайте рядом с состоянием и пояснением.
- В списке и карточке показывайте источник отклонения с переходом к операции. У операции есть идентификатор, время, причина, статус и автор или источник. В ожидающих или неизвестных состояниях показывайте фактический статус.
- Обычное редактирование заказа создаёт версию с проверкой полномочий. Проведённый платёж или возврат требует отдельного действия и сверки с провайдером. Прежнее значение и причина доступны из истории.
- Точечный ремонт выполняйте по явному списку записей, проверенным исходным состояниям и правилам единиц. Сначала dry run и сравнение, затем идемпотентное действие с аудитом. Диагноз одной записи не применяется ко всем отрицательным суммам.
- Загружайте финансовые факты для видимой страницы заказов, сохраняйте фильтры и точную сортировку. Сводка и детализация используют согласованные расчёты.

## Пример применения

В списке заказов менеджер видит начисление, полученную сумму и частичный возврат. Из строки открывается операция с причиной. Цена в старом заказе сохраняется после обновления карточки товара.

## Как проверить

- Создайте тестовый заказ, поменяйте цену в каталоге, оформите тестовую частичную оплату и возврат. Сверьте снимок, итог и причины в списке, деталях и журнале.
- Проверьте неизвестную старую сумму и ошибочный тестовый платёж. Интерфейс показывает основание или статус сверки. Реальный возврат не создаётся автоматически.
- Проверьте повтор точечного ремонта и граничные записи. Аудит сохранён, чужие заказы не затронуты.

## Человек

Утверждает финансовые формулы, право на корректировки и причины операций.

## Агент

Агент сохраняет снимки, проверяет точность вычисления и показывает основание каждого итога.

## Источники

- [Stripe — модель платежа PaymentIntent](https://docs.stripe.com/payments/payment-intents)
- [Stripe — возвраты и отмены](https://docs.stripe.com/refunds)
- [PostgreSQL — ограничения](https://www.postgresql.org/docs/current/ddl-constraints.html)

Уровень: Обязательно. Опубликовано: 2026-11-19. Проверено: 2026-11-19. Изменено: 2026-11-19.

[Исходный файл](https://github.com/sergey-from-riders/vibecoding-base/blob/93129dd470a134cabdf15a353da6633362f2b0fe/registry/standards/ui/admin-interface/rules/order-financial-history.md)
