+ ラベルバリエーション対応プレイブック
+ 現場のラベルに新しい書式（カード番号の型、品番の桁数、Code 128 の区切り、新しい仕向地など）が現れたときに、何が起きるか・どう切り分けるか・どう直すかをまとめる。2026-09-08 の障害（#129）を教訓として書いた。顧客向けのデータ仕様書（docs/qr-barcode-spec-analysis.html、git-ignored）とは別に、リポジトリに残す運用文書である。
+
+
+ 1. 何が起きたか（2026-09-08）
+ TestFlight 1.0 (6)/(8) を配った直後、現場から「以前の QR と Code 128 が読めず照合できない」と報告があった。照合ログ（設定 → 照合ログの共有）には、カメラで読んだ澤井製作所の QR が rejected / invalid_format で4回続けて弾かれた記録が残っていた。
+
+ 「デンソー対応ビルドから壊れた」ように見えたのは、厳格化（#46 / #75 / #78 / #93）が build 4（2026-09-06）で入り、build 5・6・8 が短期間に続いたため、現場が最初に触った厳格ビルドがたまたまデンソー対応版だったからである。
+
+
+
+ 2. 根本原因
+
+ - サンプルへの過学習。2026-08-17 時点で手元にあった12組（カード番号は
DCLP / DAYA / DAAL＋6桁）から「英字4＋数字6」「品目番号は10桁」と定め、それを受理条件として固定した。12組は同じ工場・同じ時期の連続したラベルで、書式の全体像を代表していなかった。
+ - 吸収していた緩さを、別の目的で取り除いた。もともとカメラの QR は内容検証をせず、照合も「QR 全文の正規化文字列にバーコードの品番が含まれるか」という部分一致で成立していた。逆順入力や無関係な QR を弾くために内容検証を加え（#46 / #75 / #78）、部分一致フォールバックを撤去した（#93）ことで、正規表現の狭さがそのまま拒否になった。個々の変更は正しいが、合わせると「実データより狭い規則が唯一の判定」になった。
+ - テストが思い込みを固定した。モルテン対応で 4-2-3 を追加したとき、「4-2-3 はモルテンだけ、澤井製作所では受理しない」というテストを書いた（TEST_PARITY 行77・86）。実データの裏付けがない排他条件をテストで固定すると、後から直す人が「仕様」だと誤解する。
+ - 現場との検証が Code 128 中心だった。Bluetooth 経路の QR 検証は以前から存在したが、現場はカメラ運用だったため問題が隠れていた。TestFlight での検証もフィクスチャの12組で行っていた。
+
+
+
+
+ 3. 現在の受理条件（2026-09-08 以降）
+ iOS ios/CodeMatch/Models/ScanModels.swift と Android android/core/matching/.../CodeMatcher.kt が同じ規則を持つ。正本は docs/PRODUCT_SPEC.md。
+
+ 仕向地の判定はデンソー → 澤井製作所 → モルテン → 空白除去した澤井製作所の順。仕向地未確定のときの Code 128 は3パターンの OR で受理する。
+
+
+
+ 4. 受理条件を決めるときの原則
+
+ - 誤って弾く方が、誤って通すより高くつく。本物のラベルを弾くと生産が止まる。無関係な QR を通しても、その後の照合で「不一致」になるだけで履歴にも件数にも残らない。迷ったら緩い側に倒す。
+ - 構造で判定し、文字種の並びを決め打ちしない。固定長、数量欄が数字、品番欄が英数字、といった「レコードとしての構造」は安定している。「4文字目は必ず英字」のような観察は、サンプルが増えると覆る。
+ - 排他条件（「〜だけで受理」「〜では受理しない」）には実データの裏付けを要求する。裏付けがないなら共通の規則にする。今回の Code 128 は澤井製作所とモルテンで同一パターンになった。
+ - 部分一致フォールバックは復活させない。取り違え（同一シリーズの 52 / 55、9桁と10桁の同一接頭辞）を見逃す。緩めるのは「受理条件」であって「一致条件」ではない。
+ - 受理条件を狭めるときは、必ず現場の照合ログか写真の実測値で全ラベルを流してから。フィクスチャの既存ケースが通るだけでは足りない。
+ - 新しい実データは共通フィクスチャに追加してから規則を変える。写真そのものはリポジトリに置かず、デコード済みの文字列だけを入れる。
+
+ CLAUDE.md にも記した: 今回緩めた規則を12組のサンプルに合わせて狭め直さないこと。
+
+
+
+ 5. 新しいバリエーションが来たときの手順
+ STEP 0現場から証拠を回収する
+
+ - 設定 → 照合ログの共有（JSONL）。
rejected イベントに生の QR / Code 128 と reason（invalid_format / wrong_order / wrong_destination …）が残る。これだけで多くは切り分けられる。
+ - ラベルの写真（QR と Code 128 が同じ写真に写っているもの）。git-ignored の
tmp/ 配下に置き、絶対にコミットしない。
+
+
+ STEP 1写真を一括デコードする
+swiftc -O shared/tools/decode_label_photos.swift -o /tmp/decode_label_photos
+/tmp/decode_label_photos tmp/labels > tmp/decoded.tsv
+grep -c . tmp/decoded.tsv # 1シンボル1行。NONE の写真は全景など
+ Vision の VNDetectBarcodesRequest を使う。末尾空白や CR/LF は [ ] 内にそのまま残るので、桁数（len=）で固定長を確認できる。
+
+ STEP 2現行の照合コアに流し、何がどこで落ちるかを見る
+ios/scripts/verify_label_pairs.sh tmp/decoded.tsv
+ iOS の ScanModels.swift をそのままコンパイルして、写真ごとに仕向地判定・品番抽出・Code 128 の形式検証・照合結果・箱識別子を表にする。末尾の summary で「nil/…（仕向地判定で落ちた）」「…/tag=false/…（Code 128 の形式で落ちた）」を数える。Android は同じ規則をミラーしているので、原因の特定は iOS 側で足りる。
+
+ STEP 3規則を「実データで裏付けられる構造」まで緩める
+
+ - iOS:
KanbanQRRecord.parse / MoltenQRRecord.parse / DensoKanbanRecord.parse、TagBarcodeRecord.isValidScanPayload、Destination.detect。
+ - Android:
KanbanQrRecord / MoltenQrRecord / DensoKanbanQrRecord、TagBarcodeRecord.isValidScanPayload、CodeMatcher.detectDestination。ScanReducer.invalidPayloadReason は桁数の案内だけなので、固定長が変わらなければ触らない。
+ - 表記（
format(partNumber:destination:) / formatPartNumber）と履歴・PDF は品番の桁数から区切りを決めているので、桁数の種類が増えたときだけ見直す。
+ - 変更後に STEP 2 を再実行し、全ペアが
match、guards（X×66、逆順、他仕向地の区切り）が変わっていないことを確認する。
+
+
+ STEP 4共通フィクスチャとテストに固定する
+
+ shared/test-fixtures/matching-cases.json に、日付入りのプレフィックス（例 sawai-2026-09-08-NN-<品番>）でケースを追加する。一致ケースに加え、同一品番の2箱、隣接シリーズの取り違え、桁数違いの同一接頭辞を mismatch として入れる。notes に由来を1項目追加する。- ケース数を固定しているテスト（iOS
CodeMatcherTests.testSharedMatchingFixtures、Android CodeMatcherTest.sharedMatchingFixturesHaveTheSameResultsAsSwift）と docs の「NNケース」を更新する。既存の label- プレフィックスは12組固定なので流用しない。
+ - 新プレフィックス向けに「読取境界を両方通る」テストを iOS / Android の両方に追加し、
docs/android/TEST_PARITY.md に行を足す。
+ - 「〜では受理しない」を固定しているテストがあれば、実データに合わせて反転する。
+
+
+ STEP 5検証してリリースする
+# iOS
+DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild test \
+ -project ios/CodeMatch.xcodeproj -scheme CodeMatch \
+ -destination 'platform=iOS Simulator,name=iPhone 17 Pro'
+# Android
+cd android && ./gradlew lintDebug testDebugUnitTest && ./gradlew :app:assembleRelease \
+ && bash scripts/verify-release-hardening.sh
+
+ - GitHub Issue を起票し（原因・実測値・決定事項）、PR で
docs/PRODUCT_SPEC.md、CLAUDE.md、docs/android/STATUS.md、docs/android/TEST_PARITY.md、顧客向け仕様書（ローカル）を同時に更新する。
+ - iOS はビルド番号を上げて TestFlight へ。Android は release APK を側面ロード。
+ - 配布後、現場の照合ログをもう一度回収し、
rejected / invalid_format が残っていないことを確認して閉じる。
+
+
+
+
+ 6. チェックリスト
+
+ - ☐ 照合ログか写真から、拒否された生ペイロードを得た（推測で直していない）
+ - ☐
verify_label_pairs.sh で「現行」と「修正後」の両方の結果を記録した
+ - ☐ 既存の3仕向地の全ペアと
guards が変わっていない
+ - ☐ 新しい実データを共通フィクスチャに追加した（写真は未コミット）
+ - ☐ 反転・追加したテストを TEST_PARITY に反映した
+ - ☐ PRODUCT_SPEC / CLAUDE.md / STATUS / 顧客向け仕様書を更新した
+ - ☐ iOS 単体・UI テスト、Android lint・JVM テスト、release ゲートが通った
+ - ☐ 配布後に現場の照合ログで
invalid_format が消えたことを確認した
+
+
+
+
+
+
+
diff --git a/ios/CodeMatch.xcodeproj/project.pbxproj b/ios/CodeMatch.xcodeproj/project.pbxproj
index e6bc041..007683e 100644
--- a/ios/CodeMatch.xcodeproj/project.pbxproj
+++ b/ios/CodeMatch.xcodeproj/project.pbxproj
@@ -503,7 +503,7 @@
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
CODE_SIGN_STYLE = Automatic;
- CURRENT_PROJECT_VERSION = 8;
+ CURRENT_PROJECT_VERSION = 9;
DEVELOPMENT_TEAM = NHP8639NK4;
GENERATE_INFOPLIST_FILE = NO;
INFOPLIST_FILE = CodeMatch/Resources/Info.plist;
@@ -532,7 +532,7 @@
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
CODE_SIGN_STYLE = Automatic;
- CURRENT_PROJECT_VERSION = 8;
+ CURRENT_PROJECT_VERSION = 9;
DEVELOPMENT_TEAM = NHP8639NK4;
GENERATE_INFOPLIST_FILE = NO;
INFOPLIST_FILE = CodeMatch/Resources/Info.plist;
diff --git a/ios/CodeMatch/Models/ScanModels.swift b/ios/CodeMatch/Models/ScanModels.swift
index 4427c13..bee74db 100644
--- a/ios/CodeMatch/Models/ScanModels.swift
+++ b/ios/CodeMatch/Models/ScanModels.swift
@@ -99,7 +99,7 @@ enum Destination: String, Codable, CaseIterable, Equatable {
/// QRペイロードの仕向地を判定する。いずれのレコード様式でもない場合は nil。
///
/// デンソーを最初に判定する: `KanbanQRRecord.parse` は寛容(先頭10桁が
- /// `[A-Z]{4}[0-9]{6}`、20桁以上)なので、`JAMA501195…` をカード番号として
+ /// `[A-Z0-9]{4}[0-9]{6}`、20桁以上)なので、`JAMA501195…` をカード番号として
/// 受理してしまう。JAMA自己記述形式として解析できるQRは常にデンソーとする。
static func detect(qrPayload raw: String) -> Destination? {
let payload = stripTransportTerminators(raw)
@@ -138,8 +138,10 @@ extension Destination {
///
/// - 現品票のCode 128: `品番(ハイフン付き)@管理コード` 例: `BCJH-52-81GG@1N5X0C`
/// - 澤井製作所の納品書兼現品票QR: 66桁固定長レコード。先頭からカード番号(10桁)、
-/// 品目番号(10桁・区切りなし)、枝番(2桁・空白の場合あり)、数量などが続く。
-/// 例: `DCLP675300` + `BCJH5281GG` + `02` + …
+/// 品目番号(10桁の欄・区切りなし・9桁品番は左詰めで末尾空白)、枝番(2桁・空白の場合あり)、
+/// 数量などが続く。例: `DCLP675300` + `BCJH5281GG` + `02` + …、
+/// 9桁品番の例: `DAH4093540` + `BCJH5281F ` + ` ` + …
+/// - 現品票のCode 128の品番は10桁品番が4-2-4、9桁品番が4-2-3(例: `BCJH-52-81F@01R95K`)。
/// - モルテンの納品書QR: 61桁固定長レコード。7-16桁が左詰めの部品番号(9桁または10桁)。
///
/// 2つのペイロードは文字列としては一致しないため、双方から品番を抽出して比較する。
@@ -209,8 +211,8 @@ enum CodeMatcher {
/// フィールド位置は docs/PRODUCT_SPEC.md と実データ解析に基づく。
/// もう一方の仕向地モルテン(61桁)は `MoltenQRRecord` が担当する。
struct KanbanQRRecord: Equatable {
- let cardNumber: String // 1-10桁: カード番号
- let partNumber: String // 11-20桁: 品目番号
+ let cardNumber: String // 1-10桁: カード番号(英数4桁のコード + 6桁の連番)
+ let partNumber: String // 11-20桁: 品目番号(9桁または10桁。9桁は左詰めで末尾空白を除去済み)
let partSuffix: String? // 21-22桁: 枝番(空白の場合あり)
let deliveryQuantity: Double? // 23-30桁: 納入数量(×100で記録)
let instructedQuantity: Double? // 31-38桁: 指示数(×100で記録)
@@ -249,14 +251,17 @@ struct KanbanQRRecord: Equatable {
guard
let cardNumber = slice(0..<10),
- cardNumber.range(of: "^[A-Z]{4}[0-9]{6}$", options: .regularExpression) != nil,
- let partNumber = slice(10..<20),
- partNumber.range(of: "^[A-Z0-9]{10}$", options: .regularExpression) != nil
+ // カード番号は英数4桁のコード + 6桁の連番。実データは `DCLP675300` 型と
+ // `DAH4093870` 型の両方があり、4桁目が数字でも受理する(#129)。
+ cardNumber.range(of: "^[A-Z0-9]{4}[0-9]{6}$", options: .regularExpression) != nil,
+ let partField = slice(10..<20),
+ // 品目番号欄は10桁。9桁品番は左詰めで末尾が空白(`BCJH5281F `)。
+ partField.range(of: "^[A-Z0-9]{9}[A-Z0-9 ]$", options: .regularExpression) != nil
else { return nil }
return KanbanQRRecord(
cardNumber: cardNumber,
- partNumber: partNumber,
+ partNumber: partField.trimmingCharacters(in: .whitespaces),
partSuffix: trimmedOrNil(slice(20..<22)),
deliveryQuantity: quantity(slice(22..<30)),
instructedQuantity: quantity(slice(30..<38)),
@@ -569,8 +574,8 @@ struct TagBarcodeRecord: Equatable {
let partNumber: String // ハイフン付き品番
let managementCode: String? // @以降の管理コード
- /// 澤井製作所の現品票: 品番は4-2-4。
- private static let sawaiFormatPattern = "^[A-Z0-9]{4}-[A-Z0-9]{2}-[A-Z0-9]{4}@[A-Z0-9]+$"
+ /// 澤井製作所の現品票: 品番は4-2-4(10桁)または4-2-3(9桁品番、例 `BCJH-52-81F`)。
+ private static let sawaiFormatPattern = "^[A-Z0-9]{4}-[A-Z0-9]{2}-[A-Z0-9]{3,4}@[A-Z0-9]+$"
/// モルテンの現品票: 品番は4-2-3または4-2-4。
private static let moltenFormatPattern = "^[A-Z0-9]{4}-[A-Z0-9]{2}-[A-Z0-9]{3,4}@[A-Z0-9]+$"
/// デンソーの現品票: 品番は6-4。
@@ -578,7 +583,7 @@ struct TagBarcodeRecord: Equatable {
/// 現品票Code 128の業務フォーマット（品番@管理コード）かを確認する。
/// 物理シンボル種別はSDK通知に含まれないため、QR文字列などを次工程で受理しない。
- /// 品番の区切りは澤井製作所が4-2-4、モルテンが4-2-3または4-2-4、デンソーが6-4。
+ /// 品番の区切りは澤井製作所・モルテンが4-2-3または4-2-4、デンソーが6-4。
/// 仕向地が未判定(nil)のときは、どの仕向地でも取りこぼさないよう3つのORで判定する。
static func isValidScanPayload(_ payload: String, destination: Destination?) -> Bool {
let value = payload.trimmingCharacters(in: .whitespacesAndNewlines).uppercased()
diff --git a/ios/CodeMatchTests/BluetoothScannerFlowTests.swift b/ios/CodeMatchTests/BluetoothScannerFlowTests.swift
index fe7f285..d00a5a5 100644
--- a/ios/CodeMatchTests/BluetoothScannerFlowTests.swift
+++ b/ios/CodeMatchTests/BluetoothScannerFlowTests.swift
@@ -935,32 +935,33 @@ final class BluetoothScannerFlowTests: XCTestCase {
XCTAssertEqual(context.store.activeSession?.matchedCount, 0)
}
- func testFourTwoThreeBarcodeIsRejectedInSawaiSession() async {
+ func testFourTwoThreeBarcodeMatchesInSawaiSession() async {
let context = makeContext()
defer { context.cleanup() }
let camera = context.viewModel.camera
+ // 2026-09-08 の現場ラベル（#129）: カード番号は `DAH4` 型、品目番号欄は9桁品番を
+ // 左詰めにした末尾空白、枝番は空白。現品票の品番は4-2-3。
+ let qrPayload = "DAH4093540BCJH5281F 0002000000020000H 000000BHB01LHA28 0*"
+ let barcodePayload = "BCJH-52-81F@01R95K"
+ XCTAssertEqual(qrPayload.count, 66)
- context.viewModel.cameraScanner(camera, didRead: ScannerViewModel.sampleQRPayload, type: .qr)
+ context.viewModel.cameraScanner(camera, didRead: qrPayload, type: .qr)
XCTAssertEqual(context.viewModel.step, .barcode)
XCTAssertEqual(context.viewModel.destination, .sawai)
+ XCTAssertEqual(context.viewModel.qrPartNumber, "BCJH5281F")
try? await Task.sleep(for: .milliseconds(300))
- // 澤井製作所の現品票は品番末尾が4桁固定。モルテンの4-2-3品番は受理しない。
- context.viewModel.cameraScanner(
- camera,
- didRead: ScannerViewModel.sampleMoltenBarcodePayload,
- type: .code128
- )
- context.viewModel.cameraScanner(
- camera,
- didRead: ScannerViewModel.sampleMoltenBarcodePayload,
- type: .code128
- )
-
+ // 4-2-3の現品票も澤井製作所のセッションで受理し、カメラでは同一値2フレームで確定する。
+ context.viewModel.cameraScanner(camera, didRead: barcodePayload, type: .code128)
XCTAssertEqual(context.viewModel.step, .barcode)
XCTAssertTrue(context.viewModel.barcodeValue.isEmpty)
- XCTAssertTrue(context.viewModel.message.contains("Code 128バーコードではありません"))
- XCTAssertEqual(context.store.activeSession?.matchedCount, 0)
+ context.viewModel.cameraScanner(camera, didRead: barcodePayload, type: .code128)
+
+ XCTAssertEqual(context.viewModel.step, .result(.match))
+ XCTAssertEqual(context.viewModel.barcodePartNumber, "BCJH5281F")
+ XCTAssertEqual(CodeMatcher.format(partNumber: "BCJH5281F", destination: context.viewModel.destination), "BCJH-52-81F")
+ XCTAssertEqual(context.store.activeSession?.matchedCount, 1)
+ XCTAssertEqual(context.store.activeSession?.destination, .sawai)
}
func testMoltenQRAtBarcodeStepIsWrongOrder() async {
@@ -1231,7 +1232,7 @@ final class BluetoothScannerFlowTests: XCTestCase {
}
func testSixFourBarcodeIsRejectedInSawaiAndMoltenSessions() async {
- // 澤井製作所は4-2-4、モルテンは4-2-3/4-2-4。デンソーの6-4はどちらでも受理しない。
+ // 澤井製作所・モルテンは4-2-3/4-2-4。デンソーの6-4はどちらでも受理しない。
for (qrPayload, destination) in [
(ScannerViewModel.sampleQRPayload, Destination.sawai),
(ScannerViewModel.sampleMoltenQRPayload, Destination.molten)
diff --git a/ios/CodeMatchTests/CodeMatcherTests.swift b/ios/CodeMatchTests/CodeMatcherTests.swift
index 548db80..999614f 100644
--- a/ios/CodeMatchTests/CodeMatcherTests.swift
+++ b/ios/CodeMatchTests/CodeMatcherTests.swift
@@ -28,6 +28,14 @@ final class CodeMatcherTests: XCTestCase {
private let moltenShortPartQRPayload = "AK6805PAF115422 UAG5560000FA2P5901FEM000012009080000"
private let moltenShortPartBarcodePayload = "PAF1-15-422@0NKD3C"
+ // 2026-09-08 の現場ラベル（仕向地 澤井製作所、#129）。カード番号は `DAH4` + 6桁連番
+ // （英数4桁のコード）で、`DCLP675300` 型と同じ66桁レコード。
+ private let sawaiAlnumCardQRPayload = "DAH4093870BCJH558SHE020001600000016000H 000000BHB01LHA29 0*"
+ private let sawaiAlnumCardBarcodePayload = "BCJH-55-8SHE@02C04G"
+ // 9桁品番: 品目番号欄は左詰め＋末尾空白、枝番欄は空白、現品票は4-2-3。
+ private let sawaiShortPartQRPayload = "DAH4093540BCJH5281F 0002000000020000H 000000BHB01LHA28 0*"
+ private let sawaiShortPartBarcodePayload = "BCJH-52-81F@01R95K"
+
// 仕向地 デンソーの実データ（かんばん 0140・221桁）。
// 項目144・402・515・516の空白の連なりもデータなので、詰めないこと。
private let densoQRPayload =
@@ -82,7 +90,7 @@ final class CodeMatcherTests: XCTestCase {
let fixtures = try loadSharedMatchingFixtures()
XCTAssertEqual(fixtures.schemaVersion, 2)
- XCTAssertEqual(fixtures.cases.count, 47)
+ XCTAssertEqual(fixtures.cases.count, 63)
XCTAssertEqual(
Set(fixtures.cases.map(\.id)).count,
fixtures.cases.count,
@@ -168,6 +176,65 @@ final class CodeMatcherTests: XCTestCase {
XCTAssertEqual(label12?.supplyPointCode, "LAB14")
}
+ /// 2026-09-08 の現場ラベル（sawai-2026-09-08-NN、#129）: カード番号が `DAH4` 型で、
+ /// 9桁品番（4-2-3の現品票）を5品番含む。全てがカメラ・BLE共通の読取境界を通り、
+ /// QRの品目番号と現品票の品番が一致する。
+ func testSharedFieldLabels20260908PassBothScanBoundaries() throws {
+ let pairs = try loadSharedMatchingFixtures().cases.filter {
+ $0.id.hasPrefix("sawai-2026-09-08-") && $0.expected == "match"
+ }
+ XCTAssertEqual(pairs.count, 12)
+
+ var nineCharacterParts = 0
+ for pair in pairs {
+ XCTAssertTrue(KanbanQRRecord.isValidScanPayload(pair.qrPayload), pair.id)
+ XCTAssertTrue(
+ TagBarcodeRecord.isValidScanPayload(pair.barcodePayload, destination: .sawai),
+ pair.id
+ )
+ XCTAssertFalse(MoltenQRRecord.isValidScanPayload(pair.qrPayload), pair.id)
+ XCTAssertEqual(Destination.detect(qrPayload: pair.qrPayload), .sawai, pair.id)
+ let record = KanbanQRRecord.parse(pair.qrPayload)
+ XCTAssertEqual(
+ record?.partNumber,
+ CodeMatcher.partNumber(fromBarcode: pair.barcodePayload),
+ pair.id
+ )
+ // カード番号は英数4桁のコード + 6桁の連番
+ XCTAssertNotNil(
+ record?.cardNumber.range(of: "^[A-Z0-9]{4}[0-9]{6}$", options: .regularExpression),
+ pair.id
+ )
+ XCTAssertTrue(record?.cardNumber.hasPrefix("DAH4") ?? false, pair.id)
+ XCTAssertEqual(record?.factoryCode, "H", pair.id)
+ XCTAssertTrue(record?.partSuffix == nil || record?.partSuffix == "02", pair.id)
+ if record?.partNumber.count == 9 { nineCharacterParts += 1 }
+ }
+ XCTAssertEqual(nineCharacterParts, 5)
+
+ func pair(_ suffix: String) -> SharedMatchingCase? {
+ pairs.first { $0.id == "sawai-2026-09-08-\(suffix)" }
+ }
+ // 9桁品番: 枝番が空白のものと `02` のものの両方がある。
+ let blankSuffix = pair("06-BCJH-52-81F").flatMap { KanbanQRRecord.parse($0.qrPayload) }
+ XCTAssertEqual(blankSuffix?.partNumber, "BCJH5281F")
+ XCTAssertNil(blankSuffix?.partSuffix)
+ let numberedSuffix = pair("07-BEME-55-81F").flatMap { KanbanQRRecord.parse($0.qrPayload) }
+ XCTAssertEqual(numberedSuffix?.partNumber, "BEME5581F")
+ XCTAssertEqual(numberedSuffix?.partSuffix, "02")
+
+ // 同一品番2箱: 現品票は同じでカード番号が連番。箱固有キーはQR単体なので別の箱になる。
+ let boxA = pair("box-a-KAAA-45-81MB")
+ let boxB = pair("box-b-KAAA-45-81MB")
+ XCTAssertEqual(boxA?.barcodePayload, boxB?.barcodePayload)
+ XCTAssertEqual(KanbanQRRecord.parse(boxA?.qrPayload ?? "")?.cardNumber, "DAH4094520")
+ XCTAssertEqual(KanbanQRRecord.parse(boxB?.qrPayload ?? "")?.cardNumber, "DAH4094530")
+ XCTAssertNotEqual(
+ BoxIdentity.make(qrPayload: boxA?.qrPayload ?? "", barcodePayload: boxA?.barcodePayload),
+ BoxIdentity.make(qrPayload: boxB?.qrPayload ?? "", barcodePayload: boxB?.barcodePayload)
+ )
+ }
+
func testDifferentPartNumberMismatches() {
// BCJH-55-81GG (LH) と BCJH-52-81GG (RH) の取り違え
XCTAssertEqual(
@@ -247,6 +314,53 @@ final class CodeMatcherTests: XCTestCase {
XCTAssertNil(KanbanQRRecord.parse("SHORT"))
}
+ /// 2026-09-08 の現場ラベル（#129）: カード番号の4桁目が数字（`DAH4093870`）でも受理し、
+ /// 9桁品番は品目番号欄の末尾空白を除いて保持する。枝番は空白でも `02` でもよい。
+ func testKanbanQRRecordAcceptsAlphanumericCardCodeAndNineCharacterPart() {
+ let tenCharacter = KanbanQRRecord.parse(sawaiAlnumCardQRPayload)
+ XCTAssertEqual(tenCharacter?.cardNumber, "DAH4093870")
+ XCTAssertEqual(tenCharacter?.partNumber, "BCJH558SHE")
+ XCTAssertEqual(tenCharacter?.partSuffix, "02")
+ XCTAssertEqual(tenCharacter?.deliveryQuantity ?? 0, 160, accuracy: 0.001)
+ XCTAssertEqual(tenCharacter?.instructedQuantity ?? 0, 160, accuracy: 0.001)
+ XCTAssertEqual(tenCharacter?.factoryCode, "H")
+ XCTAssertEqual(tenCharacter?.warehouseCode, "BHB01")
+ XCTAssertEqual(tenCharacter?.supplyPointCode, "LHA29")
+
+ let nineCharacter = KanbanQRRecord.parse(sawaiShortPartQRPayload)
+ XCTAssertEqual(nineCharacter?.cardNumber, "DAH4093540")
+ XCTAssertEqual(nineCharacter?.partNumber, "BCJH5281F")
+ XCTAssertNil(nineCharacter?.partSuffix)
+ XCTAssertEqual(nineCharacter?.deliveryQuantity ?? 0, 200, accuracy: 0.001)
+
+ let nineCharacterWithSuffix = KanbanQRRecord.parse(
+ "DAH4094390BEME5581F 020002000000020000H 000000BHB01LHA29 0*"
+ )
+ XCTAssertEqual(nineCharacterWithSuffix?.partNumber, "BEME5581F")
+ XCTAssertEqual(nineCharacterWithSuffix?.partSuffix, "02")
+
+ // 読取境界・仕向地判定・照合のすべてを通る。
+ XCTAssertTrue(KanbanQRRecord.isValidScanPayload(sawaiAlnumCardQRPayload))
+ XCTAssertTrue(KanbanQRRecord.isValidScanPayload(sawaiShortPartQRPayload))
+ XCTAssertEqual(Destination.detect(qrPayload: sawaiAlnumCardQRPayload), .sawai)
+ XCTAssertEqual(Destination.detect(qrPayload: sawaiShortPartQRPayload), .sawai)
+ XCTAssertEqual(
+ CodeMatcher.compare(qrPayload: sawaiAlnumCardQRPayload, barcodePayload: sawaiAlnumCardBarcodePayload),
+ .match
+ )
+ XCTAssertEqual(
+ CodeMatcher.compare(qrPayload: sawaiShortPartQRPayload, barcodePayload: sawaiShortPartBarcodePayload),
+ .match
+ )
+ XCTAssertEqual(CodeMatcher.format(partNumber: "BCJH5281F", destination: .sawai), "BCJH-52-81F")
+
+ // 品目番号欄の途中の空白、連番の英字、無関係な66桁は引き続き受理しない。
+ XCTAssertNil(KanbanQRRecord.parse("DAH4093540BCJH52 1F 0002000000020000H 000000BHB01LHA28 0*"))
+ XCTAssertNil(KanbanQRRecord.parse("DAH409387ABCJH558SHE020001600000016000H 000000BHB01LHA29 0*"))
+ XCTAssertNil(KanbanQRRecord.parse("DAH4093540 BCJH5281F 0002000000020000H 000000BHB01LHA28 0*"))
+ XCTAssertNil(Destination.detect(qrPayload: String(repeating: "X", count: 66)))
+ }
+
func testBluetoothScanPayloadValidationRejectsReverseOrderFormats() {
XCTAssertTrue(KanbanQRRecord.isValidScanPayload(qrPayload))
XCTAssertFalse(KanbanQRRecord.isValidScanPayload(barcodePayload))
@@ -391,12 +505,18 @@ final class CodeMatcherTests: XCTestCase {
)
}
- func testTagBarcodeRecordAcceptsFourTwoThreeOnlyForMolten() {
- XCTAssertTrue(
- TagBarcodeRecord.isValidScanPayload(moltenShortPartBarcodePayload, destination: .molten)
- )
+ func testTagBarcodeRecordAcceptsFourTwoThreeForSawaiAndMolten() {
+ // 9桁品番の現品票（4-2-3）は澤井製作所にもある（#129）。デンソーの6-4とは区別する。
+ for destination in [Destination.sawai, .molten] {
+ XCTAssertTrue(
+ TagBarcodeRecord.isValidScanPayload(moltenShortPartBarcodePayload, destination: destination)
+ )
+ XCTAssertTrue(
+ TagBarcodeRecord.isValidScanPayload(sawaiShortPartBarcodePayload, destination: destination)
+ )
+ }
XCTAssertFalse(
- TagBarcodeRecord.isValidScanPayload(moltenShortPartBarcodePayload, destination: .sawai)
+ TagBarcodeRecord.isValidScanPayload(sawaiShortPartBarcodePayload, destination: .denso)
)
// 仕向地未判定のときは、どちらの仕向地の現品票も取りこぼさない
XCTAssertTrue(
diff --git a/ios/scripts/verify_label_pairs.sh b/ios/scripts/verify_label_pairs.sh
new file mode 100755
index 0000000..3d62d59
--- /dev/null
+++ b/ios/scripts/verify_label_pairs.sh
@@ -0,0 +1,29 @@
+#!/bin/sh
+# Run decoded label pairs through the production matching core without Xcode.
+#
+# swiftc -O shared/tools/decode_label_photos.swift -o /tmp/decode_label_photos
+# /tmp/decode_label_photos tmp/labels > tmp/decoded.tsv # photos stay git-ignored
+# ios/scripts/verify_label_pairs.sh tmp/decoded.tsv
+#
+# Compiles ios/CodeMatch/Models/ScanModels.swift together with the driver in
+# ios/scripts/verify_label_pairs/main.swift, so the result reflects exactly the
+# rules the app ships. Run it once on master to see what the current build does
+# with a new label set, and again after changing the rules. See
+# docs/label-variation-playbook.html.
+set -eu
+
+if [ "$#" -ne 1 ]; then
+ echo "usage: $0