# Pier_v1 — 교각 3D 형상 생성 웹 뷰어

엑셀 입력(교각 · IP · 받침)으로 T형 교각의 3D 형상을 만들고, 웹 브라우저에서 확인하는 프로젝트입니다.
형상 생성 → 형상계획 → 철근배근 → 재료표 순서로 진행합니다.

## 주요 기능

- **① 형상 생성**: 엑셀 입력을 불러와 교각을 3D로 생성합니다. 기본은 **전체 보기**(교각 여러 기를 한 화면에 콘크리트만 표시)입니다.
- **② 형상계획**: 부재별(코핑, 기둥, 확대기초·말뚝, 지반, 교량받침) 입력을 고치고, 기준 교각의 값을 다른 교각에 **속성 복사**합니다.
- **③ 철근배근**: 부재별 철근을 3D로 표시하고 철근표를 만듭니다.
- **④ 재료표**: 철근 재료표를 교각별로 또는 **교량 전체 집계**로 보고, 엑셀로 내보냅니다.

## 실행 방법

필요 환경: Node.js (LTS 권장), npm

```bash
npm install
npm run dev        # 개발 서버 (기본 http://localhost:5173)
```

WSL에서 호스트를 지정하려면:

```bash
npm run dev -- --host 127.0.0.1 --port 5173
```

## 명령어

| 명령 | 내용 |
| :--- | :--- |
| `npm run dev` | 개발 서버 실행 |
| `npm run typecheck` | TypeScript 타입 검사 |
| `npm test` | 단위 테스트 (vitest) |
| `npm run build` | 타입 검사 후 배포용 빌드 (`dist/`) |

## 입력 파일

`public/samples/운곡교P1입력.xlsx`가 기본 예시입니다. 시트 구성은 다음과 같습니다.

- **교각**: 교각명, 교각 형식, 두부보 EL, 기초 하단 EL, 지반고 EL, 말뚝 길이(mm), 두부보 폭·길이(mm), 기둥 개수
- **IP**: 교각별 IP1–IP4 좌표와 코핑 꺾임각
- **받침**: 교각별 받침 번호, 좌표, EL, 방위각, 위치(전열·후열)

엑셀에서 **시트 1장 = 교각 1기**입니다. 오류가 있는 교각만 건너뛰고 나머지는 생성합니다.

## 폴더 구조

```
src/
  core/     계산과 규칙 (형상, 철근, 재료표, 복사, 입력 검사)
  view/     3D 장면과 도면 뷰 (three.js)
  main.ts   화면 동작과 상태
tests/      단위 테스트
public/     샘플 입력 파일
scripts/    검증·자동화 스크립트
verify/     검증 실행 기록
```

## 참고

- 작업 규칙과 커밋 방식은 `CLAUDE.md`에 있습니다.
- 명세와 설계 기준은 프로젝트 외부 문서(RAG 폴더)를 따릅니다.