diff --git a/public/release-manifest.json b/public/release-manifest.json
index aa2664d..3fedbd2 100644
--- a/public/release-manifest.json
+++ b/public/release-manifest.json
@@ -38,28 +38,28 @@
},
"contractSet": {
"setAlgorithm": "CA_CONTRACT_SET_V1",
- "setDigest": "sha256:9f103bda702c05965e54732f975f68f5f850d9496fc2a59209d9891e64602d80",
+ "setDigest": "sha256:bc0766de75feb10ebc689402840def8689d4653f10d3c42cfbe5f553c7844890",
"packages": [
{
"packageId": "@tech-log/management-contract",
"version": "1.0.0",
"digest": "sha256:0c226600c45b06433480a8a2ef3d812480dce3850c333bfcab5f626143ce77ea",
"runtimeProtocolVersion": 1,
- "sourceRevision": "4065e89"
+ "sourceRevision": "a0dac96"
},
{
"packageId": "@tech-log/public-contract",
"version": "2.1.0",
- "digest": "sha256:0159d7b834d69252c6edcb5102166084769a58fe1c36764958b90511bb5ec2cc",
+ "digest": "sha256:99f75d51cf19c8efe9847e9080babb8e5bf14ad28223e1a90d6501d96a0b4e15",
"runtimeProtocolVersion": 1,
- "sourceRevision": "4065e89"
+ "sourceRevision": "a0dac96"
},
{
"packageId": "@tech-log/studio-contract",
"version": "3.1.0",
"digest": "sha256:d06434f33a944f4bbcb26d8725e36c0391685125d2f902176c7ec4b16a78dc40",
"runtimeProtocolVersion": 1,
- "sourceRevision": "4065e89"
+ "sourceRevision": "a0dac96"
}
]
}
diff --git a/src/features/tech-log/contracts/management/canonical-source.json b/src/features/tech-log/contracts/management/canonical-source.json
index 6b4baf6..921f238 100644
--- a/src/features/tech-log/contracts/management/canonical-source.json
+++ b/src/features/tech-log/contracts/management/canonical-source.json
@@ -2,7 +2,7 @@
"packageId": "@tech-log/management-contract",
"version": "1.0.0",
"digest": "sha256:0c226600c45b06433480a8a2ef3d812480dce3850c333bfcab5f626143ce77ea",
- "sourceRevision": "4065e89",
+ "sourceRevision": "a0dac96",
"operationIds": [
"createCaseDraft",
"getCaseForEdit",
diff --git a/src/features/tech-log/contracts/public/canonical-source.json b/src/features/tech-log/contracts/public/canonical-source.json
index f314c39..6b261d3 100644
--- a/src/features/tech-log/contracts/public/canonical-source.json
+++ b/src/features/tech-log/contracts/public/canonical-source.json
@@ -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"
]
}
diff --git a/src/features/tech-log/contracts/public/generated.ts b/src/features/tech-log/contracts/public/generated.ts
index ac1f0ee..a2945cd 100644
--- a/src/features/tech-log/contracts/public/generated.ts
+++ b/src/features/tech-log/contracts/public/generated.ts
@@ -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;
diff --git a/src/features/tech-log/contracts/public/public-api.openapi.yaml b/src/features/tech-log/contracts/public/public-api.openapi.yaml
index d97ea6d..c97e4c2 100644
--- a/src/features/tech-log/contracts/public/public-api.openapi.yaml
+++ b/src/features/tech-log/contracts/public/public-api.openapi.yaml
@@ -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
diff --git a/src/features/tech-log/contracts/studio/canonical-source.json b/src/features/tech-log/contracts/studio/canonical-source.json
index 3210501..1876d2b 100644
--- a/src/features/tech-log/contracts/studio/canonical-source.json
+++ b/src/features/tech-log/contracts/studio/canonical-source.json
@@ -2,7 +2,7 @@
"packageId": "@tech-log/studio-contract",
"version": "3.1.0",
"digest": "sha256:d06434f33a944f4bbcb26d8725e36c0391685125d2f902176c7ec4b16a78dc40",
- "sourceRevision": "4065e89",
+ "sourceRevision": "a0dac96",
"operationIds": [
"getStudioSession",
"getStudioDashboard",
diff --git a/tests/features/tech-log/contract-operation-coverage.test.ts b/tests/features/tech-log/contract-operation-coverage.test.ts
index 3c9a03d..b7f08c5 100644
--- a/tests/features/tech-log/contract-operation-coverage.test.ts
+++ b/tests/features/tech-log/contract-operation-coverage.test.ts
@@ -25,8 +25,11 @@ function contractOperationIds(path: string): string[] {
/**
* 봉투를 쓰지 않고 바이트를 그대로 돌려주는 연산. `` 가 직접 가리키므로 HTTP 기여
* 목록을 지나지 않는다 — 등록을 잊은 것이 아니라 지날 이유가 없다.
+ *
+ *
`getPublicSitemap` 도 같은 자리다. XML 을 돌려주고, 그것을 읽는 것은 브라우저 코드가 + * 아니라 크롤러다. */ -const NOT_A_JSON_OPERATION = new Set(["getPublicMedia"]); +const NOT_A_JSON_OPERATION = new Set(["getPublicMedia", "getPublicSitemap"]); test("공개 계약의 모든 연산이 기여 목록에 등록되어 있다", () => { const declared = contractOperationIds(