Set replaces or adds a user.

─── Generic GET ───────────────────────────────────── get sends a GET request, parses the {code, message, data} envelope and unmarshals data into out.

Request sends an HTTP request to the Fiber app and returns the response

Award adjusts the user's unified balance and syncs the local cache. Best-effort + non-blocking: it must be called OUTSIDE any DB transaction and AFTE

GalgameBatch calls /galgame/batch?ids=1,2,3 to fetch lightweight galgame info in bulk. contentLimit is the NSFW filter — pass "sfw" / "nsfw" / "all"

Users fetches user briefs by id. Cache hits skip the network. Misses are deduped, sharded into chunks of 100, coalesced via singleflight, and the resu

writeWikiResult is the shared result -> response mapping for both modes. Wiki business errors (e.g. 80008 image quota, 60002 review rejected, 40300 fo

Init POST /api/upload/init — start an upload; the artifact service decides single-PUT vs multipart and returns the presigned URL(s).

Status returns HTTPResponse.Status

gatePatchByContentLimit checks whether `patchID`'s owning galgame passes the caller's content_limit filter. Returns true → handler may serve the data;

ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers

atoi is a panic-free helper for already-regex-validated digit strings.

createDedupMessage inserts a user_message unless a matching one already exists. redeliverAfterRead controls the dedup window: - false: dedup against A

ownedPatchIDsSubquery is the `id IN (patches owned by U)` building block, reused across the owned-patch collateral counts and the S3-key collection.

Adjust applies a signed moemoepoint delta to a user. Returns the resulting authoritative balance. A non-zero business code (16002/16003/16004/…) or an

Configured reports whether the client can talk to the artifact service.

CreateTestSession creates a Redis session and returns the cookie value. roles is the OAuth roles set; pass e.g. "admin" / "moderator" to grant privile

DB exposes the underlying *gorm.DB so a few thin "no-business-logic" handler endpoints (the wiki messages read-state shims) can do single-table reads

DeleteObject deletes an object. Returns nil even if the object does not exist (idempotent).

Ready reports whether the client has been configured. When not configured, all operations return ErrNotConfigured.

User is a single-id convenience wrapper. Returns (nil, nil) when the id is not present.

countOrLog runs a Count and, on a DB error, LOGS it instead of silently returning a false 0 (audit F074). These four profile aggregates are display-on

effectiveBanner prefers the image_service-derived URL (from the hash) and falls back to the legacy static banner URL.

mapErr turns a non-success artifact response into a sentinel (where callers branch) or a descriptive error.

─── helpers ──────────────────────────────────────── resolveRoomForMember fetches the room and confirms userID is a member, else returns an error.

Configured reports whether the client has both a base URL and credentials — i.e. Upload / ReferencePing can actually reach image_service. Lets callers

Delete soft-deletes an artifact (GC physically reclaims it after the TTL).

GetAll returns docs newest-first by the frontmatter date string (lexical == chronological for ISO), slug ASC to break ties. onlyPublished restricts to

GetGalgame calls /galgame/:gid; used to enrich detail pages. contentLimit is the NSFW filter — pass "sfw" / "nsfw" / "all" to apply, or "" to omit th

GetMessage fetches a single message by ID.

GetPatchDetail returns the local patch row, or gorm.ErrRecordNotFound when moyu has none. Like GetPatch it does NOT materialize on view (see GetPatch)

Invalidate drops both positive and negative cache entries for a single id.

StatusCode returns HTTPResponse.StatusCode

TouchResourceUpdateTime bumps a galgame's patch.resource_update_time to now — the moyu "最近更新" sort key. Called after a successful Wiki galgame-info ed

applyGalgame merges the Wiki galgame info into a card.

attachResourceUsers / attachCommentUsers do the same id-collect → batch → stamp dance for the various list endpoints below. Best-effort: on OAuth erro

displayGalgameName picks the first non-empty translation for the local notification body. Falls back to the integer id so the message never reads "您提交

─── helpers ─────────────────────────────────────────

resolveUser turns a single OAuth user id into a PatchUser brief (name / avatar / roles) via the short-TTL userclient cache. Returns nil for a nil clie

AddMember joins a room; idempotent if already a member.

Balance reads a user's current authoritative balance (GET /users/:id/moemoepoint). Used by the one-time cache-seed cmd.

CheckGalgameByVndbID calls /galgame/check?vndb_id=xxx and returns (exists, galgame_id). Used as a pre-check for POST /api/patch.

===== User Info =====

GetBool reports whether the setting is enabled. A missing key → false (settings default off). A read error also yields false: failing safe means an ou

HasAnyRole reports whether the current request's roles set contains any of the listed roles. Pass nothing to require "at least logged in".

Log reads a page of a user's moemoepoint ledger (GET /users/:id/moemoepoint/log). Cursor pagination: pass beforeID=0 for the newest page, then the las

Proxy relays a GET / JSON-write to the Wiki Service. pathAndQuery is the Wiki path WITH its leading slash and any query string, e.g. "/galgame/8329/r

===== Aggregate Updates =====

Upload sends one image to image_service. - body / filename / mime describe the file (mime may be "" — the server sniffs by magic number anyway). - pr

attachPatchSummaries fills the `Patch` field on every comment / resource row in one Wiki batch call, avoiding an N+1 over the page. Either slice may b

attachUsersToResources batch-fetches publisher briefs from OAuth and stamps the User field on each resource row.

baseCard builds the local-field portion of the card from a patch (Wiki-owned fields like Name/Banner start empty).

briefToPatchUser is the small adapter from OAuth /users/batch shape to the embedded PatchUser wire shape ({id, name, avatar}).

─── Galgame release calendar (发售月表) ─────────────── Thin moyu-side wrapper over the wiki calendar endpoints (docs/galgame_wiki/01-galgame.md §发售月历). T

effectiveAuthorAvatar resolves a user brief to a renderable avatar URL, preferring the image_service hash (the post-OAuth-migration form; "100" varian

enrichCalendarItems collects ids → looks up which moyu has a patch for → builds the has_patch-stamped cards, then stamps is_favorite for the logged-in

===== Patch CRUD ===== ensureCanPublishGalgame enforces the "creator_only" publish toggle: when on, only the trusted-publisher set — creators / modera

ensureLocalPatch reads the local patch row, lazily INSERTing a zero-stat stub when it's missing. It is called from the INTERACTION paths (ToggleFavori