Доменная модель
В API домены разделены по EF Core contexts, entity-моделям, request DTO и response DTO.
Contexts
| Context | Домен |
|---|---|
EmployeeContext | Сотрудники, должности, места производства |
IdentityContext | ASP.NET Identity users и roles |
LogicContext | Сквозная workflow-логика |
NotificationContext | Уведомления, чаты, сообщения (схема Notification) |
OrderContext | Контрагенты, заказы, оплаты, отгрузки, документы |
ProductContext | Изделия и данные спецификаций |
TaskManagerContext | Справочники задач и состояния задач |
WarehouseContext | SKU, складские параметры, резервы |
Основные сущности
Сотрудники
EmployeeEntityPostEntityLocationManufactureEntity- Identity user и user-role entities
Заказы
PartnerEntityBuyerOrderEntityOrderEntityGoodEntityContractEntityPaymentScheduleEntityPaymentInvoiceEntityInvoicePaymentEntityInvoicePaymentPaymentInvoiceEntity— связь платёж ↔ счёт (сумма на счёт)BankStatementEntityShipmentEntityDocumentEntityContactPersonEntitySignerEntityAccessGroupEntity
Изделия
ProductEntityMagnetEntityProductRequiredDocumentationEntity- сущности элементов спецификации
Склад
StockKeepingUnitEntity- справочники типов, категорий и параметров SKU
MaterialInReserveEntity- данные количества и нормализованных наименований
Задачи
ProcessEntityTaskEntityTaskTypeEntityTaskStatusEntityTaskStateEntityDateOfStatusChangeEntityTimeSpentEntity
Уведомления и чаты (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. |
InvoicePaymentPaymentInvoiceEntity | M: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 (раздел «Бек: заказ и оплаты»).