modify harness framework

2026-09-08 10:30:07 +09:00
parent 1239d5b9f6
commit 1a0f3c9aaf
68 changed files with 6729 additions and 957 deletions
@@ -1,24 +1,16 @@
-# 아키텍처
+# 제품 아키텍처

-## 디렉토리 구조
-```
-src/
-├── app/               # 페이지 + API 라우트
-├── components/        # UI 컴포넌트
-├── types/             # TypeScript 타입 정의
-├── lib/               # 유틸리티 + 헬퍼
-└── services/          # 외부 API 래퍼
+## 확인된 구조
+
+```text
+include/  public header
+src/      제품 구현
+tests/    제품 테스트
 ```

-## 패턴
-{사용하는 디자인 패턴 (예: Server Components 기본, 인터랙션이 필요한 곳만 Client Component)}
+- public header는 소비자가 implementation 세부사항에 의존하지 않도록 유지한다.
+- implementation에서 public 계약을 사용하며 의존성 방향을 역전하지 않는다.
+- 제품 모듈, entry point, 런타임 데이터 흐름과 배포 구조는 미정이다.

-## 데이터 흐름
-```
-{데이터가 어떻게 흐르는지 (예:
-사용자 입력 → Client Component → API Route → 외부 API → 응답 → UI 업데이트
-)}
-```
-
-## 상태 관리
-{상태 관리 방식 (예: 서버 상태는 Server Components, 클라이언트 상태는 useState/useReducer)}
+실제 디렉터리나 build metadata가 추가되면 확인된 구조만 이 문서에 기록한다.
+Harness의 Python 모듈 구조와 phase 운영 절차는 제품 아키텍처에 포함하지 않는다.