leistungsbilanz-ts/docs/spec/05-linked-devices-and-sync.md

Linked Project Devices and Synchronization

Concept

Circuit device rows may be linked to project devices.

Manual rows may exist without a linked project device.

A manual row can later be saved as a project device.

Name vs Display Name

Project devices and circuit list device rows use separate naming fields.

ProjectDevice.name

The technical or product-related name.

Examples:

• E-Line Pro
• Arbeitsplatzsteckdosen
• Durchlauferhitzer 21 kW

This field may be synchronized to linked circuit list rows where a technical source name is shown.

ProjectDevice.displayName

A default display name used when inserting the device into a circuit list.

Example:

• Lichtband
• Arbeitsplatzsteckdosen
• Handtrockner

CircuitDeviceRow.displayName

The circuit-list-specific display name.

Examples:

• Lichtband Seminarraum
• Beleuchtung Flur
• Steckdosen Arbeitsplatz Büro 2.14

When a project device is inserted, the row display name is prefilled from the project device.

After insertion, displayName remains local and must not be synchronized automatically.

Default Synchronization Rule

By default, these fields may be synchronized from project device to linked circuit list rows:

• name
• phaseType
• connectionKind
• costGroup
• category
• quantity
• powerPerUnit
• simultaneityFactor
• cosPhi
• totalPower
• remark

Default excluded field:

• displayName

Synchronization Dialog

When a project device is changed, the app should show a synchronization dialog.

The dialog should display affected linked rows.

For each affected row, show:

• distribution board
• section
• circuit identifier
• row display name
• changed fields
• current row value
• new project device value
• whether the row value was locally overridden

The user can choose:

• apply change to one linked row
• apply change to all linked rows
• exclude specific fields
• disconnect selected linked rows from the project device
• cancel synchronization

The app must not silently overwrite locally edited values without user control.

Local Overrides

A linked circuit device row may override inherited values locally.

The implementation should track overridden fields.

If a field is locally overridden, the synchronization dialog should mark it clearly.

The user may still choose to overwrite it.

Disconnecting a Linked Device

A linked device row can be disconnected from its source project device.

After disconnecting:

• the row remains in the circuit list
• existing local values stay unchanged
• future changes to the project device no longer affect this row

Manual Row to Project Device

Manual rows can be saved as project devices.

When this action is used:

• create a new project device from the row data
• link the row to the new project device
• preserve the existing circuit list display name
• apply synchronization rules from that point onward