feat: sitemap 을 공개 계약에 올린다

서버가 공개 프리픽스 아래에 내는 것은 전부 계약에 있어야 한다 —
PublicContractDriftTest 가 양방향으로 본다. 봉투를 쓰지 않는 자리는 media 가
선례이고, sitemap 도 같다: XML 이고 읽는 것은 브라우저가 아니라 크롤러다.

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 15:46:32 +09:00
co-authored by Claude Opus 5
parent 871e791cbc
commit 0d4d1e5c0c
7 changed files with 89 additions and 10 deletions
@@ -2,7 +2,7 @@
"packageId": "@tech-log/management-contract",
"version": "1.0.0",
"digest": "sha256:0c226600c45b06433480a8a2ef3d812480dce3850c333bfcab5f626143ce77ea",
"sourceRevision": "4065e89",
"sourceRevision": "a0dac96",
"operationIds": [
"createCaseDraft",
"getCaseForEdit",
@@ -1,8 +1,8 @@
{
"packageId": "@tech-log/public-contract",
"version": "2.1.0",
"digest": "sha256:0159d7b834d69252c6edcb5102166084769a58fe1c36764958b90511bb5ec2cc",
"sourceRevision": "4065e89",
"digest": "sha256:99f75d51cf19c8efe9847e9080babb8e5bf14ad28223e1a90d6501d96a0b4e15",
"sourceRevision": "a0dac96",
"operationIds": [
"getPublicSite",
"getPublicHome",
@@ -24,6 +24,7 @@
"getPublicRelease",
"getPublicProfile",
"searchPublicResources",
"getPublicSitemap",
"getPublicMedia"
]
}
@@ -339,6 +339,35 @@ export interface paths {
patch?: never;
trace?: never;
};
"/sitemap": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
/** @description 크롤러가 읽는 공개 주소 목록.
*
* `public/robots.txt` 는 처음부터 Sitemap 을 광고했는데 그 주소가 404 였다 — 규칙이
* 있다고 말해 놓고 규칙이 없는 것과 같았다.
*
* 정적 파일로 만들 수 없다. 무엇이 게시됐는지는 빌드 시점이 아니라 게시 시점에 정해지고,
* 그것을 아는 것은 서버뿐이다.
*
* 경로에 `.xml` 을 붙이지 않는다 — 경로 조각 규칙(AIP-122)이 점을 막고, sitemap
* 프로토콜은 확장자를 요구하지 않는다. robots.txt 가 가리키는 주소가 sitemap XML 을
* 돌려주면 된다.
*
* 봉투를 쓰지 않는다. XML 이고 브라우저 코드가 부르지 않는다. */
get: operations["getPublicSitemap"];
put?: never;
post?: never;
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/media/{assetId}": {
parameters: {
query?: never;
@@ -1918,6 +1947,26 @@ export interface operations {
};
};
};
getPublicSitemap: {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
requestBody?: never;
responses: {
/** @description OK */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/xml": string;
};
};
};
};
getPublicMedia: {
parameters: {
query?: never;
@@ -750,6 +750,32 @@ paths:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
/sitemap:
get:
operationId: getPublicSitemap
tags:
- Sitemap
description: |-
크롤러가 읽는 공개 주소 목록.
`public/robots.txt` 는 처음부터 Sitemap 을 광고했는데 그 주소가 404 였다 — 규칙이
있다고 말해 놓고 규칙이 없는 것과 같았다.
정적 파일로 만들 수 없다. 무엇이 게시됐는지는 빌드 시점이 아니라 게시 시점에 정해지고,
그것을 아는 것은 서버뿐이다.
경로에 `.xml` 을 붙이지 않는다 — 경로 조각 규칙(AIP-122)이 점을 막고, sitemap
프로토콜은 확장자를 요구하지 않는다. robots.txt 가 가리키는 주소가 sitemap XML 을
돌려주면 된다.
봉투를 쓰지 않는다. XML 이고 브라우저 코드가 부르지 않는다.
responses:
'200':
description: OK
content:
application/xml:
schema:
type: string
/media/{assetId}:
get:
operationId: getPublicMedia
@@ -2,7 +2,7 @@
"packageId": "@tech-log/studio-contract",
"version": "3.1.0",
"digest": "sha256:d06434f33a944f4bbcb26d8725e36c0391685125d2f902176c7ec4b16a78dc40",
"sourceRevision": "4065e89",
"sourceRevision": "a0dac96",
"operationIds": [
"getStudioSession",
"getStudioDashboard",