05 Location Management

@T-FUNC-0501.01.01
Scenario: Locations are displayed as cards on the board
  Given I have a novel with three locations
  When I navigate to the location list board
  Then I see three location cards displayed

@T-FUNC-0501.01.02
Scenario: Archived locations do not appear on the location list board
  Given I have a novel with one active location and one archived location
  When I navigate to the location list board
  Then I see only the active location
  And I do not see the archived location

@T-UI-0501.01.01
Scenario: No parent summary section is shown on the location list board
  Given I have a novel with at least one location
  When I navigate to the location list board
  Then I do not see a parent summary section
  And I see only the location cards

@T-FUNC-0502.01.01
Scenario: Successfully create a location
  Given I have an existing novel
  And I am on the location list board
  When I click the Add Location button
  And I enter a location name
  And I click the Save button
  Then the location is created
  And it appears on the location list board

@T-FUNC-0502.01.02
Scenario: Attempt to create a location without a name
  Given I am on the add location page
  When I click the Save button without entering a location name
  Then the location is not created
  And I see an error message indicating that a location name is required

@T-UI-0502.01.01
Scenario: Add location form presents all required fields
  Given I have an existing novel
  When I click the Add Location button
  Then the add location form displays fields for: location name, location type, description, notes, and image

@T-UI-0501.02.01
Scenario: Location image is displayed on the card when one has been uploaded
  Given I have a location with an uploaded image
  When I view the location list board
  Then the location's card displays the uploaded image

@T-UI-0501.02.02
Scenario: Location card displays no image when none has been uploaded
  Given I have a location with no uploaded image
  When I view the location list board
  Then the location's card does not display an image

@T-FUNC-0502.02.01
Scenario: Successfully upload a location image on the add location page
  Given I am on the add location page
  When I upload an image file using the image field
  And I click the Save button
  Then the location is created with the uploaded image associated
  And the image is displayed on the location's edit page

@T-FUNC-0502.02.02
Scenario: Successfully upload a location image on the edit location page
  Given I have an existing location with no image
  And I am on the edit location page
  When I upload an image file using the image field
  And I click the Save button
  Then the uploaded image is associated with the location
  And the image is displayed on the location's edit page

@T-FUNC-0502.02.03
Scenario: Successfully replace an existing location image
  Given I have an existing location with an uploaded image
  And I am on the edit location page
  When I upload a new image file using the image field
  And I click the Save button
  Then the new image replaces the previous image

@T-SEC-0502.01.01
Scenario: PNG file is accepted for location image upload
  Given I am on the add location page
  When I upload a file with the extension .png
  Then the file is accepted

@T-SEC-0502.01.02
Scenario: JPG file is accepted for location image upload
  Given I am on the add location page
  When I upload a file with the extension .jpg
  Then the file is accepted

@T-SEC-0502.01.03
Scenario: JPEG file is accepted for location image upload
  Given I am on the add location page
  When I upload a file with the extension .jpeg
  Then the file is accepted

@T-SEC-0502.01.04
Scenario: File with unsupported extension is rejected
  Given I am on the add location page
  When I attempt to upload a file with an extension other than .png, .jpg, or .jpeg
  Then the file is rejected
  And I see an error message indicating that only PNG and JPEG files are accepted

@T-FUNC-0502.03.01
Scenario: Successfully add a new location type value
  Given I am on the location form for a novel
  When I open the type manager
  And I enter a new type name
  And I click the Add button
  Then the new type value is saved
  And it is immediately available for selection in the type field

@T-FUNC-0502.03.02
Scenario: Type values are scoped to the current novel
  Given I have added a type value to Novel A
  When I open the location form for Novel B
  Then the type value from Novel A is not available in Novel B's type field

@T-FUNC-0502.04.01
Scenario: Successfully rename a location type value
  Given a location type value exists
  And I am on the location form
  When I open the type manager
  And I rename the type value
  And I click the Save button
  Then the type value is updated
  And any locations assigned to that type display the new name

@T-FUNC-0502.05.01
Scenario: Successfully delete a location type value
  Given a location type value exists
  And I am on the location form
  When I open the type manager
  And I delete the type value
  Then the type value is removed from the available options

@T-FUNC-0502.05.02
Scenario: Deleting a type value does not delete assigned locations
  Given a location type value exists
  And one or more locations are assigned to that type
  When I delete the type value
  Then the locations assigned to that type are not deleted
  And those locations have no type assigned

@T-FUNC-0503.01.01
Scenario: Successfully save changes to a location
  Given I have an existing location
  And I am on the edit location page
  When I change the location name
  And I click the Save button
  Then the location is updated
  And the new name is displayed on the location list board

@T-FUNC-0503.01.02
Scenario: Cancel editing a location
  Given I have an existing location
  And I am on the edit location page
  When I change the location name
  And I click the Cancel button
  Then the location is not updated
  And the original name is retained

@T-UI-0503.01.01
Scenario: Appears in scenes is displayed as read-only on the edit location page
  Given I have an existing location
  When I navigate to the edit location page
  Then the appears in scenes field is displayed
  And it is not editable

@T-FUNC-0510.01.01
Scenario: Successfully define a relationship between a location and a character
  Given I have a novel with a location and a character
  And I am on the details page of the location
  When I add a relationship to the character
  And I enter a forward label of "inhabited by"
  And I enter a reverse label of "inhabits"
  And I click the Save button
  Then the relationship is created
  And it is displayed on the location's details page with the label "inhabited by"
  And it is displayed on the character's details page with the label "inhabits"

@T-FUNC-0510.01.02
Scenario: Successfully define a relationship between two locations
  Given I have a novel with two locations
  And I am on the details page of the first location
  When I add a relationship to the second location
  And I enter a forward label of "borders"
  And I enter a reverse label of "bordered by"
  And I click the Save button
  Then the relationship is created
  And it is displayed on the first location's details page with the label "borders"
  And it is displayed on the second location's details page with the label "bordered by"

@T-FUNC-0510.02.01
Scenario: Relationship appears on both participating entities' pages with correct labels
  Given a relationship exists between a location and a character
  And the forward label is "inhabited by" and the reverse label is "inhabits"
  When I view the location's details page
  Then I see the relationship to the character labelled "inhabited by"
  When I view the character's details page
  Then I see the relationship to the location labelled "inhabits"

@T-FUNC-0510.03.01
Scenario: Successfully edit a relationship from the location's page
  Given a relationship exists between a location and an item
  And I am on the details page of the location
  When I edit the relationship and change the forward label
  And I click the Save button
  Then the updated label is displayed on both the location's and the item's details pages

@T-FUNC-0510.04.01
Scenario: Successfully delete a relationship from the location's page
  Given a relationship exists between a location and a character
  And I am on the details page of the location
  When I delete the relationship
  Then the relationship no longer appears on the location's details page
  And the relationship no longer appears on the character's details page
  And both the location and the character still exist

@T-DATA-0510.01.01
Scenario: Relationships are removed when a location is deleted
  Given a relationship exists between a location and a character
  When the location is deleted
  Then the relationship no longer appears on the character's details page