av
8af8ec2e54
- колонка `owner` связью с `users` в обеих коллекциях новым шагом схемы `202608140001`; чтение задачи сужено владельцем, и чужая, ничья и несуществующая дают один ответ; правило просмотра файлов сужено им же - приём по HTTP берёт владельца из сессии, а предъявителя без учётной записи пользователя отвергает до чтения тела: позже пришлось бы убирать уложенный файл, а уборки файлов сервис не умеет. Выборка воркера владельцем не сужается - удаление учётной записи с записями отвергается стражем, и вешает его сама сборка хранилища: сборка, забывшая его позвать, теряла защиту молча
77 lines
5.3 KiB
Go
77 lines
5.3 KiB
Go
package contract
|
|
|
|
import (
|
|
"io"
|
|
"time"
|
|
|
|
"git.vakhrushev.me/av/transcriber/internal/entity"
|
|
)
|
|
|
|
// WorkFile — рабочая копия файла на диске: её просят шаги, отдающие файл
|
|
// внешней программе, потому что `ffmpeg` и `ffprobe` принимают имя аргументом.
|
|
//
|
|
// Заводится копия одним способом — репозиторием файлов, — и убирает её за собой
|
|
// Close. Каждый шаг, заводящий копию сам, повторял бы и обязанность прибрать, а
|
|
// забытая копия это шестичасовая запись во временном каталоге, о которой не
|
|
// узнает никто.
|
|
type WorkFile interface {
|
|
// Path — имя копии на диске, годное для внешней программы.
|
|
Path() string
|
|
// Size — длина копии в байтах на момент вызова.
|
|
Size() (int64, error)
|
|
// Close убирает копию. Зовётся на любом исходе, включая отказ.
|
|
Close() error
|
|
}
|
|
|
|
type FileRepository interface {
|
|
// Stage принимает содержимое потоком в рабочую копию с заданным
|
|
// расширением: по нему внешняя программа выбирает разбор. В память запись
|
|
// целиком не читается — расчётный потолок шесть часов.
|
|
Stage(ext string, content io.Reader) (WorkFile, error)
|
|
// StageEmpty заводит пустую рабочую копию с заданным расширением — под
|
|
// результат внешней программы, которая пишет по имени.
|
|
StageEmpty(ext string) (WorkFile, error)
|
|
// Localize выдаёт рабочую копию хранимого файла.
|
|
Localize(fileID string) (WorkFile, error)
|
|
// CreateLocal кладёт рабочую копию в хранилище под именем name и заводит
|
|
// запись о файле. Имя задаёт сервис: умолчание хранилища, строящее его из
|
|
// имени отправителя, не применяется.
|
|
//
|
|
// ownerID — владелец записи, которой файл принадлежит; пустой значит «файл
|
|
// без владельца», и таков всякий файл записи, принятой ботом. Владелец
|
|
// лежит своей колонкой, а не выводится через задачу: ссылку на файл в
|
|
// задаче переставляет каждый шаг конвейера, и исходная копия после
|
|
// конвертации не связана с задачей ничем.
|
|
CreateLocal(name string, work WorkFile, ownerID string) (*entity.File, error)
|
|
// CreateRemote заводит запись о копии, лежащей во внешнем хранилище.
|
|
CreateRemote(objectKey string, size int64, ownerID string) (*entity.File, error)
|
|
GetByID(id string) (*entity.File, error)
|
|
// Open отдаёт содержимое хранимого файла потоком.
|
|
Open(fileID string) (io.ReadCloser, error)
|
|
}
|
|
|
|
type TranscriptJobRepository interface {
|
|
Create(job *entity.TranscribeJob) error
|
|
// Save сохраняет задачу, захват которой держит holder. Захват, доставшийся
|
|
// за время работы другому, даёт LostAcquisitionError и запись не проводит.
|
|
// Пустой holder снимает эту условность и в конвейере не употребляется: все
|
|
// его шаги получают признак захвата от FindAndAcquire.
|
|
Save(job *entity.TranscribeJob, holder string) error
|
|
// GetByID отдаёт задачу, только если её владелец — ownerID. Чужая задача,
|
|
// ничья задача и несуществующая дают одну и ту же ошибку: по разнице
|
|
// ответов иначе перебирается список заведённых задач.
|
|
//
|
|
// Владелец здесь обязателен, и пустой ownerID не совпадает ни с чем —
|
|
// включая задачи без владельца. Правило записано со стороны спрашивающего:
|
|
// обязательность, которую держит одна лишь подпись метода, пустую строку
|
|
// пропускает, и вызывающий без учётной записи получил бы ровно множество
|
|
// записей бота.
|
|
//
|
|
// Второго читающего метода нет намеренно: он выбирался бы по
|
|
// внимательности вызывающего.
|
|
GetByID(id, ownerID string) (*entity.TranscribeJob, error)
|
|
// FindAndAcquire забирает задачу одним неделимым шагом и увеличивает число
|
|
// её попыток. Работы в состоянии нет — JobNotFoundError.
|
|
FindAndAcquire(state, acquisitionId string, rottingTime time.Time) (*entity.TranscribeJob, error)
|
|
}
|