タグ “廃止” 追加 (#378) (#379)

Reviewed-on: #379
Co-authored-by: miteruzo <miteruzo@naver.com>
Co-committed-by: miteruzo <miteruzo@naver.com>

frontend/src/lib/gekanator.test.ts

@@ -1,9 +1,11 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 
-import { apiPost } from '@/lib/api'
+import { apiGet, apiPost } from '@/lib/api'
 import {
   buildGekanatorQuestions,
   expectedAnswerForQuestion,
+  fetchGekanatorPosts,
+  fetchGekanatorQuestions,
   learnedSemanticSideForPost,
   questionIdForCondition,
   restoreGekanatorQuestion,
@@ -24,6 +26,7 @@ vi.mock('@/lib/api', () => ({
 }))
 
 const mockedApiPost = vi.mocked(apiPost)
+const mockedApiGet = vi.mocked(apiGet)
 
 const post = (overrides: Partial<Post> = {}): Post => ({
   id: 1,
@@ -43,6 +46,24 @@ const post = (overrides: Partial<Post> = {}): Post => ({
   ...overrides,
 })
 
+describe('Gekanator API functions', () => {
+  it('returns posts from the Gekanator posts endpoint', async () => {
+    const posts = [post()]
+    mockedApiGet.mockResolvedValueOnce({ posts })
+
+    await expect(fetchGekanatorPosts()).resolves.toEqual(posts)
+    expect(mockedApiGet).toHaveBeenCalledWith('/gekanator/posts')
+  })
+
+  it('returns questions from the Gekanator questions endpoint', async () => {
+    const questions: StoredGekanatorQuestion[] = []
+    mockedApiGet.mockResolvedValueOnce({ questions })
+
+    await expect(fetchGekanatorQuestions()).resolves.toEqual(questions)
+    expect(mockedApiGet).toHaveBeenCalledWith('/gekanator/questions')
+  })
+})
+
 describe('expectedAnswerForQuestion', () => {
   it('returns a direct example answer when present', () => {
     const question: StoredGekanatorQuestion = {
@@ -126,6 +147,7 @@ describe('expectedAnswerForQuestion', () => {
               postCount: 1,
               createdAt: '2026-06-10T00:00:00.000Z',
               updatedAt: '2026-06-10T00:00:00.000Z',
+              deprecatedAt: null,
               hasWiki: false,
               hasDeerjikists: false,
               materialId: null,

frontend/src/lib/prefetchers.ts

@@ -17,6 +17,10 @@ const mWiki = match<{ title: string }> ('/wiki/:title')
 const mTag = match<{ id: string }> ('/tags/:id')
 
 
+const boolFromQuery = (value: string | null): boolean =>
+    ['1', 'true', 'on', 'yes', ''].includes ((value ?? '').toLowerCase ())
+
+
 const prefetchWikiPagesIndex: Prefetcher = async (qc, url) => {
   const title = url.searchParams.get ('title') ?? ''
 
@@ -156,13 +160,16 @@ const prefetchTagsIndex: Prefetcher = async (qc, url) => {
   const createdTo = url.searchParams.get ('created_to') ?? ''
   const updatedFrom = url.searchParams.get ('updated_from') ?? ''
   const updatedTo = url.searchParams.get ('updated_to') ?? ''
+  const deprecated = url.searchParams.has ('deprecated')
+      ? boolFromQuery (url.searchParams.get ('deprecated'))
+      : null
   const page = Number (url.searchParams.get ('page') || 1)
   const limit = Number (url.searchParams.get ('limit') || 20)
   const order = (url.searchParams.get ('order') ?? 'post_count:desc') as FetchTagsOrder
 
   const keys = {
       post, name, category, postCountGTE, postCountLTE, createdFrom, createdTo,
-      updatedFrom, updatedTo, page, limit, order }
+      updatedFrom, updatedTo, deprecated, page, limit, order }
 
   await qc.prefetchQuery ({
       queryKey: tagsKeys.index (keys),

frontend/src/lib/tags.test.ts

@@ -20,6 +20,7 @@ const baseParams: FetchTagsParams = {
   createdTo:    '',
   updatedFrom:  '',
   updatedTo:    '',
+  deprecated:   null,
   page:         1,
   limit:        30,
   order:        'updated_at:desc',
@@ -57,6 +58,20 @@ describe ('tags API functions', () => {
     )
   })
 
+  it.each ([
+    [true, '1'],
+    [false, '0'],
+  ] as const) ('maps deprecated=%s to %s', async (deprecated, expected) => {
+    api.apiGet.mockResolvedValueOnce ({ tags: [], count: 0 })
+
+    await fetchTags ({ ...baseParams, deprecated })
+
+    expect (api.apiGet).toHaveBeenCalledWith (
+        '/tags',
+        { params: expect.objectContaining ({ deprecated: expected }) },
+    )
+  })
+
   it ('returns null when tag fetches fail', async () => {
     api.apiGet.mockRejectedValueOnce (new Error ('missing'))
     api.apiGet.mockRejectedValueOnce (new Error ('missing'))

frontend/src/lib/tags.ts

@@ -10,7 +10,8 @@ import type { Deerjikist,
 
 export const fetchTags = async (
     { post, name, category, postCountGTE, postCountLTE, createdFrom, createdTo,
-      updatedFrom, updatedTo, page, limit, order }: FetchTagsParams,
+      updatedFrom, updatedTo, deprecated,
+      page, limit, order }: FetchTagsParams,
 ): Promise<{ tags:  Tag[]
 	     count: number }> =>
     await apiGet ('/tags', { params: {
@@ -23,6 +24,7 @@ export const fetchTags = async (
 	...(createdTo && { created_to: createdTo }),
 	...(updatedFrom && { updated_from: updatedFrom }),
 	...(updatedTo && { updated_to: updatedTo }),
+	...(deprecated != null && { deprecated: deprecated ? '1' : '0' }),
 	...(page && { page }),
 	...(limit && { limit }),
 	...(order && { order }) } })
@@ -64,7 +66,6 @@ export const fetchTagByName = async (name: string): Promise<Tag | null> => {
   }
 }
 
-
 export const fetchTagChanges = async (
     { id, page, limit }: {
 	id?:    string