docs: organize project guidance and module contracts

2026-09-29 00:34:57 +09:00
parent 73db138566
commit a3502c9b97
50 changed files with 1748 additions and 414 deletions
@@ -0,0 +1,13 @@
+# DOF와 equation 구성
+
+DofManager가 물리 DOF, full/free/constrained mapping, equation 번호, scatter와 sparse
+pattern을 소유한다. 이 정보를 Node·Element·개별 solver에 분산 저장하지 않는다.
+
+- Source node identity와 equation index를 구분하고 numbering·row ordering을 결정적으로 만든다.
+- Partition은 전체 DOF를 중복·누락 없이 덮어야 한다. Prescribed 값과 free 해 복구가 같은
+  mapping을 사용해야 하며 partial rotation constraint를 full clamp로 바꾸지 않는다.
+- 모든 DOF가 constrained인 유효한 모델의 0차원 free system을 허용한다. Empty free와
+  잘못된 topology·singular free matrix는 다른 경우다.
+- Validation은 임의 fallback으로 잘못된 scatter를 건너뛰지 않는다.
+- Renumbering, shared nodes, mixed free/constrained, all-constrained, invalid scatter와
+  serial/parallel 경로의 동일 sparse structure를 검증한다.