хранилище, файлы записей и очередь переведены на встроенную PocketBase

- записи, метаданные и файлы съехались под один каталог данных; появилась
  панель владельца, а gin, goqu, goose и требование CGO ушли
- захват задачи стал одним запросом с RETURNING; заведены число попыток,
  состояние dead и нарастающая пауза вместо признака is_error
- имя файла в хранилище задаёт сервис и в журнал не идёт: вместе с
  идентификатором записи оно собирало бы ссылку на скачивание

internal/controller/http/transcribe.go

@@ -1,22 +1,30 @@
 package http
 
 import (
-	"log"
+	"log/slog"
 	"net/http"
 	"time"
 
+	"github.com/pocketbase/pocketbase/apis"
+	"github.com/pocketbase/pocketbase/core"
+	"github.com/pocketbase/pocketbase/tools/router"
+
 	"git.vakhrushev.me/av/transcriber/internal/contract"
+	"git.vakhrushev.me/av/transcriber/internal/entity"
 	"git.vakhrushev.me/av/transcriber/internal/service"
-	"github.com/gin-gonic/gin"
 )
 
 type TranscribeHandler struct {
 	jobRepo    contract.TranscriptJobRepository
 	trsService *service.TranscribeService
+	logger     *slog.Logger
 }
 
-func NewTranscribeHandler(jobRepo contract.TranscriptJobRepository, trsService *service.TranscribeService) *TranscribeHandler {
-	return &TranscribeHandler{jobRepo: jobRepo, trsService: trsService}
+func NewTranscribeHandler(jobRepo contract.TranscriptJobRepository, trsService *service.TranscribeService, logger *slog.Logger) *TranscribeHandler {
+	if logger == nil {
+		logger = slog.Default()
+	}
+	return &TranscribeHandler{jobRepo: jobRepo, trsService: trsService, logger: logger}
 }
 
 type CreateTranscribeJobResponse struct {
@@ -31,74 +39,56 @@ type GetTranscribeJobResponse struct {
 	TranscriptionText *string   `json:"transcription_text,omitempty"`
 }
 
-func (h *TranscribeHandler) CreateTranscribeJob(c *gin.Context) {
+// Register вешает маршруты сервиса на роутер хранилища. Порт у сервиса и у
+// панели один, поэтому и роутер один; имена полей ответа и коды при переезде
+// сохранены — публичный контракт API объявлен необратимым.
+func (h *TranscribeHandler) Register(r *router.Router[*core.RequestEvent]) {
+	api := r.Group("/api")
+	// Умолчание роутера хранилища — 32 МиБ на тело, и оно отсекало бы запись
+	// раньше обработчика, без строки в журнале приёма. Приём размеру не судья,
+	// поэтому предел тела равен потолку самой записи.
+	api.POST("/audio", h.CreateTranscribeJob).Bind(apis.BodyLimit(entity.MaxRecordSize))
+	api.GET("/status/{id}", h.GetTranscribeJobStatus)
+}
+
+func (h *TranscribeHandler) CreateTranscribeJob(e *core.RequestEvent) error {
 	// Получаем файл из формы
-	file, header, err := c.Request.FormFile("audio")
+	file, header, err := e.Request.FormFile("audio")
 	if err != nil {
-		c.JSON(http.StatusBadRequest, gin.H{"error": "No audio file provided"})
-		return
+		return e.JSON(http.StatusBadRequest, map[string]string{"error": "No audio file provided"})
 	}
-	defer file.Close()
+	defer func() {
+		if err := file.Close(); err != nil {
+			h.logger.Error("Failed to close uploaded file", "error", err)
+		}
+	}()
 
 	job, err := h.trsService.CreateJobFromApi(file, header.Filename)
 	if err != nil {
-		log.Printf("Err: %v", err)
-		c.JSON(http.StatusInternalServerError, gin.H{"error": "Failed to create transcibe job"})
-		return
+		// Второй раз отказ не логируем: приём назван конвенцией логирующей
+		// границей и уже написал о нём. Транспорт переводит ошибку в ответ.
+		return e.JSON(http.StatusInternalServerError, map[string]string{"error": "Failed to create transcibe job"})
 	}
 
 	// Возвращаем успешный ответ
-	response := CreateTranscribeJobResponse{
+	return e.JSON(http.StatusCreated, CreateTranscribeJobResponse{
 		JobID: job.Id,
 		State: job.State,
-	}
-
-	c.JSON(http.StatusCreated, response)
+	})
 }
 
-func (h *TranscribeHandler) GetTranscribeJobStatus(c *gin.Context) {
-	jobID := c.Param("id")
+func (h *TranscribeHandler) GetTranscribeJobStatus(e *core.RequestEvent) error {
+	jobID := e.Request.PathValue("id")
 
 	job, err := h.jobRepo.GetByID(jobID)
 	if err != nil {
-		c.JSON(http.StatusNotFound, gin.H{"error": "Job not found"})
-		return
+		return e.JSON(http.StatusNotFound, map[string]string{"error": "Job not found"})
 	}
 
-	c.JSON(http.StatusOK, GetTranscribeJobResponse{
+	return e.JSON(http.StatusOK, GetTranscribeJobResponse{
 		JobID:             job.Id,
 		State:             job.State,
 		CreatedAt:         job.CreatedAt,
 		TranscriptionText: job.TranscriptionText,
 	})
 }
-
-func (h *TranscribeHandler) RunConversionJob(c *gin.Context) {
-	err := h.trsService.FindAndRunConversionJob()
-	if err != nil {
-		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
-		return
-	}
-
-	c.Status(http.StatusOK)
-}
-
-func (h *TranscribeHandler) RunTranscribeJob(c *gin.Context) {
-	err := h.trsService.FindAndRunTranscribeJob()
-	if err != nil {
-		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
-		return
-	}
-
-	c.Status(http.StatusOK)
-}
-
-func (h *TranscribeHandler) RunRecognitionCheckJob(c *gin.Context) {
-	err := h.trsService.FindAndRunTranscribeCheckJob()
-	if err != nil {
-		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
-		return
-	}
-
-	c.Status(http.StatusOK)
-}