feat: 주제 화면을 계약에 잇고, 등록을 잊는 사고를 가드로 막는다

주제 화면은 주제 셋(`jpa`, `authentication`, `redis`)을 코드에 적어 두고 그 셋만
열었다. 제목과 설명까지 코드에 있었고, 목록에 없는 주제는 기록이 멀쩡히 있어도 404 로
갔다 — 픽스처의 `kubernetes` 가 그랬다. 계약에는 처음부터 `/topics/{slug}` 가 있었지만
아무도 부르지 않았다. 이제 그 연산을 부르고, 주제가 답하는 질문(논지)과 그 질문에 대해
실제로 만들어 본 답들(축)을 화면의 뼈대로 둔다.

프로젝트의 논지도 마찬가지다. 담을 칸이 없어 목적(`purpose`)을 대신 보여 주고
있었는데, 목적은 시작할 때 쓰는 글이라 화면에는 늘 시작할 때의 말만 남았다.

축 CRUD 네 연산은 계약에 있으면서 기여 목록에 없었다 — 등록되지 않은 연산은 타입에는
멀쩡히 보이는데 부를 수가 없다. `getPublicConcept` 과 `deleteConceptDraft` 가 정확히
그래서 못 불렸고, 개념 삭제가 질문 삭제를 불러 "질문을 찾을 수 없습니다" 가 떴다.
그래서 가드를 둘 넣는다. 공개 계약은 전수 대조하고(봉투 없이 바이트를 주는 `/media` 만
면제), 관리 계약은 **한 종류만 빠진 자리**를 본다 — 깨진 것이 늘 그 모양이었다.
개념 삭제 등록을 지워 보고 실제로 멈추는 것을 확인했다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
This commit is contained in:
DongHyeonka
2026-09-01 16:57:24 +09:00
co-authored by Claude Opus 5
parent 618a228eff
commit 15e6ea8f15
18 changed files with 512 additions and 80 deletions
@@ -2821,3 +2821,84 @@ textarea.studio-control { min-height: 118px; resize: vertical; line-height: 1.65
font-size: 13px;
line-height: 1.6;
}
/*
주제 화면의 축 비교.
이 자리는 표가 아니라 목록이다. 축이 둘이든 넷이든 같은 배치로 읽히고, 좁은 화면에서 표가
가로로 밀리는 일도 없다. 이 사이트의 다른 목록과 같은 규칙을 따른다 — 테두리는 줄을 가르는
가로선 하나, 강조는 글자 굵기와 색으로만.
*/
.topic-variants {
margin-top: 64px;
padding-top: 30px;
border-top: 1px solid var(--line-strong);
}
.topic-variants h2 {
margin: 10px 0 20px;
font-size: 26px;
letter-spacing: -0.03em;
}
.topic-variants ul {
margin: 0;
padding: 0;
list-style: none;
}
.topic-variants li {
border-top: 1px solid var(--line);
}
.topic-variants li:last-child {
border-bottom: 1px solid var(--line);
}
.topic-variants a {
display: grid;
grid-template-columns: 180px minmax(0, 1fr) 72px;
gap: 20px;
align-items: baseline;
padding: 26px 2px 27px;
}
.topic-variants strong {
color: var(--ink);
font-size: 16px;
font-weight: 620;
line-height: 1.5;
}
.topic-variants p {
margin: 0;
color: var(--muted);
font-size: 14px;
line-height: 1.65;
}
.topic-variants a > span {
color: var(--faint);
font-size: 12px;
text-align: right;
}
.topic-variants a:hover strong {
color: var(--signal);
}
/* 주제 화면에서는 관계 목록이 본문 안에 있으므로 문서 하단만큼 띄우지 않는다. */
.topic-hub .document-relations {
margin-top: 64px !important;
}
@media (max-width: 720px) {
.topic-variants a {
grid-template-columns: minmax(0, 1fr);
gap: 8px;
}
.topic-variants a > span {
text-align: left;
}
}