Factorizer/Cluster ERP WikiCluster ERP English
Ana sayfa / Platform

Referans

Sözleşmeler başvurusu

core/contracts.py içindeki 270 dondurulmuş dataclass; bölümlere göre gruplanmış, her sözleşmeyi üreten ve işleyen modüllerle birlikte.

Bu sayfa src/cluster_erp/core/contracts.py içindeki her sözleşmeyi listeler: modüllerin EventBus üzerinden değiş tokuş ettiği dondurulmuş dataclass'lar. Her sözleşme için türü, satırı, onu oluşturan modülleri ve onu işleyen modülleri verir. Veri yolunun sözleşmeleri nasıl ilettiği olay veri yolu sayfasında anlatılır; alan listeleri kaynak dosyadadır.

Kapsam ve kaynak

  • Tanımlandığı yer: src/cluster_erp/core/contracts.py
  • Sayı: @dataclass(frozen=True ile işaretli 270 sınıf (grep -c "@dataclass(frozen=True" ile sayıldı). Bunların 149'u Event'ten türer (145'i doğrudan, 4'ü _SubscriptionEvent üzerinden), 118'i Query'den türer ve 3'ü DescribeAnalyticsFacts yanıtlarında kullanılan düz değer türleridir.
  • 153 sözleşmenin en az bir işleyicisi vardır. 117'sinin yoktur. 38'i için üretici bulunamadı.

Sütunlar şöyle üretildi:

  • Tür: class satırındaki temel sınıf.
  • Satır: src/cluster_erp/core/contracts.py içindeki class ifadesinin satırı.
  • Üreticiler: contracts.py hariç src/cluster_erp/modules, src/cluster_erp/server, src/cluster_erp/core veya src/cluster_erp/ai içinde Name( çağrısı (bir oluşturma) taşıyan dosyaların modülleri. core ve server bu klasörleri adlandırır. "(adla)", src/cluster_erp/modules/subscriptions/customer_subscriptions/services.py:423-429 dosyasının sözleşmeler modülü üzerinde getattr ile kurduğu abonelik olaylarını işaretler.
  • Tüketiciler: sözleşmeyi aynı satırda veya sonraki satırda subscribe( ya da register_query_handler( çağrısının ilk argümanı olarak veren modüller.
  • -, o yöntemle hiçbir şey bulunamadığı anlamına gelir.

Gruplar contracts.py içindeki bölüm yorumlarını izler. Bir grup adı sınıfın bildirildiği bölümdür, onu yayınlayan modül olmayabilir; gerçek üretici Üreticiler sütunundadır.

Taraf alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
PartyCreated Event 24 parties -
PartyUpdated Event 31 parties crm, procurement
PartyDeleted Event 43 parties crm, owned_organisations, procurement
PartyRoleSet Event 48 crm, owned_organisations, procurement parties
GetPartyById Query 59 crm, fleet, intranet, inventory, procurement, products_and_services, purchasing_quotations, sales_orders parties
GetAddressById Query 64 procurement, sales_orders parties
SearchParties Query 73 intranet parties
CountPartyChannels Query 81 crm parties

Kuruluş alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
OrganisationCreated Event 95 owned_organisations -
OrganisationUpdated Event 102 owned_organisations -
EmployeeAdded Event 108 owned_organisations -
GetOrganisationById Query 115 production owned_organisations
GetCompanyDefaultTimezone Query 120 intranet, production owned_organisations
EnsurePartyForOrganisation Query 135 owned_organisations parties

Ürün ve hizmet alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
ProductCreated Event 149 products_and_services -
ProductUpdated Event 157 products_and_services procurement
ProductStatusChanged Event 163 products_and_services -
ProductDeleted Event 170 products_and_services bom
RecordActivated Event 177 records owned_organisations, products_and_services
ServiceCreated Event 191 products_and_services -
GetProductById Query 197 bom, inventory, nesting, procurement, production, products_and_services, sales_orders products_and_services
CreateScaffoldIntermediate Query 202 production products_and_services
ValidateProductBreakdown Query 219 core products_and_services
GetProductDefaultBreakdown Query 230 bom, procurement, production products_and_services
GetBulkProductDefaultBreakdowns Query 240 bom, procurement products_and_services
IsProductManufacturable Query 248 production products_and_services
IsProductPurchasable Query 253 - products_and_services
IsProductSellable Query 258 - products_and_services
GetProductsByMaterialType Query 263 - products_and_services

Kimlik doğrulama alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
ApprovalCompleted Event 275 auth documents
GetUserById Query 283 - auth
GetUserPermissions Query 288 - auth
GetApprovalChainForAction Query 293 documents, intranet auth
SubmitForApproval Query 299 documents, intranet auth
GetApprovalRequestById Query 307 documents auth

Belge alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
DocumentCreated Event 317 documents -
DocumentVersionActivated Event 322 documents -
DocumentVersionSuperseded Event 329 documents -
ResolveDocumentVersionFile Query 336 intranet documents

E-posta alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
ResolveEntityEmails Event 352 intranet, server parties

CRM alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
CustomerCreated Event 364 crm parties
CustomerUpdated Event 370 crm -
GetCustomerById Query 376 quotations, sales_orders crm
RfqUpdated Event 381 crm -
RfqReceived Event 387 crm -
RfqAssigned Event 394 crm -
RfqPackageCompleted Event 400 crm -
RfqDeclined Event 412 crm, quotations -
RfqExpired Event 418 crm -
RfqWon Event 423 crm -
RfqLost Event 428 crm -
RfqReopened Event 433 - -
GetRfqById Query 438 quotations, sales_orders crm
GetRfqIdsByCustomer Query 443 quotations crm
GetCustomerPartById Query 448 sales_orders crm
GetCustomerPartsByCustomer Query 453 - crm

Teklif alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
QuoteCreated Event 464 quotations -
QuoteFeasibilityCompleted Event 471 quotations -
QuoteBomAttached Event 476 quotations -
QuoteCostingCompleted Event 482 costing, quotations -
QuoteMgmtApprovalRecorded Event 488 quotations -
QuoteSent Event 494 quotations -
QuoteWon Event 500 quotations -
QuoteLost Event 506 quotations -
QuoteExpired Event 512 quotations -
QuoteFeasibilityFailed Event 517 quotations -
QuoteReturnedToBom Event 523 - -
QuoteMgmtRejected Event 528 - -
QuoteRevised Event 534 - -
GetQuoteById Query 541 sales_orders quotations
GetQuoteLineItems Query 546 sales_orders quotations
ReferenceQuoteLines Query 554 sales_orders quotations
ReleaseQuoteLineReferences Query 570 sales_orders quotations
GetPurchasingQuotationById Query 580 - purchasing_quotations
CreateFollowOnFromSupplierQuotation Query 585 purchasing_quotations procurement
SupplierQuotationAwarded Event 607 purchasing_quotations procurement
GetInfoRecordPrice Query 619 - -
GetPurchaseRfqQuotations Query 628 purchasing_quotations procurement

Satış siparişi alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
SalesOrderPoReceived Event 644 sales_orders projects
SalesOrderMismatchDetected Event 650 sales_orders -
SalesOrderRevisionRequested Event 656 sales_orders -
SalesOrderMatched Event 661 sales_orders -
SalesOrderOpened Event 666 sales_orders procurement
SalesOrderCancelled Event 675 sales_orders -
SalesOrderShipped Event 681 sales_orders -
SalesOrderDelivered Event 686 sales_orders -
SalesOrderClosed Event 691 sales_orders -
SalesOrderRevisionLimitReached Event 696 - -
SalesOrderOnHold Event 702 - -
SalesOrderResumed Event 708 - -
SalesOrderPartiallyShipped Event 713 sales_orders -
GetSalesOrderById Query 719 nesting, projects sales_orders

Proje alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
ProjectCreated Event 729 projects sales_orders
ProjectKickoffCompleted Event 737 projects -
ProjectActionCreated Event 742 projects -
ProjectActionOverdue Event 750 - -
ProjectSchedulePublished Event 757 projects production
ProjectActivityChanged Event 764 projects -
ProjectScheduleShared Event 776 projects -
ProjectFixtureRequired Event 782 projects -
ProjectClosed Event 791 projects -
ProjectStatusChanged Event 796 projects -
GetProjectById Query 803 sales_orders projects
GetProjectMemberPartyIds Query 808 intranet projects
IsKickoffCompleted Query 818 - projects

Tasarım ve mühendislik alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
DesignCreated Event 828 design_engineering -
DesignApproved Event 836 design_engineering bom
DesignSuperseded Event 844 design_engineering -
EcnProposed Event 851 design_engineering -
EcnApproved Event 859 design_engineering -
EcnImplemented Event 866 design_engineering -
GetDesignById Query 874 bom design_engineering
IsDesignApproved Query 879 - design_engineering

Ürün ağacı alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
BomDraftCreated Event 889 bom -
BomActivated Event 897 bom costing, procurement
BomVersionActivated Event 904 bom production
BomSuperseded Event 921 bom -
BomLaborUpdated Event 928 - -
BomItemAdded Event 934 - procurement
BomItemChanged Event 941 bom procurement
GetBomById Query 947 production, sales_orders bom
IsBomActive Query 952 - bom

Envanter alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
GoodsReceived Event 962 inventory procurement
GoodsIssued Event 985 inventory procurement
StockTransferred Event 997 inventory procurement
StockAdjusted Event 1006 inventory procurement
BatchCreated Event 1016 inventory -
GoodsMovementReversed Event 1023 inventory procurement
StockReserved Event 1040 inventory -
StockReservationConsumed Event 1050 inventory -
StockReservationCancelled Event 1055 inventory -
GetStockLevel Query 1060 procurement inventory
GrBlockedReceived Event 1072 inventory -
GrBlockedReleased Event 1082 - -
StockCategoryTransferred Event 1090 inventory procurement
ReturnedToVendor Event 1100 inventory -
ScrapPosted Event 1110 inventory -
UsageDecisionRecorded Event 1119 inventory -
GetBatchesByProduct Query 1131 - inventory
IsStockAvailable Query 1137 - inventory
GetBomVersionsUpdatedAt Query 1149 procurement bom
GetBomExplosion Query 1158 costing, procurement, production bom
GetBomMaterials Query 1163 crm bom
GetBomItemDisplay Query 1171 production bom
GetBomVersionDisplay Query 1176 production bom
ReserveStock Query 1181 nesting inventory
ConsumeReservation Query 1195 nesting inventory
CancelReservation Query 1200 - inventory
PostGoodsReceipt Query 1205 nesting, procurement, production inventory
PostGoodsIssue Query 1227 fleet, nesting, production inventory

Üretim alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
ProductionOrderCreated Event 1251 production procurement
ProductionOrderStatusChanged Event 1259 production -
GetProjectProductionSchedule Query 1266 projects production
GetProjectSalesDelivery Query 1278 projects sales_orders
GetProjectProductionEvm Query 1286 projects production
GetProjectProductionRollup Query 1298 projects production
GetPlannedOrdersForCapacity Query 1309 production procurement
CreateProductionOrderFromPlanned Query 1319 procurement production
CreateBomForProduct Query 1334 sales_orders bom
CreateProductionOrderForProject Query 1356 projects production
WorkOrderCompleted Event 1375 production -
ProductionOrderCompleted Event 1386 production procurement
ProductionOrderCancelled Event 1393 production -
ProductionOrderOnHold Event 1399 production -
MaterialConsumed Event 1405 production -
GetProductionOrderById Query 1413 nesting production
GetRoutingForProduct Query 1418 production production

Yerleşim alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
NestingCompleted Event 1428 nesting -
NestingApproved Event 1437 nesting -
NestingLowUtilizationAlert Event 1443 - -
GetNestingJobById Query 1450 costing nesting
NestingRemnantCreated Event 1455 nesting -
NestingRemnantConsumed Event 1463 nesting -
NestingRemnantScrapped Event 1469 nesting -
GetAvailableRemnants Query 1475 - nesting
NestingMaterialReserved Event 1483 nesting -
NestingMaterialConsumed Event 1491 nesting -
NestingScrapRecorded Event 1498 nesting -
NestingCostCalculated Event 1506 nesting costing

Maliyetlendirme alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
CostingCreated Event 1520 costing -
CostingCalculated Event 1529 costing -
CostingApproved Event 1540 costing -
CostingRejected Event 1551 costing -
CostingSuperseded Event 1559 costing -
LowMarginAlert Event 1566 costing -
CostingRateUpdated Event 1576 costing -
GetCostingById Query 1585 quotations costing
GetCostingByBomId Query 1590 - costing
GetActiveLaborRate Query 1596 - costing
GetActiveOverheadRates Query 1603 - costing
GetCostBreakdown Query 1608 - costing

Bileşen tahsisi

Sözleşme Tür Satır Üreticiler Tüketiciler
GetComponentAllocations Query 1618 bom production

Satın alma alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
PrCreated Event 1629 procurement -
PrApproved Event 1636 procurement -
PrCancelled Event 1643 procurement -
PoCreated Event 1650 procurement -
PoSent Event 1658 procurement -
PoAcknowledged Event 1665 procurement -
PoReceivedPartial Event 1671 procurement -
PoReceivedFull Event 1680 procurement -
PoDelayed Event 1686 - -
PoCancelled Event 1694 procurement -
MrpRunCompleted Event 1701 procurement -
MrpRunFailed Event 1710 procurement -
CriticalMaterialAlert Event 1717 procurement -
GetPurchaseOrderById Query 1725 - procurement
GetPurchaseRequestById Query 1730 fleet procurement
GetOpenPosForProduct Query 1735 procurement procurement
ReconcilePoReceiptReversal Query 1740 inventory procurement
GetOpenPoLinesForReceipt Query 1755 procurement procurement
GetCriticalMaterials Query 1766 procurement procurement
GetSubstitutesForProduct Query 1771 procurement procurement
GetProductVendors Query 1776 - products_and_services
GetProductPlanningData Query 1781 bom, procurement products_and_services
GetOpenSalesOrderDemand Query 1788 procurement sales_orders
GetOpenProductionDemand Query 1795 procurement production
GetProductionSupply Query 1802 procurement production
GetActiveBomVersionForProduct Query 1809 bom, procurement, production bom
GetActiveBomItemsForProduct Query 1816 procurement bom
GetBomScaffoldTree Query 1825 production bom
GetWarehouseById Query 1868 procurement inventory
GetBulkStockLevels Query 1877 bom, procurement inventory
GetConsumptionHistory Query 1885 procurement inventory
SetProductPlanningClassification Query 1898 procurement products_and_services
ApplyProductBufferZones Query 1907 procurement products_and_services
GetBatchExpirySchedule Query 1917 procurement inventory
GetProductionVersionsBulk Query 1927 procurement production
CheckProductionCapacity Query 1940 procurement production
GetPartUsageCounts Query 1952 procurement, products_and_services bom
GetBulkOpenPos Query 1961 bom, procurement procurement
GetBulkProductVendors Query 1968 procurement products_and_services

Çalışma takvimi alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
GetCalendarWindows Query 1980 production calendars
GetEffectiveWorkingCalendar Query 1991 production calendars
GetEffectiveWorkingCalendars Query 2002 production calendars
WorkingCalendarChanged Event 2013 calendars production
GetOwnerWorkingDays Query 2026 intranet, procurement, projects, sales_orders calendars

Analitik alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
DescribeAnalyticsFacts Event 2060 analytics fleet, inventory, parties, procurement, production, products_and_services, purchasing_quotations, quotations, sales_orders
AnalyticsDimension değer türü 2076 analytics, fleet, inventory, parties, procurement, production, products_and_services, purchasing_quotations, quotations, sales_orders -
AnalyticsMeasure değer türü 2101 fleet, inventory, parties, procurement, production, products_and_services, purchasing_quotations, quotations, sales_orders -
AnalyticsFactSet değer türü 2126 fleet, inventory, parties, procurement, production, products_and_services, purchasing_quotations, quotations, sales_orders -

İntranet alanı

Sözleşme Tür Satır Üreticiler Tüketiciler
SendTransactionalEmail Event 2163 intranet mail
RetentionSweep Event 2180 server intranet
IntranetEventPublished Event 2212 intranet -
IntranetEventUpdated Event 2229 intranet -
IntranetEventCancelled Event 2241 intranet -
IntranetPostPublished Event 2250 intranet -
GetUpcomingIntranetEvents Query 2262 - intranet
GetPartyForEmployee Query 2274 intranet, projects owned_organisations
ListDirectoryEmployees Query 2284 intranet owned_organisations
GetTeamPartyIds Query 2296 intranet owned_organisations

Abonelikler

Sözleşme Tür Satır Üreticiler Tüketiciler
_SubscriptionEvent Event 2318 - -
SubscriptionActivated Event (_SubscriptionEvent) 2335 subscriptions (adla) -
SubscriptionRenewed Event (_SubscriptionEvent) 2340 subscriptions (adla) -
SubscriptionCancelled Event (_SubscriptionEvent) 2345 subscriptions (adla) -
SubscriptionExpired Event (_SubscriptionEvent) 2350 subscriptions (adla) -
GetSubscriptionPlanById Query 2355 - subscriptions
GetCustomerSubscriptionById Query 2360 - subscriptions
GetDocumentsForEntity Query 2365 intranet documents

Veri sahibi talepleri

Sözleşme Tür Satır Üreticiler Tüketiciler
CollectSubjectData Event 2385 privacy auth, crm, documents, intranet, logs, mail, owned_organisations, parties, procurement
GetPartyContactValues Query 2402 privacy parties
AnonymiseSubject Event 2411 privacy auth, crm, documents, intranet, logs, mail, owned_organisations, parties, procurement, server

Son bölüm yorumundan sonraki sözleşmeler

Aşağıdaki sözleşmeler dosyada veri sahibi bölümünün ardından gelir ve kendi bölüm yorumlarını taşımaz.

Sözleşme Tür Satır Üreticiler Tüketiciler
DescribeDisplaySwitches Event 2441 server sales_orders
TenantFieldValuesChanged Event 2452 core -
DescribeFieldConsumers Event 2470 server bom, intranet, inventory, procurement, production, quotations, sales_orders
ConvertQuantity Query 2484 sales_orders products_and_services
GetUnitOfMeasure Query 2496 sales_orders products_and_services
GetPartyPrimaryAddress Query 2503 sales_orders parties
GetHeadquartersOrganisation Query 2513 sales_orders owned_organisations
FindUnitOfMeasure Query 2520 sales_orders products_and_services
GetCountryByCode Query 2529 sales_orders parties

Kısıtlar ve doğrulama

  • Her sözleşme dondurulmuş bir dataclass'tır. Event ve Query frozen=True, kw_only=True ile bildirilir; bu yüzden her alan anahtar sözcükle verilir (src/cluster_erp/core/event_bus.py:24-32).
  • Her sözleşme Event'ten gelen source_module ve timestamp alanlarını taşır (src/cluster_erp/core/event_bus.py:25-27).
  • Bir sorgu türünün yalnızca bir işleyicisi olabilir; ikincisini kaydetmek DuplicateQueryHandlerError yükseltir (src/cluster_erp/core/event_bus.py:73-79).
  • GetInfoRecordPrice, üreticisi ve işleyicisi bulunamayan bir sorgudur (src/cluster_erp/core/contracts.py:619). Onunla bus.query çağrısı QueryHandlerNotFoundError yükseltir (src/cluster_erp/core/event_bus.py:98-101).
  • İşleyicisi olmayan sözleşmeler yayınlandığında kimseye iletilmez (src/cluster_erp/core/event_bus.py:85-87). 117 sözleşmenin her birinin ileride kullanım için ayrılıp ayrılmadığı koddan belirlenemedi.

Tanıtılan terimler

Terim Kod tanımlayıcısı Tanım Türkçe terim Kaynak
contract core/contracts.py dataclass Modüller arasında değiş tokuş edilen bir olayın veya sorgunun yükünü tanımlayan dondurulmuş dataclass. sözleşme src/cluster_erp/core/contracts.py:1-6
producer yok Bir sözleşmeyi oluşturup emit veya query çağrısına veren modül. üretici src/cluster_erp/core/event_bus.py:83
consumer yok Bir sözleşme için işleyici kaydeden modül. tüketici src/cluster_erp/core/event_bus.py:55

İlgili sayfalar

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.

Doğrulanan commit 92f8051 · 2026-11-13