42 lines
3.8 KiB
Markdown
42 lines
3.8 KiB
Markdown
# 전체 쇼케이스 업그레이드 보고서 · 2026-09-12
|
||
|
||
## 상태
|
||
|
||
21개 showcase slug과 28개 공개 HTML route를 업그레이드 범위로 관리했다. 각 화면의 기존 `design.md`·토큰·기능 계약을 보존하면서, 원론·인지 연구는 화면의 선택 절차와 충돌 점검에만 사용했다. `designpaca` v0.12.0은 npm과 Forgejo에 공개됐고, Cloudflare production 배포와 전역 설치 10곳 갱신을 완료했다.
|
||
|
||
## 선택 절차
|
||
|
||
1. 프로젝트 `design.md`와 실제 카피·이미지·상태를 먼저 읽고, 기존 브랜드·기능·진실성 계약을 확정했다.
|
||
2. 구도는 [art-direction](../packages/skill/references/art-direction.md)의 초점·정렬·면적·이미지 역할 질문으로 실제 화면 재료를 비교했다.
|
||
3. 타입은 실제 한글·숫자·긴 라벨의 폭·행간·fallback을 proof 했고, [시각 지각 연구](../packages/skill/references/visual-perception-research.md)의 선호와 읽기 성능 분리를 지켰다.
|
||
4. 색은 면적·배경·상태 조합에서 역할과 대비를 확인했다. 후보는 구조 차이가 있는 경우만 비교하고, 채택 이유와 기각 조건을 `design.md`에 남겼다.
|
||
5. 규범·기능 하드 게이트, 프로젝트 계약, 시각·과업 판정을 [SKILL](../packages/skill/SKILL.md) 기준으로 분리했다. 자동 통과만으로 시각 품질이나 사용자 효과를 선언하지 않는다.
|
||
|
||
## 현재 증거
|
||
|
||
| 범위 | 현재 결과 | 의미 |
|
||
| --- | --- | --- |
|
||
| 패키지 | Core 22, CLI 9, fail 0, skip 0; `verify-package` fail 0 | release worktree의 core·CLI 검사 결과 |
|
||
| 전체 캡처 | 28/28 route, partial 0, load failure 0 | 동결된 비교 소스의 두 viewport first/full 증거 수집 완료 |
|
||
| TWENTYOZ | 204 pass | 현장 탭·WebGL fallback·catalog·접근성·runtime 계약 검사 결과 |
|
||
| archive | 108 pass | archive showcase의 기능·상태 계약 검사 결과 |
|
||
| instrument | 10 rows, hard failure 0 | 계기판 계열의 계약 검토 결과 |
|
||
| global doctor | 10 완료 | 전역 doctor 검사 기록 |
|
||
| 홈 | 86 시나리오, 1,122 assertions | 홈 시나리오 검사 기록 |
|
||
| 최종 build | pass | release build 결과 |
|
||
| root 시각 검토 | 28개 모바일, 21개 데스크톱, 7개 하위 경로, 30개 앱 상태 수용 | 자동 검사와 별도인 실제 화면 검토 기록 |
|
||
|
||
위 수치는 각 검사 범위의 결과다. 전체 사이트의 접근성 인증, 실제 제품 성능, 사용자 만족도·전환·읽기 속도·이해도 향상을 뜻하지 않는다.
|
||
|
||
## 변경의 성격
|
||
|
||
- FORM은 사진·도면·인덱스의 순서를 건축 기록으로 재구성했고, 가상 사례·생성 이미지 표기를 유지했다.
|
||
- Font Foundry는 실제 마루부리·Pretendard 선택과 같은 폭의 문장 비교, 조판 제어를 전면에 두었다.
|
||
- 나머지 showcase는 사진/증거 표면, 정보 레일, 상태·행동의 위계를 각 프로젝트 `design.md`의 보존 자산과 기각 조건에 맞춰 조정했다.
|
||
- 공개 소개 metadata는 오래된 게이트 점수 대신 현재 화면에서 확인 가능한 기능·정보로 갱신했다.
|
||
|
||
## 최종 완료 상태
|
||
|
||
- 최종 전체 재실행은 18개 계층 모두 통과했다. 최초 실행의 두 실패는 수정과 시각 검토 후 해소했고, 최종 기록은 `verify-accepted.log`다.
|
||
- npm v0.12.0과 Forgejo 릴리스를 공개했다. Cloudflare production 배포 후 6개 경로 × 데스크톱/모바일 12건에서 runtime·HTTP·이미지·폰트·가로 넘침 실패 0을 확인했다. 전체 자산 HTTP 동일성 검사는 마감 요청으로 중단했으며 통과로 계산하지 않았다.
|
||
- 사용자 참여 과업, 읽기 속도·이해도·전환 측정은 수행하지 않았다. 이 전후 사례는 강화된 스킬 지침을 기존 산출물에 적용한 비교이며, 스킬만의 인과 효과를 증명하지 않는다.
|