Device Configuration

The DeviceConfigController and its backing CQRS handlers manage the lifecycle of camera devices — from initial onboarding through configuration updates and credential management.

Onboarding Workflow

The IOnboardingService orchestrates the multi-step process of adding a new camera to the system:

1. Device document is created in the Cosmos DB deviceConfig container with camera metadata (IP, manufacturer, model, location)
2. Credentials are encrypted via IEncryptionService and stored securely
3. SQL entity is created for relational queries (user-agency-camera relationships)
4. ESRI feature layer is updated to show the camera on the map
5. Durable Entity (CameraState) is initialized for orchestration state tracking

Key Endpoints

Endpoint	Method	Purpose
/deviceconfig	GET	List all device configurations
/deviceconfig/{id}	GET	Get a single device config
/deviceconfig	POST	Create a new device config (onboarding)
/deviceconfig/{id}	PUT	Update device configuration
/deviceconfig/{id}	DELETE	Remove a device
/deviceconfig/credentials/{id}	GET	Get device credentials (decrypted)
/deviceconfig/credentials	PUT	Update device credentials

Bulk Operations

The IBulkOperationsService allows batch operations across multiple cameras:

• Bulk deploy — Start image acquisition on multiple cameras simultaneously
• Bulk stop — Stop acquisition on multiple cameras
• Bulk redeploy — Restart orchestrations for a set of cameras
• Bulk update — Apply configuration changes across a group

CQRS Handlers

Commands

• CreateDeviceConfigCommand — Creates device in Cosmos + SQL + ESRI
• UpdateDeviceConfigCommand — Updates device configuration
• DeleteDeviceConfigCommand — Removes device and cleans up related entities
• UpdateDeviceCredentialsCommand — Encrypts and stores credentials

Queries

• GetAllDeviceConfigsQuery — Lists all devices with optional filtering
• GetDeviceConfigByIdQuery — Single device lookup
• GetDeviceCredentialsByIdQuery — Decrypted credential retrieval

Data Model

Device configurations are stored in Cosmos DB with the following key fields:

Field	Description
deviceId	Unique identifier
deviceName	Human-readable name
ipAddress	Camera network address (encrypted at rest)
manufacturer	Camera manufacturer (Axis, Mobotix)
modelNumber	Camera model
latitude / longitude	Geographic coordinates
isActive	Whether the camera is currently active
acquisitionRate	Image capture interval in seconds
imageType	SINGLE, PANO, or PRE_STITCHED