Перейти к основному содержимому

Доменная модель

В API домены разделены по EF Core contexts, entity-моделям, request DTO и response DTO.

Contexts​

ContextДомен
EmployeeContextСотрудники, должности, места производства
IdentityContextASP.NET Identity users и roles
LogicContextСквозная workflow-логика
NotificationContextУведомления, чаты, сообщения (схема Notification)
OrderContextКонтрагенты, заказы, оплаты, отгрузки, документы
ProductContextИзделия и данные спецификаций
TaskManagerContextСправочники задач и состояния задач
WarehouseContextSKU, складские параметры, резервы

Основные сущности​

Сотрудники​

  • EmployeeEntity
  • PostEntity
  • LocationManufactureEntity
  • Identity user и user-role entities

Заказы​

  • PartnerEntity
  • BuyerOrderEntity
  • OrderEntity
  • GoodEntity
  • ContractEntity
  • PaymentScheduleEntity
  • PaymentInvoiceEntity
  • InvoicePaymentEntity
  • InvoicePaymentPaymentInvoiceEntity — связь платёж ↔ счёт (сумма на счёт)
  • BankStatementEntity
  • ShipmentEntity
  • DocumentEntity
  • ContactPersonEntity
  • SignerEntity
  • AccessGroupEntity

Изделия​

  • ProductEntity
  • MagnetEntity
  • ProductRequiredDocumentationEntity
  • сущности элементов спецификации

Склад​

  • StockKeepingUnitEntity
  • справочники типов, категорий и параметров SKU
  • MaterialInReserveEntity
  • данные количества и нормализованных наименований

Задачи​

  • ProcessEntity
  • TaskEntity
  • TaskTypeEntity
  • TaskStatusEntity
  • TaskStateEntity
  • DateOfStatusChangeEntity
  • TimeSpentEntity

Уведомления и чаты (NotificationContext)​

Схема общая: in-app уведомления и чаты.

  • Уведомления: NotificationEntity, справочник типов (Task / Fix / Partner / Process / Reminder / Chat)
  • Чаты: ChatEntity, ChatParticipantEntity, MessageEntity, MessageAttachmentEntity, статусы прочтения; заготовка ChatGroupEntity
  • Web Push подписки хранятся в Employee (PushSubscriptionEntity), не в этой схеме

Подробнее: notifications.md, chats.md, cursor-architecture.md (§ «Уведомления», § «Чат»).

Финансы (OrderContext)​

Цепочка: заказ покупателя → этап плана → счёт → платёж (из банковской выгрузки).

BuyerOrderEntity
└── PaymentScheduleEntity (этап: предоплата / перед отгрузкой / окончательная)
└── PaymentInvoiceEntity
└── InvoicePaymentPaymentInvoiceEntity (InvoiceAmount)
└── InvoicePaymentEntity
└── BankStatementEntity

Справочники: PaymentStageEntity, PaymentInvoiceStatusEntity.

СущностьНазначение
PaymentScheduleEntityПлановый этап оплаты по заказу: %, сумма, дата, комментарий. Создаётся через SetPaymentSchedules, не через PaymentSchedule.Add.
PaymentInvoiceEntityСчёт на этап. Ручной статус: Created / Sent / Cancelled. Paid / PartiallyPaid / Overpaid / NotPaid — только системой по сумме связей.
InvoicePaymentEntityСтрока платежа из выгрузки. SuggestedBuyerId — подсказка сопоставления. Связь со счетами — через InvoiceLinks.
InvoicePaymentPaymentInvoiceEntityM:N платёж ↔ счёт с полем InvoiceAmount. В v1 UI привязка — один счёт на платёж.
BankStatementEntityЗагруженная банковская выписка; содержит платежи.

Ключевые read-эндпоинты (сводки, не CRUD сущностей):

  • GET .../BuyerOrder/{id}/payment-summary — вкладка Финансы в заказе и аккордеон в форме счёта.
  • GET .../Partner/{id}/BuyerOrder/financials — вкладка Финансы у контрагента-покупателя.
  • GET .../PaymentStage/financials — компактная таблица План оплат (/payment-schedules).

Подробнее: finance-redesign.md, cursor-architecture.md (раздел «Бек: заказ и оплаты»).