feat: 환경 구성(SETUP) 기록 종류를 더한다

다섯 종류는 전부 끝난 일을 남긴다. 없는 것은 읽는 사람이 자기 손으로 다시
하려면 무엇부터 하는가다. Case 의 environment 는 평문 한 칸이라 명령이
들어가지 않고, 같은 셋업을 쓰는 Case 가 넷이면 같은 문장이 네 벌 복제된다.

프로젝트는 필수, 주제는 선택으로 둔다. 주제 없는 셋업이 그 프로젝트의 공통
구성이고, 주제를 붙이면 그 주제의 구성이다 — 스키마를 나누지 않고 두 범위를
같은 종류로 받는다.

버전만 본문 밖에 둔다(pinnedVersions). 이 절차가 어느 버전 위에서 성립했는지는
그 기록의 유효 범위이고, 목록과 머리말이 본문을 열지 않고 보여 줘야 한다.
나머지 셋(실행 절차·구성 값·확인 방법)은 명령과 표를 담아야 하므로 본문이다.

이름은 SETUP 이다. ENVIRONMENT 가 영어로는 자연스럽지만 case_detail.environment
와 겹친다 — 이 저장소가 열네 번 밟은 실패가 「종류를 손으로 나열한 곳을
빠뜨린다」이고 그걸 찾는 수단이 grep 이다.

손으로 나열해 두었던 자리를 이번에 표로 바꿨다. publicPath 의 삼항 사슬은
마지막 else 가 「나머지 전부」여서 새 종류의 주소가 조용히 /questions/… 가
됐고, document-editor 의 칸 경로도 같은 모양이었다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
This commit is contained in:
DongHyeonka
2026-09-09 14:12:44 +09:00
co-authored by Claude Opus 5
parent 3374f286be
commit 3af9be9e09
45 changed files with 2195 additions and 65 deletions
@@ -26,7 +26,7 @@ import type {
* 수 없는 주제를 화면이 보여주게 된다.
*/
/** 이 게이트웨이로 지울 수 있는 문서 종류. 결정은 프로젝트 경로를 요구하므로 별도 메서드다. */
export type DeletableDocumentKind = "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT";
export type DeletableDocumentKind = "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT" | "SETUP";
export type ManagementGateway = Readonly<{
listTopics(): Promise<TopicEdit[]>;
@@ -1,4 +1,8 @@
export type RecordKind = "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT";
/*
화면이 다루는 기록 종류. Studio 계약의 `RecordKind` 와 같은 집합이어야 한다 — 다만 결정은
자기 상세 화면이 없어 여기 없다.
*/
export type RecordKind = "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT" | "SETUP";
export type QuestionStatus =
| "OPEN"
@@ -130,11 +134,29 @@ export type ConceptRecord = PublicRecordBase & {
sections: ReadonlyArray<RecordSection>;
};
/**
* 환경 구성.
*
* <p>다른 종류가 끝난 일을 적는 것과 달리, 이 종류만 읽는 사람이 그대로 따라 하는 절차를 적는다.
* 낡음은 검증일도 한 줄짜리 기준 버전도 아니라 이름·버전 쌍의 목록이 말한다 — 이 절차가
* 성립한 버전들이 곧 유효 범위다.
*/
export type SetupRecord = PublicRecordBase & {
kind: "SETUP";
/** 이 절차가 성립한 버전. 비면 화면에 표를 그리지 않는다. */
pinnedVersions: ReadonlyArray<{ name: string; version: string }>;
/** 본문 Markdown 원문. Case 와 같은 규칙으로 `:::evidence` 가 도식을 끌어온다. */
content: string;
bodyAssets: ReadonlyArray<PublicBodyAsset>;
sections: ReadonlyArray<RecordSection>;
};
export type PublicRecord =
| CaseRecord
| ReferenceRecord
| QuestionRecord
| ConceptRecord;
| ConceptRecord
| SetupRecord;
export type ProjectDecision = {
id: string;