feat(bearing): 거더 짝 받침 · 종단경사 S · 솔플레이트 열 두께 (Q-SH1·4·8·9, 미연결)

받침방위각_솔플레이트검토.md §3 알고리즘의 순수 함수.
- 이웃 구조물 사이 짝짓기: 진행 방향, 방위각 차 ≤ 0.1°, 거더선 ≤ 0.1 m, 가장 가까운 것 (후보 2개 이상 WS04)
- 방위각 검사 10″ 초과 WS01 (입력 유지)
- S = z 차 / 수평거리, 오르막 쪽 구조물
- 열 두께 T = max(22, ceil(max T_req)), T1 오르막 쪽 / T2
A1–P1 검증: 짝 ①–⑤, S −1.908 / −1.906 / −1.904 / −1.904 / −1.902 %, T 30 · T1 38 · T2 22.

모델·화면에는 아직 연결하지 않는다. 높이 규칙(Q-SH7 블럭 상면 = z − (T − T_ref))이
2026-11-03 C안(받침높이 H 고정, h3 = H − T)과 충돌해 사용자 확인이 필요하다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tests/bearing-pair.test.ts

@@ -0,0 +1,71 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import * as XLSX from 'xlsx';
+import { describe, expect, it } from 'vitest';
+import { parseAbutments } from '../src/core/abut/parse';
+import { girderPairs, pairOf, type PairStructure, soleRowThickness } from '../src/core/bearing-pair';
+import { loadP1 } from './helpers';
+
+// RAG/받침방위각_솔플레이트검토.md §2 · §6 (Q-SH1·4·8·9). A1 from the RAG workbook's Abut sheet, P1 from the same input.
+const RAG = fileURLToPath(new URL('../../../RAG/운곡교P1입력.xlsx', import.meta.url));
+const a1 = parseAbutments(XLSX.read(readFileSync(RAG), { type: 'buffer' })).abutments[0];
+const A1: PairStructure = { name: 'A1', bearings: a1.bearings.map((b) => ({ no: b.no, x: b.pos.e, y: b.pos.n, z: b.z, azimuthDeg: b.azimuthDeg! })) };
+const p1 = loadP1();
+const P1: PairStructure = { name: 'P1', bearings: p1.bearings.map((b) => ({ no: b.no, x: b.x, y: b.y, z: b.z, azimuthDeg: b.azimuthDeg })) };
+
+describe('거더 짝 받침 · 종단경사 S (Q-SH1·4·5)', () => {
+  const pairs = girderPairs([A1, P1]);
+
+  it('pairs A1 ①–⑤ with P1 ①–⑤ on the girder line (offset 0.000 m, azimuth difference ≤ 0.1″)', () => {
+    expect(pairs.map((p) => [p.from.no, p.to.no])).toEqual([[1, 1], [2, 2], [3, 3], [4, 4], [5, 5]]);
+    for (const p of pairs) {
+      expect(p.offsetM).toBeLessThan(0.0005);
+      expect(p.fromCheckSec).toBeLessThanOrEqual(0.5);
+      expect(p.distanceM).toBeCloseTo(48.791, 3);
+      expect(p.warnings).toEqual([]);
+    }
+  });
+
+  it('S = −1.908 / −1.906 / −1.904 / −1.904 / −1.902 % (상세도 −1.910 … −1.901, ≤ 0.002 %), A1 is the 오르막 쪽', () => {
+    expect(pairs.map((p) => p.slopePct.toFixed(3))).toEqual(['-1.908', '-1.906', '-1.904', '-1.904', '-1.902']);
+    const drawing = [-1.910, -1.907, -1.905, -1.903, -1.901];
+    pairs.forEach((p, i) => expect(Math.abs(p.slopePct - drawing[i])).toBeLessThanOrEqual(0.0025));
+    expect(pairs.every((p) => p.uphill === 'A1')).toBe(true);
+  });
+
+  it('P1 back row ⑥–⑩ (next span, P2 not in the workbook) has no pair', () => {
+    for (const no of [6, 7, 8, 9, 10]) expect(pairOf(pairs, 'P1', no)).toBeUndefined();
+    expect(pairOf(pairs, 'P1', 3)!.from).toEqual({ structure: 'A1', no: 3 });
+  });
+
+  it('WS01: P1 ③ azimuth typed as 75°59′ (CAD) is kept but flagged', () => {
+    const typo: PairStructure = { ...P1, bearings: P1.bearings.map((b) => (b.no === 3 ? { ...b, azimuthDeg: 90 - (75 + 59 / 60) } : b)) };
+    const p = girderPairs([A1, typo]).find((q) => q.to.no === 3)!;
+    expect(p.warnings).toContain('WS01');
+    expect(p.toCheckSec).toBeGreaterThan(10);
+    expect(girderPairs([A1, typo]).filter((q) => q.to.no !== 3).every((q) => !q.warnings.includes('WS01'))).toBe(true);
+  });
+
+  it('WS04: two candidates within tolerance → the closest to the girder line is used', () => {
+    const b1 = P1.bearings[0];
+    const extra = { ...b1, no: 99, x: b1.x + 0.05 * Math.cos(b1.azimuthDeg * Math.PI / 180), y: b1.y - 0.05 * Math.sin(b1.azimuthDeg * Math.PI / 180) };
+    const p = girderPairs([A1, { ...P1, bearings: [...P1.bearings, extra] }]).find((q) => q.from.no === 1)!;
+    expect(p.warnings).toContain('WS04');
+    expect(p.to.no).toBe(1);
+  });
+});
+
+describe('솔플레이트 열 두께 (Q-SH3·8·9, L 800)', () => {
+  it('S 1.908 % → T 30, T1 38 / T2 22 (P1 상세도)', () => {
+    expect(soleRowThickness([{ lengthMm: 800, slopePct: -1.908 }])).toEqual({ T: 30, ends: [{ T1: 38, T2: 22 }] });
+  });
+  it('S 3 % → T 34, T1 46 / T2 22; S 0 → T 22', () => {
+    expect(soleRowThickness([{ lengthMm: 800, slopePct: 3 }])).toEqual({ T: 34, ends: [{ T1: 46, T2: 22 }] });
+    expect(soleRowThickness([{ lengthMm: 800, slopePct: 0 }]).T).toBe(22);
+  });
+  it('one T per row: the largest requirement wins, the flatter bearing gets a thicker T2', () => {
+    const row = soleRowThickness([{ lengthMm: 800, slopePct: 3 }, { lengthMm: 800, slopePct: 1 }]);
+    expect(row.T).toBe(34);
+    expect(row.ends[1]).toEqual({ T1: 38, T2: 30 });
+  });
+});