Alexander
ad03caa3f4
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/claude-agent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
114 lines
3.3 KiB
Plaintext
114 lines
3.3 KiB
Plaintext
@startuml MonitorAlbumStream - Automatic Mode Happy Path
|
|
skinparam sequenceMessageAlign center
|
|
skinparam responseMessageBelowArrow true
|
|
title MonitorAlbumStream: Automatic Mode (Status Updates Only)
|
|
|
|
actor Client
|
|
participant "gRPC Server" as Server
|
|
participant "monitorWorkflow" as Workflow
|
|
participant "MusicAgregatorService" as Service
|
|
participant "MetadataService" as Metadata
|
|
database "metadata-agregator\n(gRPC)" as MetaGRPC
|
|
database "PostgreSQL" as DB
|
|
participant "IndexerService\n(Jackett)" as Indexer
|
|
participant "MagnetResolver" as Magnet
|
|
participant "TorrentClient\n(qBittorrent)" as QBit
|
|
participant "River Queue" as River
|
|
|
|
== 1. Initialize Bidirectional Stream ==
|
|
|
|
Client -> Server: MonitorAlbumStream()
|
|
note right: Opens bidirectional\ngRPC stream
|
|
Server -> Client: stream established
|
|
|
|
Client -> Server: StartMonitorRequest
|
|
note right: album_id, quality, tracker\nmode = AUTOMATIC
|
|
|
|
Server -> Workflow: newMonitorWorkflow(stream, req, service)
|
|
note right: Creates workflow with\ndecisions channel and\nreceiver goroutine
|
|
|
|
== 2. Fetch Album Metadata ==
|
|
|
|
Workflow ->> Client: StatusUpdate(FETCHING_METADATA)
|
|
note right #lightblue: "Fetching metadata..."
|
|
|
|
Workflow -> Service: getAlbumWithPersist(ctx, album_id)
|
|
Service -> Metadata: GetAlbum(album_id)
|
|
Metadata -> MetaGRPC: GetAlbum(id)
|
|
MetaGRPC --> Metadata: Album
|
|
Metadata -> DB: artists.Create / albums.Create
|
|
Metadata --> Service: Album
|
|
|
|
Workflow ->> Client: StatusUpdate(FETCHING_METADATA)
|
|
note right #lightblue: "Got: Artist - Title"\nData: StreamAlbumInfo
|
|
|
|
== 3. Check If Already Owned ==
|
|
|
|
Workflow ->> Client: StatusUpdate(CHECKING_OWNED)
|
|
note right #lightblue: "Checking ownership..."
|
|
|
|
Workflow -> DB: downloads.HasAlbumInQuality()
|
|
DB --> Workflow: false
|
|
|
|
== 4. Search Indexers ==
|
|
|
|
Workflow ->> Client: StatusUpdate(SEARCHING_INDEXER)
|
|
note right #lightblue: "Searching indexers..."
|
|
|
|
Workflow -> Indexer: Search(query, tracker)
|
|
Indexer --> Workflow: SearchResponse (N items)
|
|
|
|
== 5. Parse Releases ==
|
|
|
|
loop for each search result
|
|
Workflow -> Magnet: Resolve(magnet_uri)
|
|
Magnet --> Workflow: torrent metadata
|
|
Workflow -> Workflow: ParseTorrent()
|
|
end
|
|
|
|
Workflow ->> Client: StatusUpdate(PARSING_RESULTS)
|
|
note right #lightblue: "Parsed M from N torrents"\nData: TorrentList
|
|
|
|
== 6. Filter by Quality ==
|
|
|
|
Workflow ->> Client: StatusUpdate(FILTERING_QUALITY)
|
|
note right #lightblue: "Filtering by quality..."
|
|
|
|
Workflow -> Workflow: filterByQuality(parsed, quality)
|
|
|
|
== 7. Select Best Release ==
|
|
|
|
Workflow -> Workflow: selectBestRelease(filtered)
|
|
note right: Highest seeder count wins\n(automatic selection)
|
|
|
|
Workflow ->> Client: StatusUpdate(SELECTING_RELEASE)
|
|
note right #lightblue: "Selected: Title (N seeders)"\nData: ReleaseInfo
|
|
|
|
== 8. Add to Torrent Client ==
|
|
|
|
Workflow ->> Client: StatusUpdate(ADDING_TORRENT)
|
|
note right #lightblue: "Adding torrent..."
|
|
|
|
Workflow -> QBit: AddMagnet(magnet_uri)
|
|
QBit --> Workflow: OK
|
|
|
|
== 9. Persist & Schedule ==
|
|
|
|
Workflow ->> Client: StatusUpdate(SAVING)
|
|
note right #lightblue: "Saving to database..."
|
|
|
|
Workflow -> DB: torrents.Create / downloads.Create
|
|
Workflow -> River: Insert(PollDownloadArgs)
|
|
|
|
== 10. Return Result ==
|
|
|
|
Workflow ->> Client: StatusUpdate(COMPLETE)
|
|
note right #lightblue: "Download started"
|
|
|
|
Workflow ->> Client: MonitorAlbumResponse
|
|
note right #lightgreen: Final result with:\nalbum, artist, release, download
|
|
|
|
Server -> Server: Close stream
|
|
|
|
@enduml
|