import type { FckByMember, Material } from './rebar/common'; import { checkStoredGroundModel, type GroundModelFile } from './ground-model'; import type { PierInput } from './types'; import type { AbutRecord } from './abut/parse'; import { normalizeBearingAzimuths } from './coordinate-frame'; /** Project file schema (spec §8). Bump only with a migration. */ export const SCHEMA_VERSION = 1; export interface ProjectInfo { name: string; bridge: string; client: string; author: string; crs: string; memo: string; } export interface ProjectPier { id: string; /** Generated input: the values the 3D model was built from. The model is not stored; it is regenerated on open (spec §8). */ input: PierInput; /** Values as imported from the sheet (기본값). Missing in files saved before change tracking: input is used. */ defaults?: PierInput; /** Values currently in the cards (현재 입력). Missing in older files: input is used. */ draft?: PierInput; } export interface ProjectFile { schemaVersion: number; project: ProjectInfo; source: { fileName: string; sheets: string[] }; piers: ProjectPier[]; history: { version: string; note: string; at: string }[]; /** ③ 공통 설정 (fck · fy). Absent in older files: the defaults are used. */ common?: Material; /** ② 부재별 fck (MPa). Absent in older files: every member uses the 공통 fck. */ fckByMember?: FckByMember; /** 지반 모델 (ground_model.json)의 교각별 지반고. Absent = 불러오지 않음. Applied to a pier only by the user. */ groundModel?: GroundModelFile; /** 교대 (2026-11-03, AB): 교대 입력 기록. Absent in older files: no abutments. */ abutments?: AbutRecord[]; /** 교대 기본값 (가져온 그대로): 기본값 복원에 쓴다. Absent = 교대별 현재값이 기본값. */ abutDefaults?: AbutRecord[]; } /** Serialises a project to the pretty-printed JSON stored in <교량명>_교각설계.pzr.json. */ export function serializeProject(p: ProjectFile): string { return `${JSON.stringify(p, null, 2)}\n`; } /** * Parses and checks a project file. Throws with a message that names the first problem, so a damaged file is * refused instead of being half-loaded. */ export function parseProject(text: string): ProjectFile { let raw: unknown; try { raw = JSON.parse(text); } catch { throw new Error('프로젝트 파일이 JSON으로 읽히지 않습니다.'); } const obj = raw as Partial; if (!obj || typeof obj !== 'object') throw new Error('프로젝트 파일 형식이 아닙니다.'); if (obj.schemaVersion !== SCHEMA_VERSION) { throw new Error(`지원하지 않는 파일 버전입니다 (schemaVersion ${String(obj.schemaVersion)}, 지원: ${SCHEMA_VERSION}).`); } if (!Array.isArray(obj.piers)) throw new Error('piers 목록이 없습니다.'); if (obj.fckByMember !== undefined) { for (const [member, value] of Object.entries(obj.fckByMember)) { if (!['column', 'coping', 'footing'].includes(member) || typeof value !== 'number' || !(value > 0)) { throw new Error(`부재별 fck 값이 맞지 않습니다 (${member}: ${String(value)}).`); } } } if (obj.groundModel !== undefined) checkStoredGroundModel(obj.groundModel); if (obj.abutments !== undefined) checkStoredAbutments(obj.abutments); if (obj.abutDefaults !== undefined) checkStoredAbutments(obj.abutDefaults); obj.piers.forEach((p, i) => { if (!p || typeof p.id !== 'string' || !p.input) throw new Error(`교각 ${i + 1}: id 또는 input이 없습니다.`); const input = p.input; const rows = input.strataRows; if (rows !== undefined) { const ok = Array.isArray(rows) && rows.every((r) => typeof r?.name === 'string' && typeof r?.bottomEl === 'number' && Number.isFinite(r.bottomEl) && (r.nValue === undefined || typeof r.nValue === 'string')); if (!ok) throw new Error(`교각 ${input.name}: 지층 행 형식이 맞지 않습니다.`); } if (typeof input.name !== 'string' || !Array.isArray(input.ips) || !Array.isArray(input.bearings)) { throw new Error(`교각 ${i + 1}(${String(input.name)}): 입력 형식이 맞지 않습니다.`); } for (const extra of [p.defaults, p.draft]) { if (extra !== undefined && (typeof extra !== 'object' || extra === null || typeof extra.name !== 'string')) { throw new Error(`교각 ${i + 1}(${input.name}): defaults 또는 draft 형식이 맞지 않습니다.`); } } for (const values of [p.input, p.defaults, p.draft]) { if (values?.bearingAzimuthFrame !== undefined && values.bearingAzimuthFrame !== 'model-xy') { throw new Error(`교각 ${input.name}: 받침 방위각 좌표계 표기가 맞지 않습니다.`); } if (values && !Array.isArray(values.bearings)) { throw new Error(`교각 ${input.name}: 받침 목록이 없습니다.`); } } p.input = normalizeBearingAzimuths(p.input); if (p.defaults) p.defaults = normalizeBearingAzimuths(p.defaults); if (p.draft) p.draft = normalizeBearingAzimuths(p.draft); }); return obj as ProjectFile; } const finite = (v: unknown) => typeof v === 'number' && Number.isFinite(v); const isPoint = (v: unknown) => !!v && typeof v === 'object' && finite((v as { e?: unknown }).e) && finite((v as { n?: unknown }).n); /** 교대 기록 check (AB): refuses a damaged abutment record with a message that names it. */ export function checkStoredAbutments(list: unknown): void { if (!Array.isArray(list)) throw new Error('교대 목록 형식이 맞지 않습니다.'); list.forEach((a: Partial, i) => { const who = `교대 ${i + 1}(${String(a?.name)})`; if (!a || typeof a.name !== 'string' || !/^A\d+$/.test(a.name)) throw new Error(`${who}: 교대명이 맞지 않습니다.`); if (a.type !== 'A1' && a.type !== 'A2') throw new Error(`${who}: 형식은 A1 또는 A2여야 합니다.`); for (const key of ['seatEl', 'foundationBottomEl', 'groundEl', 'pileLengthMm', 'skewDeg', 'slopeI'] as const) { if (!finite(a[key])) throw new Error(`${who}: ${key} 값이 맞지 않습니다.`); } for (const key of ['ip1', 'ip2', 'ip3'] as const) { if (!isPoint(a[key])) throw new Error(`${who}: ${key} 좌표가 맞지 않습니다.`); } if (!Array.isArray(a.bearings) || a.bearings.length < 2) throw new Error(`${who}: 받침이 2개 이상 필요합니다.`); if (a.shape !== undefined) { for (const [key, v] of Object.entries(a.shape)) { if (!finite(v)) throw new Error(`${who}: 형상 값 ${key}이(가) 숫자가 아닙니다.`); } } if (a.bearingRule !== undefined) { for (const [key, v] of Object.entries(a.bearingRule)) { if (key === 'kind' ? typeof v !== 'string' : !finite(v)) throw new Error(`${who}: 받침 규칙 ${key}이(가) 맞지 않습니다.`); } } if (a.wings !== undefined) { const forms = ['general', 'short', 'none']; if (!forms.includes(a.wings.left) || !forms.includes(a.wings.right)) throw new Error(`${who}: 날개벽 형식이 맞지 않습니다.`); } for (const b of a.bearings) { if (!b || !finite(b.no) || !isPoint(b.pos) || !finite(b.z) || (b.seatEl !== undefined && !finite(b.seatEl))) { throw new Error(`${who}: 받침 ${String(b?.no)}의 값이 맞지 않습니다.`); } } }); }