feat: 가상화 문서들 추가

2026-09-10 08:54:05 +09:00
parent e9f6a93327
commit 43e1aadef0
695 changed files with 153404 additions and 12754 deletions
@@ -7,13 +7,6 @@ topicName: 주제 안의 축
 project: TechLog
 status: 게시 전
 lastVerifiedOn: 2026-09-04
-assets:
-  - key: home-tabs-keycloak
-    file: ../../../final/evidence/browser/home-tabs-keycloak.png
-  - key: home-topic-tabs-2
-    file: ../../../final/evidence/browser/home-topic-tabs-2.png
-  - key: home-tabs-grouped
-    file: ../../../final/evidence/browser/home-tabs-grouped.png
 evidence:
  - ../../../final/evidence/browser/home-tabs-keycloak.png
  - ../../../final/evidence/browser/home-topic-tabs.png
@@ -46,11 +39,14 @@ source:

 세 단계를 거쳤다.

-| 단계 | 무엇 | 왜 바꿨나 |
-|---|---|---|
-| 1 | 주제 하나만 펼치고 아래 「다른 주제 N개 보기」 한 줄 | 홈이 「무엇을 만들었나」로 시작했다 |
-| 2 | 제목 자리를 주제 이름 탭이 대신 (30px/650) | 「다른 주제」 줄은 목록을 다 읽고 나서야 만나는 곳이라 대개 지나쳤다 |
-| 3 | 탭을 칩 크기로 낮추고 개수 상한 제거 | 주제가 열 개, 스무 개가 되면 이름만으로 화면이 덮인다 |
+1단계 : 주제 하나만 펼치고 아래에 「다른 주제 N개 보기」 한 줄
+바꾼 이유 : 홈이 「무엇을 만들었나」로 시작했다
+
+2단계 : 제목 자리를 주제 이름 탭이 대신한다 (30px/650)
+바꾼 이유 : 「다른 주제」 줄은 목록을 다 읽고 나서야 만나는 곳이라 대개 지나쳤다
+
+3단계 : 탭을 칩 크기로 낮추고 개수 상한을 없앴다
+바꾼 이유 : 주제가 열 개, 스무 개가 되면 이름만으로 화면이 덮인다

 3단계에서 요청 구조를 바꿨다. 탭은 목록 호출 하나가 주는 전부이고, 상세는 고른 탭만 그때 받아 캐시한다. 그래서 주제가 몇 개가 되든 홈이 처음 보내는 요청은 목록 하나와 주제 하나로 고정된다.

@@ -79,9 +75,6 @@ tech-log-frontend : 604ded5 → de4cb8b → 3bb724b · 2b2f443

 3단계에서 탭을 칩 크기로 낮추고 개수 상한을 없앴다. 주제가 열 개, 스무 개가 되면 이름만으로 화면이 덮이기 때문이다.

-:::evidence key="home-tabs-keycloak" alt="탭을 구역 제목 급으로 세운 2단계 화면" caption=" " zoom="true"
-:::
-
 ## 상한이 왜 있었나

 상한은 주제마다 상세를 미리 받느라 둔 것이었다. 상세를 다 받으려면 요청이 주제 수만큼 늘어나므로 그 수를 제한해야 했다.
@@ -100,14 +93,8 @@ tech-log-frontend : 604ded5 → de4cb8b → 3bb724b · 2b2f443

 칩으로 낮추니 목록 위에 글자만 떠 있는 것처럼 보였다. 고른 것이 색으로만 달라 누를 수 있는 것으로 읽히지 않았고, 탭 줄과 목록 사이가 선 없이 30px 비어 두 덩어리로 갈렸다.

-:::evidence key="home-topic-tabs-2" alt="칩으로 낮춘 직후의 비교 구역 확대" caption=" " zoom="true"
-:::
-
 고른 탭에 알약 형태를 주고, 묶음의 윗선을 목록이 아니라 패널이 갖게 해서 탭 줄이 그 선에 바로 얹히게 했다.

-:::evidence key="home-tabs-grouped" alt="고른 탭에 형태를 주고 탭 줄을 패널 윗선에 얹은 최종 화면" caption=" " zoom="true"
-:::
-
 ## 확인하지 못한 것

 주제가 스무 개일 때의 화면은 만들어 보지 않았다. 상한을 없앤 근거는 요청 구조이지 그 규모의 측정이 아니다.
@@ -45,8 +45,7 @@ topic (주제)
       └─ record_variant   어느 기록이 어느 축에 걸리는지 (kind, id) 쌍
 ```

-:::evidence key="topic-variant-model" alt="topic·topic_variant·record_variant 가 이어지고 record_variant 가 세 테이블을 가리키는 구조도" caption=" " zoom="true"
-:::
+![topic·topic_variant·record_variant 가 이어지고 record_variant 가 세 테이블을 가리키는 구조도](../../../final/assets/diagrams/topic-variant-model/topic-variant-model.svg)

 ## 축 이름은 주제가 정한다