Files
tech-log-frontend/src/features/tech-log/contracts/public/generated.ts
T
DongHyeonka fe6b56a96c fix: 열리지 않는 주소를 링크로 그리지 않는다
「다음에 읽을 것」에 걸린 결정 링크가 404 였다. 주소는 서버가 게시할 때 만들어 저장한
문자열이라 화면 코드 어디에도 흔적이 없었고, 방문자만 그것을 만났다.

- `resolvesToPublicRoute` 가 route contract 에서 읽은 라우트 표에 주소를 맞춰 본다. 맞는
  라우트가 없는 줄은 관계 목록이 링크로 그리지 않는다.
- 결정 목록의 각 항목이 `slug` 를 element id 로 단다 — 결정의 공개 주소가 이 목록 위의
  앵커이므로, id(UUID)를 달면 다른 기록이 건 링크가 갈 곳을 잃는다.
- 앵커로 들어오면 그 결정까지 내려간다. 목록은 받아온 뒤에 그려지므로 브라우저의 기본
  앵커 이동만으로는 닿지 않는다.

주제 화면 셋을 더하면서 함께 늘려야 했던 것들도 여기서 맞춘다 — nginx 로 나가는 경로
패턴, 라우트마다 하나씩인 수동 접근성 증거, 그리고 그 둘을 세는 CI 게이트 기준값.
게이트 형상 digest 는 이전 gates.json 에서 옛 값(87a22f68…)을 먼저 재현한 뒤 새로 계산했다.
2026-09-02 09:54:51 +09:00

1871 lines
62 KiB
TypeScript

/**
* This file was auto-generated by openapi-typescript.
* Do not make direct changes to the file.
*/
export interface paths {
"/site": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicSite"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/home": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicHome"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/explore/knowledge": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
/** @description Frontend의 `/explore`, `/explore/cases`, `/explore/references` 화면이
* 호출한다. 화면 route별로 별도 endpoint를 만들지 않고 `type` 필터로 구분한다.
*
* ```text
* /explore/cases → type=CASE
* /explore/references → type=REFERENCE
* /explore → type 생략
* ```
* */
get: operations["exploreKnowledge"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/explore/questions": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
/** @description Frontend의 `/explore/questions` 화면이 호출한다.
*
* 여기의 공개 상태는 `OPEN`/`RESOLVED` 축약 표현이다. Backend Inquiry의
* `INVESTIGATING`/`PAUSED`는 `OPEN`으로 표현되며 `ARCHIVED`는 공개되지 않는다.
* Domain lifecycle 자체는 축소되지 않는다.
* */
get: operations["exploreQuestions"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/topics": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["listPublicTopics"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/topics/{topicSlug}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicTopic"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/cases/{slug}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicCase"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/references/{slug}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicReference"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/concepts/{slug}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicConcept"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/questions/{slug}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicQuestion"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/projects": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["listPublicProjects"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/projects/{slug}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicProject"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/projects/{slug}/decisions": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["listPublicProjectDecisions"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/projects/{slug}/records": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["listPublicProjectRecords"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/projects/{slug}/activities": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["listPublicProjectActivities"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/releases": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["listPublicReleases"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/releases/{version}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicRelease"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/profile": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["getPublicProfile"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/search": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get: operations["searchPublicResources"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/media/{assetId}": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
/** @description 업로드한 Asset 의 바이트를 그대로 돌려준다. 이 경로가 없어서 Asset 은 저장은 되지만
* 어디에서도 보이지 않았다 — 문서와 공개 화면이 모두 이 주소를 가리키는데 서빙하는 곳이
* 없었다.
*
* `READY` 인 Asset 만 나간다. "발행된 기록이 참조하는 것만" 으로 더 좁히지 않는 이유는
* 그러면 Studio 미리보기가 깨지기 때문이다 — 미리보기는 아직 발행되지 않은 기록을 보는
* 화면이다. 대신 주소가 추측 불가능한 UUID 다.
*
* 봉투를 쓰지 않는다. 바이트를 반환하므로 감쌀 것이 없고, `<img src>` 는 JSON 을 읽지
* 않는다. */
get: operations["getPublicMedia"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
}
export type webhooks = Record<string, never>;
export interface components {
schemas: {
FieldError: {
field: string;
code: string;
message: string;
};
PageMetadata: {
number: number;
size: number;
/** Format: int64 */
totalElements: number;
totalPages: number;
hasPrevious: boolean;
hasNext: boolean;
};
TopicSummary: {
name: string;
slug: string;
};
TagSummary: {
name: string;
slug: string;
};
ProjectSummary: {
name: string;
slug: string;
path: string;
};
AssetReference: {
/** Format: uuid */
assetId: string;
url: string;
altText?: string;
width?: number;
height?: number;
contentType?: string;
};
/** @description 본문이 `:::evidence key="..."` 로 가리키는 Asset 이다.
*
* 본문은 Markdown 원문으로 나가고 그 안에는 key 만 있는데, `/media/{assetId}` 는 UUID
* 로만 서빙한다 — 주소가 추측 불가능한 것이 의도된 성질이므로 key 에서 주소를 만들 수
* 없다. 그래서 공개 화면이 key 를 해석할 수 있도록, 게시된 기록이 실제로 참조하는 Asset 을
* 함께 준다.
*
* 목록은 게시 시점에 고정된 `PUBLISHED` scope 의 참조에서 온다. 게시 이후 작업본이 Asset
* 을 바꿔도 이미 공개된 본문이 가리키는 대상은 달라지지 않는다.
* */
BodyAsset: {
assetKey: string;
/** Format: uuid */
assetId: string;
url: string;
contentType: string;
altText?: string;
width?: number;
height?: number;
/** @description 장식용이면 대체 텍스트가 비어 있어도 된다. 게시 검증이 이 값으로 판정하므로 공개
* 화면도 같은 값을 보고 `alt` 를 정해야 판정과 표시가 어긋나지 않는다.
* */
decorative: boolean;
};
RelatedEntry: {
/** @enum {string} */
type: "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT" | "PROJECT" | "PROJECT_DECISION" | "RELEASE";
title: string;
summary?: string;
/** @description 작성자가 남긴, 왜 이 기록이 걸려 있는지. Studio 에 이미 저장돼 있으나 공개 응답에
* 자리가 없어 독자는 볼 수 없었다 — 「다음에 무엇을 읽을지」의 답이 이 문장이다. */
reason?: string;
/** @description 낮을수록 먼저. 상세 화면은 앞의 한둘만 펴 두고 나머지는 접는다 — 균등한 넷은
* 선택이 아니라 부담이다. */
priority?: number;
path: string;
};
ContactLink: {
type: string;
label: string;
/** Format: uri */
url: string;
};
SiteResponse: {
brand: {
title: string;
identityStatement: string;
};
operator: {
displayName: string;
shortIdentity?: string;
avatar?: components["schemas"]["AssetReference"];
profilePath: string;
};
contacts: components["schemas"]["ContactLink"][];
};
CurrentWorkFocus: {
projectName: string;
projectPath: string;
purpose: string;
/** @enum {string} */
phase: "RESEARCH" | "DESIGN" | "IMPLEMENTATION" | "VERIFICATION" | "MAINTENANCE" | "PAUSED" | "COMPLETED";
currentObjective: string;
nextStep?: string;
/** Format: date-time */
updatedAt: string;
};
OpenQuestionFocus: {
question: string;
questionPath: string;
summary: string;
knownFacts: string[];
unresolvedPoints: string[];
nextVerification: string;
/** Format: date-time */
updatedAt: string;
};
RecentDecisionFocus: {
statement: string;
decisionPath: string;
rationale: string;
consequences: string[];
/** Format: date-time */
decidedAt: string;
};
LatestEntry: {
/** @enum {string} */
entryType: "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT" | "PROJECT_ACTIVITY" | "RELEASE";
title: string;
summary: string;
path: string;
primaryTopic?: components["schemas"]["TopicSummary"];
primaryProject?: components["schemas"]["ProjectSummary"];
/** Format: date-time */
publishedAt: string;
};
HomeResponse: {
focus: {
/** @enum {string} */
defaultType: "CURRENT_WORK" | "OPEN_QUESTION" | "RECENT_DECISION";
currentWork?: components["schemas"]["CurrentWorkFocus"];
openQuestion?: components["schemas"]["OpenQuestionFocus"];
recentDecision?: components["schemas"]["RecentDecisionFocus"];
};
latestEntries: components["schemas"]["LatestEntry"][];
};
KnowledgeListItem: {
/** @enum {string} */
type: "CASE" | "REFERENCE" | "CONCEPT";
title: string;
path: string;
primarySummary: string;
secondarySummary?: string;
primaryTopic?: components["schemas"]["TopicSummary"];
primaryProject?: components["schemas"]["ProjectSummary"];
/** Format: date-time */
publishedAt: string;
/** Format: date-time */
lastVerifiedAt?: string;
freshnessStatus?: string;
};
KnowledgePage: {
items: components["schemas"]["KnowledgeListItem"][];
page: components["schemas"]["PageMetadata"];
};
QuestionListItem: {
question: string;
path: string;
/** @enum {string} */
status: "OPEN" | "INVESTIGATING" | "PAUSED" | "RESOLVED";
summary: string;
currentUnderstanding?: string;
nextVerification?: string;
primaryProject?: components["schemas"]["ProjectSummary"];
/** @description 이 질문이 속한 주제. 지식 목록(`KnowledgeListItem`)은 처음부터 이것을 싣고 있었는데
* 질문 목록만 빠져 있어서, 같은 목록에 섞여 나오는 질문 줄만 맥락이 「· 프로젝트」로
* 시작했다. 주제로 거르는 것은 서버가 이미 하고 있었다 — 보여 줄 값만 없었다.
* */
primaryTopic?: components["schemas"]["TopicSummary"];
/** Format: date-time */
updatedAt: string;
};
QuestionPage: {
items: components["schemas"]["QuestionListItem"][];
page: components["schemas"]["PageMetadata"];
};
TopicListItem: {
name: string;
slug: string;
description: string;
/** @description 이 주제가 답하는 질문. 목록이 이름과 개수만 싣던 동안 독자는 주제 이름만 보고
* 들어갈지 말지를 정해야 했다 — 이름은 무엇에 대한 것인지만 말하고 무엇에 답하는지는
* 말하지 않는다.
* */
thesis?: string;
/** @description 축의 이름. 비면 이 주제는 축을 쓰지 않는다. */
variantLabel?: string;
/** @description 이 주제가 견주는 접근의 수. 축을 쓰지 않으면 0 이다. */
variantCount?: number;
recordCount?: number;
};
TopicListResponse: {
items: components["schemas"]["TopicListItem"][];
};
TopicDetailResponse: {
topic: {
name: string;
slug: string;
description: string;
scope?: string;
thesis?: string;
variantLabel?: string;
};
/** @description 주제 안의 접근/구조. 표시 순서대로 온다. 비어 있으면 이 주제는 축을 쓰지 않는다. */
variants?: components["schemas"]["TopicVariantSummary"][];
featuredReference?: components["schemas"]["RelatedEntry"];
featuredCases: components["schemas"]["RelatedEntry"][];
activeQuestions: components["schemas"]["RelatedEntry"][];
relatedProjects: components["schemas"]["RelatedEntry"][];
latestRecords: components["schemas"]["LatestEntry"][];
};
TopicVariantSummary: {
slug: string;
title: string;
/** @description 이 축의 공개 주소(`/topics/{주제}/{축}`). 그 축에 걸린 기록만 모아 보여 준다.
* 한동안 주제 화면 안의 앵커였는데, 주제 화면에서는 그 링크가 자기 자신을 가리켜
* 눌러도 아무 일이 없었다.
* */
path: string;
summary?: string;
/** @description 만들어 보고 무엇을 알게 됐는가. 비교표가 읽는 칸이다. */
conclusion?: string;
recordCount?: number;
};
CaseDetailResponse: {
canonicalPath: string;
/** @default true */
indexable: boolean;
case: {
title: string;
summary?: string;
problemSummary: string;
conclusionSummary: string;
environmentSummary?: string[];
content: string;
/** @enum {string} */
contentFormat: "MARKDOWN";
contentFormatVersion: number;
primaryTopic?: components["schemas"]["TopicSummary"];
tags: components["schemas"]["TagSummary"][];
primaryProject?: components["schemas"]["ProjectSummary"];
coverAsset?: components["schemas"]["AssetReference"];
/** @description 본문이 참조하는 Asset. 비어 있을 수 있다 — 본문에 evidence 가 없거나, 참조한
* Asset 이 더 이상 서빙되지 않는 경우다.
* */
bodyAssets?: components["schemas"]["BodyAsset"][];
/** Format: date-time */
publishedAt: string;
/** Format: date-time */
updatedAt: string;
/** Format: date-time */
lastVerifiedAt?: string;
};
relations: {
originQuestion?: components["schemas"]["RelatedEntry"];
projectDecisions: components["schemas"]["RelatedEntry"][];
derivedReferences: components["schemas"]["RelatedEntry"][];
relatedCases: components["schemas"]["RelatedEntry"][];
};
};
/** @description 개념은 판단 기준이 아니라 설명이다. Reference 가 규칙·적용·예외로 나뉘는 것과 달리
* 본문 하나로 흐르고, 낡음은 검증일이 아니라 `basisVersion` 이 말한다.
* */
ConceptDetailResponse: {
canonicalPath: string;
/** @default true */
indexable: boolean;
concept: {
title: string;
summary: string;
/** @description "Kubernetes 1.31" 처럼 무엇을 보고 썼는지. 비면 화면에 그리지 않는다. */
basisVersion: string;
content: string;
/** @enum {string} */
contentFormat: "MARKDOWN";
contentFormatVersion: number;
/** @description 본문이 참조하는 Asset. 아키텍처 도식이 여기로 들어온다. Case 와 같은 규칙이다 —
* 원문에는 `:::evidence key="…"` 만 남고 URL 은 이 목록이 준다.
* */
bodyAssets: components["schemas"]["BodyAsset"][];
primaryTopic?: components["schemas"]["TopicSummary"];
primaryProject?: components["schemas"]["ProjectSummary"];
tags: components["schemas"]["TagSummary"][];
coverAsset?: components["schemas"]["AssetReference"];
/** Format: date-time */
publishedAt: string;
/** Format: date-time */
updatedAt: string;
};
relations: {
primaryProject?: components["schemas"]["RelatedEntry"];
relatedRecords: components["schemas"]["RelatedEntry"][];
};
};
ConceptDetailResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ConceptDetailResponse"];
meta: components["schemas"]["ResponseMeta"];
};
ReferenceDetailResponse: {
canonicalPath: string;
/** @default true */
indexable: boolean;
reference: {
title: string;
summary?: string;
scopeSummary: string;
appliesTo: string[];
excludedScope: string[];
rules?: {
title: string;
body: string;
}[];
examples?: string[];
/** @enum {string} */
freshnessStatus: "CURRENT" | "REVIEW_DUE" | "HISTORICAL";
content: string;
/** @enum {string} */
contentFormat: "MARKDOWN";
contentFormatVersion: number;
primaryTopic?: components["schemas"]["TopicSummary"];
tags: components["schemas"]["TagSummary"][];
primaryProject?: components["schemas"]["ProjectSummary"];
coverAsset?: components["schemas"]["AssetReference"];
/** Format: date-time */
publishedAt: string;
/** Format: date-time */
updatedAt: string;
/** Format: date-time */
lastVerifiedAt?: string;
};
relations: {
supportingCases: components["schemas"]["RelatedEntry"][];
relatedDecisions: components["schemas"]["RelatedEntry"][];
relatedReferences: components["schemas"]["RelatedEntry"][];
};
};
QuestionPointGroup: {
facts: string[];
assumptions: string[];
unknowns: string[];
constraints: string[];
};
QuestionUpdatePublic: {
type: string;
title: string;
bodyMarkdown: string;
/** Format: date-time */
occurredAt: string;
};
QuestionDetailResponse: {
canonicalPath: string;
indexable: boolean;
question: {
question: string;
summary: string;
context: string;
importance: string;
/** @enum {string} */
status: "OPEN" | "INVESTIGATING" | "PAUSED" | "RESOLVED";
nextVerification?: string;
points: components["schemas"]["QuestionPointGroup"];
updates: components["schemas"]["QuestionUpdatePublic"][];
resolution?: {
type?: string;
summary?: string;
/** Format: date-time */
resolvedAt?: string;
};
/** Format: date-time */
openedAt: string;
/** Format: date-time */
updatedAt: string;
};
relations: {
primaryProject?: components["schemas"]["RelatedEntry"];
resultCase?: components["schemas"]["RelatedEntry"];
producedDecision?: components["schemas"]["RelatedEntry"];
derivedReferences: components["schemas"]["RelatedEntry"][];
};
};
ProjectListItem: {
name: string;
slug: string;
path: string;
oneLinePurpose: string;
phase: string;
currentObjective?: string;
nextStep?: string;
/** Format: date-time */
updatedAt: string;
};
ProjectListResponse: {
items: components["schemas"]["ProjectListItem"][];
};
ProjectDetailResponse: {
canonicalPath: string;
/** @default true */
indexable: boolean;
project: {
name: string;
slug: string;
oneLinePurpose: string;
/** @description 이 프로젝트가 무엇을 밝혔는가. 사람이 쓰는 한 문단이고, 기록을 합쳐 자동으로
* 나오지 않는다. 프로젝트 화면의 첫 문단이 이것이다 — 담을 칸이 없어 오래
* `purpose` 를 대신 보여 주고 있었고, 그쪽은 목적이지 결론이 아니다.
* */
thesis?: string;
purpose: string;
boundary: string;
phase: string;
currentObjective?: string;
nextStep?: string;
systemOverviewMarkdown?: string;
technologies?: string[];
/** @description 이 프로젝트가 다루는 주제. 프로젝트 화면의 "주요 주제" 가 이 목록을 그린다.
* 화면은 처음부터 이 값을 읽고 있었지만 계약에 자리가 없어 늘 비어 있었다. */
topics?: components["schemas"]["TopicSummary"][];
/** Format: date-time */
updatedAt: string;
};
featuredDecision?: components["schemas"]["RelatedEntry"];
activeQuestion?: components["schemas"]["RelatedEntry"];
selectedRecords: components["schemas"]["RelatedEntry"][];
};
/** @description 결정 화면은 상세 endpoint 없이 이 목록 하나로 그려진다(공개 주소가
* `/projects/{slug}/decisions#{slug}` 인 앵커다). 화면이 그리는 칸은 전부 여기 있어야 한다.
* */
ProjectDecisionItem: {
/** Format: uuid */
id: string;
/** @description 공개 주소의 앵커. 결정에는 상세 화면이 없으므로 다른 기록이 이 결정을 가리킬 때 쓰는 주소가
* `/projects/{projectSlug}/decisions#{slug}` 이고, 목록의 각 항목이 이 값을 element id 로 단다.
* id(UUID)를 앵커로 쓰면 다른 기록이 건 링크가 재발행 때마다 깨진다.
* */
slug: string;
/** @description 작성자가 붙인 제목. 결정문(`statement`)과 다르다 — 제목은 한 줄이고 결정문은 여러 문단일 수 있다. */
title: string;
/** @description 제목 바로 아래에 오는 요약. */
summary: string;
statement: string;
status: string;
rationaleSummary?: string;
/** @description 이 결정이 남기는 영향. 작성자가 순서대로 적는다. */
consequences: string[];
/** @description 이 결정의 근거로 연결한 공개 기록. `sourceQuestion`/`sourceCase` 는 예전의 단일 지목이고,
* 지금 작성자는 관계로 여러 개를 건다.
* */
evidence: components["schemas"]["RelatedEntry"][];
/** Format: date-time */
decidedAt: string;
sourceQuestion?: components["schemas"]["RelatedEntry"];
sourceCase?: components["schemas"]["RelatedEntry"];
};
ProjectDecisionPage: {
items: components["schemas"]["ProjectDecisionItem"][];
page: components["schemas"]["PageMetadata"];
};
/** @description 프로젝트 기록 목록의 한 줄. 탐색 목록과 같은 화면 컴포넌트가 그리므로 그 컴포넌트가 읽는
* 칸을 갖는다 — `RelatedEntry` 로는 요약·주제·게시일이 없어 목록이 제목만 남은 줄로 그려졌다.
* */
ProjectRecordItem: {
/** @enum {string} */
type: "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT";
title: string;
path: string;
summary: string;
primaryTopic?: components["schemas"]["TopicSummary"];
/** Format: date-time */
publishedAt: string;
};
ProjectRecordPage: {
items: components["schemas"]["ProjectRecordItem"][];
page: components["schemas"]["PageMetadata"];
};
ProjectActivityItem: {
type: string;
title: string;
summary?: string;
/** Format: date-time */
occurredAt: string;
relatedPath?: string;
};
ProjectActivityPage: {
items: components["schemas"]["ProjectActivityItem"][];
page: components["schemas"]["PageMetadata"];
};
ReleaseListItem: {
version: string;
title: string;
summary: string;
/** Format: date */
releasedOn: string;
changeTypes: string[];
path: string;
};
ReleaseListResponse: {
items: components["schemas"]["ReleaseListItem"][];
};
ReleaseDetailResponse: {
version: string;
title: string;
summary: string;
/** Format: date */
releasedOn: string;
changeTypes: string[];
reasonMarkdown?: string;
changesMarkdown: string;
userImpactMarkdown?: string;
implementationImpactMarkdown?: string;
verificationMarkdown: string;
knownLimitationsMarkdown?: string;
relatedRecords: components["schemas"]["RelatedEntry"][];
};
ProfileResponse: {
position: {
headline: string;
description: string;
};
workingModel: {
name: string;
description: string;
}[];
territories: {
name: string;
currentQuestion?: string;
topicPath?: string;
}[];
selectedEvidence: components["schemas"]["RelatedEntry"][];
trajectory: {
title: string;
description: string;
}[];
contacts: components["schemas"]["ContactLink"][];
};
SearchResultItem: {
contentType: string;
title: string;
path: string;
snippet: string;
matchedFields: string[];
primaryTopic?: components["schemas"]["TopicSummary"];
primaryProject?: components["schemas"]["ProjectSummary"];
/** Format: date-time */
publishedAt?: string;
/** Format: date-time */
updatedAt?: string;
};
SearchResultPage: {
query: string;
items: components["schemas"]["SearchResultItem"][];
page: components["schemas"]["PageMetadata"];
};
ResponseMeta: {
requestId: string;
traceId: string;
correlationId?: string | null;
/** @description offset 페이지네이션 정보는 각 페이지 payload 의 `page` 필드가 소유한다. 이 필드는 백엔드 템플릿의 ResponseMeta record 가 직렬화하는 자리이며 공개 조회에서는 항상 null 이다. */
page?: {
[key: string]: unknown;
} | null;
};
ValidationErrorDetails: {
fieldErrors: components["schemas"]["FieldError"][];
};
ApiError: {
/**
* @description `INTERNAL_ERROR` 는 이 기능이 아니라 스켈레톤의 공통 처리기가 내는 코드다. 계약이 그것까지 열거해야 500 응답이 계약을 벗어나지 않는다.
* @enum {string}
*/
code: "PUBLIC_REQUEST_INVALID" | "PUBLIC_RESOURCE_NOT_FOUND" | "INTERNAL_ERROR";
/** @enum {string} */
category: "VALIDATION" | "AUTH" | "AUTHZ" | "NOT_FOUND" | "CONFLICT" | "RATE_LIMIT" | "TRANSIENT_DEPENDENCY" | "PERMANENT_DEPENDENCY" | "DATA_INTEGRITY" | "INTERNAL";
message: string;
retryable: boolean;
details?: components["schemas"]["ValidationErrorDetails"] | null;
};
ErrorEnvelope: {
/** @constant */
success: false;
error: components["schemas"]["ApiError"];
meta: components["schemas"]["ResponseMeta"];
};
SiteResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["SiteResponse"];
meta: components["schemas"]["ResponseMeta"];
};
HomeResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["HomeResponse"];
meta: components["schemas"]["ResponseMeta"];
};
KnowledgePageEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["KnowledgePage"];
meta: components["schemas"]["ResponseMeta"];
};
QuestionPageEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["QuestionPage"];
meta: components["schemas"]["ResponseMeta"];
};
TopicListResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["TopicListResponse"];
meta: components["schemas"]["ResponseMeta"];
};
TopicDetailResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["TopicDetailResponse"];
meta: components["schemas"]["ResponseMeta"];
};
CaseDetailResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["CaseDetailResponse"];
meta: components["schemas"]["ResponseMeta"];
};
ReferenceDetailResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ReferenceDetailResponse"];
meta: components["schemas"]["ResponseMeta"];
};
QuestionDetailResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["QuestionDetailResponse"];
meta: components["schemas"]["ResponseMeta"];
};
ProjectListResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ProjectListResponse"];
meta: components["schemas"]["ResponseMeta"];
};
ProjectDetailResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ProjectDetailResponse"];
meta: components["schemas"]["ResponseMeta"];
};
ProjectDecisionPageEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ProjectDecisionPage"];
meta: components["schemas"]["ResponseMeta"];
};
ProjectRecordPageEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ProjectRecordPage"];
meta: components["schemas"]["ResponseMeta"];
};
ProjectActivityPageEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ProjectActivityPage"];
meta: components["schemas"]["ResponseMeta"];
};
ReleaseListResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ReleaseListResponse"];
meta: components["schemas"]["ResponseMeta"];
};
ReleaseDetailResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ReleaseDetailResponse"];
meta: components["schemas"]["ResponseMeta"];
};
ProfileResponseEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["ProfileResponse"];
meta: components["schemas"]["ResponseMeta"];
};
SearchResultPageEnvelope: {
/** @constant */
success: true;
data: components["schemas"]["SearchResultPage"];
meta: components["schemas"]["ResponseMeta"];
};
};
responses: never;
parameters: never;
requestBodies: never;
headers: never;
pathItems: never;
}
export type $defs = Record<string, never>;
export interface operations {
getPublicSite: {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["SiteResponseEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicHome: {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["HomeResponseEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
exploreKnowledge: {
parameters: {
query?: {
type?: "CASE" | "REFERENCE" | "CONCEPT";
topic?: string;
/** @description 주제 안의 축 slug. 그 축에 걸린 기록만 남긴다. `topic` 과 함께 준다 — 축 slug 는
* 주제 안에서만 유일하다.
* */
variant?: string;
project?: string;
tag?: string;
year?: number;
sort?: "PUBLISHED_DESC" | "UPDATED_DESC" | "VERIFIED_DESC";
page?: number;
size?: number;
};
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["KnowledgePageEnvelope"];
};
};
/** @description Bad Request */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
exploreQuestions: {
parameters: {
query?: {
status?: "OPEN" | "INVESTIGATING" | "PAUSED" | "RESOLVED";
topic?: string;
/** @description 주제 안의 축 slug. 그 축에 걸린 기록만 남긴다. `topic` 과 함께 준다 — 축 slug 는
* 주제 안에서만 유일하다.
* */
variant?: string;
project?: string;
tag?: string;
sort?: "UPDATED_DESC" | "OPENED_DESC" | "RESOLVED_DESC";
page?: number;
size?: number;
};
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["QuestionPageEnvelope"];
};
};
/** @description Bad Request */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
listPublicTopics: {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["TopicListResponseEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicTopic: {
parameters: {
query?: never;
header?: never;
path: {
topicSlug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["TopicDetailResponseEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicCase: {
parameters: {
query?: never;
header?: never;
path: {
slug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["CaseDetailResponseEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicReference: {
parameters: {
query?: never;
header?: never;
path: {
slug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ReferenceDetailResponseEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicConcept: {
parameters: {
query?: never;
header?: never;
path: {
slug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ConceptDetailResponseEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicQuestion: {
parameters: {
query?: never;
header?: never;
path: {
slug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["QuestionDetailResponseEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
listPublicProjects: {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ProjectListResponseEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicProject: {
parameters: {
query?: never;
header?: never;
path: {
slug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ProjectDetailResponseEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
listPublicProjectDecisions: {
parameters: {
query?: {
status?: string;
page?: number;
size?: number;
};
header?: never;
path: {
slug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ProjectDecisionPageEnvelope"];
};
};
/** @description Bad Request */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
listPublicProjectRecords: {
parameters: {
query?: {
type?: "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT";
relation?: "PRIMARY" | "RELATED";
page?: number;
size?: number;
};
header?: never;
path: {
slug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ProjectRecordPageEnvelope"];
};
};
/** @description Bad Request */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
listPublicProjectActivities: {
parameters: {
query?: {
page?: number;
size?: number;
};
header?: never;
path: {
slug: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ProjectActivityPageEnvelope"];
};
};
/** @description Bad Request */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
listPublicReleases: {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ReleaseListResponseEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicRelease: {
parameters: {
query?: never;
header?: never;
path: {
version: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ReleaseDetailResponseEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicProfile: {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ProfileResponseEnvelope"];
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
searchPublicResources: {
parameters: {
query: {
q: string;
type?: "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT" | "PROJECT" | "RELEASE";
topic?: string;
page?: number;
size?: number;
};
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["SearchResultPageEnvelope"];
};
};
/** @description Bad Request */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
getPublicMedia: {
parameters: {
query?: never;
header?: never;
path: {
assetId: string;
};
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/octet-stream": string;
};
};
/** @description Not Found */
404: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
/** @description Internal Server Error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": components["schemas"]["ErrorEnvelope"];
};
};
};
};
}