BookHandler defines Gin handlers for book routes (HTTP layer only; persistence lives in pkg/repository).

go:generate go run -mod=mod go.uber.org/mock/mockgen@v0.6.0 -destination=mock_persistence.go -package=repository golang-rest-api-template/pkg/reposito

BookService coordinates book reads/writes, list caching, and cache generation bumps.

Cache abstracts Redis operations used by the app. Book list caching invalidates via a monotonic generation counter (see pkg/service BooksListCacheGenK

Claims carries custom JWT fields plus registered (standard) JWT claims.

ErrorBody is the standard JSON error envelope for this API: {"error":"..."}.

GormBookStore implements BookPersistence using GORM.

GormUserStore implements UserPersistence using GORM.

HealthOKBody documents GET /api/v1/ 200 JSON (standard success envelope).

LoginAPIResponse documents POST /login 200 JSON.

LoginTokenBody is the "data" object returned by POST /login on success.

MockBookPersistence is a mock of BookPersistence interface.

MockBookPersistenceMockRecorder is the mock recorder for MockBookPersistence.

MockCache is a mock of Cache interface.

MockCacheMockRecorder is the mock recorder for MockCache.

MockUserPersistence is a mock of UserPersistence interface.

MockUserPersistenceMockRecorder is the mock recorder for MockUserPersistence.

PatchBook is the JSON body for PATCH /books/:id. Omitted JSON keys leave the field unchanged; the request must set at least one of title or author.

RegisterAPIResponse documents POST /register 201 JSON.

RegisterSuccessBody is the "data" object returned by POST /register on success.

ReplaceBook is the JSON body for PUT /books/:id (full replace of title and author).

UserHandler defines Gin handlers for auth routes (HTTP layer only).

UserPersistence loads and stores users without HTTP or Gin.

UserService handles authentication use-cases without Gin.

mongoAccessLogQueue buffers access-log documents and inserts them from a single worker so HTTP handlers do not block on MongoDB. If the buffer fills,

redisPinger matches *redis.Client without importing the concrete type in Cache.