fix: 개념 삭제가 질문 삭제로 떨어지던 것을 고친다

개념을 지우려 하면 「질문을 찾을 수 없습니다」가 났다. 세 가지가 겹쳤다.

게이트웨이가 종류를 삼항으로 이어 붙여, 마지막 else 가 모르는 종류를 다
받아 갔다 — 개념이 deleteQuestion 으로 떨어졌다. 화면은 종류를
`as "CASE" | "REFERENCE" | "QUESTION"` 으로 좁혀 넘겼으므로 타입도 잡지
못했다. 포트의 종류 목록도 손으로 나열해 셋에 머물러 있었다.

삼항을 Record<DeletableDocumentKind, string> 표로 바꾼다 — 종류가 늘면
빠진 자리를 타입이 잡는다. 캐스팅을 걷어내고, 계약 기여 목록에
deleteConceptDraft 를 등록한다. 이 목록에 빠뜨리면 요청이 조용히 다른
주소로 나가므로(어제 페이지 인자가 그랬다) 네 종류가 각각 자기 주소로
나가는지 확인하는 가드를 함께 둔다 — 등록을 지우면 깨지는 것을 확인했다.

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-08-31 10:35:04 +09:00
co-authored by Claude Opus 5
parent 8c5dbe1a0d
commit dec86bd1f2
11 changed files with 207 additions and 12 deletions
@@ -1,8 +1,8 @@
{
"packageId": "@tech-log/management-contract",
"version": "1.0.0",
"digest": "sha256:f97b97101791d87fcf27d78a4c016370cabd2f02bb3b30eec0b8e453803d2d5f",
"sourceRevision": "5942a2e",
"digest": "sha256:a422ff091cdba5f17a27edfa12fec06e077bcc52c9615136ddecfa8df58a5f6e",
"sourceRevision": "f56a03b",
"operationIds": [
"createCaseDraft",
"getCaseForEdit",
@@ -12,6 +12,7 @@
"getReferenceForEdit",
"updateReferenceDraft",
"deleteReferenceDraft",
"deleteConceptDraft",
"validateCase",
"submitReviewCase",
"returnToDraftCase",
@@ -68,6 +68,26 @@ export interface paths {
patch?: never;
trace?: never;
};
"/api/v1/studio/concepts/{id}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get?: never;
put?: never;
post?: never;
/** @description 개념 작업본을 지운다. Case·Reference 와 같은 `document` 테이블을 쓰므로 같은
* 유스케이스가 처리하며 `document_type` 으로만 갈린다. 공개된 개념은 지우지 않는다 —
* 공개 취소가 그 경로다.
* */
delete: operations["deleteConceptDraft"];
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/api/v1/studio/cases/{id}/validate": {
parameters: {
query?: never;
@@ -2345,6 +2365,59 @@ export interface operations {
};
};
};
deleteConceptDraft: {
parameters: {
query?: never;
header: {
"X-CSRF-TOKEN": components["parameters"]["CsrfToken"];
};
path: {
id: string;
};
cookie?: never;
};
requestBody: {
content: {
"application/json": components["schemas"]["ExpectedVersionRequest"];
};
};
responses: {
/** @description No Content */
204: {
headers: {
[name: string]: unknown;
};
content?: never;
};
/** @description Bad Request */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/problem+json": components["schemas"]["ProblemDetails"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/problem+json": components["schemas"]["ProblemDetails"];
};
};
/** @description Conflict */
409: {
headers: {
[name: string]: unknown;
};
content: {
"application/problem+json": components["schemas"]["ProblemDetails"];
};
};
};
};
validateCase: {
parameters: {
query?: never;
@@ -557,6 +557,52 @@ paths:
$ref: '#/components/schemas/ExpectedVersionRequest'
security:
- sessionCookie: []
/api/v1/studio/concepts/{id}:
delete:
operationId: deleteConceptDraft
tags:
- Concepts
description: |
개념 작업본을 지운다. Case·Reference 와 같은 `document` 테이블을 쓰므로 같은
유스케이스가 처리하며 `document_type` 으로만 갈린다. 공개된 개념은 지우지 않는다 —
공개 취소가 그 경로다.
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
- $ref: '#/components/parameters/CsrfToken'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ExpectedVersionRequest'
responses:
'204':
description: No Content
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'409':
description: Conflict
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
security:
- sessionCookie: []
/api/v1/studio/cases/{id}/validate:
post:
operationId: validateCase
@@ -2,7 +2,7 @@
"packageId": "@tech-log/public-contract",
"version": "2.1.0",
"digest": "sha256:afe415880eb5d6289ae10abf493333c97270c323c16a7245a466d4db4466e630",
"sourceRevision": "5942a2e",
"sourceRevision": "f56a03b",
"operationIds": [
"getPublicSite",
"getPublicHome",
@@ -2,7 +2,7 @@
"packageId": "@tech-log/studio-contract",
"version": "3.1.0",
"digest": "sha256:7e1ee18f7e6a6cb1750dd0baec28d975fb3b535116d8dfb57c17ae16ee8d2be8",
"sourceRevision": "5942a2e",
"sourceRevision": "f56a03b",
"operationIds": [
"getStudioSession",
"getStudioDashboard",
@@ -435,6 +435,25 @@ const HTTP_CONTRACTS = Object.freeze([
});
},
),
writeOperation(
"deleteConceptDraft",
"DELETE",
`${D}/concepts/{id}`,
{
acceptedStatuses: [204],
emptyBodyStatuses: [204],
requestByteLimit: 1_024,
responseByteLimit: 1_024,
},
(input: never) => {
const value = input as unknown as Readonly<{ id: string; expectedVersion: number }>;
return Object.freeze({
pathValues: Object.freeze({ id: value.id }),
queryEntries: NO_QUERY,
body: { expectedVersion: value.expectedVersion },
});
},
),
writeOperation(
"deleteCaseDraft",
"DELETE",