task_id: task_create_api_create_artist_profile
entity_id: api_create_artist_profile
generated_at: '2025-12-18T15:16:50.234771'
workflow_version: v001
target:
  type: api
  definition:
    id: api_create_artist_profile
    method: POST
    path: /api/artists
    description: Create artist profile (musicians only)
    request_body:
      stage_name: string
      bio: string
      cover_image_url: string
      social_links:
        twitter: string
        instagram: string
        facebook: string
        website: string
    responses:
    - status: 201
      description: Artist profile created
      schema:
        id: uuid
        stage_name: string
        bio: string
        cover_image_url: string
    - status: 403
      description: User is not a musician
      schema:
        error: string
    auth:
      required: true
      roles:
      - musician
    depends_on_models:
    - model_artist
    - model_user
related:
  models:
  - id: model_artist
    definition: &id001
      id: model_artist
      name: Artist
      table_name: artists
      description: Extended profile for musicians
      fields:
      - name: id
        type: uuid
        constraints:
        - primary_key
      - name: user_id
        type: uuid
        constraints:
        - not_null
        - foreign_key
        references: users.id
      - name: stage_name
        type: string
        constraints:
        - not_null
      - name: bio
        type: text
        constraints:
        - nullable
      - name: cover_image_url
        type: string
        constraints:
        - nullable
      - name: social_links
        type: jsonb
        description: JSON object with {twitter, instagram, facebook, website}
        constraints:
        - nullable
      - name: verified
        type: boolean
        default: false
      - name: created_at
        type: timestamp
        constraints:
        - not_null
      - name: updated_at
        type: timestamp
        constraints:
        - not_null
      relations:
      - type: belongs_to
        to: model_user
        foreign_key: user_id
      - type: has_many
        to: model_song
        foreign_key: artist_id
      - type: has_many
        to: model_album
        foreign_key: artist_id
      - type: belongs_to
        to: model_label
        foreign_key: label_id
        optional: true
      indexes:
      - fields:
        - user_id
        unique: true
      - fields:
        - stage_name
      timestamps: true
  - id: model_user
    definition: &id002
      id: model_user
      name: User
      table_name: users
      description: Base user entity with authentication
      fields:
      - name: id
        type: uuid
        constraints:
        - primary_key
      - name: email
        type: string
        constraints:
        - unique
        - not_null
      - name: password_hash
        type: string
        constraints:
        - not_null
      - name: name
        type: string
        constraints:
        - not_null
      - name: role
        type: enum
        values:
        - musician
        - listener
        - label
        constraints:
        - not_null
      - name: email_verified
        type: boolean
        default: false
      - name: avatar_url
        type: string
        constraints:
        - nullable
      - name: created_at
        type: timestamp
        constraints:
        - not_null
      - name: updated_at
        type: timestamp
        constraints:
        - not_null
      relations:
      - type: has_one
        to: model_artist
        foreign_key: user_id
        condition: role = 'musician'
      - type: has_one
        to: model_label
        foreign_key: user_id
        condition: role = 'label'
      - type: has_many
        to: model_playlist
        foreign_key: user_id
      indexes:
      - fields:
        - email
        unique: true
      - fields:
        - role
      timestamps: true
  apis: []
  components: []
dependencies:
  entity_ids:
  - model_artist
  - model_user
  definitions:
  - id: model_artist
    type: model
    definition: *id001
  - id: model_user
    type: model
    definition: *id002
files:
  to_create:
  - app/api/artists/route.ts
  reference: []
acceptance:
- criterion: POST /api/artists returns success response
  verification: curl -X POST /api/artists
- criterion: Request validation implemented
  verification: Test with invalid data
- criterion: Error responses match contract
  verification: Test error scenarios