AbortRequest aborts an in-progress upload.

AdjustRequest is the POST /users/:id/moemoepoint body. source_app is derived server-side from the authenticated client, so it's intentionally absent.

AdjustResult is the data payload of a successful adjust. Applied=false means the idempotency key already existed (no double-apply).

AdminDetail is the admin edit-load shape: raw markdown + the hash + the effective banner URL for preview.

AdminItem is one row in the admin doc-management list (incl. drafts).

AdminLog represents an admin action log entry

AdminPaginationRequest is the common admin pagination request. Status is only meaningful for the comment list (the review queue): "pending" → status<

AdminSettingBoolRequest is the request for toggling a boolean admin setting

AdminStatsRequest is the request for fetching admin stats

AdminStatsResponse is the response for overview stats. NOTE: json tags must match the FE keys (app/shared/types/admin.d.ts + app/constants/admin.ts AD

AdminStatsSumResponse is the response for total stats. json tags must match the FE keys (ADMIN_STATS_SUM_MAP + SumData): `resource_count` / `comment_c

AdminUpdateCommentRequest is the request for updating a comment (admin)

AdminUpdateResourceRequest is the request for updating a resource (admin)

ArtifactConfig points at the centralized artifact service (large-file upload/download, port 9279). Auth is HTTP Basic with an OAuth client_id/secret —

ArtifactResponse defines model for ArtifactResponse.

AuditLogger records privileged moderation actions to the admin audit log. It's defined HERE — in the canonical owner of resource/comment deletes — so

AuthRepository is the data layer for the auth module. After the OAuth migration this is intentionally tiny: identity is owned by OAuth, so the only op

Awarder applies a moemoepoint change via OAuth (the source of truth), then mirrors the returned authoritative balance into moyu's local user.moemoepoi

Brief is the public user brief returned by /users/batch and /users/search. Fields match docs/oauth/api-reference.md.

CalendarCard is a release-calendar entry: a GalgameCard built straight from the wiki calendar brief — which carries release_date + release_precision +

CarouselItem is a pinned, published doc surfaced on the home carousel. Banner is the effective (image_service hash → CDN, else static) URL; Slug drive

ChatMember is a chat room member.

ChatMessage is a chat message. FK behavior (declared in migrations/000_baseline.up.sql, NOT enforced by GORM AutoMigrate which we don't run — the `co

ChatMessageEditHistory is the edit history of a message.

ChatMessageReaction is an emoji reaction on a message.

ChatMessageSeen is the seen state of a message (a given user has read a given message).

ChatQuoteView is the compact preview of a replied-to message.

ChatReactionView is one reaction enriched with the reacting user's brief, matching the frontend's `message.reaction[]` shape.

ChatRoom is a chat room (private or group). - Type = "PRIVATE": private chat, Link format is "{minUid}-{maxUid}" - Type = "GROUP": group chat, Link i

Client calls OAuth's moemoepoint s2s endpoints.

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

Client which conforms to the OpenAPI3 specification for this service.

Client is the OAuth user-brief client.

Client is a thin singleton-friendly wrapper. Reuse one across the process.

Client is a thin wrapper around calls to the Wiki Service.

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.

CompleteRequest finalizes an upload. Parts is required for multipart, omitted for single-PUT.

CompleteResponse is the success response.

CompleteUploadRequest defines model for CompleteUploadRequest.

CompletedPart defines model for CompletedPart.

CompletedPart is one finished multipart part the client reports back.

Config configures a Client. BaseURL is the OAuth server base (same as the userclient — cfg.OAuth.ServerURL).

Config bundles connection settings (created in app.go from config).

Config configures a Client.

Config bundles connection settings. Created in app.go from config.ImageServiceConfig; defaults for ClientID/Secret fall back to the project's OAuth cr

ContentColumn is a (table, column) pair whose free-text markdown can hold domain-agnostic content image tokens (`/image/<hash>`).

Counts mirrors the frontend `_count` nested object.

CoverInput / ScreenshotInput mirror the Wiki cover/screenshot row shape (docs/galgame_wiki/03-relations.md §封面 / 截图). Used as both response element (g

CreateMessageRequest sends a message. FileURL is optional (attachment).

─── Room ─────────────────────────────────────────── CreateRoomRequest creates a group chat room.

CreatorAPIError carries OAuth's business code/message from a creator call (e.g. pending exists, cooldown) so callers can surface the message.

CreatorApplication mirrors OAuth's creator_applications row (the fields moyu surfaces to the user). Acted on behalf of the END USER, not via client cr

CreatorEligibility is the moyu-side eligibility snapshot (counts vs thresholds).

DeleteData defines model for DeleteData.

Doc is the doc table row.

DocCreateRequest is POST /admin/doc. The stored slug is "<category>/<name>"; the client sends category + name (within-category, no slash). banner_imag

DocUpdateRequest is PUT /admin/doc/:id. Pointer fields = presence semantics (nil = leave unchanged). banner_image_hash "" clears the banner.