Editing UI/Protected Segment Functionality (section)

= Protected Segment Functionality =

== Overview ==
Segments represent underground or aerial fiber paths displayed on the Google Map.  
The '''protected status''' of a segment determines whether its shape (geometry) can be modified.  
This page explains the protection statuses, the new '''Override Protected Segment Shape''' feature, and how the system handles shape modifications.

== Protection Statuses ==
Each segment has one of the following protection statuses:

{| class="wikitable"
! Status
! Description
|-
| '''Unprotected'''
| Segment can be freely edited.
|-
| '''Ready to Protect'''
| Segment has been modified and is pending revalidation before being locked again.
|-
| '''Protected'''
| Segment shape is locked and cannot be modified.
|-
| '''No Protection Needed'''
| Segment does not require any protection validation.
|}

== Override Protected Segment Shape ==

=== Purpose ===
Allows controlled modifications to a '''Protected''' segment’s shape when minor adjustments are needed (for example, correcting a slight offset or aligning with a new road line).

=== Button ===
'''Button label:''' <code>Override Protected Segment Shape</code>  

[[File:Override_protectedStatus_button.png|thumb|Button: Override Protected Segment Shape]]

=== How It Works ===
# When the button is clicked, a '''visual buffer zone''' appears around the protected segment.  
   This buffer defines the allowable area for shape adjustments.
# If the user reshapes the segment and all points remain inside the buffer:
#* The segment stays '''Protected'''.
#* The changes are saved.
# If any point of the modified shape goes outside the buffer:
#* The system displays a warning message:
#  <blockquote>''Protection Override Tool: Saving will mark as Ready to Protect.''</blockquote>
#* If the user saves, the status automatically changes from '''Protected''' → '''Ready to Protect'''.

== Summary of Behavior ==
{| class="wikitable"
! Action
! Within Buffer
! Outside Buffer
|-
| Shape edited
| Allowed
| Allowed
|-
| Visual warning
| No
| Yes (''Saving will mark as Ready to Protect'')
|-
| Resulting status after save
| Protected
| Ready to Protect
|}

== Intended Use ==
This tool is designed for '''minor route adjustments only'''.  
Larger geometry changes should be performed on '''unprotected''' segments or after manually setting the segment back to '''Unprotected'''.