npm - @k2works/claude-code-booster - Versions diffs - 4.6.0 → 4.7.0 - Mend

@k2works/claude-code-booster 4.6.0 → 4.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (779) hide show

package/lib/assets/docs/article/practical-database-design/part4/chapter30.md CHANGED Viewed

@@ -1,2180 +1,2180 @@
-# 第30章：製造原価管理の設計
-## 30.1 原価計算の概要
-### 製造原価の構成
-製造原価は、製品を製造するために発生するすべてのコストを体系的に把握するための概念です。製造原価は大きく直接費と間接費（製造間接費）に分類されます。
-```plantuml
-@startuml
-title 製造原価の構成
-package "製造原価" {
-  package "直接費" {
-    [直接材料費] as DM
-    [直接労務費] as DL
-    [直接経費] as DE
-  }
-  package "間接費（製造間接費）" {
-    [間接材料費] as IM
-    [間接労務費] as IL
-    [間接経費] as IE
-  }
-}
-note right of DM : BOMに基づく材料消費
-note right of DL : 工数実績に基づく賃金
-note right of DE : 外注加工費など
-note right of IM : 消耗品、補助材料
-note right of IL : 間接作業者の賃金
-note right of IE : 減価償却費、電力費等
-@enduml
-```
-#### 原価要素の分類
-| 分類 | 原価要素 | 説明 | 例 |
-|-----|---------|------|-----|
-| **直接材料費** | 製品に直接使用される材料 | BOM に基づき計算 | 主要材料、部品 |
-| **直接労務費** | 製造作業者の賃金 | 工数実績 × 賃率 | 製造ラインの作業者 |
-| **直接経費** | 製品に直接賦課できる経費 | 外注費など | 外注加工費、特許使用料 |
-| **間接材料費** | 製品に間接的に使用される材料 | 配賦により計算 | 潤滑油、消耗工具 |
-| **間接労務費** | 間接作業者の賃金 | 配賦により計算 | 監督者、品質管理者 |
-| **間接経費** | 製造に間接的に発生する経費 | 配賦により計算 | 減価償却費、水道光熱費 |
-### 標準原価と実際原価
-原価計算には、標準原価計算と実際原価計算の2つのアプローチがあります。
-```plantuml
-@startuml
-title 標準原価と実際原価の関係
-package "原価計算" {
-  package "標準原価計算" {
-    [標準材料費] as SM
-    [標準労務費] as SL
-    [標準経費] as SE
-  }
-  package "実際原価計算" {
-    [実際材料費] as AM
-    [実際労務費] as AL
-    [実際経費] as AE
-  }
-}
-[標準製造原価] as SC
-[実際製造原価] as AC
-[原価差異] as CV
-SM --> SC
-SL --> SC
-SE --> SC
-AM --> AC
-AL --> AC
-AE --> AC
-SC --> CV : 比較
-AC --> CV : 比較
-note right of SC : 事前に設定した目標原価
-note right of AC : 実際に発生した原価
-note right of CV : 差異分析により改善
-@enduml
-```
-| 区分 | 説明 | 用途 |
-|-----|------|-----|
-| **標準原価** | 事前に設定した目標原価 | 予算管理、見積り、原価統制 |
-| **実際原価** | 実際に発生した原価 | 実績把握、原価差異分析 |
-### 原価差異分析
-原価差異は、標準原価と実際原価の差として計算されます。
-```
-原価差異 = 実際原価 - 標準原価
-```
-差異がプラス（不利差異）の場合は実際原価が標準を上回っており、マイナス（有利差異）の場合は実際原価が標準を下回っていることを示します。
-```plantuml
-@startuml
-title 原価差異分析の構造
-package "原価差異" {
-  [材料費差異] as MV
-  [労務費差異] as LV
-  [経費差異] as EV
-}
-package "材料費差異の要因" {
-  [価格差異] as MP
-  [数量差異] as MQ
-}
-package "労務費差異の要因" {
-  [賃率差異] as LR
-  [能率差異] as LE
-}
-package "経費差異の要因" {
-  [予算差異] as EB
-  [操業度差異] as EO
-}
-MV --> MP
-MV --> MQ
-LV --> LR
-LV --> LE
-EV --> EB
-EV --> EO
-note right of MP : 実際単価と標準単価の差
-note right of MQ : 実際使用量と標準使用量の差
-note right of LR : 実際賃率と標準賃率の差
-note right of LE : 実際作業時間と標準作業時間の差
-@enduml
-```
-#### 差異の要因分析
-| 差異種類 | 要因 | 計算式 |
-|---------|-----|-------|
-| **価格差異** | 材料の購入単価の差 | (実際単価 - 標準単価) × 実際使用量 |
-| **数量差異** | 材料の使用量の差 | (実際使用量 - 標準使用量) × 標準単価 |
-| **賃率差異** | 労働者の賃率の差 | (実際賃率 - 標準賃率) × 実際作業時間 |
-| **能率差異** | 作業効率の差 | (実際作業時間 - 標準作業時間) × 標準賃率 |
----
-## 30.2 材料費・労務費・製造間接費
-### 材料費の計算（直接材料費・間接材料費）
-材料費は、製品の製造に使用された材料の消費額です。BOM（部品表）と消費実績に基づいて計算します。
-```plantuml
-@startuml
-title 材料費計算の流れ
-|BOM管理|
-start
-:BOM展開;
-:必要材料の特定;
-|在庫管理|
-:材料払出;
-:消費実績記録;
-|原価計算|
-:材料費集計;
-if (直接材料?) then (yes)
-  :直接材料費として計上;
-  :製造指示に紐付け;
-else (no)
-  :間接材料費として計上;
-  :配賦基準で配分;
-endif
-stop
-@enduml
-```
-#### 材料消費データエンティティ
-<details>
-<summary>MaterialConsumption.java</summary>
-```java
-// src/main/java/com/example/pms/domain/model/cost/MaterialConsumption.java
-package com.example.pms.domain.model.cost;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-/**
- * 材料消費データエンティティ
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class MaterialConsumption {
-    private Integer id;
-    private String workOrderNumber;
-    private String materialCode;
-    private LocalDate consumptionDate;
-    private BigDecimal consumptionQuantity;
-    private BigDecimal unitPrice;
-    private BigDecimal consumptionAmount;
-    private Boolean isDirect;
-    private String remarks;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-#### MyBatis Mapper XML：材料消費
-<details>
-<summary>MaterialConsumptionMapper.xml</summary>
-```xml
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
-        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.MaterialConsumptionMapper">
-    <resultMap id="MaterialConsumptionResultMap"
-               type="com.example.pms.domain.model.cost.MaterialConsumption">
-        <id property="id" column="ID"/>
-        <result property="workOrderNumber" column="作業指示番号"/>
-        <result property="materialCode" column="材料コード"/>
-        <result property="consumptionDate" column="消費日"/>
-        <result property="consumptionQuantity" column="消費数量"/>
-        <result property="unitPrice" column="単価"/>
-        <result property="consumptionAmount" column="消費金額"/>
-        <result property="isDirect" column="直接材料フラグ"/>
-        <result property="remarks" column="備考"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <select id="findByWorkOrderNumber" resultMap="MaterialConsumptionResultMap">
-        SELECT * FROM "材料消費データ"
-        WHERE "作業指示番号" = #{workOrderNumber}
-        ORDER BY "消費日" ASC
-    </select>
-    <select id="sumDirectMaterialCostByWorkOrderNumber" resultType="java.math.BigDecimal">
-        SELECT COALESCE(SUM("消費金額"), 0)
-        FROM "材料消費データ"
-        WHERE "作業指示番号" = #{workOrderNumber}
-          AND "直接材料フラグ" = true
-    </select>
-    <select id="sumIndirectMaterialCostByPeriod" resultType="java.math.BigDecimal">
-        SELECT COALESCE(SUM("消費金額"), 0)
-        FROM "材料消費データ"
-        WHERE "消費日" BETWEEN #{startDate} AND #{endDate}
-          AND "直接材料フラグ" = false
-    </select>
-    <insert id="insert" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
-        INSERT INTO "材料消費データ" (
-            "作業指示番号", "材料コード", "消費日",
-            "消費数量", "単価", "消費金額", "直接材料フラグ", "備考"
-        ) VALUES (
-            #{workOrderNumber}, #{materialCode}, #{consumptionDate},
-            #{consumptionQuantity}, #{unitPrice}, #{consumptionAmount},
-            #{isDirect}, #{remarks}
-        )
-    </insert>
-</mapper>
-```
-</details>
-#### Flyway マイグレーション：材料消費
-<details>
-<summary>V013__cost_management_tables.sql（材料消費部分）</summary>
-```sql
--- V013__cost_management_tables.sql（材料消費部分）
--- 材料消費データ
-CREATE TABLE "材料消費データ" (
-    "ID" SERIAL PRIMARY KEY,
-    "作業指示番号" VARCHAR(20) NOT NULL,
-    "材料コード" VARCHAR(20) NOT NULL,
-    "消費日" DATE NOT NULL,
-    "消費数量" DECIMAL(15, 2) NOT NULL,
-    "単価" DECIMAL(15, 4) NOT NULL,
-    "消費金額" DECIMAL(15, 2) NOT NULL,
-    "直接材料フラグ" BOOLEAN NOT NULL DEFAULT true,
-    "備考" VARCHAR(500),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    CONSTRAINT "FK_材料消費_作業指示" FOREIGN KEY ("作業指示番号")
-        REFERENCES "作業指示データ"("作業指示番号"),
-    CONSTRAINT "FK_材料消費_品目" FOREIGN KEY ("材料コード")
-        REFERENCES "品目マスタ"("品目コード")
-);
-COMMENT ON TABLE "材料消費データ" IS '材料消費データ';
-COMMENT ON COLUMN "材料消費データ"."直接材料フラグ" IS '直接材料=true, 間接材料=false';
--- インデックス
-CREATE INDEX "IDX_材料消費_作業指示" ON "材料消費データ" ("作業指示番号");
-CREATE INDEX "IDX_材料消費_消費日" ON "材料消費データ" ("消費日");
-```
-</details>
-### 労務費の計算（直接労務費・間接労務費）
-労務費は、製造に関わる作業者の人件費です。工数実績と賃率に基づいて計算します。
-```plantuml
-@startuml
-title 労務費計算の流れ
-|工程管理|
-start
-:作業実施;
-:工数実績記録;
-|人事管理|
-:賃率マスタ参照;
-:作業者区分確認;
-|原価計算|
-:労務費計算;
-note right: 工数 × 賃率
-if (直接作業?) then (yes)
-  :直接労務費として計上;
-  :製造指示に紐付け;
-else (no)
-  :間接労務費として計上;
-  :配賦基準で配分;
-endif
-stop
-@enduml
-```
-#### 賃率マスタエンティティ
-<details>
-<summary>WageRate.java</summary>
-```java
-// src/main/java/com/example/pms/domain/model/cost/WageRate.java
-package com.example.pms.domain.model.cost;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-/**
- * 賃率マスタエンティティ
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class WageRate {
-    private Integer id;
-    private String workerCategoryCode;
-    private String workerCategoryName;
-    private LocalDate effectiveStartDate;
-    private LocalDate effectiveEndDate;
-    private BigDecimal hourlyRate;
-    private Boolean isDirect;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-#### 工数実績データエンティティ
-<details>
-<summary>LaborHours.java</summary>
-```java
-// src/main/java/com/example/pms/domain/model/process/LaborHours.java
-package com.example.pms.domain.model.process;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-/**
- * 工数実績データエンティティ
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class LaborHours {
-    private Integer id;
-    private String workOrderNumber;
-    private String processCode;
-    private String workerCode;
-    private String workerCategoryCode;
-    private LocalDate workDate;
-    private BigDecimal workHours;
-    private BigDecimal hourlyRate;
-    private BigDecimal laborCost;
-    private Boolean isDirect;
-    private String remarks;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-#### MyBatis Mapper XML：工数実績
-<details>
-<summary>LaborHoursMapper.xml</summary>
-```xml
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
-        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.LaborHoursMapper">
-    <resultMap id="WageRateResultMap"
-               type="com.example.pms.domain.model.cost.WageRate">
-        <id property="id" column="ID"/>
-        <result property="workerCategoryCode" column="作業者区分コード"/>
-        <result property="workerCategoryName" column="作業者区分名"/>
-        <result property="effectiveStartDate" column="適用開始日"/>
-        <result property="effectiveEndDate" column="適用終了日"/>
-        <result property="hourlyRate" column="時間単価"/>
-        <result property="isDirect" column="直接労務フラグ"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <resultMap id="LaborHoursResultMap"
-               type="com.example.pms.domain.model.process.LaborHours">
-        <id property="id" column="ID"/>
-        <result property="workOrderNumber" column="作業指示番号"/>
-        <result property="processCode" column="工程コード"/>
-        <result property="workerCode" column="作業者コード"/>
-        <result property="workerCategoryCode" column="作業者区分コード"/>
-        <result property="workDate" column="作業日"/>
-        <result property="workHours" column="作業時間"/>
-        <result property="hourlyRate" column="時間単価"/>
-        <result property="laborCost" column="労務費"/>
-        <result property="isDirect" column="直接労務フラグ"/>
-        <result property="remarks" column="備考"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <select id="findByWorkOrderNumber" resultMap="LaborHoursResultMap">
-        SELECT * FROM "工数実績データ"
-        WHERE "作業指示番号" = #{workOrderNumber}
-        ORDER BY "作業日" ASC
-    </select>
-    <select id="sumDirectLaborCostByWorkOrderNumber" resultType="java.math.BigDecimal">
-        SELECT COALESCE(SUM("労務費"), 0)
-        FROM "工数実績データ"
-        WHERE "作業指示番号" = #{workOrderNumber}
-          AND "直接労務フラグ" = true
-    </select>
-    <select id="sumIndirectLaborCostByPeriod" resultType="java.math.BigDecimal">
-        SELECT COALESCE(SUM("労務費"), 0)
-        FROM "工数実績データ"
-        WHERE "作業日" BETWEEN #{startDate} AND #{endDate}
-          AND "直接労務フラグ" = false
-    </select>
-    <select id="sumWorkHoursByWorkOrderNumber" resultType="java.math.BigDecimal">
-        SELECT COALESCE(SUM("作業時間"), 0)
-        FROM "工数実績データ"
-        WHERE "作業指示番号" = #{workOrderNumber}
-    </select>
-    <select id="findWageRateByCategory" resultMap="WageRateResultMap">
-        SELECT * FROM "賃率マスタ"
-        WHERE "作業者区分コード" = #{workerCategoryCode}
-          AND "適用開始日" &lt;= #{targetDate}
-          AND ("適用終了日" IS NULL OR "適用終了日" >= #{targetDate})
-        ORDER BY "適用開始日" DESC
-        LIMIT 1
-    </select>
-    <insert id="insert" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
-        INSERT INTO "工数実績データ" (
-            "作業指示番号", "工程コード", "作業者コード", "作業者区分コード",
-            "作業日", "作業時間", "時間単価", "労務費", "直接労務フラグ", "備考"
-        ) VALUES (
-            #{workOrderNumber}, #{processCode}, #{workerCode}, #{workerCategoryCode},
-            #{workDate}, #{workHours}, #{hourlyRate}, #{laborCost}, #{isDirect}, #{remarks}
-        )
-    </insert>
-</mapper>
-```
-</details>
-#### Flyway マイグレーション：労務費
-<details>
-<summary>V013__cost_management_tables.sql（労務費部分）</summary>
-```sql
--- V013__cost_management_tables.sql（労務費部分）
--- 賃率マスタ
-CREATE TABLE "賃率マスタ" (
-    "ID" SERIAL PRIMARY KEY,
-    "作業者区分コード" VARCHAR(20) NOT NULL,
-    "作業者区分名" VARCHAR(100) NOT NULL,
-    "適用開始日" DATE NOT NULL,
-    "適用終了日" DATE,
-    "時間単価" DECIMAL(15, 2) NOT NULL,
-    "直接労務フラグ" BOOLEAN NOT NULL DEFAULT true,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    CONSTRAINT "UK_賃率_区分_適用開始日" UNIQUE ("作業者区分コード", "適用開始日")
-);
-COMMENT ON TABLE "賃率マスタ" IS '賃率マスタ';
-COMMENT ON COLUMN "賃率マスタ"."時間単価" IS '1時間あたりの賃率';
-COMMENT ON COLUMN "賃率マスタ"."直接労務フラグ" IS '直接労務=true, 間接労務=false';
--- 工数実績データ
-CREATE TABLE "工数実績データ" (
-    "ID" SERIAL PRIMARY KEY,
-    "作業指示番号" VARCHAR(20) NOT NULL,
-    "工程コード" VARCHAR(20) NOT NULL,
-    "作業者コード" VARCHAR(20) NOT NULL,
-    "作業者区分コード" VARCHAR(20) NOT NULL,
-    "作業日" DATE NOT NULL,
-    "作業時間" DECIMAL(5, 2) NOT NULL,
-    "時間単価" DECIMAL(15, 2) NOT NULL,
-    "労務費" DECIMAL(15, 2) NOT NULL,
-    "直接労務フラグ" BOOLEAN NOT NULL DEFAULT true,
-    "備考" VARCHAR(500),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    CONSTRAINT "FK_工数実績_作業指示" FOREIGN KEY ("作業指示番号")
-        REFERENCES "作業指示データ"("作業指示番号"),
-    CONSTRAINT "FK_工数実績_工程" FOREIGN KEY ("工程コード")
-        REFERENCES "工程マスタ"("工程コード")
-);
-COMMENT ON TABLE "工数実績データ" IS '工数実績データ';
-COMMENT ON COLUMN "工数実績データ"."作業時間" IS '作業時間（時間単位）';
-COMMENT ON COLUMN "工数実績データ"."労務費" IS '作業時間 × 時間単価';
--- インデックス
-CREATE INDEX "IDX_工数実績_作業指示" ON "工数実績データ" ("作業指示番号");
-CREATE INDEX "IDX_工数実績_作業日" ON "工数実績データ" ("作業日");
-CREATE INDEX "IDX_工数実績_作業者" ON "工数実績データ" ("作業者コード");
-```
-</details>
-### 製造間接費の配賦
-製造間接費は、特定の製品に直接紐付けられない費用であり、一定の配賦基準に基づいて各製品に配分します。
-```plantuml
-@startuml
-title 製造間接費配賦の流れ
-|経理部門|
-start
-:製造間接費の集計;
-note right
-  間接材料費
-  間接労務費
-  減価償却費
-  水道光熱費
-  その他
-end note
-|原価計算|
-:配賦基準の決定;
-note right
-  直接作業時間
-  機械稼働時間
-  直接材料費
-  直接労務費
-end note
-:配賦率の計算;
-note right: 製造間接費 ÷ 配賦基準総額
-:各製品への配賦;
-note right: 配賦率 × 各製品の配賦基準
-:製造原価への加算;
-stop
-@enduml
-```
-#### 製造間接費配賦データエンティティ
-<details>
-<summary>OverheadAllocation.java</summary>
-```java
-// src/main/java/com/example/pms/domain/model/cost/OverheadAllocation.java
-package com.example.pms.domain.model.cost;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-/**
- * 製造間接費配賦データエンティティ
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class OverheadAllocation {
-    private Integer id;
-    private String workOrderNumber;
-    private String accountingPeriod;
-    private String allocationBasis;
-    private BigDecimal basisAmount;
-    private BigDecimal allocationRate;
-    private BigDecimal allocatedAmount;
-    private LocalDateTime createdAt;
-}
-```
-</details>
-#### 製造間接費マスタエンティティ
-<details>
-<summary>ManufacturingOverhead.java</summary>
-```java
-// src/main/java/com/example/pms/domain/model/cost/ManufacturingOverhead.java
-package com.example.pms.domain.model.cost;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-/**
- * 製造間接費マスタエンティティ
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ManufacturingOverhead {
-    private Integer id;
-    private String accountingPeriod;
-    private String costCategory;
-    private String costCategoryName;
-    private BigDecimal amount;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-#### MyBatis Mapper XML：製造間接費
-<details>
-<summary>OverheadMapper.xml</summary>
-```xml
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
-        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.OverheadMapper">
-    <resultMap id="ManufacturingOverheadResultMap"
-               type="com.example.pms.domain.model.cost.ManufacturingOverhead">
-        <id property="id" column="ID"/>
-        <result property="accountingPeriod" column="会計期間"/>
-        <result property="costCategory" column="費用区分"/>
-        <result property="costCategoryName" column="費用区分名"/>
-        <result property="amount" column="金額"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <resultMap id="OverheadAllocationResultMap"
-               type="com.example.pms.domain.model.cost.OverheadAllocation">
-        <id property="id" column="ID"/>
-        <result property="workOrderNumber" column="作業指示番号"/>
-        <result property="accountingPeriod" column="会計期間"/>
-        <result property="allocationBasis" column="配賦基準"/>
-        <result property="basisAmount" column="基準金額"/>
-        <result property="allocationRate" column="配賦率"/>
-        <result property="allocatedAmount" column="配賦金額"/>
-        <result property="createdAt" column="作成日時"/>
-    </resultMap>
-    <select id="sumOverheadByPeriod" resultType="java.math.BigDecimal">
-        SELECT COALESCE(SUM("金額"), 0)
-        FROM "製造間接費マスタ"
-        WHERE "会計期間" = #{accountingPeriod}
-    </select>
-    <select id="findAllocationByWorkOrderNumber" resultMap="OverheadAllocationResultMap">
-        SELECT * FROM "製造間接費配賦データ"
-        WHERE "作業指示番号" = #{workOrderNumber}
-        ORDER BY "会計期間" ASC
-    </select>
-    <insert id="insertOverhead" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
-        INSERT INTO "製造間接費マスタ" (
-            "会計期間", "費用区分", "費用区分名", "金額"
-        ) VALUES (
-            #{accountingPeriod}, #{costCategory}, #{costCategoryName}, #{amount}
-        )
-    </insert>
-    <insert id="insertAllocation" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
-        INSERT INTO "製造間接費配賦データ" (
-            "作業指示番号", "会計期間", "配賦基準",
-            "基準金額", "配賦率", "配賦金額"
-        ) VALUES (
-            #{workOrderNumber}, #{accountingPeriod}, #{allocationBasis},
-            #{basisAmount}, #{allocationRate}, #{allocatedAmount}
-        )
-    </insert>
-</mapper>
-```
-</details>
-#### Flyway マイグレーション：製造間接費
-<details>
-<summary>V013__cost_management_tables.sql（製造間接費部分）</summary>
-```sql
--- V013__cost_management_tables.sql（製造間接費部分）
--- 製造間接費マスタ
-CREATE TABLE "製造間接費マスタ" (
-    "ID" SERIAL PRIMARY KEY,
-    "会計期間" VARCHAR(7) NOT NULL,
-    "費用区分" VARCHAR(20) NOT NULL,
-    "費用区分名" VARCHAR(100) NOT NULL,
-    "金額" DECIMAL(15, 2) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    CONSTRAINT "UK_製造間接費_期間_区分" UNIQUE ("会計期間", "費用区分")
-);
-COMMENT ON TABLE "製造間接費マスタ" IS '製造間接費マスタ';
-COMMENT ON COLUMN "製造間接費マスタ"."会計期間" IS '会計期間（YYYY-MM形式）';
-COMMENT ON COLUMN "製造間接費マスタ"."費用区分" IS '費用区分（間接材料/間接労務/減価償却/水道光熱など）';
--- 製造間接費配賦データ
-CREATE TABLE "製造間接費配賦データ" (
-    "ID" SERIAL PRIMARY KEY,
-    "作業指示番号" VARCHAR(20) NOT NULL,
-    "会計期間" VARCHAR(7) NOT NULL,
-    "配賦基準" VARCHAR(50) NOT NULL,
-    "基準金額" DECIMAL(15, 2) NOT NULL,
-    "配賦率" DECIMAL(10, 6) NOT NULL,
-    "配賦金額" DECIMAL(15, 2) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    CONSTRAINT "UK_間接費配賦_作業指示_期間" UNIQUE ("作業指示番号", "会計期間"),
-    CONSTRAINT "FK_間接費配賦_作業指示" FOREIGN KEY ("作業指示番号")
-        REFERENCES "作業指示データ"("作業指示番号")
-);
-COMMENT ON TABLE "製造間接費配賦データ" IS '製造間接費配賦データ';
-COMMENT ON COLUMN "製造間接費配賦データ"."配賦基準" IS '配賦基準（直接作業時間/機械稼働時間/直接材料費/直接労務費）';
-COMMENT ON COLUMN "製造間接費配賦データ"."配賦率" IS '製造間接費 ÷ 配賦基準総額';
--- インデックス
-CREATE INDEX "IDX_製造間接費_期間" ON "製造間接費マスタ" ("会計期間");
-CREATE INDEX "IDX_間接費配賦_作業指示" ON "製造間接費配賦データ" ("作業指示番号");
-```
-</details>
-### 製品原価の集計
-製品原価は、直接費と間接費を集計して計算します。
-```plantuml
-@startuml
-title 製品原価集計の流れ
-|原価計算|
-start
-fork
-  :直接材料費集計;
-fork again
-  :直接労務費集計;
-fork again
-  :直接経費集計;
-end fork
-:直接費合計;
-fork
-  :間接材料費配賦;
-fork again
-  :間接労務費配賦;
-fork again
-  :その他間接費配賦;
-end fork
-:製造間接費合計;
-:製造原価 = 直接費 + 製造間接費;
-:単位原価 = 製造原価 ÷ 完成数量;
-:実際原価データ登録;
-stop
-@enduml
-```
-#### 標準原価マスタエンティティ
-<details>
-<summary>StandardCost.java</summary>
-```java
-// src/main/java/com/example/pms/domain/model/cost/StandardCost.java
-package com.example.pms.domain.model.cost;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-/**
- * 標準原価マスタエンティティ
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class StandardCost {
-    private Integer id;
-    private String itemCode;
-    private LocalDate effectiveStartDate;
-    private LocalDate effectiveEndDate;
-    private BigDecimal standardMaterialCost;
-    private BigDecimal standardLaborCost;
-    private BigDecimal standardExpense;
-    private BigDecimal standardManufacturingCost;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-#### 実際原価データエンティティ
-<details>
-<summary>ActualCost.java</summary>
-```java
-// src/main/java/com/example/pms/domain/model/cost/ActualCost.java
-package com.example.pms.domain.model.cost;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-/**
- * 実際原価データエンティティ
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ActualCost {
-    private Integer id;
-    private String workOrderNumber;
-    private String itemCode;
-    private BigDecimal completedQuantity;
-    private BigDecimal actualMaterialCost;
-    private BigDecimal actualLaborCost;
-    private BigDecimal actualExpense;
-    private BigDecimal actualManufacturingCost;
-    private BigDecimal unitCost;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-    // 楽観ロック用バージョン
-    @Builder.Default
-    private Integer version = 1;
-    // リレーション
-    @Builder.Default
-    private List<MaterialConsumption> materialConsumptions = new ArrayList<>();
-    @Builder.Default
-    private List<LaborHours> laborHours = new ArrayList<>();
-    @Builder.Default
-    private List<OverheadAllocation> overheadAllocations = new ArrayList<>();
-}
-```
-</details>
-#### 原価差異データエンティティ
-<details>
-<summary>CostVariance.java</summary>
-```java
-// src/main/java/com/example/pms/domain/model/cost/CostVariance.java
-package com.example.pms.domain.model.cost;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-/**
- * 原価差異データエンティティ
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class CostVariance {
-    private Integer id;
-    private String workOrderNumber;
-    private String itemCode;
-    private BigDecimal materialCostVariance;
-    private BigDecimal laborCostVariance;
-    private BigDecimal expenseVariance;
-    private BigDecimal totalVariance;
-    private LocalDateTime createdAt;
-}
-```
-</details>
-#### MyBatis Mapper XML：原価管理
-<details>
-<summary>CostMapper.xml</summary>
-```xml
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
-        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.CostMapper">
-    <resultMap id="StandardCostResultMap"
-               type="com.example.pms.domain.model.cost.StandardCost">
-        <id property="id" column="ID"/>
-        <result property="itemCode" column="品目コード"/>
-        <result property="effectiveStartDate" column="適用開始日"/>
-        <result property="effectiveEndDate" column="適用終了日"/>
-        <result property="standardMaterialCost" column="標準材料費"/>
-        <result property="standardLaborCost" column="標準労務費"/>
-        <result property="standardExpense" column="標準経費"/>
-        <result property="standardManufacturingCost" column="標準製造原価"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <resultMap id="ActualCostResultMap"
-               type="com.example.pms.domain.model.cost.ActualCost">
-        <id property="id" column="ID"/>
-        <result property="workOrderNumber" column="作業指示番号"/>
-        <result property="itemCode" column="品目コード"/>
-        <result property="completedQuantity" column="完成数量"/>
-        <result property="actualMaterialCost" column="実際材料費"/>
-        <result property="actualLaborCost" column="実際労務費"/>
-        <result property="actualExpense" column="実際経費"/>
-        <result property="actualManufacturingCost" column="実際製造原価"/>
-        <result property="unitCost" column="単位原価"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <resultMap id="CostVarianceResultMap"
-               type="com.example.pms.domain.model.cost.CostVariance">
-        <id property="id" column="ID"/>
-        <result property="workOrderNumber" column="作業指示番号"/>
-        <result property="itemCode" column="品目コード"/>
-        <result property="materialCostVariance" column="材料費差異"/>
-        <result property="laborCostVariance" column="労務費差異"/>
-        <result property="expenseVariance" column="経費差異"/>
-        <result property="totalVariance" column="総差異"/>
-        <result property="createdAt" column="作成日時"/>
-    </resultMap>
-    <select id="findStandardCostByItemCode" resultMap="StandardCostResultMap">
-        SELECT * FROM "標準原価マスタ"
-        WHERE "品目コード" = #{itemCode}
-          AND "適用開始日" &lt;= #{targetDate}
-          AND ("適用終了日" IS NULL OR "適用終了日" >= #{targetDate})
-        ORDER BY "適用開始日" DESC
-        LIMIT 1
-    </select>
-    <select id="findActualCostByWorkOrderNumber" resultMap="ActualCostResultMap">
-        SELECT * FROM "実際原価データ"
-        WHERE "作業指示番号" = #{workOrderNumber}
-    </select>
-    <select id="findCostVarianceByWorkOrderNumber" resultMap="CostVarianceResultMap">
-        SELECT * FROM "原価差異データ"
-        WHERE "作業指示番号" = #{workOrderNumber}
-    </select>
-    <insert id="insertStandardCost" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
-        INSERT INTO "標準原価マスタ" (
-            "品目コード", "適用開始日", "適用終了日",
-            "標準材料費", "標準労務費", "標準経費", "標準製造原価"
-        ) VALUES (
-            #{itemCode}, #{effectiveStartDate}, #{effectiveEndDate},
-            #{standardMaterialCost}, #{standardLaborCost},
-            #{standardExpense}, #{standardManufacturingCost}
-        )
-    </insert>
-    <insert id="insertActualCost" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
-        INSERT INTO "実際原価データ" (
-            "作業指示番号", "品目コード", "完成数量",
-            "実際材料費", "実際労務費", "実際経費",
-            "実際製造原価", "単位原価"
-        ) VALUES (
-            #{workOrderNumber}, #{itemCode}, #{completedQuantity},
-            #{actualMaterialCost}, #{actualLaborCost}, #{actualExpense},
-            #{actualManufacturingCost}, #{unitCost}
-        )
-    </insert>
-    <insert id="insertCostVariance" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
-        INSERT INTO "原価差異データ" (
-            "作業指示番号", "品目コード",
-            "材料費差異", "労務費差異", "経費差異", "総差異"
-        ) VALUES (
-            #{workOrderNumber}, #{itemCode},
-            #{materialCostVariance}, #{laborCostVariance},
-            #{expenseVariance}, #{totalVariance}
-        )
-    </insert>
-    <update id="updateActualCost">
-        UPDATE "実際原価データ" SET
-            "完成数量" = #{completedQuantity},
-            "実際材料費" = #{actualMaterialCost},
-            "実際労務費" = #{actualLaborCost},
-            "実際経費" = #{actualExpense},
-            "実際製造原価" = #{actualManufacturingCost},
-            "単位原価" = #{unitCost},
-            "更新日時" = CURRENT_TIMESTAMP
-        WHERE "作業指示番号" = #{workOrderNumber}
-    </update>
-</mapper>
-```
-</details>
-#### Flyway マイグレーション：原価管理
-<details>
-<summary>V013__cost_management_tables.sql（原価管理部分）</summary>
-```sql
--- V013__cost_management_tables.sql（原価管理部分）
--- 標準原価マスタ
-CREATE TABLE "標準原価マスタ" (
-    "ID" SERIAL PRIMARY KEY,
-    "品目コード" VARCHAR(20) NOT NULL,
-    "適用開始日" DATE NOT NULL,
-    "適用終了日" DATE,
-    "標準材料費" DECIMAL(15, 2) NOT NULL,
-    "標準労務費" DECIMAL(15, 2) NOT NULL,
-    "標準経費" DECIMAL(15, 2) NOT NULL,
-    "標準製造原価" DECIMAL(15, 2) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    CONSTRAINT "UK_標準原価_品目_適用開始日" UNIQUE ("品目コード", "適用開始日"),
-    CONSTRAINT "FK_標準原価_品目" FOREIGN KEY ("品目コード")
-        REFERENCES "品目マスタ"("品目コード")
-);
-COMMENT ON TABLE "標準原価マスタ" IS '標準原価マスタ';
-COMMENT ON COLUMN "標準原価マスタ"."標準材料費" IS '標準材料費（単位あたり）';
-COMMENT ON COLUMN "標準原価マスタ"."標準労務費" IS '標準労務費（単位あたり）';
-COMMENT ON COLUMN "標準原価マスタ"."標準経費" IS '標準経費（単位あたり）';
-COMMENT ON COLUMN "標準原価マスタ"."標準製造原価" IS '標準製造原価（単位あたり）= 材料費 + 労務費 + 経費';
--- 実際原価データ
-CREATE TABLE "実際原価データ" (
-    "ID" SERIAL PRIMARY KEY,
-    "作業指示番号" VARCHAR(20) NOT NULL,
-    "品目コード" VARCHAR(20) NOT NULL,
-    "完成数量" DECIMAL(15, 2) NOT NULL,
-    "実際材料費" DECIMAL(15, 2) NOT NULL,
-    "実際労務費" DECIMAL(15, 2) NOT NULL,
-    "実際経費" DECIMAL(15, 2) NOT NULL,
-    "実際製造原価" DECIMAL(15, 2) NOT NULL,
-    "単位原価" DECIMAL(15, 4) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    CONSTRAINT "UK_実際原価_作業指示" UNIQUE ("作業指示番号"),
-    CONSTRAINT "FK_実際原価_作業指示" FOREIGN KEY ("作業指示番号")
-        REFERENCES "作業指示データ"("作業指示番号"),
-    CONSTRAINT "FK_実際原価_品目" FOREIGN KEY ("品目コード")
-        REFERENCES "品目マスタ"("品目コード")
-);
-COMMENT ON TABLE "実際原価データ" IS '実際原価データ';
-COMMENT ON COLUMN "実際原価データ"."単位原価" IS '実際製造原価 ÷ 完成数量';
--- 原価差異データ
-CREATE TABLE "原価差異データ" (
-    "ID" SERIAL PRIMARY KEY,
-    "作業指示番号" VARCHAR(20) NOT NULL,
-    "品目コード" VARCHAR(20) NOT NULL,
-    "材料費差異" DECIMAL(15, 2) NOT NULL,
-    "労務費差異" DECIMAL(15, 2) NOT NULL,
-    "経費差異" DECIMAL(15, 2) NOT NULL,
-    "総差異" DECIMAL(15, 2) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    CONSTRAINT "UK_原価差異_作業指示" UNIQUE ("作業指示番号"),
-    CONSTRAINT "FK_原価差異_作業指示" FOREIGN KEY ("作業指示番号")
-        REFERENCES "作業指示データ"("作業指示番号"),
-    CONSTRAINT "FK_原価差異_品目" FOREIGN KEY ("品目コード")
-        REFERENCES "品目マスタ"("品目コード")
-);
-COMMENT ON TABLE "原価差異データ" IS '原価差異データ';
-COMMENT ON COLUMN "原価差異データ"."材料費差異" IS '実際材料費 - 標準材料費 × 完成数量';
-COMMENT ON COLUMN "原価差異データ"."労務費差異" IS '実際労務費 - 標準労務費 × 完成数量';
-COMMENT ON COLUMN "原価差異データ"."経費差異" IS '実際経費 - 標準経費 × 完成数量';
-COMMENT ON COLUMN "原価差異データ"."総差異" IS '材料費差異 + 労務費差異 + 経費差異';
--- インデックス
-CREATE INDEX "IDX_標準原価_品目" ON "標準原価マスタ" ("品目コード");
-CREATE INDEX "IDX_実際原価_作業指示" ON "実際原価データ" ("作業指示番号");
-CREATE INDEX "IDX_原価差異_作業指示" ON "原価差異データ" ("作業指示番号");
-```
-</details>
-#### 原価計算サービス
-<details>
-<summary>CostCalculationService.java</summary>
-```java
-// src/main/java/com/example/sms/application/service/cost/CostCalculationService.java
-package com.example.pms.application.service.cost;
-import com.example.pms.domain.model.cost.*;
-import com.example.pms.infrastructure.out.persistence.mapper.*;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-import java.math.BigDecimal;
-import java.math.RoundingMode;
-import java.time.LocalDate;
-/**
- * 原価計算サービス
- */
-@Service
-@RequiredArgsConstructor
-public class CostCalculationService {
-    private final CostMapper costMapper;
-    private final MaterialConsumptionMapper materialConsumptionMapper;
-    private final LaborHoursMapper laborHoursMapper;
-    private final OverheadMapper overheadMapper;
-    private final WorkOrderMapper workOrderMapper;
-    /**
-     * 実際原価を計算する
-     *
-     * @param workOrderNumber 作業指示番号
-     * @return 実際原価データ
-     */
-    @Transactional
-    public ActualCost calculateActualCost(String workOrderNumber) {
-        // 1. 材料費の計算: 直接材料費を集計
-        BigDecimal materialCost = calculateMaterialCost(workOrderNumber);
-        // 2. 労務費の計算: 直接労務費を集計
-        BigDecimal laborCost = calculateLaborCost(workOrderNumber);
-        // 3. 経費の計算: 製造間接費配賦額を集計
-        BigDecimal expense = calculateExpense(workOrderNumber);
-        // 4. 完成数量の取得
-        BigDecimal completedQuantity = getCompletedQuantity(workOrderNumber);
-        // 5. 製造原価・単位原価の計算
-        BigDecimal totalCost = materialCost.add(laborCost).add(expense);
-        BigDecimal unitCost = completedQuantity.compareTo(BigDecimal.ZERO) > 0
-                ? totalCost.divide(completedQuantity, 4, RoundingMode.HALF_UP)
-                : BigDecimal.ZERO;
-        // 6. 実際原価データを保存
-        ActualCost actualCost = ActualCost.builder()
-                .workOrderNumber(workOrderNumber)
-                .itemCode(getItemCode(workOrderNumber))
-                .completedQuantity(completedQuantity)
-                .actualMaterialCost(materialCost)
-                .actualLaborCost(laborCost)
-                .actualExpense(expense)
-                .actualManufacturingCost(totalCost)
-                .unitCost(unitCost)
-                .build();
-        costMapper.insertActualCost(actualCost);
-        return actualCost;
-    }
-    /**
-     * 原価差異を分析する
-     *
-     * @param workOrderNumber 作業指示番号
-     * @return 原価差異データ
-     */
-    @Transactional
-    public CostVariance analyzeCostVariance(String workOrderNumber) {
-        ActualCost actualCost = costMapper.findActualCostByWorkOrderNumber(workOrderNumber);
-        StandardCost standardCost = costMapper.findStandardCostByItemCode(
-                actualCost.getItemCode(), LocalDate.now());
-        // 標準原価総額（単位原価 × 完成数量）
-        BigDecimal standardTotal = standardCost.getStandardManufacturingCost()
-                .multiply(actualCost.getCompletedQuantity());
-        // 材料費差異
-        BigDecimal materialVariance = actualCost.getActualMaterialCost()
-                .subtract(standardCost.getStandardMaterialCost()
-                        .multiply(actualCost.getCompletedQuantity()));
-        // 労務費差異
-        BigDecimal laborVariance = actualCost.getActualLaborCost()
-                .subtract(standardCost.getStandardLaborCost()
-                        .multiply(actualCost.getCompletedQuantity()));
-        // 経費差異
-        BigDecimal expenseVariance = actualCost.getActualExpense()
-                .subtract(standardCost.getStandardExpense()
-                        .multiply(actualCost.getCompletedQuantity()));
-        // 総差異
-        BigDecimal totalVariance = actualCost.getActualManufacturingCost()
-                .subtract(standardTotal);
-        CostVariance variance = CostVariance.builder()
-                .workOrderNumber(workOrderNumber)
-                .itemCode(actualCost.getItemCode())
-                .materialCostVariance(materialVariance)
-                .laborCostVariance(laborVariance)
-                .expenseVariance(expenseVariance)
-                .totalVariance(totalVariance)
-                .build();
-        costMapper.insertCostVariance(variance);
-        return variance;
-    }
-    /**
-     * 製造間接費を配賦する
-     *
-     * @param accountingPeriod 会計期間
-     * @param allocationBasis 配賦基準
-     */
-    @Transactional
-    public void allocateOverhead(String accountingPeriod, String allocationBasis) {
-        // 製造間接費総額を取得
-        BigDecimal totalOverhead = overheadMapper.sumOverheadByPeriod(accountingPeriod);
-        // 配賦基準総額を取得（例: 直接作業時間の場合）
-        BigDecimal totalBasis = getTotalAllocationBasis(accountingPeriod, allocationBasis);
-        if (totalBasis.compareTo(BigDecimal.ZERO) == 0) {
-            return;
-        }
-        // 配賦率を計算
-        BigDecimal allocationRate = totalOverhead.divide(totalBasis, 6, RoundingMode.HALF_UP);
-        // 各作業指示に配賦
-        // 実装省略: 各作業指示の配賦基準額を取得し、配賦額を計算して登録
-    }
-    private BigDecimal calculateMaterialCost(String workOrderNumber) {
-        return materialConsumptionMapper.sumDirectMaterialCostByWorkOrderNumber(workOrderNumber);
-    }
-    private BigDecimal calculateLaborCost(String workOrderNumber) {
-        return laborHoursMapper.sumDirectLaborCostByWorkOrderNumber(workOrderNumber);
-    }
-    private BigDecimal calculateExpense(String workOrderNumber) {
-        // 製造間接費配賦額を取得
-        var allocations = overheadMapper.findAllocationByWorkOrderNumber(workOrderNumber);
-        return allocations.stream()
-                .map(OverheadAllocation::getAllocatedAmount)
-                .reduce(BigDecimal.ZERO, BigDecimal::add);
-    }
-    private BigDecimal getCompletedQuantity(String workOrderNumber) {
-        // 作業指示から完成数量を取得
-        return workOrderMapper.getCompletedQuantity(workOrderNumber);
-    }
-    private String getItemCode(String workOrderNumber) {
-        return workOrderMapper.getItemCode(workOrderNumber);
-    }
-    private BigDecimal getTotalAllocationBasis(String accountingPeriod, String allocationBasis) {
-        // 配賦基準に応じて総額を計算
-        // 実装省略
-        return BigDecimal.ZERO;
-    }
-}
-```
-</details>
-### 原価管理の ER 図
-```plantuml
-@startuml
-title 製造原価管理の ER 図
-entity "品目マスタ" as item_master {
-  * 品目コード [PK]
-  --
-  ...
-}
-entity "作業指示データ" as work_order {
-  * 作業指示番号 [PK]
-  --
-  * 品目コード [FK]
-  ...
-}
-entity "材料消費データ" as material_consumption {
-  * ID [PK]
-  --
-  * 作業指示番号 [FK]
-  * 材料コード [FK]
-  * 消費日
-  * 消費数量
-  * 単価
-  * 消費金額
-  * 直接材料フラグ
-}
-entity "賃率マスタ" as wage_rate {
-  * ID [PK]
-  --
-  * 作業者区分コード
-  * 適用開始日
-  * 時間単価
-  * 直接労務フラグ
-}
-entity "工数実績データ" as labor_hours {
-  * ID [PK]
-  --
-  * 作業指示番号 [FK]
-  * 工程コード [FK]
-  * 作業者コード
-  * 作業日
-  * 作業時間
-  * 労務費
-  * 直接労務フラグ
-}
-entity "製造間接費マスタ" as overhead {
-  * ID [PK]
-  --
-  * 会計期間
-  * 費用区分
-  * 金額
-}
-entity "製造間接費配賦データ" as overhead_allocation {
-  * ID [PK]
-  --
-  * 作業指示番号 [FK]
-  * 会計期間
-  * 配賦基準
-  * 配賦率
-  * 配賦金額
-}
-entity "標準原価マスタ" as standard_cost {
-  * ID [PK]
-  --
-  * 品目コード [FK]
-  * 適用開始日
-  * 標準材料費
-  * 標準労務費
-  * 標準経費
-  * 標準製造原価
-}
-entity "実際原価データ" as actual_cost {
-  * ID [PK]
-  --
-  * 作業指示番号 [FK]
-  * 品目コード [FK]
-  * 完成数量
-  * 実際材料費
-  * 実際労務費
-  * 実際経費
-  * 実際製造原価
-  * 単位原価
-}
-entity "原価差異データ" as cost_variance {
-  * ID [PK]
-  --
-  * 作業指示番号 [FK]
-  * 品目コード [FK]
-  * 材料費差異
-  * 労務費差異
-  * 経費差異
-  * 総差異
-}
-item_master ||--o{ standard_cost
-item_master ||--o{ work_order
-work_order ||--o{ material_consumption
-work_order ||--o{ labor_hours
-work_order ||--o{ overhead_allocation
-work_order ||--|| actual_cost
-work_order ||--|| cost_variance
-actual_cost -- standard_cost : 比較
-actual_cost -- cost_variance : 差異分析
-@enduml
-```
----
-## 30.3 リレーションと楽観ロックの設計
-### MyBatis ネストした ResultMap によるリレーション設定
-製造原価管理では、実際原価データ→材料消費→品目、実際原価データ→工数実績→工程といった関連があります。MyBatis でこれらの関係を効率的に取得するためのリレーション設定を実装します。
-#### 実際原価データのネスト ResultMap（材料消費・工数実績・配賦を含む）
-実装では、nested select 方式を採用しています。これにより、N+1 問題のリスクはありますが、シンプルで保守しやすい構成となっています。
-<details>
-<summary>ActualCostMapper.xml（リレーション設定）</summary>
-```xml
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
-        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<!-- src/main/resources/mapper/ActualCostMapper.xml -->
-<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.ActualCostMapper">
-    <!-- 基本 ResultMap -->
-    <resultMap id="actualCostResultMap" type="com.example.pms.domain.model.cost.ActualCost">
-        <id property="id" column="ID"/>
-        <result property="workOrderNumber" column="作業指示番号"/>
-        <result property="itemCode" column="品目コード"/>
-        <result property="completedQuantity" column="完成数量"/>
-        <result property="actualMaterialCost" column="実際材料費"/>
-        <result property="actualLaborCost" column="実際労務費"/>
-        <result property="actualExpense" column="実際経費"/>
-        <result property="actualManufacturingCost" column="実際製造原価"/>
-        <result property="unitCost" column="単位原価"/>
-        <result property="version" column="バージョン"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <!-- リレーション付き ResultMap（nested select 方式） -->
-    <resultMap id="actualCostWithRelationsResultMap" type="com.example.pms.domain.model.cost.ActualCost">
-        <id property="id" column="ID"/>
-        <result property="workOrderNumber" column="作業指示番号"/>
-        <result property="itemCode" column="品目コード"/>
-        <result property="completedQuantity" column="完成数量"/>
-        <result property="actualMaterialCost" column="実際材料費"/>
-        <result property="actualLaborCost" column="実際労務費"/>
-        <result property="actualExpense" column="実際経費"/>
-        <result property="actualManufacturingCost" column="実際製造原価"/>
-        <result property="unitCost" column="単位原価"/>
-        <result property="version" column="バージョン"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-        <!-- 材料消費との 1:N 関連（nested select） -->
-        <collection property="materialConsumptions"
-                    column="作業指示番号"
-                    select="com.example.pms.infrastructure.out.persistence.mapper.MaterialConsumptionMapper.findByWorkOrderNumber"/>
-        <!-- 工数実績との 1:N 関連（nested select） -->
-        <collection property="laborHours"
-                    column="作業指示番号"
-                    select="com.example.pms.infrastructure.out.persistence.mapper.LaborHoursMapper.findByWorkOrderNumber"/>
-        <!-- 製造間接費配賦との 1:N 関連（nested select） -->
-        <collection property="overheadAllocations"
-                    column="作業指示番号"
-                    select="com.example.pms.infrastructure.out.persistence.mapper.OverheadAllocationMapper.findByWorkOrderNumber"/>
-    </resultMap>
-    <!-- 基本検索 -->
-    <select id="findById" resultMap="actualCostResultMap">
-        SELECT * FROM "実際原価データ" WHERE "ID" = #{id}
-    </select>
-    <select id="findByWorkOrderNumber" resultMap="actualCostResultMap">
-        SELECT * FROM "実際原価データ" WHERE "作業指示番号" = #{workOrderNumber}
-    </select>
-    <!-- リレーション付き検索 -->
-    <select id="findByWorkOrderNumberWithRelations" resultMap="actualCostWithRelationsResultMap">
-        SELECT * FROM "実際原価データ" WHERE "作業指示番号" = #{workOrderNumber}
-    </select>
-    <select id="findAll" resultMap="actualCostResultMap">
-        SELECT * FROM "実際原価データ" ORDER BY "作業指示番号"
-    </select>
-    <!-- INSERT/UPDATE/DELETE は省略（楽観ロック対応セクション参照） -->
-</mapper>
-```
-</details>
-#### 標準原価と実際原価の比較ビュー ResultMap
-<details>
-<summary>CostComparisonMapper.xml（原価比較用）</summary>
-```xml
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
-        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<!-- src/main/resources/mapper/CostComparisonMapper.xml -->
-<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.CostComparisonMapper">
-    <!-- 原価比較 ResultMap（標準原価・実際原価・差異を含む） -->
-    <resultMap id="costComparisonResultMap" type="com.example.pms.domain.model.cost.CostComparison">
-        <id property="workOrderNumber" column="作業指示番号"/>
-        <result property="itemCode" column="品目コード"/>
-        <result property="itemName" column="品目名"/>
-        <result property="completedQuantity" column="完成数量"/>
-        <!-- 標準原価 -->
-        <result property="standardMaterialCost" column="標準材料費"/>
-        <result property="standardLaborCost" column="標準労務費"/>
-        <result property="standardExpense" column="標準経費"/>
-        <result property="standardTotalCost" column="標準製造原価"/>
-        <!-- 実際原価 -->
-        <result property="actualMaterialCost" column="実際材料費"/>
-        <result property="actualLaborCost" column="実際労務費"/>
-        <result property="actualExpense" column="実際経費"/>
-        <result property="actualTotalCost" column="実際製造原価"/>
-        <!-- 差異 -->
-        <result property="materialVariance" column="材料費差異"/>
-        <result property="laborVariance" column="労務費差異"/>
-        <result property="expenseVariance" column="経費差異"/>
-        <result property="totalVariance" column="総差異"/>
-    </resultMap>
-    <!-- 原価比較クエリ -->
-    <select id="findCostComparisonByWorkOrderNumber" resultMap="costComparisonResultMap">
-        SELECT
-            ac."作業指示番号",
-            ac."品目コード",
-            i."品目名",
-            ac."完成数量",
-            sc."標準材料費" * ac."完成数量" AS 標準材料費,
-            sc."標準労務費" * ac."完成数量" AS 標準労務費,
-            sc."標準経費" * ac."完成数量" AS 標準経費,
-            sc."標準製造原価" * ac."完成数量" AS 標準製造原価,
-            ac."実際材料費",
-            ac."実際労務費",
-            ac."実際経費",
-            ac."実際製造原価",
-            cv."材料費差異",
-            cv."労務費差異",
-            cv."経費差異",
-            cv."総差異"
-        FROM "実際原価データ" ac
-        LEFT JOIN "品目マスタ" i ON ac."品目コード" = i."品目コード"
-        LEFT JOIN "標準原価マスタ" sc ON ac."品目コード" = sc."品目コード"
-            AND sc."適用開始日" &lt;= CURRENT_DATE
-            AND (sc."適用終了日" IS NULL OR sc."適用終了日" >= CURRENT_DATE)
-        LEFT JOIN "原価差異データ" cv ON ac."作業指示番号" = cv."作業指示番号"
-        WHERE ac."作業指示番号" = #{workOrderNumber}
-    </select>
-</mapper>
-```
-</details>
-#### リレーション設定のポイント
-| 設定項目 | 説明 |
-|---------|------|
-| `<collection>` + `select` | 1:N 関連の nested select 方式（実際原価→材料消費、実際原価→工数実績、実際原価→配賦） |
-| `column` 属性 | nested select に渡すパラメータ（作業指示番号を子クエリに渡す） |
-| 原価明細の集約 | 材料消費・工数実績・配賦を実際原価に紐付けて取得 |
-| シンプルな構成 | JOIN を使用しないため、クエリが単純で保守しやすい |
-### 楽観ロックの実装
-製造原価管理では、原価計算の再実行や標準原価の改定時に、データの整合性を保つために楽観ロックを実装します。
-#### Flyway マイグレーション: バージョンカラム追加
-<details>
-<summary>V013__cost_management_tables.sql（バージョンカラムは各テーブル作成時に含まれています）</summary>
-```sql
--- V013__cost_management_tables.sql（バージョンカラムは各テーブル作成時に含まれています）
--- 注: 実装ではテーブル作成時にバージョンカラムを追加済み
--- 実際原価データテーブルにバージョンカラムを追加
-ALTER TABLE "実際原価データ" ADD COLUMN "バージョン" INTEGER DEFAULT 1 NOT NULL;
--- 標準原価マスタテーブルにバージョンカラムを追加
-ALTER TABLE "標準原価マスタ" ADD COLUMN "バージョン" INTEGER DEFAULT 1 NOT NULL;
--- 材料消費データテーブルにバージョンカラムを追加
-ALTER TABLE "材料消費データ" ADD COLUMN "バージョン" INTEGER DEFAULT 1 NOT NULL;
--- コメント追加
-COMMENT ON COLUMN "実際原価データ"."バージョン" IS '楽観ロック用バージョン番号';
-COMMENT ON COLUMN "標準原価マスタ"."バージョン" IS '楽観ロック用バージョン番号';
-COMMENT ON COLUMN "材料消費データ"."バージョン" IS '楽観ロック用バージョン番号';
-```
-</details>
-#### エンティティへのバージョンフィールド追加
-<details>
-<summary>ActualCost.java（バージョンフィールド追加）</summary>
-```java
-// src/main/java/com/example/pms/domain/model/cost/ActualCost.java
-package com.example.pms.domain.model.cost;
-import com.example.pms.domain.model.process.LaborHours;
-import lombok.*;
-import java.math.BigDecimal;
-import java.math.RoundingMode;
-import java.time.LocalDateTime;
-import java.util.ArrayList;
-import java.util.List;
-/**
- * 実際原価データエンティティ.
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ActualCost {
-    private Integer id;
-    private String workOrderNumber;
-    private String itemCode;
-    private BigDecimal completedQuantity;
-    private BigDecimal actualMaterialCost;
-    private BigDecimal actualLaborCost;
-    private BigDecimal actualExpense;
-    private BigDecimal actualManufacturingCost;
-    private BigDecimal unitCost;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-    // 楽観ロック用バージョン
-    @Builder.Default
-    private Integer version = 1;
-    // リレーション
-    @Builder.Default
-    private List<MaterialConsumption> materialConsumptions = new ArrayList<>();
-    @Builder.Default
-    private List<LaborHours> laborHours = new ArrayList<>();
-    @Builder.Default
-    private List<OverheadAllocation> overheadAllocations = new ArrayList<>();
-    /**
-     * 実際製造原価を計算.
-     */
-    public BigDecimal calculateActualManufacturingCost() {
-        return actualMaterialCost.add(actualLaborCost).add(actualExpense);
-    }
-    /**
-     * 単位原価を計算.
-     */
-    public BigDecimal calculateUnitCost() {
-        if (completedQuantity == null || completedQuantity.compareTo(BigDecimal.ZERO) == 0) {
-            return BigDecimal.ZERO;
-        }
-        return actualManufacturingCost.divide(completedQuantity, 4, RoundingMode.HALF_UP);
-    }
-    /**
-     * 原価再計算が必要かチェック.
-     */
-    public boolean needsRecalculation(BigDecimal newMaterialCost,
-                                      BigDecimal newLaborCost,
-                                      BigDecimal newExpense) {
-        return !actualMaterialCost.equals(newMaterialCost)
-            || !actualLaborCost.equals(newLaborCost)
-            || !actualExpense.equals(newExpense);
-    }
-}
-```
-</details>
-#### MyBatis Mapper: 楽観ロック対応の更新
-原価データの再計算時に楽観ロックを適用します。
-<details>
-<summary>ActualCostMapper.xml（楽観ロック対応 UPDATE）</summary>
-```xml
-<!-- 実際原価更新（楽観ロック対応） -->
-<update id="update">
-    UPDATE "実際原価データ"
-    SET "完成数量" = #{completedQuantity},
-        "実際材料費" = #{actualMaterialCost},
-        "実際労務費" = #{actualLaborCost},
-        "実際経費" = #{actualExpense},
-        "実際製造原価" = #{actualManufacturingCost},
-        "単位原価" = #{unitCost},
-        "更新日時" = CURRENT_TIMESTAMP,
-        "バージョン" = "バージョン" + 1
-    WHERE "作業指示番号" = #{workOrderNumber}
-      AND "バージョン" = #{version}
-</update>
-<!-- 原価再計算による更新（楽観ロック + 完成数量チェック） -->
-<update id="recalculateWithOptimisticLock">
-    UPDATE "実際原価データ"
-    SET "実際材料費" = #{actualMaterialCost},
-        "実際労務費" = #{actualLaborCost},
-        "実際経費" = #{actualExpense},
-        "実際製造原価" = #{actualMaterialCost} + #{actualLaborCost} + #{actualExpense},
-        "単位原価" = CASE
-            WHEN "完成数量" > 0
-            THEN (#{actualMaterialCost} + #{actualLaborCost} + #{actualExpense}) / "完成数量"
-            ELSE 0
-        END,
-        "更新日時" = CURRENT_TIMESTAMP,
-        "バージョン" = "バージョン" + 1
-    WHERE "作業指示番号" = #{workOrderNumber}
-      AND "バージョン" = #{version}
-</update>
-<!-- バージョン取得 -->
-<select id="findVersionByWorkOrderNumber" resultType="java.lang.Integer">
-    SELECT "バージョン" FROM "実際原価データ"
-    WHERE "作業指示番号" = #{workOrderNumber}
-</select>
-```
-</details>
-#### Repository 実装: 楽観ロック対応
-<details>
-<summary>ActualCostRepositoryImpl.java（楽観ロック対応）</summary>
-```java
-// src/main/java/com/example/pms/infrastructure/out/persistence/repository/ActualCostRepositoryImpl.java
-package com.example.pms.infrastructure.out.persistence.repository;
-import com.example.pms.application.port.out.ActualCostRepository;
-import com.example.pms.domain.model.cost.ActualCost;
-import com.example.pms.infrastructure.out.persistence.mapper.ActualCostMapper;
-import org.springframework.stereotype.Repository;
-import java.math.BigDecimal;
-import java.util.List;
-import java.util.Optional;
-/**
- * 実際原価データリポジトリ実装.
- */
-@Repository
-public class ActualCostRepositoryImpl implements ActualCostRepository {
-    private final ActualCostMapper mapper;
-    public ActualCostRepositoryImpl(ActualCostMapper mapper) {
-        this.mapper = mapper;
-    }
-    @Override
-    public void save(ActualCost actualCost) {
-        mapper.insert(actualCost);
-    }
-    @Override
-    public int update(ActualCost actualCost) {
-        return mapper.update(actualCost);
-    }
-    @Override
-    public int recalculate(String workOrderNumber, Integer version,
-                           BigDecimal actualMaterialCost, BigDecimal actualLaborCost, BigDecimal actualExpense) {
-        return mapper.recalculateWithOptimisticLock(
-                workOrderNumber, version, actualMaterialCost, actualLaborCost, actualExpense);
-    }
-    @Override
-    public Optional<Integer> findVersionByWorkOrderNumber(String workOrderNumber) {
-        return Optional.ofNullable(mapper.findVersionByWorkOrderNumber(workOrderNumber));
-    }
-    @Override
-    public Optional<ActualCost> findById(Integer id) {
-        return Optional.ofNullable(mapper.findById(id));
-    }
-    @Override
-    public Optional<ActualCost> findByWorkOrderNumber(String workOrderNumber) {
-        return Optional.ofNullable(mapper.findByWorkOrderNumber(workOrderNumber));
-    }
-    @Override
-    public Optional<ActualCost> findByWorkOrderNumberWithRelations(String workOrderNumber) {
-        return Optional.ofNullable(mapper.findByWorkOrderNumberWithRelations(workOrderNumber));
-    }
-    @Override
-    public List<ActualCost> findAll() {
-        return mapper.findAll();
-    }
-    @Override
-    public void deleteByWorkOrderNumber(String workOrderNumber) {
-        mapper.deleteByWorkOrderNumber(workOrderNumber);
-    }
-    @Override
-    public void deleteAll() {
-        mapper.deleteAll();
-    }
-}
-```
-</details>
-#### TDD: 楽観ロックのテスト
-<details>
-<summary>ActualCostRepositoryOptimisticLockTest.java</summary>
-```java
-// src/test/java/com/example/pms/infrastructure/out/persistence/repository/ActualCostRepositoryImplTest.java
-package com.example.pms.infrastructure.out.persistence.repository;
-import com.example.pms.application.port.out.ActualCostRepository;
-import com.example.pms.domain.model.cost.ActualCost;
-import com.example.pms.testsetup.BaseIntegrationTest;
-import org.junit.jupiter.api.*;
-import org.springframework.beans.factory.annotation.Autowired;
-import java.math.BigDecimal;
-import static org.assertj.core.api.Assertions.*;
-@DisplayName("実際原価リポジトリ - 楽観ロック")
-class ActualCostRepositoryOptimisticLockTest extends BaseIntegrationTest {
-    @Autowired
-    private ActualCostRepository actualCostRepository;
-    @BeforeEach
-    void setUp() {
-        // テストデータのセットアップ
-    }
-    @Nested
-    @DisplayName("原価更新の楽観ロック")
-    class CostUpdateOptimisticLocking {
-        @Test
-        @DisplayName("同じバージョンで原価を更新できる")
-        void canUpdateCostWithSameVersion() {
-            // Arrange
-            ActualCost cost = createTestActualCost("WO-TEST-001");
-            Integer initialVersion = cost.getVersion();
-            cost.setActualMaterialCost(new BigDecimal("15000"));
-            cost.setActualLaborCost(new BigDecimal("8000"));
-            cost.setActualExpense(new BigDecimal("3000"));
-            cost.setActualManufacturingCost(new BigDecimal("26000"));
-            cost.setUnitCost(new BigDecimal("260"));
-            // Act
-            actualCostRepository.update(cost);
-            // Assert
-            var updated = actualCostRepository.findFullByWorkOrderNumber("WO-TEST-001").get();
-            assertThat(updated.getActualMaterialCost()).isEqualByComparingTo(new BigDecimal("15000"));
-            assertThat(updated.getActualManufacturingCost()).isEqualByComparingTo(new BigDecimal("26000"));
-            assertThat(updated.getVersion()).isEqualTo(initialVersion + 1);
-        }
-        @Test
-        @DisplayName("異なるバージョンで更新すると楽観ロック例外が発生する")
-        void throwsExceptionWhenVersionMismatch() {
-            // Arrange
-            ActualCost cost = createTestActualCost("WO-TEST-002");
-            Integer initialVersion = cost.getVersion();
-            // 経理担当者Aが原価を更新（成功）
-            cost.setActualMaterialCost(new BigDecimal("15000"));
-            cost.setActualManufacturingCost(new BigDecimal("25000"));
-            cost.setUnitCost(new BigDecimal("250"));
-            actualCostRepository.update(cost);
-            // Act & Assert: 経理担当者Bが古いバージョンで更新（失敗）
-            cost.setVersion(initialVersion); // 古いバージョンに戻す
-            cost.setActualMaterialCost(new BigDecimal("16000"));
-            // 古いバージョンで更新すると 0 rows が返される
-            int result = actualCostRepository.update(cost);
-            assertThat(result).isEqualTo(0);
-        }
-    }
-    @Nested
-    @DisplayName("原価再計算の楽観ロック")
-    class RecalculateOptimisticLocking {
-        @Test
-        @DisplayName("原価を再計算できる")
-        void canRecalculateCost() {
-            // Arrange
-            ActualCost cost = createTestActualCost("WO-TEST-003");
-            // Act
-            actualCostRepository.recalculate(
-                    cost.getWorkOrderNumber(),
-                    cost.getVersion(),
-                    new BigDecimal("12000"),
-                    new BigDecimal("6000"),
-                    new BigDecimal("2000"));
-            // Assert
-            var updated = actualCostRepository.findFullByWorkOrderNumber("WO-TEST-003").get();
-            assertThat(updated.getActualMaterialCost()).isEqualByComparingTo(new BigDecimal("12000"));
-            assertThat(updated.getActualLaborCost()).isEqualByComparingTo(new BigDecimal("6000"));
-            assertThat(updated.getActualExpense()).isEqualByComparingTo(new BigDecimal("2000"));
-            assertThat(updated.getActualManufacturingCost()).isEqualByComparingTo(new BigDecimal("20000"));
-        }
-        @Test
-        @DisplayName("古いバージョンで再計算すると失敗する")
-        void recalculateFailsWithOldVersion() {
-            // Arrange
-            ActualCost cost = createTestActualCost("WO-TEST-004");
-            actualCostRepository.save(cost);
-            // 先に更新してバージョンを上げる
-            ActualCost toUpdate = actualCostRepository.findByWorkOrderNumber("WO-TEST-004").get();
-            toUpdate.setActualMaterialCost(new BigDecimal("55000"));
-            actualCostRepository.update(toUpdate);
-            // Act: 古いバージョンで再計算
-            int result = actualCostRepository.recalculate(
-                    "WO-TEST-004",
-                    1, // 古いバージョン
-                    new BigDecimal("60000"),
-                    new BigDecimal("40000"),
-                    new BigDecimal("30000"));
-            // Assert
-            assertThat(result).isEqualTo(0);
-        }
-    }
-    private ActualCost createTestActualCost(String workOrderNumber) {
-        return ActualCost.builder()
-                .workOrderNumber(workOrderNumber)
-                .itemCode("PROD-001")
-                .completedQuantity(new BigDecimal("100"))
-                .actualMaterialCost(new BigDecimal("10000"))
-                .actualLaborCost(new BigDecimal("5000"))
-                .actualExpense(new BigDecimal("2000"))
-                .actualManufacturingCost(new BigDecimal("17000"))
-                .unitCost(new BigDecimal("170"))
-                .build();
-    }
-}
-```
-</details>
-### 原価再計算処理のシーケンス図
-原価再計算では、材料消費や工数実績の追加・修正後に実際原価を更新します。
-```plantuml
-@startuml
-title 原価再計算処理シーケンス（楽観ロック対応）
-actor 経理担当者A
-actor 経理担当者B
-participant "CostCalculationService" as Service
-participant "ActualCostRepository" as Repo
-database "実際原価データ" as CostTable
-== 同時原価再計算シナリオ ==
-経理担当者A -> Service: 原価再計算(WO-001)
-activate Service
-Service -> Repo: findFullByWorkOrderNumber(WO-001)
-Repo -> CostTable: SELECT
-CostTable --> Repo: 実際原価(version=1)
-Repo --> Service: 実際原価(version=1)
-Service -> Service: 材料費・労務費・経費を再集計
-経理担当者B -> Service: 原価再計算(WO-001)
-activate Service
-Service -> Repo: findFullByWorkOrderNumber(WO-001)
-Repo -> CostTable: SELECT
-CostTable --> Repo: 実際原価(version=1)
-Repo --> Service: 実際原価(version=1)
-Service -> Service: 材料費・労務費・経費を再集計
-note over 経理担当者A,CostTable: 経理担当者Aが先に更新
-Service -> Repo: recalculate(version=1, 材料費=15000)
-Repo -> CostTable: UPDATE SET 実際材料費=15000, バージョン += 1\nWHERE バージョン = 1
-CostTable --> Repo: 1 row updated
-Repo --> Service: 成功
-Service --> 経理担当者A: 再計算完了
-deactivate Service
-note over 経理担当者A,CostTable: 経理担当者Bの更新（楽観ロック失敗）
-Service -> Repo: recalculate(version=1, 材料費=16000)
-Repo -> CostTable: UPDATE SET 実際材料費=16000, バージョン += 1\nWHERE バージョン = 1
-CostTable --> Repo: 0 rows updated
-Repo -> CostTable: SELECT バージョン
-CostTable --> Repo: version=2
-Repo --> Service: OptimisticLockException
-Service --> 経理担当者B: エラー: 他の担当者が更新済み
-deactivate Service
-note over 経理担当者B: 担当者Bはリトライ
-経理担当者B -> Service: 原価再計算(WO-001)
-activate Service
-Service -> Repo: findFullByWorkOrderNumber(WO-001)
-Repo -> CostTable: SELECT
-CostTable --> Repo: 実際原価(version=2, 材料費=15000)
-Repo --> Service: 実際原価(version=2)
-Service -> Service: 最新データで再集計
-Service -> Repo: recalculate(version=2, 材料費=15500)
-Repo -> CostTable: UPDATE SET 実際材料費=15500, バージョン += 1\nWHERE バージョン = 2
-CostTable --> Repo: 1 row updated
-Repo --> Service: 成功
-Service --> 経理担当者B: 再計算完了
-deactivate Service
-@enduml
-```
-### 製造原価管理向け楽観ロックのベストプラクティス
-| ポイント | 説明 |
-|---------|------|
-| **確定状態チェック** | 原価差異分析済みの場合は再計算を禁止 |
-| **計算の一貫性** | 材料費・労務費・経費の合計と製造原価の整合性を UPDATE 内で保証 |
-| **単位原価の自動計算** | 完成数量による除算を SQL 内で実行し、0 除算を回避 |
-| **監査証跡** | 原価変更履歴を別テーブルに記録することを検討 |
-| **期間締め処理** | 月次締め後は当該期間の原価データを更新不可に |
-| **差異分析のタイミング** | 原価確定後に差異分析を実行し、確定状態を管理 |
----
-## 30.4 まとめ
-本章では、製造原価管理の設計について解説しました。
-### 設計のポイント
-1. **原価要素の体系的な管理**
-   - 直接費（材料費、労務費、経費）と間接費の分離
-   - 各原価要素のトレーサビリティ確保
-2. **標準原価と実際原価の対比**
-   - 標準原価マスタによる目標原価の設定
-   - 実際原価データによる実績の把握
-   - 原価差異分析による改善活動の支援
-3. **製造間接費の配賦**
-   - 配賦基準（直接作業時間、機械稼働時間など）の設定
-   - 配賦率の計算と各製品への配分
-4. **原価計算サービス**
-   - 材料費、労務費、製造間接費の集計
-   - 製造原価・単位原価の計算
-   - 原価差異分析の自動化
-### 次章への橋渡し
-次章では、E 社事例を通じて生産管理システムの具体的なデータ設計を解説します。精密機械部品製造業における実践的なデータ構造とシードデータの実装を取り上げます。
----
-[← 第29章：品質管理の設計](chapter29.md) | [第31章：生産管理データ設計（E社事例） →](chapter31.md)
+# 第30章：製造原価管理の設計
+## 30.1 原価計算の概要
+### 製造原価の構成
+製造原価は、製品を製造するために発生するすべてのコストを体系的に把握するための概念です。製造原価は大きく直接費と間接費（製造間接費）に分類されます。
+```plantuml
+@startuml
+title 製造原価の構成
+package "製造原価" {
+  package "直接費" {
+    [直接材料費] as DM
+    [直接労務費] as DL
+    [直接経費] as DE
+  }
+  package "間接費（製造間接費）" {
+    [間接材料費] as IM
+    [間接労務費] as IL
+    [間接経費] as IE
+  }
+}
+note right of DM : BOMに基づく材料消費
+note right of DL : 工数実績に基づく賃金
+note right of DE : 外注加工費など
+note right of IM : 消耗品、補助材料
+note right of IL : 間接作業者の賃金
+note right of IE : 減価償却費、電力費等
+@enduml
+```
+#### 原価要素の分類
+| 分類 | 原価要素 | 説明 | 例 |
+|-----|---------|------|-----|
+| **直接材料費** | 製品に直接使用される材料 | BOM に基づき計算 | 主要材料、部品 |
+| **直接労務費** | 製造作業者の賃金 | 工数実績 × 賃率 | 製造ラインの作業者 |
+| **直接経費** | 製品に直接賦課できる経費 | 外注費など | 外注加工費、特許使用料 |
+| **間接材料費** | 製品に間接的に使用される材料 | 配賦により計算 | 潤滑油、消耗工具 |
+| **間接労務費** | 間接作業者の賃金 | 配賦により計算 | 監督者、品質管理者 |
+| **間接経費** | 製造に間接的に発生する経費 | 配賦により計算 | 減価償却費、水道光熱費 |
+### 標準原価と実際原価
+原価計算には、標準原価計算と実際原価計算の2つのアプローチがあります。
+```plantuml
+@startuml
+title 標準原価と実際原価の関係
+package "原価計算" {
+  package "標準原価計算" {
+    [標準材料費] as SM
+    [標準労務費] as SL
+    [標準経費] as SE
+  }
+  package "実際原価計算" {
+    [実際材料費] as AM
+    [実際労務費] as AL
+    [実際経費] as AE
+  }
+}
+[標準製造原価] as SC
+[実際製造原価] as AC
+[原価差異] as CV
+SM --> SC
+SL --> SC
+SE --> SC
+AM --> AC
+AL --> AC
+AE --> AC
+SC --> CV : 比較
+AC --> CV : 比較
+note right of SC : 事前に設定した目標原価
+note right of AC : 実際に発生した原価
+note right of CV : 差異分析により改善
+@enduml
+```
+| 区分 | 説明 | 用途 |
+|-----|------|-----|
+| **標準原価** | 事前に設定した目標原価 | 予算管理、見積り、原価統制 |
+| **実際原価** | 実際に発生した原価 | 実績把握、原価差異分析 |
+### 原価差異分析
+原価差異は、標準原価と実際原価の差として計算されます。
+```
+原価差異 = 実際原価 - 標準原価
+```
+差異がプラス（不利差異）の場合は実際原価が標準を上回っており、マイナス（有利差異）の場合は実際原価が標準を下回っていることを示します。
+```plantuml
+@startuml
+title 原価差異分析の構造
+package "原価差異" {
+  [材料費差異] as MV
+  [労務費差異] as LV
+  [経費差異] as EV
+}
+package "材料費差異の要因" {
+  [価格差異] as MP
+  [数量差異] as MQ
+}
+package "労務費差異の要因" {
+  [賃率差異] as LR
+  [能率差異] as LE
+}
+package "経費差異の要因" {
+  [予算差異] as EB
+  [操業度差異] as EO
+}
+MV --> MP
+MV --> MQ
+LV --> LR
+LV --> LE
+EV --> EB
+EV --> EO
+note right of MP : 実際単価と標準単価の差
+note right of MQ : 実際使用量と標準使用量の差
+note right of LR : 実際賃率と標準賃率の差
+note right of LE : 実際作業時間と標準作業時間の差
+@enduml
+```
+#### 差異の要因分析
+| 差異種類 | 要因 | 計算式 |
+|---------|-----|-------|
+| **価格差異** | 材料の購入単価の差 | (実際単価 - 標準単価) × 実際使用量 |
+| **数量差異** | 材料の使用量の差 | (実際使用量 - 標準使用量) × 標準単価 |
+| **賃率差異** | 労働者の賃率の差 | (実際賃率 - 標準賃率) × 実際作業時間 |
+| **能率差異** | 作業効率の差 | (実際作業時間 - 標準作業時間) × 標準賃率 |
+---
+## 30.2 材料費・労務費・製造間接費
+### 材料費の計算（直接材料費・間接材料費）
+材料費は、製品の製造に使用された材料の消費額です。BOM（部品表）と消費実績に基づいて計算します。
+```plantuml
+@startuml
+title 材料費計算の流れ
+|BOM管理|
+start
+:BOM展開;
+:必要材料の特定;
+|在庫管理|
+:材料払出;
+:消費実績記録;
+|原価計算|
+:材料費集計;
+if (直接材料?) then (yes)
+  :直接材料費として計上;
+  :製造指示に紐付け;
+else (no)
+  :間接材料費として計上;
+  :配賦基準で配分;
+endif
+stop
+@enduml
+```
+#### 材料消費データエンティティ
+<details>
+<summary>MaterialConsumption.java</summary>
+```java
+// src/main/java/com/example/pms/domain/model/cost/MaterialConsumption.java
+package com.example.pms.domain.model.cost;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+/**
+ * 材料消費データエンティティ
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MaterialConsumption {
+    private Integer id;
+    private String workOrderNumber;
+    private String materialCode;
+    private LocalDate consumptionDate;
+    private BigDecimal consumptionQuantity;
+    private BigDecimal unitPrice;
+    private BigDecimal consumptionAmount;
+    private Boolean isDirect;
+    private String remarks;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+#### MyBatis Mapper XML：材料消費
+<details>
+<summary>MaterialConsumptionMapper.xml</summary>
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.MaterialConsumptionMapper">
+    <resultMap id="MaterialConsumptionResultMap"
+               type="com.example.pms.domain.model.cost.MaterialConsumption">
+        <id property="id" column="ID"/>
+        <result property="workOrderNumber" column="作業指示番号"/>
+        <result property="materialCode" column="材料コード"/>
+        <result property="consumptionDate" column="消費日"/>
+        <result property="consumptionQuantity" column="消費数量"/>
+        <result property="unitPrice" column="単価"/>
+        <result property="consumptionAmount" column="消費金額"/>
+        <result property="isDirect" column="直接材料フラグ"/>
+        <result property="remarks" column="備考"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <select id="findByWorkOrderNumber" resultMap="MaterialConsumptionResultMap">
+        SELECT * FROM "材料消費データ"
+        WHERE "作業指示番号" = #{workOrderNumber}
+        ORDER BY "消費日" ASC
+    </select>
+    <select id="sumDirectMaterialCostByWorkOrderNumber" resultType="java.math.BigDecimal">
+        SELECT COALESCE(SUM("消費金額"), 0)
+        FROM "材料消費データ"
+        WHERE "作業指示番号" = #{workOrderNumber}
+          AND "直接材料フラグ" = true
+    </select>
+    <select id="sumIndirectMaterialCostByPeriod" resultType="java.math.BigDecimal">
+        SELECT COALESCE(SUM("消費金額"), 0)
+        FROM "材料消費データ"
+        WHERE "消費日" BETWEEN #{startDate} AND #{endDate}
+          AND "直接材料フラグ" = false
+    </select>
+    <insert id="insert" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
+        INSERT INTO "材料消費データ" (
+            "作業指示番号", "材料コード", "消費日",
+            "消費数量", "単価", "消費金額", "直接材料フラグ", "備考"
+        ) VALUES (
+            #{workOrderNumber}, #{materialCode}, #{consumptionDate},
+            #{consumptionQuantity}, #{unitPrice}, #{consumptionAmount},
+            #{isDirect}, #{remarks}
+        )
+    </insert>
+</mapper>
+```
+</details>
+#### Flyway マイグレーション：材料消費
+<details>
+<summary>V013__cost_management_tables.sql（材料消費部分）</summary>
+```sql
+-- V013__cost_management_tables.sql（材料消費部分）
+-- 材料消費データ
+CREATE TABLE "材料消費データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "作業指示番号" VARCHAR(20) NOT NULL,
+    "材料コード" VARCHAR(20) NOT NULL,
+    "消費日" DATE NOT NULL,
+    "消費数量" DECIMAL(15, 2) NOT NULL,
+    "単価" DECIMAL(15, 4) NOT NULL,
+    "消費金額" DECIMAL(15, 2) NOT NULL,
+    "直接材料フラグ" BOOLEAN NOT NULL DEFAULT true,
+    "備考" VARCHAR(500),
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "FK_材料消費_作業指示" FOREIGN KEY ("作業指示番号")
+        REFERENCES "作業指示データ"("作業指示番号"),
+    CONSTRAINT "FK_材料消費_品目" FOREIGN KEY ("材料コード")
+        REFERENCES "品目マスタ"("品目コード")
+);
+COMMENT ON TABLE "材料消費データ" IS '材料消費データ';
+COMMENT ON COLUMN "材料消費データ"."直接材料フラグ" IS '直接材料=true, 間接材料=false';
+-- インデックス
+CREATE INDEX "IDX_材料消費_作業指示" ON "材料消費データ" ("作業指示番号");
+CREATE INDEX "IDX_材料消費_消費日" ON "材料消費データ" ("消費日");
+```
+</details>
+### 労務費の計算（直接労務費・間接労務費）
+労務費は、製造に関わる作業者の人件費です。工数実績と賃率に基づいて計算します。
+```plantuml
+@startuml
+title 労務費計算の流れ
+|工程管理|
+start
+:作業実施;
+:工数実績記録;
+|人事管理|
+:賃率マスタ参照;
+:作業者区分確認;
+|原価計算|
+:労務費計算;
+note right: 工数 × 賃率
+if (直接作業?) then (yes)
+  :直接労務費として計上;
+  :製造指示に紐付け;
+else (no)
+  :間接労務費として計上;
+  :配賦基準で配分;
+endif
+stop
+@enduml
+```
+#### 賃率マスタエンティティ
+<details>
+<summary>WageRate.java</summary>
+```java
+// src/main/java/com/example/pms/domain/model/cost/WageRate.java
+package com.example.pms.domain.model.cost;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+/**
+ * 賃率マスタエンティティ
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class WageRate {
+    private Integer id;
+    private String workerCategoryCode;
+    private String workerCategoryName;
+    private LocalDate effectiveStartDate;
+    private LocalDate effectiveEndDate;
+    private BigDecimal hourlyRate;
+    private Boolean isDirect;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+#### 工数実績データエンティティ
+<details>
+<summary>LaborHours.java</summary>
+```java
+// src/main/java/com/example/pms/domain/model/process/LaborHours.java
+package com.example.pms.domain.model.process;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+/**
+ * 工数実績データエンティティ
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class LaborHours {
+    private Integer id;
+    private String workOrderNumber;
+    private String processCode;
+    private String workerCode;
+    private String workerCategoryCode;
+    private LocalDate workDate;
+    private BigDecimal workHours;
+    private BigDecimal hourlyRate;
+    private BigDecimal laborCost;
+    private Boolean isDirect;
+    private String remarks;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+#### MyBatis Mapper XML：工数実績
+<details>
+<summary>LaborHoursMapper.xml</summary>
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.LaborHoursMapper">
+    <resultMap id="WageRateResultMap"
+               type="com.example.pms.domain.model.cost.WageRate">
+        <id property="id" column="ID"/>
+        <result property="workerCategoryCode" column="作業者区分コード"/>
+        <result property="workerCategoryName" column="作業者区分名"/>
+        <result property="effectiveStartDate" column="適用開始日"/>
+        <result property="effectiveEndDate" column="適用終了日"/>
+        <result property="hourlyRate" column="時間単価"/>
+        <result property="isDirect" column="直接労務フラグ"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <resultMap id="LaborHoursResultMap"
+               type="com.example.pms.domain.model.process.LaborHours">
+        <id property="id" column="ID"/>
+        <result property="workOrderNumber" column="作業指示番号"/>
+        <result property="processCode" column="工程コード"/>
+        <result property="workerCode" column="作業者コード"/>
+        <result property="workerCategoryCode" column="作業者区分コード"/>
+        <result property="workDate" column="作業日"/>
+        <result property="workHours" column="作業時間"/>
+        <result property="hourlyRate" column="時間単価"/>
+        <result property="laborCost" column="労務費"/>
+        <result property="isDirect" column="直接労務フラグ"/>
+        <result property="remarks" column="備考"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <select id="findByWorkOrderNumber" resultMap="LaborHoursResultMap">
+        SELECT * FROM "工数実績データ"
+        WHERE "作業指示番号" = #{workOrderNumber}
+        ORDER BY "作業日" ASC
+    </select>
+    <select id="sumDirectLaborCostByWorkOrderNumber" resultType="java.math.BigDecimal">
+        SELECT COALESCE(SUM("労務費"), 0)
+        FROM "工数実績データ"
+        WHERE "作業指示番号" = #{workOrderNumber}
+          AND "直接労務フラグ" = true
+    </select>
+    <select id="sumIndirectLaborCostByPeriod" resultType="java.math.BigDecimal">
+        SELECT COALESCE(SUM("労務費"), 0)
+        FROM "工数実績データ"
+        WHERE "作業日" BETWEEN #{startDate} AND #{endDate}
+          AND "直接労務フラグ" = false
+    </select>
+    <select id="sumWorkHoursByWorkOrderNumber" resultType="java.math.BigDecimal">
+        SELECT COALESCE(SUM("作業時間"), 0)
+        FROM "工数実績データ"
+        WHERE "作業指示番号" = #{workOrderNumber}
+    </select>
+    <select id="findWageRateByCategory" resultMap="WageRateResultMap">
+        SELECT * FROM "賃率マスタ"
+        WHERE "作業者区分コード" = #{workerCategoryCode}
+          AND "適用開始日" &lt;= #{targetDate}
+          AND ("適用終了日" IS NULL OR "適用終了日" >= #{targetDate})
+        ORDER BY "適用開始日" DESC
+        LIMIT 1
+    </select>
+    <insert id="insert" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
+        INSERT INTO "工数実績データ" (
+            "作業指示番号", "工程コード", "作業者コード", "作業者区分コード",
+            "作業日", "作業時間", "時間単価", "労務費", "直接労務フラグ", "備考"
+        ) VALUES (
+            #{workOrderNumber}, #{processCode}, #{workerCode}, #{workerCategoryCode},
+            #{workDate}, #{workHours}, #{hourlyRate}, #{laborCost}, #{isDirect}, #{remarks}
+        )
+    </insert>
+</mapper>
+```
+</details>
+#### Flyway マイグレーション：労務費
+<details>
+<summary>V013__cost_management_tables.sql（労務費部分）</summary>
+```sql
+-- V013__cost_management_tables.sql（労務費部分）
+-- 賃率マスタ
+CREATE TABLE "賃率マスタ" (
+    "ID" SERIAL PRIMARY KEY,
+    "作業者区分コード" VARCHAR(20) NOT NULL,
+    "作業者区分名" VARCHAR(100) NOT NULL,
+    "適用開始日" DATE NOT NULL,
+    "適用終了日" DATE,
+    "時間単価" DECIMAL(15, 2) NOT NULL,
+    "直接労務フラグ" BOOLEAN NOT NULL DEFAULT true,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "UK_賃率_区分_適用開始日" UNIQUE ("作業者区分コード", "適用開始日")
+);
+COMMENT ON TABLE "賃率マスタ" IS '賃率マスタ';
+COMMENT ON COLUMN "賃率マスタ"."時間単価" IS '1時間あたりの賃率';
+COMMENT ON COLUMN "賃率マスタ"."直接労務フラグ" IS '直接労務=true, 間接労務=false';
+-- 工数実績データ
+CREATE TABLE "工数実績データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "作業指示番号" VARCHAR(20) NOT NULL,
+    "工程コード" VARCHAR(20) NOT NULL,
+    "作業者コード" VARCHAR(20) NOT NULL,
+    "作業者区分コード" VARCHAR(20) NOT NULL,
+    "作業日" DATE NOT NULL,
+    "作業時間" DECIMAL(5, 2) NOT NULL,
+    "時間単価" DECIMAL(15, 2) NOT NULL,
+    "労務費" DECIMAL(15, 2) NOT NULL,
+    "直接労務フラグ" BOOLEAN NOT NULL DEFAULT true,
+    "備考" VARCHAR(500),
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "FK_工数実績_作業指示" FOREIGN KEY ("作業指示番号")
+        REFERENCES "作業指示データ"("作業指示番号"),
+    CONSTRAINT "FK_工数実績_工程" FOREIGN KEY ("工程コード")
+        REFERENCES "工程マスタ"("工程コード")
+);
+COMMENT ON TABLE "工数実績データ" IS '工数実績データ';
+COMMENT ON COLUMN "工数実績データ"."作業時間" IS '作業時間（時間単位）';
+COMMENT ON COLUMN "工数実績データ"."労務費" IS '作業時間 × 時間単価';
+-- インデックス
+CREATE INDEX "IDX_工数実績_作業指示" ON "工数実績データ" ("作業指示番号");
+CREATE INDEX "IDX_工数実績_作業日" ON "工数実績データ" ("作業日");
+CREATE INDEX "IDX_工数実績_作業者" ON "工数実績データ" ("作業者コード");
+```
+</details>
+### 製造間接費の配賦
+製造間接費は、特定の製品に直接紐付けられない費用であり、一定の配賦基準に基づいて各製品に配分します。
+```plantuml
+@startuml
+title 製造間接費配賦の流れ
+|経理部門|
+start
+:製造間接費の集計;
+note right
+  間接材料費
+  間接労務費
+  減価償却費
+  水道光熱費
+  その他
+end note
+|原価計算|
+:配賦基準の決定;
+note right
+  直接作業時間
+  機械稼働時間
+  直接材料費
+  直接労務費
+end note
+:配賦率の計算;
+note right: 製造間接費 ÷ 配賦基準総額
+:各製品への配賦;
+note right: 配賦率 × 各製品の配賦基準
+:製造原価への加算;
+stop
+@enduml
+```
+#### 製造間接費配賦データエンティティ
+<details>
+<summary>OverheadAllocation.java</summary>
+```java
+// src/main/java/com/example/pms/domain/model/cost/OverheadAllocation.java
+package com.example.pms.domain.model.cost;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+/**
+ * 製造間接費配賦データエンティティ
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class OverheadAllocation {
+    private Integer id;
+    private String workOrderNumber;
+    private String accountingPeriod;
+    private String allocationBasis;
+    private BigDecimal basisAmount;
+    private BigDecimal allocationRate;
+    private BigDecimal allocatedAmount;
+    private LocalDateTime createdAt;
+}
+```
+</details>
+#### 製造間接費マスタエンティティ
+<details>
+<summary>ManufacturingOverhead.java</summary>
+```java
+// src/main/java/com/example/pms/domain/model/cost/ManufacturingOverhead.java
+package com.example.pms.domain.model.cost;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+/**
+ * 製造間接費マスタエンティティ
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ManufacturingOverhead {
+    private Integer id;
+    private String accountingPeriod;
+    private String costCategory;
+    private String costCategoryName;
+    private BigDecimal amount;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+#### MyBatis Mapper XML：製造間接費
+<details>
+<summary>OverheadMapper.xml</summary>
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.OverheadMapper">
+    <resultMap id="ManufacturingOverheadResultMap"
+               type="com.example.pms.domain.model.cost.ManufacturingOverhead">
+        <id property="id" column="ID"/>
+        <result property="accountingPeriod" column="会計期間"/>
+        <result property="costCategory" column="費用区分"/>
+        <result property="costCategoryName" column="費用区分名"/>
+        <result property="amount" column="金額"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <resultMap id="OverheadAllocationResultMap"
+               type="com.example.pms.domain.model.cost.OverheadAllocation">
+        <id property="id" column="ID"/>
+        <result property="workOrderNumber" column="作業指示番号"/>
+        <result property="accountingPeriod" column="会計期間"/>
+        <result property="allocationBasis" column="配賦基準"/>
+        <result property="basisAmount" column="基準金額"/>
+        <result property="allocationRate" column="配賦率"/>
+        <result property="allocatedAmount" column="配賦金額"/>
+        <result property="createdAt" column="作成日時"/>
+    </resultMap>
+    <select id="sumOverheadByPeriod" resultType="java.math.BigDecimal">
+        SELECT COALESCE(SUM("金額"), 0)
+        FROM "製造間接費マスタ"
+        WHERE "会計期間" = #{accountingPeriod}
+    </select>
+    <select id="findAllocationByWorkOrderNumber" resultMap="OverheadAllocationResultMap">
+        SELECT * FROM "製造間接費配賦データ"
+        WHERE "作業指示番号" = #{workOrderNumber}
+        ORDER BY "会計期間" ASC
+    </select>
+    <insert id="insertOverhead" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
+        INSERT INTO "製造間接費マスタ" (
+            "会計期間", "費用区分", "費用区分名", "金額"
+        ) VALUES (
+            #{accountingPeriod}, #{costCategory}, #{costCategoryName}, #{amount}
+        )
+    </insert>
+    <insert id="insertAllocation" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
+        INSERT INTO "製造間接費配賦データ" (
+            "作業指示番号", "会計期間", "配賦基準",
+            "基準金額", "配賦率", "配賦金額"
+        ) VALUES (
+            #{workOrderNumber}, #{accountingPeriod}, #{allocationBasis},
+            #{basisAmount}, #{allocationRate}, #{allocatedAmount}
+        )
+    </insert>
+</mapper>
+```
+</details>
+#### Flyway マイグレーション：製造間接費
+<details>
+<summary>V013__cost_management_tables.sql（製造間接費部分）</summary>
+```sql
+-- V013__cost_management_tables.sql（製造間接費部分）
+-- 製造間接費マスタ
+CREATE TABLE "製造間接費マスタ" (
+    "ID" SERIAL PRIMARY KEY,
+    "会計期間" VARCHAR(7) NOT NULL,
+    "費用区分" VARCHAR(20) NOT NULL,
+    "費用区分名" VARCHAR(100) NOT NULL,
+    "金額" DECIMAL(15, 2) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "UK_製造間接費_期間_区分" UNIQUE ("会計期間", "費用区分")
+);
+COMMENT ON TABLE "製造間接費マスタ" IS '製造間接費マスタ';
+COMMENT ON COLUMN "製造間接費マスタ"."会計期間" IS '会計期間（YYYY-MM形式）';
+COMMENT ON COLUMN "製造間接費マスタ"."費用区分" IS '費用区分（間接材料/間接労務/減価償却/水道光熱など）';
+-- 製造間接費配賦データ
+CREATE TABLE "製造間接費配賦データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "作業指示番号" VARCHAR(20) NOT NULL,
+    "会計期間" VARCHAR(7) NOT NULL,
+    "配賦基準" VARCHAR(50) NOT NULL,
+    "基準金額" DECIMAL(15, 2) NOT NULL,
+    "配賦率" DECIMAL(10, 6) NOT NULL,
+    "配賦金額" DECIMAL(15, 2) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "UK_間接費配賦_作業指示_期間" UNIQUE ("作業指示番号", "会計期間"),
+    CONSTRAINT "FK_間接費配賦_作業指示" FOREIGN KEY ("作業指示番号")
+        REFERENCES "作業指示データ"("作業指示番号")
+);
+COMMENT ON TABLE "製造間接費配賦データ" IS '製造間接費配賦データ';
+COMMENT ON COLUMN "製造間接費配賦データ"."配賦基準" IS '配賦基準（直接作業時間/機械稼働時間/直接材料費/直接労務費）';
+COMMENT ON COLUMN "製造間接費配賦データ"."配賦率" IS '製造間接費 ÷ 配賦基準総額';
+-- インデックス
+CREATE INDEX "IDX_製造間接費_期間" ON "製造間接費マスタ" ("会計期間");
+CREATE INDEX "IDX_間接費配賦_作業指示" ON "製造間接費配賦データ" ("作業指示番号");
+```
+</details>
+### 製品原価の集計
+製品原価は、直接費と間接費を集計して計算します。
+```plantuml
+@startuml
+title 製品原価集計の流れ
+|原価計算|
+start
+fork
+  :直接材料費集計;
+fork again
+  :直接労務費集計;
+fork again
+  :直接経費集計;
+end fork
+:直接費合計;
+fork
+  :間接材料費配賦;
+fork again
+  :間接労務費配賦;
+fork again
+  :その他間接費配賦;
+end fork
+:製造間接費合計;
+:製造原価 = 直接費 + 製造間接費;
+:単位原価 = 製造原価 ÷ 完成数量;
+:実際原価データ登録;
+stop
+@enduml
+```
+#### 標準原価マスタエンティティ
+<details>
+<summary>StandardCost.java</summary>
+```java
+// src/main/java/com/example/pms/domain/model/cost/StandardCost.java
+package com.example.pms.domain.model.cost;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+/**
+ * 標準原価マスタエンティティ
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class StandardCost {
+    private Integer id;
+    private String itemCode;
+    private LocalDate effectiveStartDate;
+    private LocalDate effectiveEndDate;
+    private BigDecimal standardMaterialCost;
+    private BigDecimal standardLaborCost;
+    private BigDecimal standardExpense;
+    private BigDecimal standardManufacturingCost;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+#### 実際原価データエンティティ
+<details>
+<summary>ActualCost.java</summary>
+```java
+// src/main/java/com/example/pms/domain/model/cost/ActualCost.java
+package com.example.pms.domain.model.cost;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+/**
+ * 実際原価データエンティティ
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ActualCost {
+    private Integer id;
+    private String workOrderNumber;
+    private String itemCode;
+    private BigDecimal completedQuantity;
+    private BigDecimal actualMaterialCost;
+    private BigDecimal actualLaborCost;
+    private BigDecimal actualExpense;
+    private BigDecimal actualManufacturingCost;
+    private BigDecimal unitCost;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+    // 楽観ロック用バージョン
+    @Builder.Default
+    private Integer version = 1;
+    // リレーション
+    @Builder.Default
+    private List<MaterialConsumption> materialConsumptions = new ArrayList<>();
+    @Builder.Default
+    private List<LaborHours> laborHours = new ArrayList<>();
+    @Builder.Default
+    private List<OverheadAllocation> overheadAllocations = new ArrayList<>();
+}
+```
+</details>
+#### 原価差異データエンティティ
+<details>
+<summary>CostVariance.java</summary>
+```java
+// src/main/java/com/example/pms/domain/model/cost/CostVariance.java
+package com.example.pms.domain.model.cost;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+/**
+ * 原価差異データエンティティ
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CostVariance {
+    private Integer id;
+    private String workOrderNumber;
+    private String itemCode;
+    private BigDecimal materialCostVariance;
+    private BigDecimal laborCostVariance;
+    private BigDecimal expenseVariance;
+    private BigDecimal totalVariance;
+    private LocalDateTime createdAt;
+}
+```
+</details>
+#### MyBatis Mapper XML：原価管理
+<details>
+<summary>CostMapper.xml</summary>
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.CostMapper">
+    <resultMap id="StandardCostResultMap"
+               type="com.example.pms.domain.model.cost.StandardCost">
+        <id property="id" column="ID"/>
+        <result property="itemCode" column="品目コード"/>
+        <result property="effectiveStartDate" column="適用開始日"/>
+        <result property="effectiveEndDate" column="適用終了日"/>
+        <result property="standardMaterialCost" column="標準材料費"/>
+        <result property="standardLaborCost" column="標準労務費"/>
+        <result property="standardExpense" column="標準経費"/>
+        <result property="standardManufacturingCost" column="標準製造原価"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <resultMap id="ActualCostResultMap"
+               type="com.example.pms.domain.model.cost.ActualCost">
+        <id property="id" column="ID"/>
+        <result property="workOrderNumber" column="作業指示番号"/>
+        <result property="itemCode" column="品目コード"/>
+        <result property="completedQuantity" column="完成数量"/>
+        <result property="actualMaterialCost" column="実際材料費"/>
+        <result property="actualLaborCost" column="実際労務費"/>
+        <result property="actualExpense" column="実際経費"/>
+        <result property="actualManufacturingCost" column="実際製造原価"/>
+        <result property="unitCost" column="単位原価"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <resultMap id="CostVarianceResultMap"
+               type="com.example.pms.domain.model.cost.CostVariance">
+        <id property="id" column="ID"/>
+        <result property="workOrderNumber" column="作業指示番号"/>
+        <result property="itemCode" column="品目コード"/>
+        <result property="materialCostVariance" column="材料費差異"/>
+        <result property="laborCostVariance" column="労務費差異"/>
+        <result property="expenseVariance" column="経費差異"/>
+        <result property="totalVariance" column="総差異"/>
+        <result property="createdAt" column="作成日時"/>
+    </resultMap>
+    <select id="findStandardCostByItemCode" resultMap="StandardCostResultMap">
+        SELECT * FROM "標準原価マスタ"
+        WHERE "品目コード" = #{itemCode}
+          AND "適用開始日" &lt;= #{targetDate}
+          AND ("適用終了日" IS NULL OR "適用終了日" >= #{targetDate})
+        ORDER BY "適用開始日" DESC
+        LIMIT 1
+    </select>
+    <select id="findActualCostByWorkOrderNumber" resultMap="ActualCostResultMap">
+        SELECT * FROM "実際原価データ"
+        WHERE "作業指示番号" = #{workOrderNumber}
+    </select>
+    <select id="findCostVarianceByWorkOrderNumber" resultMap="CostVarianceResultMap">
+        SELECT * FROM "原価差異データ"
+        WHERE "作業指示番号" = #{workOrderNumber}
+    </select>
+    <insert id="insertStandardCost" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
+        INSERT INTO "標準原価マスタ" (
+            "品目コード", "適用開始日", "適用終了日",
+            "標準材料費", "標準労務費", "標準経費", "標準製造原価"
+        ) VALUES (
+            #{itemCode}, #{effectiveStartDate}, #{effectiveEndDate},
+            #{standardMaterialCost}, #{standardLaborCost},
+            #{standardExpense}, #{standardManufacturingCost}
+        )
+    </insert>
+    <insert id="insertActualCost" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
+        INSERT INTO "実際原価データ" (
+            "作業指示番号", "品目コード", "完成数量",
+            "実際材料費", "実際労務費", "実際経費",
+            "実際製造原価", "単位原価"
+        ) VALUES (
+            #{workOrderNumber}, #{itemCode}, #{completedQuantity},
+            #{actualMaterialCost}, #{actualLaborCost}, #{actualExpense},
+            #{actualManufacturingCost}, #{unitCost}
+        )
+    </insert>
+    <insert id="insertCostVariance" useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
+        INSERT INTO "原価差異データ" (
+            "作業指示番号", "品目コード",
+            "材料費差異", "労務費差異", "経費差異", "総差異"
+        ) VALUES (
+            #{workOrderNumber}, #{itemCode},
+            #{materialCostVariance}, #{laborCostVariance},
+            #{expenseVariance}, #{totalVariance}
+        )
+    </insert>
+    <update id="updateActualCost">
+        UPDATE "実際原価データ" SET
+            "完成数量" = #{completedQuantity},
+            "実際材料費" = #{actualMaterialCost},
+            "実際労務費" = #{actualLaborCost},
+            "実際経費" = #{actualExpense},
+            "実際製造原価" = #{actualManufacturingCost},
+            "単位原価" = #{unitCost},
+            "更新日時" = CURRENT_TIMESTAMP
+        WHERE "作業指示番号" = #{workOrderNumber}
+    </update>
+</mapper>
+```
+</details>
+#### Flyway マイグレーション：原価管理
+<details>
+<summary>V013__cost_management_tables.sql（原価管理部分）</summary>
+```sql
+-- V013__cost_management_tables.sql（原価管理部分）
+-- 標準原価マスタ
+CREATE TABLE "標準原価マスタ" (
+    "ID" SERIAL PRIMARY KEY,
+    "品目コード" VARCHAR(20) NOT NULL,
+    "適用開始日" DATE NOT NULL,
+    "適用終了日" DATE,
+    "標準材料費" DECIMAL(15, 2) NOT NULL,
+    "標準労務費" DECIMAL(15, 2) NOT NULL,
+    "標準経費" DECIMAL(15, 2) NOT NULL,
+    "標準製造原価" DECIMAL(15, 2) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "UK_標準原価_品目_適用開始日" UNIQUE ("品目コード", "適用開始日"),
+    CONSTRAINT "FK_標準原価_品目" FOREIGN KEY ("品目コード")
+        REFERENCES "品目マスタ"("品目コード")
+);
+COMMENT ON TABLE "標準原価マスタ" IS '標準原価マスタ';
+COMMENT ON COLUMN "標準原価マスタ"."標準材料費" IS '標準材料費（単位あたり）';
+COMMENT ON COLUMN "標準原価マスタ"."標準労務費" IS '標準労務費（単位あたり）';
+COMMENT ON COLUMN "標準原価マスタ"."標準経費" IS '標準経費（単位あたり）';
+COMMENT ON COLUMN "標準原価マスタ"."標準製造原価" IS '標準製造原価（単位あたり）= 材料費 + 労務費 + 経費';
+-- 実際原価データ
+CREATE TABLE "実際原価データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "作業指示番号" VARCHAR(20) NOT NULL,
+    "品目コード" VARCHAR(20) NOT NULL,
+    "完成数量" DECIMAL(15, 2) NOT NULL,
+    "実際材料費" DECIMAL(15, 2) NOT NULL,
+    "実際労務費" DECIMAL(15, 2) NOT NULL,
+    "実際経費" DECIMAL(15, 2) NOT NULL,
+    "実際製造原価" DECIMAL(15, 2) NOT NULL,
+    "単位原価" DECIMAL(15, 4) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "UK_実際原価_作業指示" UNIQUE ("作業指示番号"),
+    CONSTRAINT "FK_実際原価_作業指示" FOREIGN KEY ("作業指示番号")
+        REFERENCES "作業指示データ"("作業指示番号"),
+    CONSTRAINT "FK_実際原価_品目" FOREIGN KEY ("品目コード")
+        REFERENCES "品目マスタ"("品目コード")
+);
+COMMENT ON TABLE "実際原価データ" IS '実際原価データ';
+COMMENT ON COLUMN "実際原価データ"."単位原価" IS '実際製造原価 ÷ 完成数量';
+-- 原価差異データ
+CREATE TABLE "原価差異データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "作業指示番号" VARCHAR(20) NOT NULL,
+    "品目コード" VARCHAR(20) NOT NULL,
+    "材料費差異" DECIMAL(15, 2) NOT NULL,
+    "労務費差異" DECIMAL(15, 2) NOT NULL,
+    "経費差異" DECIMAL(15, 2) NOT NULL,
+    "総差異" DECIMAL(15, 2) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "UK_原価差異_作業指示" UNIQUE ("作業指示番号"),
+    CONSTRAINT "FK_原価差異_作業指示" FOREIGN KEY ("作業指示番号")
+        REFERENCES "作業指示データ"("作業指示番号"),
+    CONSTRAINT "FK_原価差異_品目" FOREIGN KEY ("品目コード")
+        REFERENCES "品目マスタ"("品目コード")
+);
+COMMENT ON TABLE "原価差異データ" IS '原価差異データ';
+COMMENT ON COLUMN "原価差異データ"."材料費差異" IS '実際材料費 - 標準材料費 × 完成数量';
+COMMENT ON COLUMN "原価差異データ"."労務費差異" IS '実際労務費 - 標準労務費 × 完成数量';
+COMMENT ON COLUMN "原価差異データ"."経費差異" IS '実際経費 - 標準経費 × 完成数量';
+COMMENT ON COLUMN "原価差異データ"."総差異" IS '材料費差異 + 労務費差異 + 経費差異';
+-- インデックス
+CREATE INDEX "IDX_標準原価_品目" ON "標準原価マスタ" ("品目コード");
+CREATE INDEX "IDX_実際原価_作業指示" ON "実際原価データ" ("作業指示番号");
+CREATE INDEX "IDX_原価差異_作業指示" ON "原価差異データ" ("作業指示番号");
+```
+</details>
+#### 原価計算サービス
+<details>
+<summary>CostCalculationService.java</summary>
+```java
+// src/main/java/com/example/sms/application/service/cost/CostCalculationService.java
+package com.example.pms.application.service.cost;
+import com.example.pms.domain.model.cost.*;
+import com.example.pms.infrastructure.out.persistence.mapper.*;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDate;
+/**
+ * 原価計算サービス
+ */
+@Service
+@RequiredArgsConstructor
+public class CostCalculationService {
+    private final CostMapper costMapper;
+    private final MaterialConsumptionMapper materialConsumptionMapper;
+    private final LaborHoursMapper laborHoursMapper;
+    private final OverheadMapper overheadMapper;
+    private final WorkOrderMapper workOrderMapper;
+    /**
+     * 実際原価を計算する
+     *
+     * @param workOrderNumber 作業指示番号
+     * @return 実際原価データ
+     */
+    @Transactional
+    public ActualCost calculateActualCost(String workOrderNumber) {
+        // 1. 材料費の計算: 直接材料費を集計
+        BigDecimal materialCost = calculateMaterialCost(workOrderNumber);
+        // 2. 労務費の計算: 直接労務費を集計
+        BigDecimal laborCost = calculateLaborCost(workOrderNumber);
+        // 3. 経費の計算: 製造間接費配賦額を集計
+        BigDecimal expense = calculateExpense(workOrderNumber);
+        // 4. 完成数量の取得
+        BigDecimal completedQuantity = getCompletedQuantity(workOrderNumber);
+        // 5. 製造原価・単位原価の計算
+        BigDecimal totalCost = materialCost.add(laborCost).add(expense);
+        BigDecimal unitCost = completedQuantity.compareTo(BigDecimal.ZERO) > 0
+                ? totalCost.divide(completedQuantity, 4, RoundingMode.HALF_UP)
+                : BigDecimal.ZERO;
+        // 6. 実際原価データを保存
+        ActualCost actualCost = ActualCost.builder()
+                .workOrderNumber(workOrderNumber)
+                .itemCode(getItemCode(workOrderNumber))
+                .completedQuantity(completedQuantity)
+                .actualMaterialCost(materialCost)
+                .actualLaborCost(laborCost)
+                .actualExpense(expense)
+                .actualManufacturingCost(totalCost)
+                .unitCost(unitCost)
+                .build();
+        costMapper.insertActualCost(actualCost);
+        return actualCost;
+    }
+    /**
+     * 原価差異を分析する
+     *
+     * @param workOrderNumber 作業指示番号
+     * @return 原価差異データ
+     */
+    @Transactional
+    public CostVariance analyzeCostVariance(String workOrderNumber) {
+        ActualCost actualCost = costMapper.findActualCostByWorkOrderNumber(workOrderNumber);
+        StandardCost standardCost = costMapper.findStandardCostByItemCode(
+                actualCost.getItemCode(), LocalDate.now());
+        // 標準原価総額（単位原価 × 完成数量）
+        BigDecimal standardTotal = standardCost.getStandardManufacturingCost()
+                .multiply(actualCost.getCompletedQuantity());
+        // 材料費差異
+        BigDecimal materialVariance = actualCost.getActualMaterialCost()
+                .subtract(standardCost.getStandardMaterialCost()
+                        .multiply(actualCost.getCompletedQuantity()));
+        // 労務費差異
+        BigDecimal laborVariance = actualCost.getActualLaborCost()
+                .subtract(standardCost.getStandardLaborCost()
+                        .multiply(actualCost.getCompletedQuantity()));
+        // 経費差異
+        BigDecimal expenseVariance = actualCost.getActualExpense()
+                .subtract(standardCost.getStandardExpense()
+                        .multiply(actualCost.getCompletedQuantity()));
+        // 総差異
+        BigDecimal totalVariance = actualCost.getActualManufacturingCost()
+                .subtract(standardTotal);
+        CostVariance variance = CostVariance.builder()
+                .workOrderNumber(workOrderNumber)
+                .itemCode(actualCost.getItemCode())
+                .materialCostVariance(materialVariance)
+                .laborCostVariance(laborVariance)
+                .expenseVariance(expenseVariance)
+                .totalVariance(totalVariance)
+                .build();
+        costMapper.insertCostVariance(variance);
+        return variance;
+    }
+    /**
+     * 製造間接費を配賦する
+     *
+     * @param accountingPeriod 会計期間
+     * @param allocationBasis 配賦基準
+     */
+    @Transactional
+    public void allocateOverhead(String accountingPeriod, String allocationBasis) {
+        // 製造間接費総額を取得
+        BigDecimal totalOverhead = overheadMapper.sumOverheadByPeriod(accountingPeriod);
+        // 配賦基準総額を取得（例: 直接作業時間の場合）
+        BigDecimal totalBasis = getTotalAllocationBasis(accountingPeriod, allocationBasis);
+        if (totalBasis.compareTo(BigDecimal.ZERO) == 0) {
+            return;
+        }
+        // 配賦率を計算
+        BigDecimal allocationRate = totalOverhead.divide(totalBasis, 6, RoundingMode.HALF_UP);
+        // 各作業指示に配賦
+        // 実装省略: 各作業指示の配賦基準額を取得し、配賦額を計算して登録
+    }
+    private BigDecimal calculateMaterialCost(String workOrderNumber) {
+        return materialConsumptionMapper.sumDirectMaterialCostByWorkOrderNumber(workOrderNumber);
+    }
+    private BigDecimal calculateLaborCost(String workOrderNumber) {
+        return laborHoursMapper.sumDirectLaborCostByWorkOrderNumber(workOrderNumber);
+    }
+    private BigDecimal calculateExpense(String workOrderNumber) {
+        // 製造間接費配賦額を取得
+        var allocations = overheadMapper.findAllocationByWorkOrderNumber(workOrderNumber);
+        return allocations.stream()
+                .map(OverheadAllocation::getAllocatedAmount)
+                .reduce(BigDecimal.ZERO, BigDecimal::add);
+    }
+    private BigDecimal getCompletedQuantity(String workOrderNumber) {
+        // 作業指示から完成数量を取得
+        return workOrderMapper.getCompletedQuantity(workOrderNumber);
+    }
+    private String getItemCode(String workOrderNumber) {
+        return workOrderMapper.getItemCode(workOrderNumber);
+    }
+    private BigDecimal getTotalAllocationBasis(String accountingPeriod, String allocationBasis) {
+        // 配賦基準に応じて総額を計算
+        // 実装省略
+        return BigDecimal.ZERO;
+    }
+}
+```
+</details>
+### 原価管理の ER 図
+```plantuml
+@startuml
+title 製造原価管理の ER 図
+entity "品目マスタ" as item_master {
+  * 品目コード [PK]
+  --
+  ...
+}
+entity "作業指示データ" as work_order {
+  * 作業指示番号 [PK]
+  --
+  * 品目コード [FK]
+  ...
+}
+entity "材料消費データ" as material_consumption {
+  * ID [PK]
+  --
+  * 作業指示番号 [FK]
+  * 材料コード [FK]
+  * 消費日
+  * 消費数量
+  * 単価
+  * 消費金額
+  * 直接材料フラグ
+}
+entity "賃率マスタ" as wage_rate {
+  * ID [PK]
+  --
+  * 作業者区分コード
+  * 適用開始日
+  * 時間単価
+  * 直接労務フラグ
+}
+entity "工数実績データ" as labor_hours {
+  * ID [PK]
+  --
+  * 作業指示番号 [FK]
+  * 工程コード [FK]
+  * 作業者コード
+  * 作業日
+  * 作業時間
+  * 労務費
+  * 直接労務フラグ
+}
+entity "製造間接費マスタ" as overhead {
+  * ID [PK]
+  --
+  * 会計期間
+  * 費用区分
+  * 金額
+}
+entity "製造間接費配賦データ" as overhead_allocation {
+  * ID [PK]
+  --
+  * 作業指示番号 [FK]
+  * 会計期間
+  * 配賦基準
+  * 配賦率
+  * 配賦金額
+}
+entity "標準原価マスタ" as standard_cost {
+  * ID [PK]
+  --
+  * 品目コード [FK]
+  * 適用開始日
+  * 標準材料費
+  * 標準労務費
+  * 標準経費
+  * 標準製造原価
+}
+entity "実際原価データ" as actual_cost {
+  * ID [PK]
+  --
+  * 作業指示番号 [FK]
+  * 品目コード [FK]
+  * 完成数量
+  * 実際材料費
+  * 実際労務費
+  * 実際経費
+  * 実際製造原価
+  * 単位原価
+}
+entity "原価差異データ" as cost_variance {
+  * ID [PK]
+  --
+  * 作業指示番号 [FK]
+  * 品目コード [FK]
+  * 材料費差異
+  * 労務費差異
+  * 経費差異
+  * 総差異
+}
+item_master ||--o{ standard_cost
+item_master ||--o{ work_order
+work_order ||--o{ material_consumption
+work_order ||--o{ labor_hours
+work_order ||--o{ overhead_allocation
+work_order ||--|| actual_cost
+work_order ||--|| cost_variance
+actual_cost -- standard_cost : 比較
+actual_cost -- cost_variance : 差異分析
+@enduml
+```
+---
+## 30.3 リレーションと楽観ロックの設計
+### MyBatis ネストした ResultMap によるリレーション設定
+製造原価管理では、実際原価データ→材料消費→品目、実際原価データ→工数実績→工程といった関連があります。MyBatis でこれらの関係を効率的に取得するためのリレーション設定を実装します。
+#### 実際原価データのネスト ResultMap（材料消費・工数実績・配賦を含む）
+実装では、nested select 方式を採用しています。これにより、N+1 問題のリスクはありますが、シンプルで保守しやすい構成となっています。
+<details>
+<summary>ActualCostMapper.xml（リレーション設定）</summary>
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<!-- src/main/resources/mapper/ActualCostMapper.xml -->
+<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.ActualCostMapper">
+    <!-- 基本 ResultMap -->
+    <resultMap id="actualCostResultMap" type="com.example.pms.domain.model.cost.ActualCost">
+        <id property="id" column="ID"/>
+        <result property="workOrderNumber" column="作業指示番号"/>
+        <result property="itemCode" column="品目コード"/>
+        <result property="completedQuantity" column="完成数量"/>
+        <result property="actualMaterialCost" column="実際材料費"/>
+        <result property="actualLaborCost" column="実際労務費"/>
+        <result property="actualExpense" column="実際経費"/>
+        <result property="actualManufacturingCost" column="実際製造原価"/>
+        <result property="unitCost" column="単位原価"/>
+        <result property="version" column="バージョン"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <!-- リレーション付き ResultMap（nested select 方式） -->
+    <resultMap id="actualCostWithRelationsResultMap" type="com.example.pms.domain.model.cost.ActualCost">
+        <id property="id" column="ID"/>
+        <result property="workOrderNumber" column="作業指示番号"/>
+        <result property="itemCode" column="品目コード"/>
+        <result property="completedQuantity" column="完成数量"/>
+        <result property="actualMaterialCost" column="実際材料費"/>
+        <result property="actualLaborCost" column="実際労務費"/>
+        <result property="actualExpense" column="実際経費"/>
+        <result property="actualManufacturingCost" column="実際製造原価"/>
+        <result property="unitCost" column="単位原価"/>
+        <result property="version" column="バージョン"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+        <!-- 材料消費との 1:N 関連（nested select） -->
+        <collection property="materialConsumptions"
+                    column="作業指示番号"
+                    select="com.example.pms.infrastructure.out.persistence.mapper.MaterialConsumptionMapper.findByWorkOrderNumber"/>
+        <!-- 工数実績との 1:N 関連（nested select） -->
+        <collection property="laborHours"
+                    column="作業指示番号"
+                    select="com.example.pms.infrastructure.out.persistence.mapper.LaborHoursMapper.findByWorkOrderNumber"/>
+        <!-- 製造間接費配賦との 1:N 関連（nested select） -->
+        <collection property="overheadAllocations"
+                    column="作業指示番号"
+                    select="com.example.pms.infrastructure.out.persistence.mapper.OverheadAllocationMapper.findByWorkOrderNumber"/>
+    </resultMap>
+    <!-- 基本検索 -->
+    <select id="findById" resultMap="actualCostResultMap">
+        SELECT * FROM "実際原価データ" WHERE "ID" = #{id}
+    </select>
+    <select id="findByWorkOrderNumber" resultMap="actualCostResultMap">
+        SELECT * FROM "実際原価データ" WHERE "作業指示番号" = #{workOrderNumber}
+    </select>
+    <!-- リレーション付き検索 -->
+    <select id="findByWorkOrderNumberWithRelations" resultMap="actualCostWithRelationsResultMap">
+        SELECT * FROM "実際原価データ" WHERE "作業指示番号" = #{workOrderNumber}
+    </select>
+    <select id="findAll" resultMap="actualCostResultMap">
+        SELECT * FROM "実際原価データ" ORDER BY "作業指示番号"
+    </select>
+    <!-- INSERT/UPDATE/DELETE は省略（楽観ロック対応セクション参照） -->
+</mapper>
+```
+</details>
+#### 標準原価と実際原価の比較ビュー ResultMap
+<details>
+<summary>CostComparisonMapper.xml（原価比較用）</summary>
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<!-- src/main/resources/mapper/CostComparisonMapper.xml -->
+<mapper namespace="com.example.pms.infrastructure.out.persistence.mapper.CostComparisonMapper">
+    <!-- 原価比較 ResultMap（標準原価・実際原価・差異を含む） -->
+    <resultMap id="costComparisonResultMap" type="com.example.pms.domain.model.cost.CostComparison">
+        <id property="workOrderNumber" column="作業指示番号"/>
+        <result property="itemCode" column="品目コード"/>
+        <result property="itemName" column="品目名"/>
+        <result property="completedQuantity" column="完成数量"/>
+        <!-- 標準原価 -->
+        <result property="standardMaterialCost" column="標準材料費"/>
+        <result property="standardLaborCost" column="標準労務費"/>
+        <result property="standardExpense" column="標準経費"/>
+        <result property="standardTotalCost" column="標準製造原価"/>
+        <!-- 実際原価 -->
+        <result property="actualMaterialCost" column="実際材料費"/>
+        <result property="actualLaborCost" column="実際労務費"/>
+        <result property="actualExpense" column="実際経費"/>
+        <result property="actualTotalCost" column="実際製造原価"/>
+        <!-- 差異 -->
+        <result property="materialVariance" column="材料費差異"/>
+        <result property="laborVariance" column="労務費差異"/>
+        <result property="expenseVariance" column="経費差異"/>
+        <result property="totalVariance" column="総差異"/>
+    </resultMap>
+    <!-- 原価比較クエリ -->
+    <select id="findCostComparisonByWorkOrderNumber" resultMap="costComparisonResultMap">
+        SELECT
+            ac."作業指示番号",
+            ac."品目コード",
+            i."品目名",
+            ac."完成数量",
+            sc."標準材料費" * ac."完成数量" AS 標準材料費,
+            sc."標準労務費" * ac."完成数量" AS 標準労務費,
+            sc."標準経費" * ac."完成数量" AS 標準経費,
+            sc."標準製造原価" * ac."完成数量" AS 標準製造原価,
+            ac."実際材料費",
+            ac."実際労務費",
+            ac."実際経費",
+            ac."実際製造原価",
+            cv."材料費差異",
+            cv."労務費差異",
+            cv."経費差異",
+            cv."総差異"
+        FROM "実際原価データ" ac
+        LEFT JOIN "品目マスタ" i ON ac."品目コード" = i."品目コード"
+        LEFT JOIN "標準原価マスタ" sc ON ac."品目コード" = sc."品目コード"
+            AND sc."適用開始日" &lt;= CURRENT_DATE
+            AND (sc."適用終了日" IS NULL OR sc."適用終了日" >= CURRENT_DATE)
+        LEFT JOIN "原価差異データ" cv ON ac."作業指示番号" = cv."作業指示番号"
+        WHERE ac."作業指示番号" = #{workOrderNumber}
+    </select>
+</mapper>
+```
+</details>
+#### リレーション設定のポイント
+| 設定項目 | 説明 |
+|---------|------|
+| `<collection>` + `select` | 1:N 関連の nested select 方式（実際原価→材料消費、実際原価→工数実績、実際原価→配賦） |
+| `column` 属性 | nested select に渡すパラメータ（作業指示番号を子クエリに渡す） |
+| 原価明細の集約 | 材料消費・工数実績・配賦を実際原価に紐付けて取得 |
+| シンプルな構成 | JOIN を使用しないため、クエリが単純で保守しやすい |
+### 楽観ロックの実装
+製造原価管理では、原価計算の再実行や標準原価の改定時に、データの整合性を保つために楽観ロックを実装します。
+#### Flyway マイグレーション: バージョンカラム追加
+<details>
+<summary>V013__cost_management_tables.sql（バージョンカラムは各テーブル作成時に含まれています）</summary>
+```sql
+-- V013__cost_management_tables.sql（バージョンカラムは各テーブル作成時に含まれています）
+-- 注: 実装ではテーブル作成時にバージョンカラムを追加済み
+-- 実際原価データテーブルにバージョンカラムを追加
+ALTER TABLE "実際原価データ" ADD COLUMN "バージョン" INTEGER DEFAULT 1 NOT NULL;
+-- 標準原価マスタテーブルにバージョンカラムを追加
+ALTER TABLE "標準原価マスタ" ADD COLUMN "バージョン" INTEGER DEFAULT 1 NOT NULL;
+-- 材料消費データテーブルにバージョンカラムを追加
+ALTER TABLE "材料消費データ" ADD COLUMN "バージョン" INTEGER DEFAULT 1 NOT NULL;
+-- コメント追加
+COMMENT ON COLUMN "実際原価データ"."バージョン" IS '楽観ロック用バージョン番号';
+COMMENT ON COLUMN "標準原価マスタ"."バージョン" IS '楽観ロック用バージョン番号';
+COMMENT ON COLUMN "材料消費データ"."バージョン" IS '楽観ロック用バージョン番号';
+```
+</details>
+#### エンティティへのバージョンフィールド追加
+<details>
+<summary>ActualCost.java（バージョンフィールド追加）</summary>
+```java
+// src/main/java/com/example/pms/domain/model/cost/ActualCost.java
+package com.example.pms.domain.model.cost;
+import com.example.pms.domain.model.process.LaborHours;
+import lombok.*;
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+/**
+ * 実際原価データエンティティ.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ActualCost {
+    private Integer id;
+    private String workOrderNumber;
+    private String itemCode;
+    private BigDecimal completedQuantity;
+    private BigDecimal actualMaterialCost;
+    private BigDecimal actualLaborCost;
+    private BigDecimal actualExpense;
+    private BigDecimal actualManufacturingCost;
+    private BigDecimal unitCost;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+    // 楽観ロック用バージョン
+    @Builder.Default
+    private Integer version = 1;
+    // リレーション
+    @Builder.Default
+    private List<MaterialConsumption> materialConsumptions = new ArrayList<>();
+    @Builder.Default
+    private List<LaborHours> laborHours = new ArrayList<>();
+    @Builder.Default
+    private List<OverheadAllocation> overheadAllocations = new ArrayList<>();
+    /**
+     * 実際製造原価を計算.
+     */
+    public BigDecimal calculateActualManufacturingCost() {
+        return actualMaterialCost.add(actualLaborCost).add(actualExpense);
+    }
+    /**
+     * 単位原価を計算.
+     */
+    public BigDecimal calculateUnitCost() {
+        if (completedQuantity == null || completedQuantity.compareTo(BigDecimal.ZERO) == 0) {
+            return BigDecimal.ZERO;
+        }
+        return actualManufacturingCost.divide(completedQuantity, 4, RoundingMode.HALF_UP);
+    }
+    /**
+     * 原価再計算が必要かチェック.
+     */
+    public boolean needsRecalculation(BigDecimal newMaterialCost,
+                                      BigDecimal newLaborCost,
+                                      BigDecimal newExpense) {
+        return !actualMaterialCost.equals(newMaterialCost)
+            || !actualLaborCost.equals(newLaborCost)
+            || !actualExpense.equals(newExpense);
+    }
+}
+```
+</details>
+#### MyBatis Mapper: 楽観ロック対応の更新
+原価データの再計算時に楽観ロックを適用します。
+<details>
+<summary>ActualCostMapper.xml（楽観ロック対応 UPDATE）</summary>
+```xml
+<!-- 実際原価更新（楽観ロック対応） -->
+<update id="update">
+    UPDATE "実際原価データ"
+    SET "完成数量" = #{completedQuantity},
+        "実際材料費" = #{actualMaterialCost},
+        "実際労務費" = #{actualLaborCost},
+        "実際経費" = #{actualExpense},
+        "実際製造原価" = #{actualManufacturingCost},
+        "単位原価" = #{unitCost},
+        "更新日時" = CURRENT_TIMESTAMP,
+        "バージョン" = "バージョン" + 1
+    WHERE "作業指示番号" = #{workOrderNumber}
+      AND "バージョン" = #{version}
+</update>
+<!-- 原価再計算による更新（楽観ロック + 完成数量チェック） -->
+<update id="recalculateWithOptimisticLock">
+    UPDATE "実際原価データ"
+    SET "実際材料費" = #{actualMaterialCost},
+        "実際労務費" = #{actualLaborCost},
+        "実際経費" = #{actualExpense},
+        "実際製造原価" = #{actualMaterialCost} + #{actualLaborCost} + #{actualExpense},
+        "単位原価" = CASE
+            WHEN "完成数量" > 0
+            THEN (#{actualMaterialCost} + #{actualLaborCost} + #{actualExpense}) / "完成数量"
+            ELSE 0
+        END,
+        "更新日時" = CURRENT_TIMESTAMP,
+        "バージョン" = "バージョン" + 1
+    WHERE "作業指示番号" = #{workOrderNumber}
+      AND "バージョン" = #{version}
+</update>
+<!-- バージョン取得 -->
+<select id="findVersionByWorkOrderNumber" resultType="java.lang.Integer">
+    SELECT "バージョン" FROM "実際原価データ"
+    WHERE "作業指示番号" = #{workOrderNumber}
+</select>
+```
+</details>
+#### Repository 実装: 楽観ロック対応
+<details>
+<summary>ActualCostRepositoryImpl.java（楽観ロック対応）</summary>
+```java
+// src/main/java/com/example/pms/infrastructure/out/persistence/repository/ActualCostRepositoryImpl.java
+package com.example.pms.infrastructure.out.persistence.repository;
+import com.example.pms.application.port.out.ActualCostRepository;
+import com.example.pms.domain.model.cost.ActualCost;
+import com.example.pms.infrastructure.out.persistence.mapper.ActualCostMapper;
+import org.springframework.stereotype.Repository;
+import java.math.BigDecimal;
+import java.util.List;
+import java.util.Optional;
+/**
+ * 実際原価データリポジトリ実装.
+ */
+@Repository
+public class ActualCostRepositoryImpl implements ActualCostRepository {
+    private final ActualCostMapper mapper;
+    public ActualCostRepositoryImpl(ActualCostMapper mapper) {
+        this.mapper = mapper;
+    }
+    @Override
+    public void save(ActualCost actualCost) {
+        mapper.insert(actualCost);
+    }
+    @Override
+    public int update(ActualCost actualCost) {
+        return mapper.update(actualCost);
+    }
+    @Override
+    public int recalculate(String workOrderNumber, Integer version,
+                           BigDecimal actualMaterialCost, BigDecimal actualLaborCost, BigDecimal actualExpense) {
+        return mapper.recalculateWithOptimisticLock(
+                workOrderNumber, version, actualMaterialCost, actualLaborCost, actualExpense);
+    }
+    @Override
+    public Optional<Integer> findVersionByWorkOrderNumber(String workOrderNumber) {
+        return Optional.ofNullable(mapper.findVersionByWorkOrderNumber(workOrderNumber));
+    }
+    @Override
+    public Optional<ActualCost> findById(Integer id) {
+        return Optional.ofNullable(mapper.findById(id));
+    }
+    @Override
+    public Optional<ActualCost> findByWorkOrderNumber(String workOrderNumber) {
+        return Optional.ofNullable(mapper.findByWorkOrderNumber(workOrderNumber));
+    }
+    @Override
+    public Optional<ActualCost> findByWorkOrderNumberWithRelations(String workOrderNumber) {
+        return Optional.ofNullable(mapper.findByWorkOrderNumberWithRelations(workOrderNumber));
+    }
+    @Override
+    public List<ActualCost> findAll() {
+        return mapper.findAll();
+    }
+    @Override
+    public void deleteByWorkOrderNumber(String workOrderNumber) {
+        mapper.deleteByWorkOrderNumber(workOrderNumber);
+    }
+    @Override
+    public void deleteAll() {
+        mapper.deleteAll();
+    }
+}
+```
+</details>
+#### TDD: 楽観ロックのテスト
+<details>
+<summary>ActualCostRepositoryOptimisticLockTest.java</summary>
+```java
+// src/test/java/com/example/pms/infrastructure/out/persistence/repository/ActualCostRepositoryImplTest.java
+package com.example.pms.infrastructure.out.persistence.repository;
+import com.example.pms.application.port.out.ActualCostRepository;
+import com.example.pms.domain.model.cost.ActualCost;
+import com.example.pms.testsetup.BaseIntegrationTest;
+import org.junit.jupiter.api.*;
+import org.springframework.beans.factory.annotation.Autowired;
+import java.math.BigDecimal;
+import static org.assertj.core.api.Assertions.*;
+@DisplayName("実際原価リポジトリ - 楽観ロック")
+class ActualCostRepositoryOptimisticLockTest extends BaseIntegrationTest {
+    @Autowired
+    private ActualCostRepository actualCostRepository;
+    @BeforeEach
+    void setUp() {
+        // テストデータのセットアップ
+    }
+    @Nested
+    @DisplayName("原価更新の楽観ロック")
+    class CostUpdateOptimisticLocking {
+        @Test
+        @DisplayName("同じバージョンで原価を更新できる")
+        void canUpdateCostWithSameVersion() {
+            // Arrange
+            ActualCost cost = createTestActualCost("WO-TEST-001");
+            Integer initialVersion = cost.getVersion();
+            cost.setActualMaterialCost(new BigDecimal("15000"));
+            cost.setActualLaborCost(new BigDecimal("8000"));
+            cost.setActualExpense(new BigDecimal("3000"));
+            cost.setActualManufacturingCost(new BigDecimal("26000"));
+            cost.setUnitCost(new BigDecimal("260"));
+            // Act
+            actualCostRepository.update(cost);
+            // Assert
+            var updated = actualCostRepository.findFullByWorkOrderNumber("WO-TEST-001").get();
+            assertThat(updated.getActualMaterialCost()).isEqualByComparingTo(new BigDecimal("15000"));
+            assertThat(updated.getActualManufacturingCost()).isEqualByComparingTo(new BigDecimal("26000"));
+            assertThat(updated.getVersion()).isEqualTo(initialVersion + 1);
+        }
+        @Test
+        @DisplayName("異なるバージョンで更新すると楽観ロック例外が発生する")
+        void throwsExceptionWhenVersionMismatch() {
+            // Arrange
+            ActualCost cost = createTestActualCost("WO-TEST-002");
+            Integer initialVersion = cost.getVersion();
+            // 経理担当者Aが原価を更新（成功）
+            cost.setActualMaterialCost(new BigDecimal("15000"));
+            cost.setActualManufacturingCost(new BigDecimal("25000"));
+            cost.setUnitCost(new BigDecimal("250"));
+            actualCostRepository.update(cost);
+            // Act & Assert: 経理担当者Bが古いバージョンで更新（失敗）
+            cost.setVersion(initialVersion); // 古いバージョンに戻す
+            cost.setActualMaterialCost(new BigDecimal("16000"));
+            // 古いバージョンで更新すると 0 rows が返される
+            int result = actualCostRepository.update(cost);
+            assertThat(result).isEqualTo(0);
+        }
+    }
+    @Nested
+    @DisplayName("原価再計算の楽観ロック")
+    class RecalculateOptimisticLocking {
+        @Test
+        @DisplayName("原価を再計算できる")
+        void canRecalculateCost() {
+            // Arrange
+            ActualCost cost = createTestActualCost("WO-TEST-003");
+            // Act
+            actualCostRepository.recalculate(
+                    cost.getWorkOrderNumber(),
+                    cost.getVersion(),
+                    new BigDecimal("12000"),
+                    new BigDecimal("6000"),
+                    new BigDecimal("2000"));
+            // Assert
+            var updated = actualCostRepository.findFullByWorkOrderNumber("WO-TEST-003").get();
+            assertThat(updated.getActualMaterialCost()).isEqualByComparingTo(new BigDecimal("12000"));
+            assertThat(updated.getActualLaborCost()).isEqualByComparingTo(new BigDecimal("6000"));
+            assertThat(updated.getActualExpense()).isEqualByComparingTo(new BigDecimal("2000"));
+            assertThat(updated.getActualManufacturingCost()).isEqualByComparingTo(new BigDecimal("20000"));
+        }
+        @Test
+        @DisplayName("古いバージョンで再計算すると失敗する")
+        void recalculateFailsWithOldVersion() {
+            // Arrange
+            ActualCost cost = createTestActualCost("WO-TEST-004");
+            actualCostRepository.save(cost);
+            // 先に更新してバージョンを上げる
+            ActualCost toUpdate = actualCostRepository.findByWorkOrderNumber("WO-TEST-004").get();
+            toUpdate.setActualMaterialCost(new BigDecimal("55000"));
+            actualCostRepository.update(toUpdate);
+            // Act: 古いバージョンで再計算
+            int result = actualCostRepository.recalculate(
+                    "WO-TEST-004",
+                    1, // 古いバージョン
+                    new BigDecimal("60000"),
+                    new BigDecimal("40000"),
+                    new BigDecimal("30000"));
+            // Assert
+            assertThat(result).isEqualTo(0);
+        }
+    }
+    private ActualCost createTestActualCost(String workOrderNumber) {
+        return ActualCost.builder()
+                .workOrderNumber(workOrderNumber)
+                .itemCode("PROD-001")
+                .completedQuantity(new BigDecimal("100"))
+                .actualMaterialCost(new BigDecimal("10000"))
+                .actualLaborCost(new BigDecimal("5000"))
+                .actualExpense(new BigDecimal("2000"))
+                .actualManufacturingCost(new BigDecimal("17000"))
+                .unitCost(new BigDecimal("170"))
+                .build();
+    }
+}
+```
+</details>
+### 原価再計算処理のシーケンス図
+原価再計算では、材料消費や工数実績の追加・修正後に実際原価を更新します。
+```plantuml
+@startuml
+title 原価再計算処理シーケンス（楽観ロック対応）
+actor 経理担当者A
+actor 経理担当者B
+participant "CostCalculationService" as Service
+participant "ActualCostRepository" as Repo
+database "実際原価データ" as CostTable
+== 同時原価再計算シナリオ ==
+経理担当者A -> Service: 原価再計算(WO-001)
+activate Service
+Service -> Repo: findFullByWorkOrderNumber(WO-001)
+Repo -> CostTable: SELECT
+CostTable --> Repo: 実際原価(version=1)
+Repo --> Service: 実際原価(version=1)
+Service -> Service: 材料費・労務費・経費を再集計
+経理担当者B -> Service: 原価再計算(WO-001)
+activate Service
+Service -> Repo: findFullByWorkOrderNumber(WO-001)
+Repo -> CostTable: SELECT
+CostTable --> Repo: 実際原価(version=1)
+Repo --> Service: 実際原価(version=1)
+Service -> Service: 材料費・労務費・経費を再集計
+note over 経理担当者A,CostTable: 経理担当者Aが先に更新
+Service -> Repo: recalculate(version=1, 材料費=15000)
+Repo -> CostTable: UPDATE SET 実際材料費=15000, バージョン += 1\nWHERE バージョン = 1
+CostTable --> Repo: 1 row updated
+Repo --> Service: 成功
+Service --> 経理担当者A: 再計算完了
+deactivate Service
+note over 経理担当者A,CostTable: 経理担当者Bの更新（楽観ロック失敗）
+Service -> Repo: recalculate(version=1, 材料費=16000)
+Repo -> CostTable: UPDATE SET 実際材料費=16000, バージョン += 1\nWHERE バージョン = 1
+CostTable --> Repo: 0 rows updated
+Repo -> CostTable: SELECT バージョン
+CostTable --> Repo: version=2
+Repo --> Service: OptimisticLockException
+Service --> 経理担当者B: エラー: 他の担当者が更新済み
+deactivate Service
+note over 経理担当者B: 担当者Bはリトライ
+経理担当者B -> Service: 原価再計算(WO-001)
+activate Service
+Service -> Repo: findFullByWorkOrderNumber(WO-001)
+Repo -> CostTable: SELECT
+CostTable --> Repo: 実際原価(version=2, 材料費=15000)
+Repo --> Service: 実際原価(version=2)
+Service -> Service: 最新データで再集計
+Service -> Repo: recalculate(version=2, 材料費=15500)
+Repo -> CostTable: UPDATE SET 実際材料費=15500, バージョン += 1\nWHERE バージョン = 2
+CostTable --> Repo: 1 row updated
+Repo --> Service: 成功
+Service --> 経理担当者B: 再計算完了
+deactivate Service
+@enduml
+```
+### 製造原価管理向け楽観ロックのベストプラクティス
+| ポイント | 説明 |
+|---------|------|
+| **確定状態チェック** | 原価差異分析済みの場合は再計算を禁止 |
+| **計算の一貫性** | 材料費・労務費・経費の合計と製造原価の整合性を UPDATE 内で保証 |
+| **単位原価の自動計算** | 完成数量による除算を SQL 内で実行し、0 除算を回避 |
+| **監査証跡** | 原価変更履歴を別テーブルに記録することを検討 |
+| **期間締め処理** | 月次締め後は当該期間の原価データを更新不可に |
+| **差異分析のタイミング** | 原価確定後に差異分析を実行し、確定状態を管理 |
+---
+## 30.4 まとめ
+本章では、製造原価管理の設計について解説しました。
+### 設計のポイント
+1. **原価要素の体系的な管理**
+   - 直接費（材料費、労務費、経費）と間接費の分離
+   - 各原価要素のトレーサビリティ確保
+2. **標準原価と実際原価の対比**
+   - 標準原価マスタによる目標原価の設定
+   - 実際原価データによる実績の把握
+   - 原価差異分析による改善活動の支援
+3. **製造間接費の配賦**
+   - 配賦基準（直接作業時間、機械稼働時間など）の設定
+   - 配賦率の計算と各製品への配分
+4. **原価計算サービス**
+   - 材料費、労務費、製造間接費の集計
+   - 製造原価・単位原価の計算
+   - 原価差異分析の自動化
+### 次章への橋渡し
+次章では、E 社事例を通じて生産管理システムの具体的なデータ設計を解説します。精密機械部品製造業における実践的なデータ構造とシードデータの実装を取り上げます。
+---
+[← 第29章：品質管理の設計](chapter29.md) | [第31章：生産管理データ設計（E社事例） →](chapter31.md)