@startuml Configuration Management Sequence
!theme plain
skinparam backgroundColor #FEFEFE

title Configuration Management - Create G-Core Server Flow

actor "Client\n(Browser/API)" as client
participant "FastAPI\nREST API\n:8000" as api
participant "gRPC\nSDK Bridge\n:50051" as bridge
participant "SetupClient" as setup
participant "FolderTree\nParser" as parser
participant "FolderTree\nWriter" as writer
participant "GeViServer\n:7700-7703" as server
database "TestMKS.set" as config

== Server Creation Request ==

client -> api : POST /api/v1/configuration/servers\n{"alias": "New Server", "host": "192.168.1.100", ...}
activate api

api -> api : Validate request\n(check required fields)

api -> bridge : gRPC: CreateServer(request)
activate bridge

bridge -> setup : DownloadConfiguration()
activate setup

setup -> server : Connect to SetupClient port\n(Request configuration)
activate server

server -> setup : Return binary .set file
deactivate server

setup --> bridge : Binary config data
deactivate setup

bridge -> parser : ParseConfiguration(binaryData)
activate parser

parser -> parser : Parse binary format\nBuild folder tree structure
parser --> bridge : FolderTree object
deactivate parser

== Configuration Modification ==

bridge -> bridge : Navigate to GeViGCoreServer folder
bridge -> bridge : Find highest server ID\n(e.g., max = 13)
bridge -> bridge : Generate new ID = 14

bridge -> writer : CreateServerNode(\nid="14",\nalias="New Server",\nhost="192.168.1.100",\n...)
activate writer

writer -> writer : Create folder node\nAdd child nodes:\n- Alias\n- DeactivateEcho\n- DeactivateLiveCheck\n- Enabled (bool type!)\n- Host\n- Password\n- User

writer -> writer : Insert into GeViGCoreServer\nfolder in alphabetical order

writer --> bridge : Updated FolderTree
deactivate writer

== Upload Modified Configuration ==

bridge -> setup : UploadConfiguration(modifiedTree)
activate setup

setup -> setup : Serialize FolderTree\nto binary format

setup -> server : Upload modified .set file\nvia SetupClient protocol
activate server

server -> config : Save TestMKS.set
server -> server : Reload configuration\n(batch import)

server --> setup : Upload success
deactivate server

setup --> bridge : Configuration updated
deactivate setup

bridge --> api : CreateServerResponse\n{id: "14", ...}
deactivate bridge

api --> client : HTTP 201 Created\n{"id": "14", "alias": "New Server", ...}
deactivate api

== Verification (Optional) ==

client -> api : GET /api/v1/configuration/servers
activate api

api -> bridge : gRPC: GetAllServers()
activate bridge

bridge -> setup : DownloadConfiguration()
activate setup

setup -> server : Request current config
activate server
server --> setup : Current .set file
deactivate server

setup --> bridge : Binary data
deactivate setup

bridge -> parser : ParseConfiguration()
activate parser
parser --> bridge : FolderTree
deactivate parser

bridge -> bridge : Extract all servers from\nGeViGCoreServer folder

bridge --> api : List of servers\n(including new server #14)
deactivate bridge

api --> client : HTTP 200 OK\n[{id:"1",...}, {id:"14",...}]
deactivate api

note over bridge, server
  **Critical Implementation Details:**

  1. **Bool Type Handling**:
     - Must write Enabled as type code 1 (bool)
     - GeViServer stores as int32 but reads bool correctly

  2. **Field Order**:
     - Must be: Alias, DeactivateEcho, DeactivateLiveCheck,
       Enabled, Host, Password, User

  3. **Auto-increment ID**:
     - Find max numeric ID in existing servers
     - Increment by 1 for new server

  4. **SetupClient Port**:
     - Only one client can connect at a time
     - GeViSet blocks SDK Bridge connection (and vice versa)
end note

@enduml