Fab Forward Dev/

DDD ドキュメント

PMS ユビキタス言語辞書 / Ubiquitous Language Dictionary

SSOT (Single Source of Truth) — 業務用語・英語・変数名・テーブル名の正規対応表

この辞書はステークホルダー間のコミュニケーション齟齬を防ぐための共通言語です。 コード中の命名は必ずこの辞書に準拠してください。

: レガシーテーブル名はインスタンス固有の参照値。詳細は docs/ddd/pms/instances/{tenant}/ を参照。

対応ドメイン: docs/ddd/sales/01-ubiquitous-language.md (Sales CRM 側の用語辞書)


凡例 / Legend

説明
業務用語社内で日常使われる日本語
English (Domain)DDD モデル上の英語名
Type / Variableコード上の型名・変数名 (PascalCase / camelCase)
Legacy Table旧システムのテーブル名 (T_ / M_ / P_)
Modern Table新スキーマのテーブル名 (snake_case)

1. コアドメイン: 生産管理 (PMS)

1.1 見積・受注 (Quotation & Order)

業務用語English (Domain)Type / VariableLegacy TableModern Table
見積QuotationQuotation / quotationT_MITU_HEDquotations
見積明細Quotation LineQuotationLine / quotationLineT_MITU_BDYquotation_lines
受注Sales OrderSalesOrder / salesOrderT_ORDERorders
見積受注連携Quotation-Order LinkQuotationOrderLink / quotationOrderLinkT_MITU_ORDERquotation_order_links
受注 (顧客発注)Customer OrderCustomerOrder / customerOrderT_JUCHUcustomer_orders
見積番号Quotation NumberquotationNumberMITUMORI_NOquotation_number
改訂番号Revision SeqrevisionSeqKAITEI_NOrevision_seq
見積ステータスQuotation StatusquotationStatusMITUMORI_STSquotation_status
オーダNoOrder NumberorderNumberORDER_NOorder_number
親オーダNoParent Order NumberparentOrderNumberORDER_NOPparent_order_number
受注日Order DateorderDateORDER_DATEorder_date
納期Due DatedueDateNOUKIdue_date
完了予定日Scheduled DatescheduledDateYOTEI_DATEscheduled_date
完了日Completed DatecompletedDateKANRYO_DATEcompleted_date

1.2 外注手配 (Procurement)

業務用語English (Domain)Type / VariableLegacy TableModern Table
手配Purchase OrderPurchaseOrder / purchaseOrderT_TEHAIpurchase_orders
注文番号PO NumberpoNumberCHUMON_NOpo_number
手配状況Procurement StatusprocurementStatusTEHAI_STSprocurement_status
手配区分Procurement TypeprocurementTypeTEHAI_KBNprocurement_type
手配済みフラグIs OrderedisOrderedTEHAI_SUMIis_ordered
手配不要フラグIs Order UnnecessaryisOrderUnnecessaryTEHAI_FUYOis_order_unnecessary
発注日PO DatepoDateCHUMON_DATEpo_date

1.3 受入 (Goods Receiving)

業務用語English (Domain)Type / VariableLegacy TableModern Table
受入Goods ReceiptGoodsReceipt / goodsReceiptT_UKEIREreceiving_records
受入区分Receiving TypereceivingTypeUKEIRE_KBNreceiving_type
受入日Receiving DatereceivingDateUKEIRE_DATEreceiving_date
受入合計数Total ReceivedtotalReceivedUKEIRE_TOTALtotal_received

1.4 製作指示・作業日報 (Internal Production)

業務用語English (Domain)Type / VariableLegacy TableModern Table
製作指示Production InstructionProductionInstruction / productionInstructionT_SSIJIproduction_orders
作業日報Work ReportWorkReport / workReportT_NIPPOwork_logs
製作実績Production RecordProductionRecord / productionRecordT_SJISKproduction_records
指示番号Production Order NumberproductionOrderNumberSIJI_NOproduction_order_number
指示状況Production StatusproductionStatusSIJI_STSproduction_status
作業日Work DateworkDateSAGYO_DATEwork_date
作業開始時間Work Start TimeworkStartTimeSAGYO_STR_TIMEwork_start_time
作業終了時間Work End TimeworkEndTimeSAGYO_END_TIMEwork_end_time
作業時間Work HoursworkHoursSAGYO_TIMEwork_hours

1.5 売上・売掛・入金 (Sales & Billing)

業務用語English (Domain)Type / VariableLegacy TableModern Table
検収Delivery InspectionDeliveryInspection / deliveryInspectionT_KENSHUdelivery_inspections
売上Sales InvoiceSalesInvoice / salesInvoiceT_URIAGEsales_invoices
売掛AR Balance (CQRS)ARBalance / arBalanceT_URIKAKEar_balances
請求残高Invoice Balance (CQRS)InvoiceBalance / invoiceBalanceT_SKZANinvoice_balances
入金Cash ReceiptCashReceipt / cashReceiptT_NYUKINcash_receipts
納品案内Delivery AdviceDeliveryAdvice / deliveryAdviceT_NOUANNdelivery_advices
請求確定日Billing Confirmed DatebillingConfirmedDateSEIKYUBIbilling_confirmed_date
請求残高Billing BalancebillingBalanceSEIKYU_ZANbilling_balance

1.6 買掛・支払 (Accounts Payable)

業務用語English (Domain)Type / VariableLegacy TableModern Table
仕入AP ReceiptAPReceipt / apReceiptT_SHIIREap_receipts
支払Supplier PaymentSupplierPayment / supplierPaymentT_SIHARAIsupplier_payments
買掛AP Balance (CQRS)APBalance / apBalanceT_KAIKAKEap_balances
支払区分Payment TypepaymentTypeSIHARAI_KBNpayment_type
支払確定日Payment Confirmed DatepaymentConfirmedDateSIHARAIBIpayment_confirmed_date
支払残高Payment BalancepaymentBalanceSIHARAI_ZANpayment_balance

1.7 原価分析 (Cost Analysis)

業務用語English (Domain)Type / VariableLegacy TableModern Table
原価レポートCost ReportCostReport / costReport— (集計ビュー)
原価CostcostGENKA
検収額Inspection AmountinspectionAmountKENSHUGAKU
仕掛Work In ProgressworkInProgressSIKAKARI

2. コアドメイン: 営業CRM (Sales)

Sales CRM の用語定義は docs/ddd/sales/01-ubiquitous-language.md を参照。 本セクションでは PMS が連携時に参照する Sales CRM 用語のみを記載する。

業務用語English (Domain)Type / Variable説明
取引先AccountAccount顧客マスタの Sales CRM 側オーナー
案件DealDealパイプライン管理の基本単位
案件成約Deal Wondeal.wonPMS への受注依頼 (CreateOrderRequest) のトリガー

3. マスタデータ (Master Data — 両システム共通)

業務用語English (Domain)Type / VariableLegacy TableModern Table
社員EmployeeEmployee / employeeM_SHAINemployees
得意先CustomerCustomer / customerM_TOKUISAKIcustomers
仕入先SupplierSupplier / supplierM_SIIRESAKI (+ M_TEHAISAKI*)suppliers
区分ClassificationClassification / classificationM_KUBUNclassifications
区分名称Classification LabelClassificationLabel / classificationLabelM_KUBUN_NAMEclassification_labels
採番管理Number SequenceNumberSequence / numberSequenceM_NO_KANRInumber_sequences
品番ProductProduct / productM_HINBANproducts
部品表 (ヘッダ)BOM HeaderBOMHeader / bomHeaderM_PARTS_HEDbom_headers
部品表 (明細)BOM LineBOMLine / bomLineM_PARTS_BDYbom_lines
部品表 (設変)BOM RevisionBOMRevision / bomRevisionM_PARTS_CHGbom_revisions
単価Unit PriceunitPriceM_TANKAprice_lists
部署DepartmentDepartment / departmentM_BUSHOdepartments
権限PermissionPermission / permissionM_KENGENpermissions
権限グループPermission GroupPermissionGroup / permissionGroupM_KENGEN_IDXpermission_groups
納入先Delivery DestinationDeliveryDestination / deliveryDestinationM_NOUNYUSAKIdelivery_destinations
工程ProcessProcess / processM_KOUTEIprocesses
作業種別Work TypeWorkType / workTypeM_SAGYOwork_types
仕入単価Supplier PriceSupplierPrice / supplierPriceM_SHIIRETANKAsupplier_prices

マスタ共通フィールド

業務用語English (Domain)Type / VariableLegacy ColumnModern Column
得意先コードCustomer CodecustomerCodeTOKUISAKI_CODEcustomer_code
得意先名Customer NamecustomerNameTOKUISAKI_NAMEcustomer_name
仕入先コードSupplier CodesupplierCodeSIIRESAKI_CODEsupplier_code
仕入先名Supplier NamesupplierNameSIIRESAKI_NAMEsupplier_name
社員コードEmployee CodeemployeeCodeSHAIN_CODEemployee_code
権限コードPermission CodepermissionCodeKENGEN_CODEpermission_code
品番Product NumberproductNumberHINBANproduct_number
品名Product NameproductNameHINMEIproduct_name
型式Model NumbermodelNumberKATASIKImodel_number
材質MaterialmaterialZAISHITUmaterial
寸法DimensionsdimensionsSUNPOdimensions
重量WeightweightJYURYOweight
単価Unit PriceunitPriceTANKAunit_price
発注単価Purchase PricepurchasePriceHTANKApurchase_price
売価Selling PricesellingPriceUTANKAselling_price
見積単価Quote PricequotePriceMTANKAquote_price

マスタデータ注記

* M_TEHAISAKI → Supplier 統合: レガシーでは M_SIIRESAKI (財務系) と M_TEHAISAKI (手配系) の 2つの仕入先マスタが存在したが、これはレガシー設計の負債である。新システムでは単一の Supplier エンティティに統合し、手配系属性 (工程コード, 分類, 印刷レイアウト) と財務系属性 (支払方法, 支払残高) をロールベースフィールドとして保持する。詳細: docs/ddd/pms/instances/tamari/migration-notes.md

CQRS 読取モデル: AR Balance (T_URIKAKE), Invoice Balance (T_SKZAN), AP Balance (T_KAIKAKE) は 月次締め処理で全削除→再作成されるエフェメラルなスナップショットテーブル。新システムでは CQRS の 読取モデルとして実装し、トランザクションテーブルとは区別する。

区分マスタの主要区分種別 (Classification Categories)

区分マスタ (M_KUBUN / classifications) はドロップダウン値・ステータスコード・業務設定を テナント単位で管理する汎用マスタ。以下は製造業で共通的に必要となる区分種別の一覧。

区分種別EnglishType用途
単位区分Unit of MeasureUnitOfMeasure数量の単位 (個/式/台/Kg/m 等)
端数処理区分Rounding PolicyRoundingPolicy税額・単価の丸め方法
請求計算区分Billing CalculationBillingCalculationMethod明細単位 or 合算
単価区分Price TypePriceType売価/発注単価/見積単価
社内外区分Internal/ExternalInternalExternal社内作業 or 外注
入金方法Receipt Payment MethodPaymentMethod現金/振込/手形/相殺 等
支払方法Supplier Payment MethodPaymentMethod現金/振込/手形/相殺 等
費目区分Expense CategoryExpenseCategory仕入の費目分類
見積費目区分Quotation Cost ItemQuotationCostItem見積明細の費目 (20分類程度)
社内工程区分Internal Process CategoryInternalProcessCategory労務費の工程分類
手配品区分Procurement Item TypeProcurementItemType材料/部品/購入品/外注
仕入先区分Supplier ClassificationSupplierClassification購入先/外注/納入先 等
注文書出力方法PO Output MethodPOOutputMethod紙/FAX/メール/出力なし
締日区分Closing DayClosingDayType月次締め日
支払月区分Payment TimingPaymentTiming当月/翌月/翌々月
権限レベルPermission LevelPermissionLevel使用不可/参照のみ/更新可
見積ステータスQuotation StatusQuotationStatus作成中→申請中→承認/否認
手配ステータスProcurement StatusProcurementStatus作成中→申請→確定→承認→発注→受入→検収
工事ステータスOrder StatusOrderStatus工事中→完了(未売上)→完了(売上済)
製作指示ステータスProduction StatusProductionStatus着手→完了

4. 連携コントラクト (Integration Contracts)

業務用語English (Domain)Type / Variable方向説明
受注依頼Create Order RequestCreateOrderRequestSales → PMS案件から受注への変換リクエスト
見積依頼・回答Quote Request / ResponseQuoteRequest / QuoteResponseSales ↔ PMSBOM原価計算の依頼と回答
ドメインイベントDomain EventDomainEventPMS → Sales製造進捗イベント (10種)
進捗コールバックOrder Status CallbackOrderStatusCallbackPMS → Sales集約ステータス通知
顧客同期Customer Sync PayloadCustomerSyncPayloadSales → PMS顧客マスタの同期
製品マスタProduct Catalog EntryProductCatalogEntryPMS → Sales製品カタログの同期

ドメインイベント種別

イベント名EnglishTypeトリガー
受注受付Order Acceptedorder.acceptedPMS が受注を登録
作業指示作成Work Order Createdwork_order.created製作指示を発行
作業着手Work Startedwork_order.started作業員が着手
作業完了Work Completedwork_order.completed作業が完了
外注発注PO Issuedpurchase_order.issued仕入先に発注
入荷Goods Receivedgoods.received受入処理完了
検収完了Inspection Passedinspection.passed顧客検収合格
出荷Shippedorder.shipped納品発送
請求発行Invoice Issuedinvoice.issued請求書発行
入金確認Payment Receivedpayment.received入金消込完了

5. 共通フィールド (Audit & Metadata)

業務用語English (Domain)Type / VariableLegacy ColumnModern Column
登録日時Created AtcreatedAtINPUTDATEcreated_at
更新日時Updated AtupdatedAtLASTDATEupdated_at
登録者Created BycreatedByINPUTUSERcreated_by
更新者Updated ByupdatedByLASTUSERupdated_by
削除フラグIs DeletedisDeletedDEL_FLGis_deleted
備考RemarksremarksBIKOremarks

6. 承認ワークフロー (Approval Workflow)

業務用語English (Domain)Type / VariableLegacy ColumnModern Column
作成者AuthorauthorCodeSAKUSEI_CODEauthor_code
作成日Authored DateauthoredDateSAKUSEI_DATEauthored_date
承認者ApproverapproverCodeSHOUNIN_CODEapprover_code
承認日Approved DateapprovedDateSHOUNIN_DATEapproved_date
確定者ConfirmerconfirmerCodeKAKUTEI_CODEconfirmer_code
確認担当者VerifierverifierCodeKAKUNIN_CODEverifier_code
検収者InspectorinspectorCodeKENSHU_CODEinspector_code

7. 帳票 (Print / Reports)

業務用語English (Domain)Type / VariableLegacy TableModern Table
見積書Quotation ReportRptQuotationP_MITUMORIrpt_quotations
見積依頼書Quote Request ReportRptQuoteRequestP_MITU_IRAIrpt_quote_requests
購入品申請書Purchase Request ReportRptPurchaseRequestP_SINSEIrpt_purchase_requests
注文書Purchase Order ReportRptPurchaseOrderP_CHUMONrpt_purchase_orders
製作指示書Production Order ReportRptProductionOrderP_SSIJIrpt_production_orders
納品書Delivery Note ReportRptDeliveryNoteP_NOUHINrpt_delivery_notes
納品案内書Delivery Notice ReportRptDeliveryNoticeP_NOUANNrpt_delivery_notices
請求書Invoice ReportRptInvoiceP_SEIKYUrpt_invoices

命名規則 / Naming Conventions

テーブル名

  • Legacy: プレフィックス T_ (トランザクション), M_ (マスタ), P_ (帳票)
  • Modern: snake_case 複数形 (e.g., purchase_orders, employees)

カラム名

  • Legacy: UPPER_SNAKE_CASE (e.g., TOKUISAKI_CODE)
  • Modern: lower_snake_case (e.g., customer_code)

TypeScript 型名

  • エンティティ: PascalCase 単数形 (e.g., SalesOrder, PurchaseOrder)
  • 変数: camelCase 単数形 (e.g., salesOrder, purchaseOrder)
  • コレクション: camelCase 複数形 (e.g., salesOrders, purchaseOrders)

禁止事項

  • ローマ字をそのまま変数名にしない (mitumori NG → quotation OK)
  • 略語を型名に使わない (Mitu NG → Quotation OK)
  • レガシー名をそのまま新コードに持ち込まない (T_ORDER NG → SalesOrder OK)