GetFollowing returns followee user briefs, batch-resolved from OAuth. See GetFollowers for `viewerID` semantics.

GetFollowing GET /api/user/:id/following

===== All Patches (admin browse) ===== GetGalgame GET /api/admin/galgame Lists every patch with pagination. The optional `search` query is matched ag

GetGalgameCalendar fetches one ISO month. month is strict "YYYY-MM" or "" for the current month (JST, wiki-side). contentLimit is "sfw" / "nsfw" (exac

GetGalgameCalendarPending fetches the "year-only, month TBD" bucket. year is strict "YYYY" or "" for the current year (JST, wiki-side).

GetGalgameCalendarPending GET /api/galgame/calendar/pending?year=YYYY

GetGalgameCalendarTBA fetches the global "release date TBA" bucket.

GetGalgameCalendarTBA GET /api/galgame/calendar/tba

GetGalgameList GET /api/galgame Local-side filters: translation type + sort. NSFW filter follows the wiki content_limit protocol (docs/galgame_wiki/0

GetGlobalComments GET /api/comment

GetGlobalResources GET /api/resource NSFW filter follows the wiki content_limit protocol (default sfw). Filtered AFTER the page slice is drawn: `tota

GetHikari GET /api/hikari?vndb_id=... Public partner API — CORS allowlist + rate limit are applied at the route (see router.go). Response mirrors the

GetHome GET /api/home Returns "recent activity on this service" (latest 12 patches + 6 resources + 6 comments). NSFW filtering follows the wiki conte

===== Logs =====

===== Admin Logs =====

GetLogs GET /api/admin/log

GetMessages retrieves paginated messages for a user

GetMessages retrieves messages for a user, optionally filtered by type. NOTE: Count and Find MUST run on independent statements. gorm v2 mutates the

GetMoemoepointLog reads a page of the user's OWN moemoepoint ledger from OAuth (the unified source of truth — moyu stores no local ledger). Cursor pag

GetMoemoepointLog GET /api/user/moemoepoint/log The authenticated user's OWN moemoepoint ledger. The user id comes from the session (never a path para

GetMoyuHasPatch GET /api/moyu/patch/has-patch

GetMyWikiMessages proxies GET /galgame/messages/mine (Bearer). Used by the notification center to merge wiki notifications with local ones.

GetMyWikiMessages GET /api/v1/galgame/messages/mine

GetOrphanCandidateIDs returns the ids of all candidate orphans (cheap local filter only — the handler then verifies them against Wiki by id).

GetOrphanPatches returns the list of true orphan patches. excludeIDs are candidates Wiki confirmed exist by id (not real orphans).

GetOrphanPatches returns a paginated list of orphan patches (see orphanCond), ordered by resource count descending so admins can prioritize "important

===== Orphan Patches (D12) ===== GetOrphanPatches GET /api/admin/patch/orphans Lists TRUE "orphan" patches. The `vndb_id` not being a well-formed VND

GetPatch returns the local patch row, or gorm.ErrRecordNotFound when moyu has none. It does NOT materialize: a galgame that only exists on the wiki ("

GetPatch GET /api/patch/:id D12: return the flat GalgameCard structure directly (no longer wrapped in patch / is_favorite layers). Frontend PatchHead

GetPatchDetail GET /api/patch/:id/detail D12: detail enrichment goes through Wiki /galgame/:gid to additionally fetch intro / tag_ids / official_ids.

GetPatchRanking GET /api/ranking/patch Top 60 patches sorted by view / download / favorite. Results are passed through the enricher so each row carri

GetPatchesByIDs fetches multiple patch rows in one query, preserving the caller-supplied id order so the enricher's downstream join keeps galgame orde

GetPost renders one published doc by slug. Missing OR draft → ErrRecordNotFound so the handler maps both to a 404.

GetPost GET /doc/post?slug=<category>/<name> — published only.

GetRandomPatch GET /api/home/random NSFW: forwards content_limit so the random landing page can't dump a NSFW patch into an anonymous (sfw-default) b

includeEmpty=false hides games with no patch resources (the "显示无补丁资源的 游戏" toggle, default off) so "随机游戏" never lands on a patch-less game.

GetResourceByID exposes the resource row so the service layer can read Storage / S3Key before DELETE (admin needs them to clean up the S3 object, see

GetResourceDetail GET /api/resource/:id Returns the resource with its owning patch enriched via Wiki, plus up to 5 recommended resources from the sam

GetResourceDownloadInfo backs the lightweight GET /patch/resource/:id/link. The /resource/:id detail endpoint additionally Wiki-enriches the owning pa

IncrementResourceDownload PUT /api/patch/resource/:resourceId/download GetResourceDownloadInfo GET /api/patch/resource/:resourceId/link Minimal paylo

GetResourceFileHistory returns the privacy-safe, paginated file-replacement audit for one resource. Public (any visitor, incl. anonymous): deliberatel

GetResourceFileHistory returns the file-replacement audit rows for one resource, newest first. Public surface (the privacy-safe projection that drops

GetResourceFileHistory GET /api/patch/resource/:resourceId/history Public, privacy-safe view of one resource's file-replacement audit (when / who-rol

===== Resource file history (MOYU-PR5 / M3) =====

===== Resource file history (MOYU-PR5 / M3) ===== GetResourceFileHistory returns the audit trail for one resource, newest first. Page-based; default l

===== Logs ===== GetResourceFileHistory GET /api/admin/resource/:id/history Returns the append-only file-replacement audit trail for one patch_resour

GetResourceFileHistoryS3Keys mirrors PatchRepository's same-named helper (kept here so admin doesn't reach across modules into the patch repo). Needed

GetResourceRevisions returns the paginated per-field edit history for one resource (public; Changes are secret-free).

GetResourceRevisions returns the per-field edit-diff history for one resource, newest first. Public (stored Changes are secret-free). Paginated.

GetResourceRevisions GET /api/patch/resource/:resourceId/revisions Public per-field edit history (diff) for one resource: each row is one edit with a

===== Resources =====

===== Resources =====

===== Resources ===== GetResources GET /api/patch/:id/resource NSFW gate: same as GetComments. Resource notes / titles may describe NSFW content expl

===== Resources =====

===== Resources =====

===== Resources ===== GetResources GET /api/admin/resource

GetRoomDetail returns the room and its members. Caller must be a member.

GetRoomDetail GET /api/chat/room/:link Returns the room plus its full member list (with each user's profile). Caller must be a member.

===== Stats =====

User management & creator-application repo methods are gone with the migration: identity is owned by OAuth, and the creator role was retired. ===== St

The "禁止注册" (disable-register) setting was removed — registration is unified on the OAuth server (the local register flow no longer exists), so the tog

GetStatsSum GET /api/admin/stats/sum

GetUnreadTypes returns the list of unread message types

GetUnreadTypes returns distinct types of unread messages

GetUnreadTypes GET /api/message/unread

GetUserByID retrieves the local user row (site-local fields only).

GetUserComments retrieves the user's comment list with each comment enriched with its owning patch's Wiki summary (name only — banner is not needed fo

GetUserComments GET /api/user/:id/comment

GetUserContributions retrieves the user's contribution list.

GetUserContributions GET /api/user/:id/contribute

GetUserFavorites retrieves the user's favorite list.

GetUserFavorites GET /api/user/:id/favorite

GetUserFloating retrieves the floating-card view of a user.

GetUserFloating GET /api/user/:id/floating

GetUserInfo GET /api/user/:id

GetUserPatches retrieves the user's patch list.

===== User Profile Lists ===== All list helpers below split Count and Find onto independent statements via .Session(&gorm.Session{}). Reusing one chai

GetUserPatches GET /api/user/:id/patch

===== User purge (anti-spam, admin-only) ===== GetUserPurgePreview GET /api/admin/user/:id/purge-preview?purge_owned_patches= Dry run: returns the co

GetUserRanking GET /api/ranking/user Top 60 users sorted by one of: - moemoepoint (default) - patch — count of patches the user owns - resourc

GetUserResources retrieves the user's resource list with each resource enriched with its owning patch's Wiki summary (name + banner) so the user/:id/r

GetUserResources GET /api/user/:id/resource

GetWikiMessagesReadState GET /api/v1/galgame/messages/read-state Returns the caller's last-read marker for wiki notifications. Used by the notificati

HasRole reports whether the current request's roles set contains role.

HikariCORS is the dynamic CORS for the external Hikari API: it reflects the request Origin ONLY when it matches a partner-site pattern, and answers th

IncludeEmptyGalgames reports whether a browse-list caller opted in to seeing galgames that have no patch resources (patch.resource_count = 0), via the

IncrementView bumps the counter without touching updated_at (UpdateColumn).