modify documents
This commit is contained in:
@@ -1,63 +1,24 @@
|
||||
# Shell Transient Heat Transfer 지역 작업 지침
|
||||
# shell-transient-heat-transfer 문서·작업 지침
|
||||
|
||||
- Feature ID: `shell-transient-heat-transfer`
|
||||
- 메인 owner: 메인 assistant
|
||||
- 적용 범위: `docs/shell-transient-heat-transfer/`의 계약·계획·검토 문서.
|
||||
이 파일은 `src/`, `include/`, `tests/`에 자동 적용되는 지침이 아니다.
|
||||
- 현재 범위·상태·checklist 원본: [Feature PRD](PRD.md).
|
||||
- 문서 진입점·목적·사용법·Handoff: [README](README.md).
|
||||
- 현재 범위·checklist: [PRD](PRD.md); 결정·승인·대체 이력: [ADR](ADR.md).
|
||||
- 적용 범위: 해당 기능의 문서. 자동 로드되는 코드 영역 `AGENTS.md`가 아니다.
|
||||
|
||||
기준: [프로젝트 지침](../../AGENTS.md), [프로젝트 PRD](../PRD.md),
|
||||
[공통 ADR](../ADR.md#adr-028), [ARCHITECTURE](../ARCHITECTURE.md),
|
||||
[Feature 문서 관리](../FEATURE_DOCUMENTATION.md).
|
||||
이 파일은 자동 로드되는 `AGENTS.md`가 아니며, Feature 작업 시 명시적으로 참조한다.
|
||||
기준: [프로젝트 지침](../../AGENTS.md), [ARCHITECTURE](../ARCHITECTURE.md),
|
||||
[Feature 문서 관리](../FEATURE_DOCUMENTATION.md), [공통 tolerance](../TOLERANCE.md).
|
||||
|
||||
## 계약과 작업 경계
|
||||
## 보존할 계약과 인계
|
||||
|
||||
- 인터뷰에서 합의한 지원 범위는 PRD, 채택 상태·이유·영향은 ADR에 기록한다.
|
||||
ready에서 승인한 채택 계약과 독립 검토·실제 구현 완료 evidence를 구별한다.
|
||||
- 수식 원본은 formulation, 구현 순서·코드 연결은 design-plan, 독립 지적과 검산 evidence는
|
||||
numerical-review가 소유한다. 긴 유도·검토 내용을 PRD나 이 파일에 복제하지 않는다.
|
||||
- 현재 checklist는 PRD 한 곳에 둔다. 현재 구현은 사용자의 `dryforge:go` 요청으로 승인되었다. 외부 solver 실행·배포 권한은 포함하지 않는다.
|
||||
- 변경이 보간·물성·geometry 근사·초기 상태·적분·시간 갱신 의미를 바꾸면 관련 ADR과
|
||||
정식화를 먼저 갱신하고 필요한 독립 numerical review를 받는다. Specialist는 할당 문서만 수정한다.
|
||||
수식·I/O·수치 기준의 원본은 README에서 연결한 전문 문서를 따른다. 기능을 재개할 때
|
||||
관련 계약과 실제 실행 revision·미해결 항목을 함께 읽는다. 과거 stage pass나 현재 문서
|
||||
정리를 solver 검증 통과로 계산하지 않는다. 요구사항·ADR ID와 승인 이력을 유지한다.
|
||||
메인은 PRD·ADR·진입점·문서 참조를 관리하고 전문 작업자는 할당한 본문과 관련 범위만 수정한다.
|
||||
기존 개인 설정·reference·다른 작업자의 변경을 보존하며 실패를 tolerance 완화로 숨기지 않는다.
|
||||
문서만 수정하면 정적 검토를 수행하고, 동작 변경에는 관련 검사와 필요한 독립 검토를 수행한다.
|
||||
|
||||
## 이 Feature에서 보존할 의미
|
||||
|
||||
- 현재 목표는 단일 step의 uncoupled 열해석이다. 초기의 두께 방향 등온 선택은 대체되었으며
|
||||
현재 요구는 균질 단면의 온도점 5개와 면내·두께 방향 열전달이다.
|
||||
- Source DOF 11/13/15는 각각 아랫면/중앙면/윗면이다. Source DOF, 내부 equation 번호,
|
||||
온도점·적분점·flux recovery 위치를 구분한다.
|
||||
- 검산용 54개 직접 적분 위치와 24개 flux trace 위치는 서로 다르다. 중앙면의 두께
|
||||
미분 양쪽 값을 평균하거나 요소 경계를 넘어 flux를 합치지 않는다.
|
||||
- 반력 열률은 열용량 항을 포함한 full residual로 정의한다. Fourier flux와
|
||||
반력 열률을 같은 observable로 대체하지 않는다.
|
||||
- Thin-shell 곡률 근사, 다른 두께·fold의 접속, 초기 온도 jump와 결과 schema는
|
||||
[PRD 상세 계약](PRD.md#sth-c01--모델-geometry와-자유도)을 따른다. Edge 입력 011은 이번 구현에서 연기한다. 미지원 의미를 임의 default로 처리하지 않는다.
|
||||
- 기존 reference `.inp`와 CSV는 변경하지 않고 진단 비교에 사용한다. 음수 reference는
|
||||
roundoff로 단정하거나 clamp하지 않고 [TOLERANCE](../TOLERANCE.md)를 적용한다.
|
||||
새 필수 reference는 [PRD STH-C08](PRD.md#sth-c08--reference-원본과-완료-evidence)과
|
||||
[STH-ADR-015](ADR.md#sth-adr-015-원본-reference-진단-전환과-새-모델-비교)를 따른다.
|
||||
- All-constrained와 단면 전체 end 온도 지정은 검산용 algebra/assembly fixture다.
|
||||
내부 온도점 경계조건을 공개 입력 기능으로 확대하는 근거로 사용하지 않는다.
|
||||
|
||||
## 문서 소유권과 인계
|
||||
|
||||
| 문서 | Owner | 책임 |
|
||||
| --- | --- | --- |
|
||||
| [FEATURED_AGENTS.md](FEATURED_AGENTS.md) | 메인 assistant | 지역 지침·소유권·문서 연결 |
|
||||
| [PRD.md](PRD.md) | 메인 assistant | 요구사항·제외·acceptance·현재 checklist |
|
||||
| [ADR.md](ADR.md) | 메인 assistant | 채택 결정·승인 근거·이유와 영향 |
|
||||
| [design-plan.md](design-plan.md) | 메인 assistant | 방법론 요약·코드 연결·구현 순서 |
|
||||
| [formulation.md](formulation.md) | formulation-agent | 수식·geometry·보간·적분·시간 갱신·recovery |
|
||||
| [numerical-review.md](numerical-review.md) | numerical-review-agent | 독립 검산·수치 위험·검증 설계 |
|
||||
|
||||
I/O·구현은 design-plan의 작업별 owner에게 할당하고 physics 평가는 독립 검토자에게 할당한다. 필요한 PRD 항목과 관련
|
||||
전문 문서의 절, 수정 파일, 검증 기준을 전달하고 결과·변경 경로·미해결 항목을 반환한다.
|
||||
|
||||
## 변경 확인
|
||||
|
||||
문서 변경은 요구사항 ID·결정 상태·수식의 위치/부호·상대 링크·diff 정합으로 확인한다.
|
||||
문서만 바꾸면 build/test를 실행하지 않는다. 구현 시 검증 명령과 단계별 기준은
|
||||
[계획안의 검증 실행](design-plan.md#11-검증-실행과-완료-판단) 및 프로젝트 지침을 따른다.
|
||||
정확 산술 검산, solver build/CTest, 외부 reference 비교, 실제 결과의 physics 검토를
|
||||
서로 다른 evidence로 기록하고 미실행 항목을 통과로 표시하지 않는다.
|
||||
Uncoupled Q4×two-P2·consistent C·Backward Euler가 현재 범위다. DOF11/13/15는 bottom/mid/top이고
|
||||
공개 지정온도·열률은11/15만 지원한다. 중립면의 양쪽 flux trace를 평균하지 않는다.
|
||||
원본 NT11은 수치 FAIL을 보존한 diagnostic이며 새 필수 reference는 준비 중이다.
|
||||
Edge 열입력·내부 station BC·열-구조 연성을 확대하지 않는다. Private full-end fixture를
|
||||
공개 입력 지원이나 접합부의 실제3D 전도 검증으로 해석하지 않는다.
|
||||
|
||||
Reference in New Issue
Block a user