busya/ss-tools
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
001-migration-ui-redesign
ss-tools/specs/005-fix-ui-ws-validation/data-model.md
busya 43b4c75e36 worked backup
2025-12-21 00:16:12 +03:00

1.1 KiB
Raw Permalink Blame History

Data Model: Fix UI Styling, WebSocket Port Mismatch, and URL Validation

Entities

ServiceConnection

Represents the configuration for an external service.

Field Type Description Validation
base_url AnyHttpUrl The base URL of the service. Normalized to include /api/v1 if missing.
name string Friendly name for the connection. Required.
status string Connection status (connected, failed, etc.). Read-only.

TaskLogMessage

The structure of messages sent over the WebSocket for real-time logs.

Field Type Description
task_id string Unique identifier for the task.
message string The log message text.
timestamp datetime When the log was generated.
level string Log level (INFO, ERROR, etc.).

State Transitions

Connection Validation

  1. User inputs base_url.
  2. System validates URL format.
  3. System checks for /api/v1 suffix.
  4. If missing, system appends /api/v1.
  5. System attempts connection and updates status.