Files
pipu-music/services/api/internal/server/router.go
T
mrleo1nidandClaude Opus 5.5 ca106e8eb1
ci / api / api (push) Successful in 46s
ci / contract / contract (сгенерированный код совпадает с openapi.yaml) (push) Successful in 1m3s
ci / mobile / mobile (Metro-бандл Android) (push) Successful in 1m22s
ci / ts / ts (packages + web) (push) Successful in 1m38s
feat(api): upload queue with quota, tus intake, processing and import (M5.5)
- Migration 00008: upload_batches, upload_files, upload_quota.
- Quota reserved under a row lock when a batch is created; every status
  change goes through one transition that frees space in the same
  transaction. SHA-256 duplicates are rejected before any upload.
- tus 1.0.0 core (HEAD/PATCH) for the author only; offset is the real
  staging file size, data beyond the declared size is refused (ADR-015).
- Processing worker: ffprobe checks, SHA-256 verification, exact and
  Chromaprint duplicates against library and queue, metadata from tags
  or the dropped folder path, possible_duplicate on metadata match, and
  the target path from write_template reusing existing folder spelling.
- Import worker: edited tags written with ffmpeg stream copy, file
  written by storage-agent, point scan of the new file, imported status;
  idempotent and resumed after restart. Stale uploads expire after 24 h,
  orphan staging files are removed at startup.
- API: quota, precheck, batches, my uploads, withdraw, admin list,
  metadata edit, bulk review, retry and queue settings.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 17:23:05 +03:00

99 lines
3.3 KiB
Go

// Package server собирает HTTP-роутер сервиса api из модулей.
package server
import (
"log/slog"
"net/http"
"github.com/go-chi/chi/v5"
"github.com/go-chi/chi/v5/middleware"
"pipu/api/internal/api/gen"
"pipu/api/internal/appupdate"
"pipu/api/internal/auth"
"pipu/api/internal/library"
"pipu/api/internal/platform/httpx"
"pipu/api/internal/playback"
"pipu/api/internal/search"
"pipu/api/internal/system"
"pipu/api/internal/uploads"
"pipu/api/internal/wave"
)
// Deps — модули, реализующие части контракта API.
type Deps struct {
Log *slog.Logger
System *system.Handler
Auth *auth.Handler
// Library — хранилища, сканы и каталог.
Library *library.Handler
Search *search.Handler
// Playback — стрим, события, история, реакции, состояние плеера.
Playback *playback.Handler
// Wave — «Моя волна».
Wave *wave.Handler
App *appupdate.Handler
// Uploads — очередь на добавление; TUS — приём файлов (вне OpenAPI).
Uploads *uploads.Handler
TUS *uploads.TUS
// AuthService проверяет access-токены в middleware. nil — только для тестов служебных эндпоинтов.
AuthService *auth.Service
}
// handlers объединяет модули в единую реализацию gen.StrictServerInterface.
// По мере появления модулей (catalog, ...) они встраиваются сюда.
// Алиасы дают встроенным полям разные имена: у модулей одинаковое имя типа Handler.
type (
systemHandler = system.Handler
authHandler = auth.Handler
libraryHandler = library.Handler
searchHandler = search.Handler
playbackHandler = playback.Handler
waveHandler = wave.Handler
appHandler = appupdate.Handler
uploadsHandler = uploads.Handler
)
type handlers struct {
*systemHandler
*authHandler
*libraryHandler
*searchHandler
*playbackHandler
*waveHandler
*appHandler
*uploadsHandler
}
var _ gen.StrictServerInterface = handlers{}
// NewRouter возвращает корневой http.Handler.
func NewRouter(d Deps) http.Handler {
log := d.Log
if log == nil {
log = slog.New(slog.DiscardHandler)
}
r := chi.NewRouter()
r.Use(middleware.RequestID, httpx.RealIP, httpx.AccessLog(log), middleware.Recoverer)
if d.AuthService != nil {
r.Use(auth.Middleware(d.AuthService, log))
}
r.NotFound(httpx.NotFound)
r.MethodNotAllowed(httpx.MethodNotAllowed)
if d.TUS != nil {
d.TUS.Mount(r)
}
strict := gen.NewStrictHandlerWithOptions(handlers{systemHandler: d.System, authHandler: d.Auth, libraryHandler: d.Library, searchHandler: d.Search, playbackHandler: d.Playback, waveHandler: d.Wave, appHandler: d.App, uploadsHandler: d.Uploads},
[]gen.StrictMiddlewareFunc{httpx.StrictRequest}, gen.StrictHTTPServerOptions{
RequestErrorHandlerFunc: httpx.RequestError,
ResponseErrorHandlerFunc: httpx.ResponseError(log),
})
return gen.HandlerWithOptions(strict, gen.ChiServerOptions{
BaseRouter: r,
// Ошибки разбора path- и query-параметров — тоже problem+json, а не текст по умолчанию.
ErrorHandlerFunc: httpx.RequestError,
})
}