docs: consolidate solver knowledge and preserve formulation originals

2026-10-17 22:34:12 +09:00
parent 149e7e2de8
commit d76602a0f1
19 changed files with 1740 additions and 380 deletions
@@ -1,48 +1,15 @@
-# FESA 문서 안내
+# FESA 기술 문서

-현재 계약, 기능의 재사용 정보, 실제 검증 결과와 과거 개발 이력을 구분한다.
-기능 구현과 기능 검증 완료는 다르며, 문서 정리로 과거 실행을 현재 통과로 바꾸지 않는다.
+현재 구현의 목적·경계·소유권·검증 한계를 기능별로 요약한다. 정식화 원문은 유도와 당시 가정을 보존하며 현재 채택 여부는 README에서 구분한다. 문서 정리는 새 build/test 또는 외부 검증 통과를 뜻하지 않는다.

-## 공통 기준
-
-| 확인할 내용 | 원본 문서 |
-| --- | --- |
-| 제품 목적·지원 범위·승인 요구사항 | [PRD](PRD.md), [business-rules](business-rules.md) |
-| 모듈·데이터 흐름·소유권·수명 | [ARCHITECTURE](ARCHITECTURE.md) |
-| CLI·입력·결과·비교 identity | [contracts](contracts.md) |
-| 외부 수치 비교와 승인 예외 | [TOLERANCE](TOLERANCE.md) |
-| 개발·수치 구현에서 지킬 규칙 | [standards](standards.md), [CODINGSTYLE](CODINGSTYLE.md), [engineering-notes](engineering-notes.md) |
-| 환경 준비·실행·build/test | [operations](operations.md), [HARNESS](HARNESS.md), [HARNESS_WORKFLOW](HARNESS_WORKFLOW.md) |
-| 실행 권한·데이터 취급 | [security](security.md) |
-| 전문 작업·skill·기능 문서 소유권 | [SOLVER_AGENT_DESIGN](SOLVER_AGENT_DESIGN.md), [SOLVER_SKILL_DESIGN](SOLVER_SKILL_DESIGN.md), [FEATURE_DOCUMENTATION](FEATURE_DOCUMENTATION.md) |
-| 승인 결정과 변경 이유 | [ADR](ADR.md), [결정 목록](tracking/decisions/index.md) |
-| 현재 구현·검증과 잔여 문제 | [현황](tracking/status.md), [미해결 문제](tracking/findings.md) |
-
-공통 요약과 상세 계약이 충돌하면 내용을 최신 날짜만으로 덮어쓰지 않는다. 승인된 의미와
-실제 구현·검사 대상 revision을 대조하고, 물리·acceptance 변경은 별도로 판단한다.
-
-## 기능별 진입점
-
-각 진입점에서 목적·범위, 수식·I/O, 사용법·Handoff, 검증·수정·한계를 연결한다.
-
-| 기능 | 문서 |
-| --- | --- |
-| B33 선형 정적 Beam | [linear-static-3d-euler-beam](linear-static-3d-euler-beam/README.md) |
-| MITC4 선형 정적 Shell | [linear-static-mitc4-shell](linear-static-mitc4-shell/README.md) |
-| MITC4 비선형 정적 Newton–Raphson | [nonlinear-static-newton-raphson](nonlinear-static-newton-raphson/README.md) |
-| Shell 표면 압력 | [shell-surface-pressure-load](shell-surface-pressure-load/README.md) |
-| MITC4 질량·FEAST 현재 구현 | [mitc4-shell-feast-eigen2](mitc4-shell-feast-eigen2/README.md) |
-| 이전 MFE의 요구·채택 유도·반례 근거 | [mitc4-shell-feast-eigen](mitc4-shell-feast-eigen/README.md) |
-| HHT implicit dynamics | [hht-implicit-dynamics](hht-implicit-dynamics/README.md) |
-| Shell transient heat transfer | [shell-transient-heat-transfer](shell-transient-heat-transfer/README.md) |
-| C++ 모듈화와 공개 API 정리 | [cpp-object-oriented-modular-refactoring](cpp-object-oriented-modular-refactoring/README.md) |
-
-## 개발 이력과 원문
-
-[개발 결정·폐기된 운영 계획](development-history.md)은 승인 출처와 중요한 교훈을 연결한다.
-[MITC4 보충 기록](MITC4_SUPP.md)은 실제 실패·계약 변경·예상 TDD RED를 구분한다.
-[초기 작성 노트](archive/ProjectInitialPlanNote.md)는 역사 자료이고 현재 작업 계획이 아니다.
-`reference-papers/`는 논문·발췌·이미지 원문이며 기능 검증 통과의 근거와는 구분한다.
-
-현재 checkout에 없는 개인 로그·생성 결과는 당시 evidence 위치로 표시한다. 저장소에 있는
-검사 코드·reference 원본·검증 보고서와 다른 자료이므로 실제 파일이 제공된 것으로 해석하지 않는다.
+- [솔버 공통 구조·입출력·수치 비교](solver-core/README.md)
+- [3D Euler beam](linear-static-3d-euler-beam/README.md)
+- [MITC4 선형 정적 shell](linear-static-mitc4-shell/README.md)
+- [MITC4 비선형 정적](nonlinear-static-newton-raphson/README.md)
+- [Shell 표면 압력](shell-surface-pressure-load/README.md)
+- [이전 eigen 유도](mitc4-shell-feast-eigen/README.md) · [현재 FEAST eigen](mitc4-shell-feast-eigen2/README.md)
+- [Shell HHT 동역학](hht-implicit-dynamics/README.md)
+- [Hex8 구조해석](hex8-structural-analysis/README.md)
+- [Shell 열전달](shell-transient-heat-transfer/README.md)
+- [계산 성능](calculation-performance/README.md)
+- [C++ 모듈화](cpp-object-oriented-modular-refactoring/README.md)