IncrementView PUT /api/patch/:id/view

Init validates, then asks the artifact service to start an upload. Artifact returns the presigned single-PUT URL or the multipart parts (server-driven

InitUpload reserves quota + creates the artifact row, returning the presigned upload URL(s) for the browser to PUT directly to B2.

InitUploadWithBodyWithResponse request with any body

InitUploadWithBodyWithResponse request with arbitrary body returning *InitUploadResp

IsAdmin reports whether the caller holds a super-admin role (admin or ren).

IsModerator reports whether the caller can moderate: super-admins or moderators.

IsNotFound exposes an ErrRecordNotFound check for callers to distinguish business errors.

JoinRoom POST /api/chat/room/join

LatestMessagePerRoom returns the most recent message of each given room, keyed by chat_room_id. One query (id IN max-per-room subquery) — no N+1. Used

ListArtifactsWithResponse request

ListArtifactsWithResponse request returning *ListArtifactsResp

─── Message ──────────────────────────────────────── ListMessages returns a page of messages, always in ascending id order so the frontend can append/

ListMyGalgames proxies GET /galgame/mine. Status filter is csv (default "3,4" when the caller passes an empty string).

ListMyGalgames GET /api/v1/galgame/mine

ListPinnedPosts GET /doc/pinned — pinned published docs for the home carousel, newest first by display date.

===== Public ===== ListPosts GET /doc/posts — published flat list + category tree.

─── Room ─────────────────────────────────────────── ListRooms lists all rooms the user has joined.

─── Room ─────────────────────────────────────────── ListRooms GET /api/chat/room Enriches each room with: the last-message text preview, and — for P

LocateComment resolves a comment id to its page in the root-comment listing. limit MUST match the list's page size (clamped to the same 1..30 bound).

LocateComment GET /api/patch/comment/:commentId/locate?limit=N Resolves a comment id to {page, root_id, is_reply, galgame_id} in the paginated root-c

Log reads a page of the user's moemoepoint ledger from OAuth (the source of truth — moyu keeps no local ledger). Read-only passthrough to the s2s endp

Logout POST /api/v1/auth/logout Best-effort: revoke the OAuth refresh_token on the upstream OAuth server (per its implementation, /oauth/revoke looks

LookupPatchesByIDs makes AdminService satisfy enricher.PatchSummaryDB, so the handler can attach galgame name/banner summaries to comment/resource lis

LookupPatchesByIDs returns the minimal patch projection (id + vndb_id) for a set of ids. Satisfies enricher.PatchSummaryDB so admin list endpoints can

MarkAsRead marks messages of a given type (or all) as read

MarkAsRead marks messages as read by type (or all if type is "all")

MarkAsRead PUT /api/message/read

MarkSeen marks messages as seen in bulk.

─── Seen ─────────────────────────────────────────── MarkSeen writes seen markers in bulk. Duplicate inserts are ignored via OnConflict DoNothing.

MarkSeen PUT /api/chat/room/:link/seen

MaybeProbe runs the `healthcheck` subcommand and exits the process, or returns immediately when not invoked that way. It is a no-op unless os.Args[1]

Me GET /api/v1/auth/me Composes identity (userID/sub/roles from session+JWT), display fields (name/avatar/bio from OAuth /users/batch), and site-loca

MustRender returns the original text on render failure (as a fallback).

New constructs a Client. Empty BaseURL/credentials = no-op client whose calls return ErrNotConfigured, so the caller can degrade gracefully in dev.

New constructs a Client. Empty BaseURL = no-op client (Upload returns error quickly so the caller can degrade gracefully when image_service is intenti

New constructs a Client. baseURL looks like http://127.0.0.1:9280/api

New constructs a Handler.

New constructs a Service. rdb may be nil in tests (idempotency then degrades to best-effort).

NewClientWithResponses creates a new ClientWithResponses, which wraps Client with return type handling

NewHandler constructs a Handler. img/wiki may be nil in tests.

NewS3 initializes a client from config. When cfg.Endpoint is empty it returns a disabled placeholder (so dev can start without S3).

NewTestApp creates a minimal Fiber app with miniredis

OAuthCallback POST /api/v1/auth/oauth/callback Exchanges the authorization code for tokens, fetches user identity from oauth/userinfo, ensures a loca

Paginated emits { code, message, data: { items, total } }. Nullish items are normalized to an empty slice to keep the shape stable for the frontend.

ParseMonthSet parses the released_months CSV (e.g. "3,7,12") into a sorted, deduped []int of months 1-12, per docs/galgame_wiki/00-handbook §17.10. It

ParsePaginatedResponse reads and parses the paginated JSON response body.

ParseReleaseLowerBound parses released_from into an inclusive lower date bound. "" → (nil, nil) meaning "no lower bound". YYYY → Jan 1 of that year; Y

ParseReleaseUpperBound parses released_to into an inclusive upper date bound. "" → (nil, nil). YYYY → Dec 31 of that year; YYYY-MM → the last day of t

ParseResponse reads and parses the JSON response body

ParseWikiReleaseDate turns Wiki's release_date string into a date-only *time.Time for storage in patch.release_date. "" / nil / unparseable → nil (bes

PatchGalgameDraft proxies PATCH /galgame/:gid (status ∈ {3,4}). Editing a declined draft auto-flips it back to pending review.

PatchGalgameDraft PATCH /api/v1/galgame/:gid Edit one's own pending/declined draft. Wiki auto-flips status=4 back to 3. Same dual-content-type as Sub

PurgeUser wipes every moyu-side trace of the user, then best-effort deletes the orphaned S3 objects (same philosophy as DeleteResource / DeletePatch:

PurgeUser wipes every moyu-side trace of a user in one transaction, then the service does best-effort S3 cleanup with the keys from CollectUserS3Keys.

PurgeUser POST /api/admin/user/:id/purge body: { purge_owned_patches: bool } Irreversibly removes every moyu-side trace of the user (comments, reso

Put pre-seeds the cache (e.g. from an upload result, which already carries the metadata) so the first render of a freshly uploaded image needs no netw