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 @@
+# 결정적인 sparse·하중 조립
+
+Assembly는 element/load의 local contribution을 global matrix/vector로 누적한다.
+Equation 번호와 pattern의 owner는 DofManager이며 worker가 pattern을 변경하지 않는다.
+
+- Worker는 element/index-owned buffer만 쓰고 join 뒤 stable COO ordering과 고정된
+  reduction으로 합산한다. Global CSR에 직접 병렬 더하기를 하지 않는다.
+- Full-space stiffness·내력·외력·pressure tangent의 scatter와 부호를 유지한다.
+  Free 성분만 조립해 constrained reaction의 근거를 잃지 않는다.
+- 여러 element가 같은 DOF에 기여하는 순서는 thread scheduling에 의존하지 않는다.
+  Failure diagnostic도 발견 시각이 아니라 지정된 순서로 선택한다.
+- Serial/parallel 일치, shared node 누적, 중복 COO, invalid contribution, empty partition,
+  pressure 합력·모멘트와 tangent를 검증한다.