# 3D Euler–Bernoulli Beam

## 목적과 현재 범위

B33 선형 정적 해석, 지정 변위·절점 하중과 endpoint 복구. 등분포 등가하중은 local 검산이며 공개 DLOAD 지원이 아니다를 구현한 기능이다. 역사적 기능 검증과 현재 통합 회귀의 범위를 구분한다.
최근 dev 통합 회귀는 [전체 현황](../tracking/status.md)에 연결하며, 과거 release 판정은
[release.md](release.md)에 남긴다. 문서 정리는 새 기능 검증이나 재승인을 뜻하지 않는다.

## 계약과 재사용 Handoff

- [요구사항·acceptance](requirements.md): 지원·제외와 기존 요구사항 ID.
- [정식화](formulation.md): 수식·가정·부호·좌표계·복구 위치.
- [I/O](io.md): 입력 subset·진단·source identity·결과 schema.
- [Reference 모델](reference-model.md): 원본과 비교량·행 identity·적용 범위.
- [독립 수치 검토](numerical-review.md): 검산·위험·반례와 수정 확인.
- [검증·물리 결과](verification.md): 실제 실행한 명령·수치·실패·미실행·한계.
- [연구 근거](research.md): 정식화에 필요한 출처와 적용 경계.

공통 소유권은 [ARCHITECTURE](../ARCHITECTURE.md)를 따른다. Element는 local 계산,
Assembly는 결정적 reduction, Procedure는 trial/commit, Recovery는 물리 의미,
Writer는 직렬화를 담당한다. 새 기능에서 기존 stage/phase 실행 계획을 재사용하지 않는다.
현재 공개 API는 `include/fesa/`, 실제 구현은 `src/fesa/`와 대응 검사를 확인한다.

## 사용법

환경 준비·build·CTest·CLI 기본 사용은 [operations](../operations.md), 입력과 결과의
공통 계약은 [contracts](../contracts.md)를 따른다. 이 기능의 keyword·option 허용 범위는
위 I/O 계약을 확인한다. 과거 보고서의 machine 경로·임시 command를 현재 기본값으로 쓰지 않는다.

## 개발 과정과 주의사항

기존 단계별 계획·coordination은 완료된 실행 운영 기록이어서 제거했다. 승인된 요구사항·
수식·검토·실제 검증 결과는 위 문서에 보존한다. Git `858e87b`의 이전 경로는 당시 원문을
조회하는 용도로만 사용하며 현행 작업 지침이 아니다.

- Dense Matrix 저장 크기 곱의 overflow가 실제 음성 검사에서 드러났다. 크기를 할당 전에 검사하도록 수정했다.
- 빌드 실패 뒤 `No tests were found`가 나온 실행은 통과 evidence가 아니다. discovery inventory와 실제 실행을 함께 확인한다.
- 여러 instance의 같은 source label과 공유 절점의 서로 다른 element endpoint를 합치지 않는다.
- Beam endpoint action 부호와 회전·local/global 좌표를 검산하며 displacement 일치로 stress/reaction 정확성을 추론하지 않는다.
- 초기 단계의 header 누락 RED는 예상 TDD 실패이고 위 overflow는 실제 결함이었다. 두 종류를 구분한다.

실제 numerical·parser·solver·reaction·CLI 수정의 세부 evidence는 [수정 기록](lessons.md)에 남긴다.