64 lines
2.4 KiB
Markdown
64 lines
2.4 KiB
Markdown
# 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 폴더)를 따릅니다.
|