────────────────────────────────────────── Requests ──────────────────────────────────────────

────────────────────────────────────────── Row projection ────────────────────────────────────────── ActivityRow is one row of the timeline. Identity

────────────────────────────────────────── Responses ──────────────────────────────────────────

AppError is the unified error type for all API responses. It implements the error interface.

────────────────────────────────────────── Responses ────────────────────────────────────────── ArticleCategoryBrief is the nested category shape embe

ArticleDetailResponse is the shape of GET /doc/article/:slug.

────────────────────────────────────────── GetList — GET /doc/article ────────────────────────────────────────── ArticleListResult carries the list +

ArticleSummary is the list-row shape of GET /doc/article. All fields are camelCase to match the rest of the kungal API surface (post-doc casing cleanu

ArtifactClientConfig holds the credentials kungal uses to call the centralized artifact service (kun-galgame-infra :9279) for large-file (toolset arch

ArtifactResponse defines model for ArtifactResponse.

AuthService handles the OAuth-callback session bootstrap and a few session-lifecycle ops. Identity (name / avatar / email / bio / status) is owned by

Awarder applies a moemoepoint change via OAuth (source of truth), then mirrors the returned authoritative balance into the local read-cache.

────────────────────────────────────────── Admin ──────────────────────────────────────────

BestAnswerRow is a topic's accepted best-answer reply (excerpt + like count). ReplyID is the reply's id, so the card can dedup it against the top repl

CalendarHandler serves the galgame release-calendar endpoints. Read-only and SFW-default like the rest of the galgame surface — utils.IsSFW reads the

Release-calendar response shapes. These wrap the wiki calendar endpoints (GET /galgame/calendar[/pending|/tba]) after local enrichment, re-keying the

CalendarMonthPage is one ISO month's release list (day + month precision), already sorted by the wiki (date asc; within a day, exact-day entries befor

CalendarPendingPage is the "year known, month undecided" bucket (release_precision='year') for a given year.

CalendarService proxies the wiki release-calendar endpoints (GET /galgame/calendar[/pending|/tba]) and enriches each entry with forum-local data (view

CalendarTBAPage is the global "release date to be announced" bucket (release_precision='tba').

CalendarUpcomingMonth groups one month's not-yet-released entries.

CalendarUpcomingPage is the consolidated "未发售" view: every dated entry (day/month precision) with release_date >= today, aggregated forward from the c

CategoryListResult carries the list + total for paginated handler responses.

ChatMessageItem is a single chat message item returned by GetChatHistory. Field names/shape must match the frontend exactly. Content is the raw markd

ChatMessageRow is a chat_message row. Identity (sender name/avatar) is hydrated by the service layer via userclient.

────────────────────────────────────────── Chat system ──────────────────────────────────────────

────────────────────────────────────────── Responses ────────────────────────────────────────── ChatSender is the sender object embedded in chat messa

Client is a thin singleton-friendly wrapper around the generated client.

Client which conforms to the OpenAPI3 specification for this service.

Client calls the checker's POST /v1/check/batch endpoint with Bearer auth (plus Cloudflare Access service-token headers when configured).

Client is safe for concurrent use across goroutines.

Client is the image service client. Safe for concurrent use.

Client calls the OAuth server via HTTP. It is a thin transport layer: it performs raw HTTP calls and decodes the standard {code, message, data} wrappe

The interface specification for the client above.

ClientOption allows setting custom parameters during construction

ClientWithResponses builds on ClientInterface to offer response payloads

ClientWithResponsesInterface is the interface specification for the client with responses above.

Check column types

CollectionDetail is GET /galgame/collection/:cid — metadata + one page of games.

CollectionService owns galgame collections (收藏夹): CRUD, visibility/access, and the membership write path that carries the favorite_count + owner moemo

────────────────────────────────────────── Response shapes ────────────────────────────────────────── CollectionSummary is one card in a user's collec

CommentContext is a minimal preview of a parent comment (被评论的评论).

CommentDetailItem is a slim comment + user projection used by the toolset detail response (commentPreview field). Explicit camelCase fields instead o

CommentItem is the wire shape. Roots have Replies populated with the full descendant subtree; the frontend visually caps recursion at depth 3 and open

────────────────────────────────────────── Responses ────────────────────────────────────────── CommentItem is the shape returned by GET /toolset/:id/

CommentItem matches the galgame comment view: GET returns ROOTS only, each carrying its FULL set of descendants flattened into `reply` (oldest-first,

────────────────────────────────────────── Requests ──────────────────────────────────────────