refactor: 템플릿에서 기본적으로 제공하고 있는 워크 플로우에 디자인과 라우팅 흡수
This commit is contained in:
@@ -0,0 +1,654 @@
|
||||
# TechLog Frontend — template capability 활용 및 리팩터링 리뷰
|
||||
|
||||
- 날짜: 2026-09-21
|
||||
- 대상: `/shared/codebase/tech-log-frontend`
|
||||
- 범위: TechLog public / Studio presentation, route 구성, server-state 사용, management/asset gateway 경계, 하드코딩·중복 조회·수동 네트워크 상태 관리
|
||||
- 기준: clean-architecture-frontend-template이 제공하는 route contract, server-state query/mutation runtime, failure/idempotency/cancellation 경계를 TechLog 도메인이 우회하지 않는가
|
||||
|
||||
## 결론
|
||||
|
||||
이번 검토에서 확인된 핵심 문제는 단순한 컴포넌트 중복보다 **TechLog presentation이 템플릿이 이미 제공하는 runtime 경계를 여러 군데에서 직접 다시 구현하고 있었다는 점**이었다.
|
||||
|
||||
현재 worktree 기준으로 다음 항목은 정리되었다.
|
||||
|
||||
1. Studio presentation의 직접 `StudioGateway` 호출: **0건**
|
||||
2. Studio presentation의 직접 `ManagementGateway` 호출: **0건**
|
||||
3. Studio presentation의 직접 `StudioAssetGateway` 호출: **0건**
|
||||
4. Studio presentation의 수동 `AbortController` 네트워크 lifecycle: **0건**
|
||||
5. public presentation의 `searchPublicContent("")` 기반 전체 catalog 우회: **0건**
|
||||
6. Public/Studio route 문자열 직접 조립 방지: **route contract 기반 builder + 정적 검사로 전환**
|
||||
7. app/test TypeScript, ESLint, architecture, TechLog contract sync, `git diff --check`: **PASS**
|
||||
|
||||
따라서 **template capability를 사용하지 않고 TechLog가 자체 구현으로 우회하던 주요 경계는 현재 정리된 상태**다.
|
||||
|
||||
저장소 기본 Coka 런타임은 Node `v22.23.2`지만, 시스템 Node를 변경하지 않고 `pnpm dlx node@24.11.0`으로 저장소가 요구하는 Node `24.11.0`을 일회성 실행했다. 이 환경에서 TechLog Vitest 전체 **60 files / 416 tests가 모두 통과**했고, template 공통 계층의 component regression도 **27 files / 154 tests가 모두 통과**했다.
|
||||
|
||||
따라서 TechLog의 route/server-state/network lifecycle/template primitive 활용과 Taxonomy N+1 제거는 런타임 테스트까지 검증됐다. 별도로 남는 것은 backend 공통 SpotBugs analysis classpath 문제와, 기준 소스 앱이 없어 새 증거를 만들 수 없는 browser source-parity뿐이다.
|
||||
|
||||
---
|
||||
|
||||
## 1. Public read model — 검색 API를 projection 대용으로 사용하던 문제
|
||||
|
||||
### 기존 문제
|
||||
|
||||
Home/Profile/Projects/Releases 계열에서 필요한 데이터가 “검색 결과”가 아님에도 public search 경로를 전체 catalog 조회처럼 사용하는 흔적이 있었다.
|
||||
|
||||
대표적인 문제는 다음과 같다.
|
||||
|
||||
- 빈 검색어를 전체 데이터 조회처럼 사용
|
||||
- Home에 필요한 latest/focus와 검색용 entity catalog의 의미가 섞임
|
||||
- Projects/Releases 목록이 검색 도메인의 반환 구조에 의존
|
||||
- API 의도가 presentation 요구사항과 맞지 않아 이후 pagination/cache 정책도 검색 정책에 끌려감
|
||||
|
||||
### 반영
|
||||
|
||||
`PublicContentQueries`에 화면 의도가 드러나는 read model을 추가했다.
|
||||
|
||||
- `listCatalog()`
|
||||
- `getLatestEntries()`
|
||||
- `getHomeFocusItems()`
|
||||
- `listProjects()`
|
||||
- `listReleases()`
|
||||
|
||||
HTTP adapter와 static adapter도 같은 port를 구현하도록 맞췄고 public pages는 이 projection을 직접 사용하도록 변경했다.
|
||||
|
||||
### 현재 판단
|
||||
|
||||
**완료.**
|
||||
|
||||
정적 검색 기준 `src/features/tech-log/presentation` 아래 `searchPublicContent("")` 호출은 0건이다.
|
||||
|
||||
검색은 검색에 사용하고, Home/Projects/Releases projection은 각각 자신의 read model을 사용하게 되었다.
|
||||
|
||||
---
|
||||
|
||||
## 2. Studio server-state — 컴포넌트가 직접 gateway/useEffect를 소유하던 문제
|
||||
|
||||
### 기존 문제
|
||||
|
||||
Studio의 여러 화면이 다음 패턴을 각자 반복하고 있었다.
|
||||
|
||||
```text
|
||||
useEffect
|
||||
-> AbortController 생성
|
||||
-> gateway 직접 호출
|
||||
-> loading/error/data local state
|
||||
-> cleanup에서 abort
|
||||
```
|
||||
|
||||
이 방식은 개별 화면만 보면 동작하지만 template이 제공하는 공통 server-state runtime을 우회한다.
|
||||
|
||||
그 결과 다음 기능이 화면마다 따로 구현됐다.
|
||||
|
||||
- cancellation
|
||||
- stale response 방지
|
||||
- loading/error state
|
||||
- retry
|
||||
- duplicate mutation 보호
|
||||
- idempotency key 생성/전달
|
||||
- mutation failure effect
|
||||
- query ownership
|
||||
|
||||
### 반영
|
||||
|
||||
TechLog Studio에 역할별 server-state adapter를 분리했다.
|
||||
|
||||
- `studio-document-server-state.ts`
|
||||
- `studio-workspace-server-state.ts`
|
||||
- `studio-management-server-state.ts`
|
||||
- `studio-asset-server-state.ts`
|
||||
- `studio-server-state-support.ts`
|
||||
|
||||
이 레이어에서 template의 다음 기능을 사용한다.
|
||||
|
||||
- `bindQuery`
|
||||
- `useApplicationQuery`
|
||||
- `useApplicationMutation`
|
||||
- `useServerStateScope`
|
||||
- mutation intent / idempotency
|
||||
- query/mutation failure normalization
|
||||
|
||||
### 이동한 주요 화면
|
||||
|
||||
- Studio dashboard
|
||||
- document list
|
||||
- document editor
|
||||
- validation
|
||||
- preview
|
||||
- publish
|
||||
- publication list / snapshot
|
||||
- new document
|
||||
- Home Focus
|
||||
- Project editor
|
||||
- Topic editor
|
||||
- Release list/editor
|
||||
- Taxonomy
|
||||
- Asset picker/library/upload
|
||||
|
||||
DocumentEditor의 TOPIC/PROJECT/RELATION/EVIDENCE catalog도 더 이상 별도 `AbortController + Promise.all`을 소유하지 않고 각각 `useStudioCatalogQuery`로 읽는다.
|
||||
|
||||
### 현재 판단
|
||||
|
||||
**완료.**
|
||||
|
||||
최종 정적 검색 결과:
|
||||
|
||||
```text
|
||||
direct ManagementGateway calls in Studio presentation: 0
|
||||
direct StudioAssetGateway calls in Studio presentation: 0
|
||||
direct StudioGateway operations in Studio components: 0
|
||||
manual AbortController in Studio presentation: 0
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. ManagementGateway — template mutation runtime을 써도 실제 HTTP까지 보호가 전달되지 않던 문제
|
||||
|
||||
### 기존 문제
|
||||
|
||||
Management presentation을 `useApplicationMutation`으로 감싸더라도 port 자체가 signal/idempotency를 받지 않으면 보호가 adapter 직전에서 끊긴다.
|
||||
|
||||
기존 ManagementGateway는 mutation 메서드에 다음 정보가 없었다.
|
||||
|
||||
- `AbortSignal`
|
||||
- `idempotencyKey`
|
||||
|
||||
즉 화면 레벨에서 공통 mutation runtime을 사용해도 실제 관리 API 요청은 그 intent를 전달받지 못하는 구조였다.
|
||||
|
||||
### 반영
|
||||
|
||||
ManagementGateway read에는 `RequestOptions`, mutation에는 `IdempotentOptions`를 전달하도록 계약을 강화했다.
|
||||
|
||||
HTTP management adapter는 mutation마다:
|
||||
|
||||
```text
|
||||
useApplicationMutation
|
||||
-> MutationIntent
|
||||
-> Idempotency-Key
|
||||
-> ManagementGateway
|
||||
-> StudioOperationExecutor
|
||||
```
|
||||
|
||||
경로로 이어진다.
|
||||
|
||||
테스트 타입 오류로 드러난 기존 테스트도 수정했고, management delete / topic variant wiring 테스트는 idempotency key가 executor intent까지 전달되는 형태로 보강했다.
|
||||
|
||||
### 삭제 precondition도 controller로 이동
|
||||
|
||||
Document list는 목록 계약에 version이 없기 때문에 삭제 직전 최신 document detail을 읽어 `expectedVersion`을 확보해야 한다.
|
||||
|
||||
처음에는 이 한 건만 presentation에서 직접 `gateway.getDocument()`를 호출했지만 최종적으로 composite command:
|
||||
|
||||
`deleteWorkspaceDocument`
|
||||
|
||||
뒤로 이동했다.
|
||||
|
||||
따라서 화면은 “이 document를 삭제한다”는 의도만 전달하고 다음 조립은 controller가 수행한다.
|
||||
|
||||
1. 최신 document 조회
|
||||
2. expectedVersion 획득
|
||||
3. PROJECT_DECISION이면 project 경로 사용
|
||||
4. 나머지는 document kind별 management delete
|
||||
5. 같은 mutation intent/idempotency key 전달
|
||||
|
||||
### 현재 판단
|
||||
|
||||
**완료.**
|
||||
|
||||
---
|
||||
|
||||
## 4. Asset — 자체 네트워크 상태 머신 중복
|
||||
|
||||
### 기존 문제
|
||||
|
||||
Asset 영역은 port 자체는 비교적 잘 분리되어 있었지만 presentation이 다시 네트워크 lifecycle을 직접 관리했다.
|
||||
|
||||
- 목록 검색
|
||||
- cursor “더 보기”
|
||||
- 상세 조회
|
||||
- alt/decorative metadata 저장
|
||||
- archive
|
||||
- delete
|
||||
- upload
|
||||
|
||||
특히 upload는 multipart라 일반 JSON operation과 경로가 다르지만, 이미 `StudioAssetGateway`가 signal/idempotency 계약을 지원하고 있었다.
|
||||
|
||||
### 반영
|
||||
|
||||
`studio-asset-server-state.ts`로 read/mutation ownership을 이동했다.
|
||||
|
||||
- 기본 list query
|
||||
- next-page query
|
||||
- detail query
|
||||
- update metadata mutation
|
||||
- delete mutation
|
||||
- upload mutation
|
||||
|
||||
업로드 mutation identity에는 File 객체 자체만 의존하지 않고 다음 값을 명시적으로 포함한다.
|
||||
|
||||
- file name
|
||||
- MIME type
|
||||
- size
|
||||
- lastModified
|
||||
|
||||
서로 다른 파일이 동일한 in-flight mutation identity로 취급될 가능성을 줄였다.
|
||||
|
||||
AssetLibrary의 cursor append/focus UX는 유지했다.
|
||||
|
||||
### 현재 판단
|
||||
|
||||
**완료.**
|
||||
|
||||
---
|
||||
|
||||
## 5. Route — Public/Studio URL SSOT
|
||||
|
||||
### 기존 문제
|
||||
|
||||
route registry/runtime contract가 이미 있는데 presentation이 URL 문자열을 직접 만들면 route 정의가 두 군데가 된다.
|
||||
|
||||
특히 다음 변경에 취약하다.
|
||||
|
||||
- path rename
|
||||
- param rename
|
||||
- query codec 변경
|
||||
- URL encoding
|
||||
- canonical query serialization
|
||||
|
||||
### 반영
|
||||
|
||||
공통 builder:
|
||||
|
||||
- `src/presentation/routes/route-url-builder.ts`
|
||||
|
||||
TechLog Studio facade:
|
||||
|
||||
- `src/features/tech-log/presentation/studio/studio-routes.ts`
|
||||
- `src/features/tech-log/presentation/public/public-routes.ts`
|
||||
|
||||
를 추가했다.
|
||||
|
||||
`studioRoutes.documentEdit(id)`, `publicRoutes.project(slug)`처럼 route ID + codec을 통해 URL을 만든다.
|
||||
|
||||
또한 `scripts/check-tech-log-route-literals.ts`를 architecture check에 연결해 TechLog route registry에서 실제 route root를 파생해 Public/Studio route literal을 다시 하드코딩하면 검사가 실패하도록 했다.
|
||||
|
||||
### 현재 판단
|
||||
|
||||
**완료.**
|
||||
|
||||
주석 안의 `/studio/documents/*` 설명 문자열은 runtime route literal이 아니므로 검사 대상에서 제외된다.
|
||||
|
||||
---
|
||||
|
||||
## 5.1 후속 리뷰 반영 — form/theme/i18n/Asset boundary
|
||||
|
||||
후속 검토에서 기존 완료 판정을 다시 대조했고 다음 잔여 항목까지 반영했다.
|
||||
|
||||
- Public route도 `public-routes.ts`에서 contract/codec 기반으로 생성한다.
|
||||
- Project/Topic/Release 편집 lifecycle을 template `useAppForm`으로 통일했다.
|
||||
- concrete palette는 `tech-log-theme.css` 한 곳에 두고 feature CSS는 semantic token만 사용한다.
|
||||
- route/navigation/status/failure copy를 TechLog message catalog와 locale hook으로 이동했다.
|
||||
- Asset UI는 `StudioAssetGateway` prop을 받지 않고 server-state hook을 통해 Provider 경계에서만 gateway를 사용한다.
|
||||
- raw `<form>` / `<dialog>`은 TechLog presentation 기준 0건이다.
|
||||
|
||||
Markdown block, ordered list, asset card처럼 도메인 편집 자체를 표현하는 low-level native control은 기존 DOM/CSS 계약을 보존했다. 공통 lifecycle을 재구현하는 지점만 template capability로 이동하는 것이 적용 기준이다.
|
||||
|
||||
**상태: 완료.**
|
||||
|
||||
---
|
||||
|
||||
## 6. 하드코딩 검토
|
||||
|
||||
### 정리된 하드코딩
|
||||
|
||||
- Studio route path 직접 문자열
|
||||
- public 빈 검색어를 이용한 전체 catalog 조회
|
||||
- document kind를 좁히는 unsafe cast 기반 delete routing
|
||||
- 화면별 수동 idempotency key 생성
|
||||
- 화면별 수동 request cancellation
|
||||
- Project activity 허용값의 frontend 독립 배열
|
||||
- Release change type 허용값의 frontend 독립 배열
|
||||
|
||||
### activity/change type도 계약 source-of-truth로 이동
|
||||
|
||||
이전에는 management OpenAPI가 activityType과 changeTypes[]를 단순 string으로 노출했다. 그래서 frontend는 백엔드가 허용하는 값 집합을 별도 배열로 다시 적어야 했고, 서버 제약과 UI가 서로 어긋나도 TypeScript가 잡을 수 없었다.
|
||||
|
||||
이번 작업에서 backend management OpenAPI에 실제 애플리케이션이 허용하는 값을 enum으로 명시했다.
|
||||
|
||||
- Project activity: PHASE_CHANGED, QUESTION_OPENED, QUESTION_RESOLVED, DECISION_ACCEPTED, CASE_PUBLISHED, REFERENCE_PUBLISHED, MILESTONE_REACHED, PROJECT_PAUSED, PROJECT_RESUMED
|
||||
- Release change: FEATURE, FIX, REFACTOR, DOCS, INFRA, BREAKING
|
||||
|
||||
frontend generated contract는 이제 이 필드를 literal union으로 생성한다. presentation의 한국어 문구는 Record<generated-union, string>으로만 관리하므로 값이 추가되거나 빠지면 compile 단계에서 label map도 함께 수정해야 한다.
|
||||
|
||||
즉 **값의 허용 범위는 management contract**, **표시 문구는 presentation**이 소유한다. 같은 도메인 값 집합을 component마다 다시 선언하는 구조는 제거됐다.
|
||||
|
||||
---
|
||||
|
||||
## 7. 성능/조회 구조 검토
|
||||
|
||||
### 개선된 부분
|
||||
|
||||
- empty search를 전체 catalog API처럼 호출하던 경로 제거
|
||||
- query cancellation/dedup ownership을 공통 runtime으로 이동
|
||||
- 검색 입력과 제출 query 분리 유지
|
||||
- Asset pagination append 유지
|
||||
- 화면마다 중복되던 request lifecycle 제거
|
||||
- server-state query가 같은 scope/identity로 관리됨
|
||||
|
||||
### Taxonomy project-topic N+1 제거
|
||||
|
||||
기존 Taxonomy 구조 탭은 ProjectIndexItem에 topicIds가 없어 다음 요청을 만들었다.
|
||||
|
||||
1. topics 목록 1회
|
||||
2. projects 목록 1회
|
||||
3. project 수만큼 getProjectForEdit 상세 조회
|
||||
|
||||
Promise.all로 병렬화해도 API 호출 수는 2 + N이었다.
|
||||
|
||||
이번에는 management 목록 계약 자체를 확장했다.
|
||||
|
||||
- ProjectIndexItem.topicIds: uuid[] 추가
|
||||
- 목록에서 공개 경로를 연결할 때 필요한 ProjectIndexItem.slug도 정식 계약에 추가
|
||||
- frontend Taxonomy는 topics 1회 + projects 1회만 호출
|
||||
- project-topic 연결은 ProjectIndexItem.topicIds에서 바로 구성
|
||||
- per-project getProjectForEdit 호출 제거
|
||||
|
||||
backend persistence도 단순히 N+1을 서버 내부로 옮기지 않았다. 현재 페이지의 project 목록을 읽은 뒤 project_topic을 project_id IN (:projectIds)로 한 번에 조회해 project id별로 조립한다.
|
||||
|
||||
따라서 한 Taxonomy 조회에서 project 수가 증가해도 project 목록 관련 DB query count는 다음으로 고정된다.
|
||||
|
||||
1. project index 1회
|
||||
2. 현재 페이지 project들의 project-topic relation bulk 조회 1회
|
||||
|
||||
frontend 회귀 테스트는 getProject를 호출하면 실패하도록 구성했고, backend PostgreSQL integration test는 index projection이 slug와 topicIds 순서를 실제로 보존하는지 검증하도록 추가했다.
|
||||
|
||||
**구현 상태: 완료. 최종 테스트 결과는 아래 검증 절에 기록한다.**
|
||||
|
||||
---
|
||||
|
||||
## 8. 런타임 검증에서 추가로 발견한 template 통합 결함
|
||||
|
||||
정적 검사만으로는 드러나지 않았지만 Node 24에서 실제 TechLog suite를 실행하면서 다음 통합 결함이 확인됐다. 모두 수정 후 회귀 테스트를 통과했다.
|
||||
|
||||
### nullable query
|
||||
|
||||
`useApplicationQuery`가 `null`을 “아직 데이터가 없음”으로 해석하고 있었다. TechLog의 `Preview 없음 = null`은 정상 성공값이므로 화면이 영구 `initial-loading`에 머물 수 있었다.
|
||||
|
||||
현재는 `undefined`만 미수신 상태로 보고, `null`은 수신된 empty value로 처리한다. 공통 async-state 테스트에 `data: null -> empty` 계약을 추가했다.
|
||||
|
||||
### host object mutation identity
|
||||
|
||||
Asset upload payload는 `File`을 포함한다. 공통 mutation이 전송 input 전체를 canonicalize하면 plain object가 아닌 `File`에서 identity 생성이 실패한다.
|
||||
|
||||
`BoundMutation`에 `identity(input)` projection을 추가해 전송 payload와 command identity를 분리했다. Asset upload는 `File` 자체를 전송하되 identity에는 `fileIdentity`, `kind`, `decorative`, `altText`만 사용한다. 공통 application-query 테스트로 이 계약을 고정했다.
|
||||
|
||||
### mutation mount timing
|
||||
|
||||
mutation controller가 mount된 직후 effect가 unknown-effect channel을 publish하기 전에 사용자가 submit하면 정상 command도 channel limit failure로 거절될 수 있었다.
|
||||
|
||||
submit 경로에서도 현재 scope에 대해 channel을 lazy-acquire하도록 수정했다. scope 충돌이나 registry saturation은 그대로 fail-closed 한다.
|
||||
|
||||
### Dashboard result budget
|
||||
|
||||
Dashboard query는 결과 객체 하나를 반환하지만 내부 row 개수를 `itemCount`로 계산해 `maxResultItems=1` budget을 정상 응답이 초과할 수 있었다.
|
||||
|
||||
`itemCount=1`로 수정하고 내부 row 수는 estimated bytes에만 반영했다.
|
||||
|
||||
### Dialog / Pagination primitive
|
||||
|
||||
공통 `Dialog`에 initial focus, focus return, Tab boundary trap, 별도 accessible title을 보강했다. Public Search, Evidence zoom, Asset Upload, Asset Picker가 동일 lifecycle을 사용한다.
|
||||
|
||||
공통 `Pagination`은 기본 link semantics를 유지하면서 `pageControl="button"`과 `pageAccessibleLabel`을 지원하도록 확장했다. Studio는 기존 UX 계약대로 숫자는 짧게 보이고 접근성 이름은 `N 페이지`로 유지한다.
|
||||
|
||||
### test composition
|
||||
|
||||
production app은 `ServerStateGenerationProvider` 아래에서 실행되는데 일부 TechLog component test는 직접 `StudioProvider`만 렌더하고 있었다. 테스트 helper를 실제 provider stack과 동일한 QueryClient / MutationIntent / ServerStateScope / QueryInvalidation 구조로 맞췄다.
|
||||
|
||||
---
|
||||
|
||||
## 9. 검증 결과
|
||||
|
||||
### frontend 정적/빌드 — PASS
|
||||
|
||||
실행한 게이트:
|
||||
- check:types
|
||||
- lint
|
||||
- check:architecture
|
||||
- check:design-system
|
||||
- check:tech-log-contract
|
||||
- check:i18n
|
||||
- build:app-only
|
||||
- git diff --check
|
||||
|
||||
최종 결과:
|
||||
|
||||
~~~text
|
||||
Static import graph: 500 modules, 1775 dependencies, all imports resolved
|
||||
Architecture graph fixtures: 14 regression checks PASS
|
||||
TypeScript-only source policy: PASS
|
||||
Architecture fixtures: allowed PASS, 9 forbidden rejected
|
||||
TechLog route source-of-truth: PASS
|
||||
Design system contract: 48 tokens and vendor boundaries PASS
|
||||
I18n contract: 282 keys across 4 locales PASS
|
||||
production Vite build: PASS
|
||||
git diff --check: PASS
|
||||
~~~
|
||||
|
||||
Contract sync:
|
||||
|
||||
~~~text
|
||||
@tech-log/studio-contract@3.1.0 — 19 operations
|
||||
@tech-log/public-contract@2.1.0 — 22 operations
|
||||
@tech-log/management-contract@1.0.0 — 87 operations
|
||||
contracts are in sync
|
||||
~~~
|
||||
|
||||
추가 정적 검색:
|
||||
|
||||
~~~text
|
||||
raw <dialog> in TechLog presentation: 0
|
||||
manual AbortController in TechLog presentation: 0
|
||||
searchPublicContent("") in TechLog: 0
|
||||
getProject(project.id) Taxonomy fan-out: 0
|
||||
frontend ACTIVITY_TYPES 허용값 배열: 0
|
||||
frontend CHANGE_TYPES 허용값 배열: 0
|
||||
~~~
|
||||
|
||||
### Node 24 TechLog Vitest — PASS
|
||||
|
||||
시스템 Node는 변경하지 않고 one-off Node 24.11.0으로 실행했다.
|
||||
|
||||
~~~text
|
||||
Test Files 60 passed (60)
|
||||
Tests 416 passed (416)
|
||||
~~~
|
||||
|
||||
새 taxonomy-projection.test.tsx는 Taxonomy가 project index의 topicIds만으로 구조를 만들고 project detail gateway를 호출하지 않는 것을 고정한다.
|
||||
|
||||
**상태: 완료.**
|
||||
|
||||
### template 공통 회귀 테스트 — PASS
|
||||
|
||||
~~~text
|
||||
application-query.test.tsx 29 passed
|
||||
async-surface.test.tsx 17 passed
|
||||
design-system-platform.test.tsx 8 passed
|
||||
locale-platform.test.tsx 3 passed
|
||||
합계 57 passed
|
||||
~~~
|
||||
|
||||
**상태: 완료.**
|
||||
|
||||
### backend management projection — PASS
|
||||
|
||||
Taxonomy N+1 제거를 위해 backend management 계약과 persistence projection까지 확장했다.
|
||||
|
||||
- ProjectIndexItemView에 slug, topicIds 추가
|
||||
- project 목록 1회 + project_topic bulk 조회 1회로 조립
|
||||
- management OpenAPI에 ProjectIndexItem.topicIds 추가
|
||||
- project activity / release change 허용값을 OpenAPI enum으로 고정
|
||||
- generated web model과 application string 경계 mapper 연결
|
||||
- PostgreSQL integration test에 project index slug/topicIds 검증 추가
|
||||
|
||||
실제 PostgreSQL management integration:
|
||||
|
||||
~~~text
|
||||
:adapter:outbound:persistence-jpa:postgresqlTechLogManagementPersistenceIntegrationTest
|
||||
BUILD SUCCESSFUL
|
||||
~~~
|
||||
|
||||
변경 모듈의 test / checkstyle / spotless:
|
||||
|
||||
~~~text
|
||||
application-core
|
||||
persistence-jpa
|
||||
inbound-web
|
||||
|
||||
BUILD SUCCESSFUL in 19s
|
||||
36 actionable tasks: 6 executed, 30 up-to-date
|
||||
~~~
|
||||
|
||||
**상태: 완료.**
|
||||
|
||||
### backend repository 전체 check — 기존 SpotBugs classpath issue
|
||||
|
||||
backend 전체 ./gradlew check는 이번 변경 파일의 컴파일/테스트 오류가 아니라 다음 기존 분석 classpath 문제에서 중단됐다.
|
||||
|
||||
~~~text
|
||||
:app-bootstrap:spotbugsFunctionalTest
|
||||
missing analysis class:
|
||||
dev.caskeleton.shared.error.ApiErrorCarrier
|
||||
dev.caskeleton.shared.error.ApiErrorCode
|
||||
~~~
|
||||
|
||||
변경 모듈을 별도로 검증했을 때도 application-core:spotbugsMain이 동일 계열의 shared-contract 분석 class 누락으로 실패한다.
|
||||
|
||||
따라서 이번 management projection 변경은 PostgreSQL integration, module test, checkstyle, spotless로 검증 완료했으며 repository 전체 SpotBugs classpath 문제는 별도 build-qualification 이슈다.
|
||||
|
||||
### browser source-parity — 실행 조건 부족
|
||||
|
||||
browser parity runner가 요구하는 기준 source app이 현재 Coka 환경에 없다.
|
||||
|
||||
~~~text
|
||||
source: http://127.0.0.1:4375
|
||||
target: http://127.0.0.1:4174
|
||||
source root: /home/donghyeon/workspace/techlog-studio-frontend
|
||||
~~~
|
||||
|
||||
기준 source root와 두 서버가 준비되지 않은 상태에서 실행하면 ERR_CONNECTION_REFUSED가 발생한다.
|
||||
|
||||
이 항목은 구현 미완료가 아니라 외부 비교 기준 부재로 증거를 새로 생성할 수 없는 상태다.
|
||||
|
||||
---
|
||||
|
||||
## 10. 최종 상태
|
||||
|
||||
| 검토 항목 | 상태 |
|
||||
|---|---|
|
||||
| template HTTP binding 활용 | 완료 |
|
||||
| template route capability 활용 | 완료 |
|
||||
| Studio server-state capability 활용 | 완료 |
|
||||
| mutation idempotency / host-object identity | 완료 |
|
||||
| cancellation ownership | 완료 |
|
||||
| shared Dialog / Pagination / Form primitive 활용 | 완료 |
|
||||
| semantic design token 연결 | 완료 |
|
||||
| ManagementGateway presentation 직접 호출 제거 | 완료 |
|
||||
| StudioGateway presentation 직접 호출 제거 | 완료 |
|
||||
| AssetGateway presentation 직접 호출 제거 | 완료 |
|
||||
| public empty-search projection 우회 제거 | 완료 |
|
||||
| route hardcoding guard | 완료 |
|
||||
| activity/change type contract enum화 | 완료 |
|
||||
| Taxonomy project-topic N+1 제거 | 완료 |
|
||||
| frontend typecheck | 완료 |
|
||||
| frontend lint | 완료 |
|
||||
| architecture check | 완료 |
|
||||
| design-system check | 완료 |
|
||||
| TechLog contract sync | 완료 |
|
||||
| repository i18n gate | 완료 |
|
||||
| production Vite build | 완료 |
|
||||
| Node 24 TechLog Vitest 416/416 | 완료 |
|
||||
| template component regression 154/154 | 완료 |
|
||||
| backend PostgreSQL management integration | 완료 |
|
||||
| backend 변경 모듈 test/checkstyle/spotless | 완료 |
|
||||
| backend repository 전체 SpotBugs | 아직 더 봐야댐 — 기존 shared-contract 분석 classpath 문제 |
|
||||
| browser source-parity evidence | 아직 더 봐야댐 — baseline/source app 부재 |
|
||||
|
||||
## 11. 남은 범위
|
||||
|
||||
이번 리뷰에서 확인한 TechLog frontend/template 활용, Taxonomy N+1, 관리 계약 허용값 하드코딩, i18n gate는 완료했다.
|
||||
|
||||
**Frontend 코드 수정으로 남은 TechLog 리뷰 항목은 없다.** 현재 별도로 남는 것은 두 가지 외부/공통 검증 조건이다.
|
||||
|
||||
1. backend build-qualification의 SpotBugs analysis classpath 누락 문제
|
||||
2. browser source-parity용 원본 source app 및 source/target 서버 준비
|
||||
|
||||
둘 다 이번 TechLog presentation/refactor 구현의 미완료 항목과는 분리된다.
|
||||
|
||||
---
|
||||
|
||||
## 12. 2026-09-22 재검수 종료
|
||||
|
||||
2026-09-22 재검수에서 이전에 남아 있던 네 축을 다시 확인했다.
|
||||
|
||||
- TechLogFeatureInput은 raw gateway factory 대신 createStudioApplication()을 노출한다.
|
||||
- StudioContextValue는 studioApplication만 노출하며 presentation component/controller의 raw gateway 직접 호출은 0건이다.
|
||||
- TechLog presentation의 raw button/input/select/textarea, form, dialog는 모두 0건이다.
|
||||
- 일반 행동 문구는 message catalog를 사용한다. 최종 검색에 남은 게시/공개/검증/검색 등의 직접 문자열은 상태명, field label, heading 등 이번 리뷰의 behavioral copy 대상에서 제외한 표현이다.
|
||||
- AssetLibrary, TaxonomyManager, ProjectEditor, TopicEditor, DocumentList 다섯 화면 모두 controller hook 경계를 가진다.
|
||||
- DocumentList의 search params, query composition, pagination, delete orchestration, search/filter synchronization은 use-document-list-controller.ts가 소유한다.
|
||||
|
||||
정적 증거:
|
||||
|
||||
~~~text
|
||||
raw native control = 0
|
||||
raw form = 0
|
||||
raw dialog = 0
|
||||
gateway port import = 0
|
||||
component gateway direct call = 0
|
||||
controller files = 5
|
||||
behavioral action literal = 0
|
||||
~~~
|
||||
|
||||
Node 24.11.0 최종 검증:
|
||||
|
||||
~~~text
|
||||
types=PASS
|
||||
lint=PASS
|
||||
architecture=PASS
|
||||
design=PASS
|
||||
contract=PASS
|
||||
i18n=PASS
|
||||
techlog-tests=PASS
|
||||
component-tests=PASS
|
||||
build=PASS
|
||||
diff=PASS
|
||||
|
||||
TechLog tests: 60 files / 416 tests PASS
|
||||
Component tests: 27 files / 154 tests PASS
|
||||
~~~
|
||||
|
||||
| 리뷰 항목 | 판정 |
|
||||
|---|---|
|
||||
| template HTTP binding 활용 | 완료 |
|
||||
| Public/Studio route capability 및 route hardcoding 제거 | 완료 |
|
||||
| Studio server-state / cancellation ownership | 완료 |
|
||||
| TechLogFeatureInput / StudioContext application boundary | 완료 |
|
||||
| design-system native control / Form / Dialog primitive 적용 | 완료 |
|
||||
| behavioral action/error/loading/empty copy i18n | 완료 |
|
||||
| 대형 Studio component controller/view-state 분리 | 완료 |
|
||||
| management contract 기반 허용값 SSOT | 완료 |
|
||||
| Taxonomy project-topic N+1 제거 | 완료 |
|
||||
| TechLog/component/정적/빌드 회귀 검증 | 완료 |
|
||||
|
||||
완료: 10
|
||||
아직 더 봐야댐: 0
|
||||
|
||||
이 판정은 TechLog frontend/template 활용 재검수 10개 축에 대한 것이다. 기존 문서에 기록된 backend 공통 SpotBugs classpath와 browser source-parity 실행 조건은 이 10개 축의 구현 미완료 항목으로 계산하지 않는다.
|
||||
|
||||
---
|
||||
|
||||
## 작업트리 주의
|
||||
|
||||
이번 검토를 시작할 때 저장소에는 이미 여러 변경이 존재했다. 기존 변경을 보존한 상태에서 작업했으며 destructive git 명령, reset, checkout, commit, merge는 수행하지 않았다.
|
||||
|
||||
따라서 현재 전체 `git diff`를 전부 이번 리뷰의 신규 변경이라고 간주하면 안 된다. 이 문서는 이번 세션에서 직접 확인한 구조적 문제와 현재 worktree에서 검증된 최종 상태를 기준으로 작성했다.
|
||||
@@ -0,0 +1,121 @@
|
||||
# TechLog Frontend — template 활용 재검수
|
||||
|
||||
- 날짜: 2026-09-22
|
||||
- 대상: /shared/codebase/tech-log-frontend
|
||||
- 기준 문서: docs/reviews/2026-09-21-tech-log-template-utilization-review.md
|
||||
- 목적: 이전 재검수에서 남아 있던 4개 축을 닫고 기존 완료 항목까지 포함해 10개 축을 최종 판정한다.
|
||||
|
||||
## 결론
|
||||
|
||||
| 리뷰 항목 | 판정 |
|
||||
|---|---|
|
||||
| template HTTP binding 활용 | 완료 |
|
||||
| Public/Studio route capability 및 route hardcoding 제거 | 완료 |
|
||||
| Studio server-state / cancellation ownership | 완료 |
|
||||
| TechLogFeatureInput / StudioContext application boundary | 완료 |
|
||||
| design-system native control / Form / Dialog primitive 적용 | 완료 |
|
||||
| behavioral action/error/loading/empty copy i18n | 완료 |
|
||||
| 대형 Studio component controller/view-state 분리 | 완료 |
|
||||
| management contract 기반 허용값 SSOT | 완료 |
|
||||
| Taxonomy project-topic N+1 제거 | 완료 |
|
||||
| TechLog/component/정적/빌드 회귀 검증 | 완료 |
|
||||
|
||||
완료: 10
|
||||
아직 더 봐야댐: 0
|
||||
|
||||
## 남았던 4개 축
|
||||
|
||||
### 1. TechLogFeatureInput / StudioContext raw gateway 노출
|
||||
|
||||
TechLogFeatureInput은 raw gateway factory를 노출하지 않고 createStudioApplication()으로 application facade를 만든다. StudioContextValue도 studioApplication만 노출한다.
|
||||
|
||||
최종 정적 결과:
|
||||
|
||||
~~~text
|
||||
gateway port import = 0
|
||||
component gateway direct call = 0
|
||||
~~~
|
||||
|
||||
Studio의 studio-*-server-state.ts 내부에는 application facade가 캡슐화한 gateway 호출이 존재하지만, component/controller가 gateway를 직접 호출하는 구조는 아니다.
|
||||
|
||||
판정: 완료
|
||||
|
||||
### 2. design-system primitive
|
||||
|
||||
TechLog presentation에서 native control과 raw form/dialog를 다시 검색했다.
|
||||
|
||||
~~~text
|
||||
raw native control = 0
|
||||
raw form = 0
|
||||
raw dialog = 0
|
||||
~~~
|
||||
|
||||
기존 DOM/CSS를 보존해야 하는 화면은 template primitive의 visualPolicy=inherit 경로를 사용한다.
|
||||
|
||||
판정: 완료
|
||||
|
||||
### 3. behavioral copy i18n
|
||||
|
||||
일반 행동 버튼과 action prop의 저장, 추가, 검색, 취소, 다시 시도, 삭제, 더 보기, 닫기, 업로드, 게시, 공개, 검증, 적용, 삽입, 필터 초기화 등을 message catalog로 이동했다.
|
||||
|
||||
최종 검색에 남는 동일 단어는 publication 상태명, field label, heading, 동적 noun 기반 버튼 등 리뷰에서 behavioral copy 대상으로 잡지 않은 표현이다.
|
||||
|
||||
Unsaved navigation의 기존 접근성 이름 저장 중도 별도 catalog key로 유지해 i18n 이동 때문에 UI 계약이 바뀌지 않도록 했다.
|
||||
|
||||
판정: 완료
|
||||
|
||||
### 4. 대형 Studio component controller/view-state 분리
|
||||
|
||||
다음 5개 controller가 존재한다.
|
||||
|
||||
~~~text
|
||||
use-asset-library-controller.ts
|
||||
use-taxonomy-controller.ts
|
||||
use-project-editor-controller.ts
|
||||
use-topic-editor-controller.ts
|
||||
use-document-list-controller.ts
|
||||
~~~
|
||||
|
||||
DocumentList의 useSearchParams, query composition, pagination, pageOverride, delete orchestration, search/filter synchronization은 controller가 소유한다. component는 controller state를 렌더하고 action을 호출하는 역할로 남아 있다.
|
||||
|
||||
판정: 완료
|
||||
|
||||
## 최종 검증
|
||||
|
||||
Node 24.11.0 기준:
|
||||
|
||||
~~~text
|
||||
types=PASS
|
||||
lint=PASS
|
||||
architecture=PASS
|
||||
design=PASS
|
||||
contract=PASS
|
||||
i18n=PASS
|
||||
techlog-tests=PASS
|
||||
component-tests=PASS
|
||||
build=PASS
|
||||
diff=PASS
|
||||
~~~
|
||||
|
||||
테스트:
|
||||
|
||||
~~~text
|
||||
TechLog: 60 files / 416 tests PASS
|
||||
Component regression: 27 files / 154 tests PASS
|
||||
~~~
|
||||
|
||||
정적 증거:
|
||||
|
||||
~~~text
|
||||
raw native control = 0
|
||||
raw form = 0
|
||||
raw dialog = 0
|
||||
gateway port import = 0
|
||||
component gateway direct call = 0
|
||||
controller files = 5
|
||||
behavioral action literal = 0
|
||||
~~~
|
||||
|
||||
## 범위 주의
|
||||
|
||||
기존 리뷰 문서에 기록된 backend 공통 SpotBugs analysis classpath 문제와 browser source-parity 실행 조건 부족은 이번 TechLog frontend/template 활용 10개 축과 별도다. 이번 재검수에서 frontend 코드 수정으로 남은 항목은 없다.
|
||||
@@ -0,0 +1,185 @@
|
||||
# TechLog Frontend — 2026-09-23 재검수 및 구현 결과
|
||||
|
||||
- 대상: `/shared/codebase/tech-log-frontend`
|
||||
- 기준: 2026-09-23 재검수에서 `완료: 8`, `아직 더 봐야댐: 2`로 판정한 10개 항목
|
||||
- 수정 대상: application boundary, behavioral action/error/loading/empty copy i18n
|
||||
- 검증 런타임: Node `v24.11.0`
|
||||
- 기존 작업트리: 보존. reset / checkout / clean / commit 수행하지 않음
|
||||
|
||||
## 결론
|
||||
|
||||
2026-09-23 재검수 당시 남아 있던 두 항목을 구현하고 현재 worktree에서 다시 검증했다.
|
||||
|
||||
| 항목 | 판정 |
|
||||
|---|---|
|
||||
| template HTTP binding | 완료 |
|
||||
| route capability / hardcoding 제거 | 완료 |
|
||||
| Studio server-state | 완료 |
|
||||
| application boundary | 완료 |
|
||||
| design-system primitive | 완료 |
|
||||
| behavioral copy i18n | 완료 |
|
||||
| controller/view-state 분리 | 완료 |
|
||||
| management allowed-value SSOT | 완료 |
|
||||
| Taxonomy N+1 제거 | 완료 |
|
||||
| 회귀 검증 | 완료 |
|
||||
|
||||
완료: 10
|
||||
아직 더 봐야댐: 0
|
||||
|
||||
## 1. Application boundary
|
||||
|
||||
### 이전 상태
|
||||
|
||||
`TechLogStudioApplication`이 아래 outbound port를 그대로 노출했다.
|
||||
|
||||
```text
|
||||
documents: StudioGateway
|
||||
assets: StudioAssetGateway
|
||||
management: ManagementGateway
|
||||
```
|
||||
|
||||
따라서 이름은 application facade였지만 presentation server-state가 다시 raw outbound port를 꺼낼 수 있었다.
|
||||
|
||||
### 현재 상태
|
||||
|
||||
`TechLogStudioApplication`은 application-owned capability만 노출한다.
|
||||
|
||||
```text
|
||||
workspaceQueries
|
||||
workspaceCommands
|
||||
documentQueries
|
||||
documentCommands
|
||||
assetQueries
|
||||
assetCommands
|
||||
managementQueries
|
||||
managementCommands
|
||||
```
|
||||
|
||||
`StudioGateway`, `StudioAssetGateway`, `ManagementGateway`는 `createTechLogStudioApplication(...)`의 내부 dependency로만 사용한다. factory dependency 타입도 export하지 않는다.
|
||||
|
||||
`create-tech-log-feature-input.ts`는 세 adapter를 만든 뒤 application factory에 주입한다. Studio presentation은 더 이상 `.documents`, `.assets`, `.management`를 꺼내지 않고 application capability를 사용한다.
|
||||
|
||||
기존 테스트가 gateway test-double을 직접 조작해야 하는 경우는 `tests/helpers/studio-application-gateway-adapter.ts`에서만 gateway-shaped test adapter를 만든다. 이 adapter는 production presentation 경계를 우회하지 않는다.
|
||||
|
||||
정적 증거:
|
||||
|
||||
```text
|
||||
application_public_gateway_tokens=0
|
||||
application_dependency_export=0
|
||||
presentation_gateway_port_import=0
|
||||
presentation_old_app_property=0
|
||||
component_controller_gateway_call=0
|
||||
```
|
||||
|
||||
판정: 완료
|
||||
|
||||
## 2. Behavioral copy i18n
|
||||
|
||||
### 이전 상태
|
||||
|
||||
message catalog가 존재했지만 TechLog feature presentation은 `scripts/check-i18n.ts`의 hardcoded-locale 검사 범위에 포함되지 않았다. 따라서 `check:i18n=PASS`만으로는 TechLog behavioral copy 이관 완료를 증명할 수 없었다.
|
||||
|
||||
실제 새 gate를 처음 적용했을 때 action/error/loading/empty/not-found/announcement 계열 위반이 다수 확인됐다.
|
||||
|
||||
### 현재 상태
|
||||
|
||||
`src/features/tech-log/contracts/tech-log-message-catalog.ts`에 behavioral copy를 ko-KR/en-US 쌍으로 이동했다. 동적 성공 announcement도 `{title}`, `{name}`, `{version}` interpolation으로 이동했다.
|
||||
|
||||
추가된 검사 경계:
|
||||
|
||||
- `scripts/lib/tech-log-i18n-policy.ts`
|
||||
- `tests/unit/tech-log-i18n-gate.test.ts`
|
||||
- `scripts/check-i18n.ts`의 `src/features/tech-log/presentation` 별도 behavioral scan
|
||||
|
||||
공통 presentation의 기존 blanket Korean literal 검사는 그대로 유지한다. TechLog에는 별도 targeted policy를 적용해 다음은 차단한다.
|
||||
|
||||
- direct `setRequestAnnouncement`, `setNotice`, `setSuccess` literal
|
||||
- 동적 template/문자열 조합 announcement
|
||||
- static Button/Link action text
|
||||
- `pendingLabel`, `closeLabel`, `resetLabel`, `clearLabel` 등 action prop literal
|
||||
- error/failure fallback literal
|
||||
- public error/empty/not-found behavioral surface literal
|
||||
|
||||
반대로 heading, field label, publication/domain status 같은 editorial/domain copy는 blanket 금지하지 않는다.
|
||||
|
||||
최종 증거:
|
||||
|
||||
```text
|
||||
behavioral_literal_violations=0
|
||||
checked_techlog_presentation_files=148
|
||||
I18n contract: 460 keys across 4 locales PASS
|
||||
I18n policy tests: 1 file / 3 tests PASS
|
||||
```
|
||||
|
||||
판정: 완료
|
||||
|
||||
## 3. 기존 완료 항목 회귀
|
||||
|
||||
이번 수정 후에도 기존 구조적 완료 조건을 다시 확인했다.
|
||||
|
||||
```text
|
||||
raw_native_control=0
|
||||
raw_form=0
|
||||
raw_dialog=0
|
||||
controllers=5
|
||||
```
|
||||
|
||||
application boundary 변경 후 component/controller에는 raw gateway 직접 호출이 없다. design-system native control/Form/Dialog 경계와 controller 분리도 유지된다.
|
||||
|
||||
판정: 완료
|
||||
|
||||
## 4. 최종 회귀 검증
|
||||
|
||||
Node `v24.11.0`에서 현재 worktree를 다시 실행했다.
|
||||
|
||||
```text
|
||||
check:types PASS
|
||||
lint PASS
|
||||
check:architecture PASS
|
||||
check:design-system PASS
|
||||
check:tech-log-contract PASS
|
||||
check:i18n PASS
|
||||
i18n policy unit tests PASS
|
||||
test:tech-log PASS
|
||||
test:component PASS
|
||||
build:app-only PASS
|
||||
git diff --check PASS
|
||||
```
|
||||
|
||||
테스트 수:
|
||||
|
||||
```text
|
||||
TechLog: 61 files / 417 tests PASS
|
||||
Component: 27 files / 154 tests PASS
|
||||
I18n policy: 1 file / 3 tests PASS
|
||||
```
|
||||
|
||||
TechLog suite는 application boundary regression test가 추가되어 이전 60 files / 416 tests에서 61 files / 417 tests로 증가했다.
|
||||
|
||||
최종 전체 로그:
|
||||
|
||||
```text
|
||||
/shared/.coka-logs/tech-log-frontend-final-verification-v4-20260923.log
|
||||
```
|
||||
|
||||
판정: 완료
|
||||
|
||||
## 5. 작업트리 주의
|
||||
|
||||
현재 `git status --short` 기준:
|
||||
|
||||
```text
|
||||
status_total=177
|
||||
modified_entries=149
|
||||
untracked=27
|
||||
deleted_entries=1
|
||||
```
|
||||
|
||||
이 수치는 이번 작업 이전부터 존재하던 대규모 미커밋 변경과 이번 구현 변경을 함께 포함한다. 기존 사용자 변경을 reset, checkout, clean 하지 않았다. commit도 생성하지 않았다.
|
||||
|
||||
## 최종 판정
|
||||
|
||||
2026-09-23 재검수 당시 `아직 더 봐야댐`이었던 application boundary와 behavioral copy i18n 두 항목은 현재 구현과 검증 기준에서 완료다.
|
||||
|
||||
완료: 10
|
||||
아직 더 봐야댐: 0
|
||||
@@ -0,0 +1,148 @@
|
||||
# TechLog Application Boundary + Behavioral i18n Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox syntax for tracking.
|
||||
|
||||
**Goal:** Close the two remaining TechLog re-review items so the application API hides outbound gateways and TechLog behavioral copy is catalog-driven and enforced by `check:i18n`.
|
||||
|
||||
**Architecture:** `createTechLogStudioApplication()` owns `StudioGateway`, `StudioAssetGateway`, and `ManagementGateway` privately and exposes application-owned query/command capability objects. TechLog presentation keeps using server-state hooks, but server-state calls application capabilities rather than extracting gateway ports. Behavioral copy moves to the TechLog message catalog with interpolation, and `scripts/check-i18n.ts` gains a targeted TechLog behavioral scanner rather than a blanket Korean-literal ban.
|
||||
|
||||
**Tech Stack:** TypeScript 7, React, Vitest, pnpm, custom architecture/i18n check scripts.
|
||||
|
||||
**Spec:** `docs/superpowers/specs/2026-09-23-tech-log-application-boundary-i18n-design.md`
|
||||
|
||||
## Global Constraints
|
||||
|
||||
- Preserve all existing user changes; no reset/checkout/clean/commit/merge.
|
||||
- Use Node 24.11.0 for verification without changing repository configuration.
|
||||
- Do not intentionally change visible Korean copy or accessibility names.
|
||||
- `TechLogStudioApplication` must not expose, alias, extend, or return `StudioGateway`, `StudioAssetGateway`, or `ManagementGateway` objects.
|
||||
- Components/controllers must not gain direct gateway/application orchestration that belongs in server-state.
|
||||
- TechLog i18n gate targets behavioral copy only; headings, field labels, help text, domain status labels, and dynamic noun labels remain allowed.
|
||||
|
||||
## Review Focus
|
||||
|
||||
- Application capability methods preserve signal/idempotency options exactly; focused delegation test covers both query and mutation paths.
|
||||
- Management capability split does not drop any operation currently consumed by `studio-management-server-state.ts`; typecheck and TechLog tests pin the full surface.
|
||||
- Dynamic delete announcements preserve interpolation values and Korean rendering.
|
||||
- i18n gate rejects direct behavioral announcements/actions but permits headings/field labels/domain status literals.
|
||||
- Existing accessible copy such as `저장 중` remains byte-for-byte unchanged.
|
||||
|
||||
---
|
||||
|
||||
### Task 1: Application-owned Studio capability boundary
|
||||
|
||||
**Files:**
|
||||
- Modify: `src/features/tech-log/application/studio-application.ts`
|
||||
- Modify: `src/features/tech-log/adapters/create-tech-log-feature-input.ts`
|
||||
- Modify: `src/features/tech-log/presentation/studio/studio-workspace-server-state.ts`
|
||||
- Modify: `src/features/tech-log/presentation/studio/studio-document-server-state.ts`
|
||||
- Modify: `src/features/tech-log/presentation/studio/studio-asset-server-state.ts`
|
||||
- Modify: `src/features/tech-log/presentation/studio/studio-management-server-state.ts`
|
||||
- Test: `tests/features/tech-log/studio-application-boundary.test.ts`
|
||||
|
||||
**Interfaces:**
|
||||
- Produces: `createTechLogStudioApplication({ studio, assets, management }): TechLogStudioApplication`
|
||||
- Produces capability properties: `workspaceQueries`, `workspaceCommands`, `documentQueries`, `documentCommands`, `assetQueries`, `assetCommands`, `managementQueries`, `managementCommands`.
|
||||
- Consumes existing DTOs/return types and request/idempotency option types; outbound port types are private factory dependencies only.
|
||||
|
||||
- [ ] **Step 1: Write failing boundary/delegation test**
|
||||
|
||||
Create a focused test that constructs spy-like in-memory gateways, calls representative application capability methods, and asserts delegation. Add static assertions that the public application value has no `documents`, `assets`, or `management` properties.
|
||||
|
||||
- [ ] **Step 2: Run the focused test and verify RED**
|
||||
|
||||
Run under Node 24.11.0:
|
||||
`corepack pnpm exec vitest run tests/features/tech-log/studio-application-boundary.test.ts`
|
||||
Expected: FAIL because `createTechLogStudioApplication` / application-owned capability properties do not exist yet.
|
||||
|
||||
- [ ] **Step 3: Implement minimal application capability API**
|
||||
|
||||
Define application-owned query/command capability types with explicit method signatures copied from current port operations, then implement `createTechLogStudioApplication()` with frozen capability objects delegating to the private gateways.
|
||||
|
||||
- [ ] **Step 4: Wire composition root and server-state**
|
||||
|
||||
Change `create-tech-log-feature-input.ts` to call the factory. Replace all `application.documents/assets/management` extraction in Studio server-state with the corresponding query/command capability object. Do not change component/controller public APIs unless type propagation requires it.
|
||||
|
||||
- [ ] **Step 5: Run focused + type/architecture checks**
|
||||
|
||||
Run:
|
||||
`corepack pnpm exec vitest run tests/features/tech-log/studio-application-boundary.test.ts`
|
||||
`corepack pnpm check:types`
|
||||
`corepack pnpm check:architecture`
|
||||
Expected: PASS.
|
||||
|
||||
### Task 2: TechLog behavioral copy catalog migration and i18n gate
|
||||
|
||||
**Files:**
|
||||
- Modify: `src/features/tech-log/contracts/tech-log-message-catalog.ts`
|
||||
- Modify: affected files under `src/features/tech-log/presentation/studio/**`
|
||||
- Modify: affected files under `src/features/tech-log/presentation/public/**`
|
||||
- Modify: `scripts/check-i18n.ts`
|
||||
- Modify/Create: `tests/unit/i18n-contract.test.ts` and/or `tests/fixtures/i18n/**` as appropriate to the existing checker test harness.
|
||||
|
||||
**Interfaces:**
|
||||
- Consumes: existing `useTechLogCopy()` / locale message interpolation API.
|
||||
- Produces: catalog keys for behavioral notices/failures/public error states and interpolation keys for dynamic deletion announcements.
|
||||
- Produces: targeted TechLog behavioral checker integrated into `check:i18n`.
|
||||
|
||||
- [ ] **Step 1: Add failing i18n checker tests/fixtures**
|
||||
|
||||
Add one forbidden fixture representing a direct TechLog behavioral literal such as `setNotice("삭제했습니다.")` and one allowed fixture representing a heading/field label/domain status literal. Ensure the checker distinguishes them.
|
||||
|
||||
- [ ] **Step 2: Run i18n test/check and verify RED**
|
||||
|
||||
Run `corepack pnpm check:i18n` and the focused i18n unit test command used by `tests/unit/i18n-contract.test.ts`.
|
||||
Expected: the new behavioral negative fixture is not detected yet.
|
||||
|
||||
- [ ] **Step 3: Implement targeted TechLog behavioral scanner**
|
||||
|
||||
Keep the existing common-presentation blanket scan unchanged. Add TechLog presentation files as a separate source set and inspect targeted contexts: static Button action text, action-label props, `setRequestAnnouncement`, `setNotice`, `setSuccess`, failure/error/loading/empty/not-found fallback literals, and public error/retry surfaces. Catalog calls and interpolated message calls must pass. Editorial/domain literals must pass.
|
||||
|
||||
- [ ] **Step 4: Migrate actual behavioral literals**
|
||||
|
||||
Move the currently identified Studio/Public notices/failures/error states into `tech-log-message-catalog.ts` for `ko-KR` and `en-US`. Convert dynamic delete announcements to message interpolation. Preserve rendered Korean strings and existing accessibility names.
|
||||
|
||||
- [ ] **Step 5: Run focused i18n + TechLog tests**
|
||||
|
||||
Run:
|
||||
`corepack pnpm check:i18n`
|
||||
`corepack pnpm test:tech-log`
|
||||
Expected: PASS with zero TechLog behavioral literal violations.
|
||||
|
||||
### Task 3: Final regression and re-review evidence
|
||||
|
||||
**Files:**
|
||||
- Modify: `docs/reviews/2026-09-22-tech-log-template-utilization-rereview.md`
|
||||
- Create or update: `docs/reviews/2026-09-23-tech-log-template-utilization-rereview.md`
|
||||
|
||||
**Interfaces:**
|
||||
- Consumes Tasks 1-2 outputs.
|
||||
- Produces final 10-item re-review evidence only after fresh verification passes.
|
||||
|
||||
- [ ] **Step 1: Run all required checks under Node 24.11.0**
|
||||
|
||||
Run exactly:
|
||||
`corepack pnpm check:types`
|
||||
`corepack pnpm lint`
|
||||
`corepack pnpm check:architecture`
|
||||
`corepack pnpm check:design-system`
|
||||
`corepack pnpm check:tech-log-contract`
|
||||
`corepack pnpm check:i18n`
|
||||
`corepack pnpm test:tech-log`
|
||||
`corepack pnpm test:component`
|
||||
`corepack pnpm build:app-only`
|
||||
`git diff --check`
|
||||
Expected: all PASS.
|
||||
|
||||
- [ ] **Step 2: Collect static evidence**
|
||||
|
||||
Record counts for application gateway type exposure, presentation gateway port imports, raw gateway extraction, component/controller gateway direct calls, TechLog behavioral literal violations, raw native controls/form/dialog, and controller files.
|
||||
Expected: gateway/i18n/raw DOM violations 0; controllers 5.
|
||||
|
||||
- [ ] **Step 3: Update re-review docs**
|
||||
|
||||
Only after fresh verification, update the review from `완료: 8 / 아직 더 봐야댐: 2` to `완료: 10 / 아직 더 봐야댐: 0`, with actual current test counts and commands.
|
||||
|
||||
- [ ] **Step 4: No commit**
|
||||
|
||||
Do not commit. Preserve the user's existing dirty worktree and report only changed files and fresh verification evidence.
|
||||
@@ -0,0 +1,398 @@
|
||||
# TechLog Application Boundary and Behavioral i18n Design
|
||||
|
||||
## Context
|
||||
|
||||
The 2026-09-23 TechLog frontend re-review re-opened two items that had previously been marked complete:
|
||||
|
||||
1. `TechLogFeatureInput / StudioContext application boundary`
|
||||
2. `behavioral action/error/loading/empty copy i18n`
|
||||
|
||||
The current implementation is otherwise considered complete for the remaining eight review axes. This design intentionally limits scope to these two open items and the regression evidence required to close them.
|
||||
|
||||
The existing worktree contains substantial unrelated user changes. Those changes must be preserved. No reset, checkout, clean, commit, merge, or other destructive Git operation is part of this work.
|
||||
|
||||
## Goals
|
||||
|
||||
### Goal A — Hide outbound gateway ports behind an application-owned API
|
||||
|
||||
`TechLogStudioApplication` must stop exposing `StudioGateway`, `StudioAssetGateway`, and `ManagementGateway` as public properties.
|
||||
|
||||
Presentation server-state code must consume application-owned query/command capabilities instead of extracting raw outbound ports from the application facade.
|
||||
|
||||
### Goal B — Make TechLog behavioral copy verifiably catalog-driven
|
||||
|
||||
Behavioral action, success, error, loading, empty-state, not-found, and validation-facing copy in TechLog presentation must use the TechLog message catalog, including dynamic announcements through interpolation.
|
||||
|
||||
`check:i18n` must include a TechLog-specific behavioral-copy gate so a passing i18n check is actual evidence that these literals are not reintroduced.
|
||||
|
||||
## Non-goals
|
||||
|
||||
This work does not migrate every Korean literal in TechLog presentation into the catalog.
|
||||
|
||||
The following remain intentionally allowed when they are domain/editorial copy rather than behavioral UI copy:
|
||||
|
||||
- headings
|
||||
- long-form explanatory text
|
||||
- help text
|
||||
- field labels
|
||||
- publication/domain status labels
|
||||
- document titles and other content values
|
||||
- dynamic noun-based labels where the noun itself is domain content
|
||||
|
||||
This work does not redesign HTTP, route, design-system, server-state runtime, Taxonomy projection, controller boundaries, or management allowed-value SSOT beyond changes strictly required by the two open review items.
|
||||
|
||||
## Current problem 1 — Application facade leaks outbound ports
|
||||
|
||||
The current public type is effectively:
|
||||
|
||||
```ts
|
||||
export type TechLogStudioApplication = Readonly<{
|
||||
documents: StudioGateway;
|
||||
assets: StudioAssetGateway;
|
||||
management: ManagementGateway;
|
||||
}>;
|
||||
```
|
||||
|
||||
Although `TechLogFeatureInput` and `StudioContextValue` no longer expose three gateway factories directly, server-state code still performs operations such as:
|
||||
|
||||
```ts
|
||||
const { documents: gateway } = useStudioApplication();
|
||||
const gateway = application.assets;
|
||||
```
|
||||
|
||||
This means presentation still receives outbound port objects. The boundary has been renamed but not raised to an application use-case API.
|
||||
|
||||
## Application boundary design
|
||||
|
||||
### Public application shape
|
||||
|
||||
`TechLogStudioApplication` will expose application-owned query and command capabilities, grouped by responsibility rather than by outbound adapter.
|
||||
|
||||
The target shape is:
|
||||
|
||||
```ts
|
||||
export type TechLogStudioApplication = Readonly<{
|
||||
workspaceQueries: StudioWorkspaceQueries;
|
||||
workspaceCommands: StudioWorkspaceCommands;
|
||||
documentQueries: StudioDocumentQueries;
|
||||
documentCommands: StudioDocumentCommands;
|
||||
assetQueries: StudioAssetQueries;
|
||||
assetCommands: StudioAssetCommands;
|
||||
managementQueries: StudioManagementQueries;
|
||||
managementCommands: StudioManagementCommands;
|
||||
}>;
|
||||
```
|
||||
|
||||
The exact grouping follows current server-state responsibilities. The grouping is an application API; none of these exported capability types may alias, extend, or expose `StudioGateway`, `StudioAssetGateway`, or `ManagementGateway`.
|
||||
|
||||
### Capability ownership
|
||||
|
||||
#### `StudioWorkspaceQueries`
|
||||
|
||||
Owns read operations used by dashboard/list/publication/catalog workflows, including the current equivalents of:
|
||||
|
||||
- get dashboard
|
||||
- list documents
|
||||
- list publications
|
||||
- get publication snapshot
|
||||
- get catalog
|
||||
|
||||
#### `StudioWorkspaceCommands`
|
||||
|
||||
Owns workspace-level mutations currently used outside the document editor lifecycle, including the current equivalents of:
|
||||
|
||||
- create document
|
||||
- unpublish publication
|
||||
|
||||
#### `StudioDocumentQueries`
|
||||
|
||||
Owns document-editor reads:
|
||||
|
||||
- get document
|
||||
- get current preview
|
||||
|
||||
#### `StudioDocumentCommands`
|
||||
|
||||
Owns document-editor mutations:
|
||||
|
||||
- save document
|
||||
- validate document
|
||||
- create preview
|
||||
- publish document
|
||||
|
||||
#### `StudioAssetQueries`
|
||||
|
||||
Owns asset reads:
|
||||
|
||||
- list assets
|
||||
- get asset
|
||||
|
||||
#### `StudioAssetCommands`
|
||||
|
||||
Owns asset mutations:
|
||||
|
||||
- upload asset
|
||||
- update asset metadata
|
||||
- delete asset
|
||||
|
||||
#### `StudioManagementQueries` and `StudioManagementCommands`
|
||||
|
||||
Expose the management read/write operations currently consumed by `studio-management-server-state.ts`, grouped by query versus mutation ownership.
|
||||
|
||||
The public application contract can preserve current command/query DTOs and return values where they already represent application-level concepts. The requirement is specifically that the outbound gateway interfaces themselves are hidden.
|
||||
|
||||
### Factory
|
||||
|
||||
A dedicated application factory will own outbound ports as private dependencies:
|
||||
|
||||
```ts
|
||||
export function createTechLogStudioApplication(dependencies: Readonly<{
|
||||
studio: StudioGateway;
|
||||
assets: StudioAssetGateway;
|
||||
management: ManagementGateway;
|
||||
}>): TechLogStudioApplication
|
||||
```
|
||||
|
||||
The implementation will build frozen capability objects whose methods delegate to the private dependencies.
|
||||
|
||||
`create-tech-log-feature-input.ts` will construct the three adapters as it does today and pass them into `createTechLogStudioApplication(...)`. It will no longer construct an object literal that exposes the gateways.
|
||||
|
||||
### Presentation integration
|
||||
|
||||
`StudioContextValue` continues to expose one `studioApplication` value.
|
||||
|
||||
Server-state modules will switch from raw port extraction:
|
||||
|
||||
```ts
|
||||
application.documents
|
||||
application.assets
|
||||
application.management
|
||||
```
|
||||
|
||||
to application capabilities:
|
||||
|
||||
```ts
|
||||
application.workspaceQueries
|
||||
application.workspaceCommands
|
||||
application.documentQueries
|
||||
application.documentCommands
|
||||
application.assetQueries
|
||||
application.assetCommands
|
||||
application.managementQueries
|
||||
application.managementCommands
|
||||
```
|
||||
|
||||
Components and controllers continue to consume server-state hooks and must not gain direct application capability orchestration that belongs in server-state.
|
||||
|
||||
### Boundary invariants
|
||||
|
||||
The final implementation must satisfy all of these:
|
||||
|
||||
```text
|
||||
TechLogStudioApplication references to *Gateway public property types = 0
|
||||
presentation imports from application/ports/*gateway* = 0
|
||||
presentation raw .documents/.assets/.management application extraction = 0
|
||||
component gateway direct calls = 0
|
||||
controller gateway direct calls = 0
|
||||
```
|
||||
|
||||
Outbound gateway types may remain in adapter/application implementation files where dependency inversion requires them.
|
||||
|
||||
## Current problem 2 — Behavioral i18n has feature-level blind spots
|
||||
|
||||
The TechLog catalog already contains many action/state/failure keys, but direct behavioral literals remain in presentation.
|
||||
|
||||
Observed examples include:
|
||||
|
||||
```text
|
||||
저장하지 못했습니다. 다시 시도해 주세요.
|
||||
검증하지 못했습니다. 다시 시도해 주세요.
|
||||
Public Preview를 만들지 못했습니다. 다시 시도해 주세요.
|
||||
게시하지 못했습니다. 다시 시도해 주세요.
|
||||
게시했습니다.
|
||||
홈에 표시할 항목을 저장했습니다.
|
||||
보관했습니다.
|
||||
삭제했습니다.
|
||||
대체 텍스트를 저장했습니다.
|
||||
페이지를 찾을 수 없습니다.
|
||||
최근 기록을 불러오지 못했습니다.
|
||||
페이지를 불러오지 못했습니다.
|
||||
```
|
||||
|
||||
Dynamic announcements also remain, for example deletion messages containing release, variant, document, topic, or project names.
|
||||
|
||||
The current `scripts/check-i18n.ts` hardcoded-locale scan checks shared `src/presentation/*` directories but not `src/features/tech-log/presentation`, so `check:i18n=PASS` does not prove TechLog behavioral-copy completeness.
|
||||
|
||||
## Behavioral i18n design
|
||||
|
||||
### Catalog migration
|
||||
|
||||
Behavioral literals will move into `tech-log-message-catalog.ts` for both `ko-KR` and `en-US`.
|
||||
|
||||
Static messages use ordinary keys, for example:
|
||||
|
||||
```text
|
||||
techLog.notice.published
|
||||
techLog.notice.homeFocusSaved
|
||||
techLog.notice.assetArchived
|
||||
techLog.notice.assetDeleted
|
||||
techLog.notice.assetAltTextSaved
|
||||
techLog.failure.saveRetry
|
||||
techLog.failure.validationRetry
|
||||
techLog.failure.previewRetry
|
||||
techLog.failure.publishRetry
|
||||
techLog.public.notFound
|
||||
techLog.public.latestLoadFailed
|
||||
techLog.public.pageLoadFailed
|
||||
```
|
||||
|
||||
Existing semantically equivalent keys must be reused instead of duplicated.
|
||||
|
||||
### Interpolated announcements
|
||||
|
||||
Dynamic success/announcement copy must use interpolation parameters rather than template literals in presentation.
|
||||
|
||||
Representative target pattern:
|
||||
|
||||
```ts
|
||||
copy("techLog.notice.documentDeleted", {
|
||||
title: item.title || copy("techLog.state.untitled"),
|
||||
});
|
||||
```
|
||||
|
||||
with matching locale entries such as:
|
||||
|
||||
```text
|
||||
ko-KR: 작업본 {title} 을(를) 삭제했습니다.
|
||||
en-US: Deleted working copy {title}.
|
||||
```
|
||||
|
||||
The exact key naming may follow the existing catalog organization, but interpolation parameter names must match across locales and continue to pass the existing catalog interpolation contract check.
|
||||
|
||||
### TechLog-specific i18n gate
|
||||
|
||||
`check-i18n.ts` will keep the existing blanket common-presentation scan unchanged for shared UI.
|
||||
|
||||
TechLog presentation will be added through a separate behavioral rule set, not through the blanket Korean-literal regex. This avoids falsely rejecting allowed domain/editorial Korean copy.
|
||||
|
||||
The TechLog behavioral gate must detect direct user-facing behavioral literals in at least these contexts:
|
||||
|
||||
- static `Button` action text
|
||||
- action-like props such as `pendingLabel`, `closeLabel`, `resetLabel`, and similar control labels
|
||||
- `setRequestAnnouncement("...")`
|
||||
- `setNotice("...")`
|
||||
- `setSuccess("...")`
|
||||
- direct fallback strings used for error/failure/loading/empty/not-found behavior
|
||||
- direct behavioral literals in public error/empty/retry surfaces
|
||||
|
||||
The rule must permit catalog calls and interpolated message calls.
|
||||
|
||||
The gate should be implemented as a targeted source checker rather than a blanket ban on Korean literals under the whole feature directory.
|
||||
|
||||
### Gate testability
|
||||
|
||||
The checker must have negative fixtures or equivalent explicit test inputs demonstrating that it fails for representative TechLog behavioral literals and does not fail for allowed domain/editorial copy.
|
||||
|
||||
At minimum, fixture coverage must pin these two distinctions:
|
||||
|
||||
1. a direct behavioral announcement/action literal fails;
|
||||
2. a heading/field-label/domain-status literal is allowed.
|
||||
|
||||
## Compatibility requirements
|
||||
|
||||
The refactor must not intentionally change visible Korean copy or accessibility names unless an existing copy contract is already inconsistent.
|
||||
|
||||
If moving a string to the catalog would change punctuation, ellipsis, spacing, or an accessible button name, preserve the existing rendered value with a dedicated key rather than changing tests to accept the new copy.
|
||||
|
||||
The existing `저장 중` versus `저장 중…` regression is the precedent: preserve the concrete UI contract and represent distinct copy as distinct keys when necessary.
|
||||
|
||||
## Test strategy
|
||||
|
||||
### Application boundary tests
|
||||
|
||||
Add or update focused tests that prove the application factory delegates through application-owned capabilities without exposing outbound ports.
|
||||
|
||||
Static architecture checks must prove:
|
||||
|
||||
```text
|
||||
TechLogStudioApplication public gateway type exposure = 0
|
||||
presentation raw gateway extraction = 0
|
||||
presentation gateway port imports = 0
|
||||
```
|
||||
|
||||
Existing server-state behavior tests should continue to pass unchanged where observable behavior has not changed.
|
||||
|
||||
### i18n tests
|
||||
|
||||
Add or update checker fixtures/tests so `check:i18n` fails when TechLog behavioral literals are introduced into guarded contexts.
|
||||
|
||||
Catalog interpolation parity across locales must remain enforced.
|
||||
|
||||
### Full regression
|
||||
|
||||
Use Node 24.11.0 without changing repository configuration and run:
|
||||
|
||||
```text
|
||||
corepack pnpm check:types
|
||||
corepack pnpm lint
|
||||
corepack pnpm check:architecture
|
||||
corepack pnpm check:design-system
|
||||
corepack pnpm check:tech-log-contract
|
||||
corepack pnpm check:i18n
|
||||
corepack pnpm test:tech-log
|
||||
corepack pnpm test:component
|
||||
corepack pnpm build:app-only
|
||||
git diff --check
|
||||
```
|
||||
|
||||
Expected baseline:
|
||||
|
||||
```text
|
||||
TechLog: 60 files / 416 tests PASS
|
||||
Component: 27 files / 154 tests PASS
|
||||
```
|
||||
|
||||
If test counts change because new focused tests are added, the new larger counts become the final evidence.
|
||||
|
||||
## Final static evidence
|
||||
|
||||
The re-review is complete only when all final evidence is collected from the current worktree:
|
||||
|
||||
```text
|
||||
application gateway type exposure = 0
|
||||
presentation gateway port import = 0
|
||||
presentation raw gateway extraction = 0
|
||||
component/controller gateway direct call = 0
|
||||
behavioral literal violations = 0
|
||||
raw native control = 0
|
||||
raw form = 0
|
||||
raw dialog = 0
|
||||
controller files = 5
|
||||
```
|
||||
|
||||
## Completion criteria
|
||||
|
||||
The two re-opened review axes can be marked complete only when:
|
||||
|
||||
1. `TechLogStudioApplication` exposes application-owned query/command capabilities and no raw outbound gateway object;
|
||||
2. Studio/Public behavioral literals are catalog-driven, including dynamic announcements;
|
||||
3. `check:i18n` actively checks TechLog feature presentation behavioral copy;
|
||||
4. targeted i18n gate tests/fixtures demonstrate the rule catches regressions without blanket-rejecting domain/editorial copy;
|
||||
5. Node 24 full regression passes;
|
||||
6. final static evidence reports zero violations for the application-boundary and behavioral-i18n criteria.
|
||||
|
||||
At that point the 2026-09-23 re-review may move from:
|
||||
|
||||
```text
|
||||
완료: 8
|
||||
아직 더 봐야댐: 2
|
||||
```
|
||||
|
||||
to:
|
||||
|
||||
```text
|
||||
완료: 10
|
||||
아직 더 봐야댐: 0
|
||||
```
|
||||
|
||||
No completion claim is allowed before those checks pass.
|
||||
Reference in New Issue
Block a user