163 lines
3.6 KiB
YAML
163 lines
3.6 KiB
YAML
task_id: task_create_api_update_song
|
|
entity_id: api_update_song
|
|
generated_at: '2025-12-18T15:16:50.250397'
|
|
workflow_version: v001
|
|
target:
|
|
type: api
|
|
definition:
|
|
id: api_update_song
|
|
method: PUT
|
|
path: /api/songs/:id
|
|
description: Update song metadata
|
|
request_body:
|
|
title: string
|
|
album_id: uuid
|
|
genre_ids: array[uuid]
|
|
release_date: string
|
|
is_public: boolean
|
|
responses:
|
|
- status: 200
|
|
description: Song updated
|
|
schema:
|
|
id: uuid
|
|
title: string
|
|
- status: 403
|
|
description: Unauthorized
|
|
schema:
|
|
error: string
|
|
auth:
|
|
required: true
|
|
owner_only: true
|
|
depends_on_models:
|
|
- model_song
|
|
related:
|
|
models:
|
|
- id: model_song
|
|
definition: &id001
|
|
id: model_song
|
|
name: Song
|
|
table_name: songs
|
|
description: Audio track with metadata
|
|
fields:
|
|
- name: id
|
|
type: uuid
|
|
constraints:
|
|
- primary_key
|
|
- name: artist_id
|
|
type: uuid
|
|
constraints:
|
|
- not_null
|
|
- foreign_key
|
|
references: artists.id
|
|
- name: album_id
|
|
type: uuid
|
|
constraints:
|
|
- nullable
|
|
- foreign_key
|
|
references: albums.id
|
|
- name: title
|
|
type: string
|
|
constraints:
|
|
- not_null
|
|
- name: duration
|
|
type: integer
|
|
description: Duration in seconds
|
|
constraints:
|
|
- not_null
|
|
- name: file_url
|
|
type: string
|
|
description: Cloud storage URL for audio file
|
|
constraints:
|
|
- not_null
|
|
- name: file_format
|
|
type: enum
|
|
values:
|
|
- mp3
|
|
- wav
|
|
constraints:
|
|
- not_null
|
|
- name: file_size
|
|
type: integer
|
|
description: File size in bytes
|
|
constraints:
|
|
- not_null
|
|
- name: waveform_data
|
|
type: jsonb
|
|
description: Waveform visualization data
|
|
constraints:
|
|
- nullable
|
|
- name: cover_art_url
|
|
type: string
|
|
constraints:
|
|
- nullable
|
|
- name: release_date
|
|
type: date
|
|
constraints:
|
|
- nullable
|
|
- name: play_count
|
|
type: integer
|
|
default: 0
|
|
- name: is_public
|
|
type: boolean
|
|
default: true
|
|
- name: track_number
|
|
type: integer
|
|
description: Position in album
|
|
constraints:
|
|
- nullable
|
|
- name: created_at
|
|
type: timestamp
|
|
constraints:
|
|
- not_null
|
|
- name: updated_at
|
|
type: timestamp
|
|
constraints:
|
|
- not_null
|
|
relations:
|
|
- type: belongs_to
|
|
to: model_artist
|
|
foreign_key: artist_id
|
|
- type: belongs_to
|
|
to: model_album
|
|
foreign_key: album_id
|
|
optional: true
|
|
- type: has_many
|
|
to: model_genre
|
|
through: song_genres
|
|
foreign_key: song_id
|
|
- type: has_many
|
|
to: model_playlist_song
|
|
foreign_key: song_id
|
|
indexes:
|
|
- fields:
|
|
- artist_id
|
|
- fields:
|
|
- album_id
|
|
- fields:
|
|
- release_date
|
|
- fields:
|
|
- play_count
|
|
- fields:
|
|
- is_public
|
|
timestamps: true
|
|
apis: []
|
|
components: []
|
|
dependencies:
|
|
entity_ids:
|
|
- model_song
|
|
definitions:
|
|
- id: model_song
|
|
type: model
|
|
definition: *id001
|
|
files:
|
|
to_create:
|
|
- app/api/songs/id/route.ts
|
|
reference: []
|
|
acceptance:
|
|
- criterion: PUT /api/songs/:id returns success response
|
|
verification: curl -X PUT /api/songs/:id
|
|
- criterion: Request validation implemented
|
|
verification: Test with invalid data
|
|
- criterion: Error responses match contract
|
|
verification: Test error scenarios
|