Files
DongHyeonkaandClaude Opus 5 8996430d23 fix: 공개 개념 문서를 열 수 있게 한다
`/concepts/idp-brokering` 이 「페이지를 찾을 수 없습니다」였다. API 도
라우트도 200 인데 화면만 404 였고, 콘솔을 보니 개념 화면이
`/api/v1/public/questions/idp-brokering` 을 부르고 있었다.

세 가지가 겹쳤다. 계약 타입에는 getPublicConcept 이 있었지만 기여 목록에
등록되지 않아 부를 수 없었다. 게이트웨이는 종류를 삼항으로 이어 붙여
마지막 else 가 남은 것을 다 질문 조회로 보냈다. 응답을 기록으로 바꾸는
분기에도 개념이 없어, 설령 불렸어도 질문 매핑으로 떨어졌을 것이다.

개념 삭제에서 겪은 것과 같은 모양이다 — 손으로 나열한 분기의 마지막
else 가 새 종류를 조용히 삼킨다. 표로 두어 종류가 늘면 타입이 잡게 하고,
네 종류가 각각 자기 주소로 나가는지 확인하는 가드를 둔다.

개념 본문은 Case 와 같은 규칙을 쓴다(Markdown 한 덩어리 + `:::evidence`).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
2026-09-01 14:37:39 +09:00

40 lines
1.9 KiB
TypeScript

import assert from "node:assert/strict";
import { test } from "vitest";
import { TECH_LOG_PUBLIC_CONTRIBUTION } from "../../../src/features/tech-log/contracts/tech-log-public-contract-contribution.ts";
/**
* 종류마다 읽는 주소가 다르다. 이 대응이 어긋나면 화면이 다른 종류의 API 를 부른다.
*
* <p>실제로 그렇게 났다: 게이트웨이가 종류를 삼항으로 이어 붙여 마지막 else 가 남은 것을 다
* 받아 갔고, `/concepts/{slug}` 화면이 `/api/v1/public/questions/{slug}` 를 불러 404 를 받았다.
* 계약 타입에는 `getPublicConcept` 이 있었지만 기여 목록에 등록되지 않아 부를 수도 없었다.
* 삭제 경로에서 겪은 것과 같은 모양이다.
*/
const EXPECTED = {
CASE: { operationId: "getPublicCase", path: "/api/v1/public/cases/{slug}" },
REFERENCE: { operationId: "getPublicReference", path: "/api/v1/public/references/{slug}" },
QUESTION: { operationId: "getPublicQuestion", path: "/api/v1/public/questions/{slug}" },
CONCEPT: { operationId: "getPublicConcept", path: "/api/v1/public/concepts/{slug}" },
} as const;
test("문서 종류마다 자기 조회 주소가 있고 서로 겹치지 않는다", () => {
const byId = new Map(
TECH_LOG_PUBLIC_CONTRIBUTION.http.map((entry) => [entry.contract.operationId, entry]),
);
const paths = new Set<string>();
for (const [kind, expected] of Object.entries(EXPECTED)) {
const installed = byId.get(expected.operationId);
assert.ok(installed, `${kind} 를 읽는 ${expected.operationId} 가 기여 목록에 있어야 한다`);
assert.equal(installed.contract.method, "GET");
assert.equal(
installed.contract.pathTemplate,
expected.path,
`${kind} 는 자기 주소로 나가야 한다`,
);
assert.ok(!paths.has(expected.path), `${kind} 가 다른 종류와 같은 주소를 쓴다`);
paths.add(expected.path);
}
});