Phase 0 WP-0.2–0.9: Implement Commons (types, entities, interfaces, messages, protocol, tests)

- WP-0.2: Namespace/folder skeleton (26 directories)
- WP-0.3: Shared data types (6 enums, RetryPolicy, Result<T>)
- WP-0.4: 24 domain entity POCOs across 10 domain areas
- WP-0.5: 7 repository interfaces with full CRUD signatures
- WP-0.6: IAuditService cross-cutting interface
- WP-0.7: 26 message contract records across 8 concern areas
- WP-0.8: IDataConnection protocol abstraction with batch ops
- WP-0.9: 8 architectural constraint enforcement tests
All 40 tests pass, zero warnings.

src/ScadaLink.Commons/Interfaces/Repositories/ITemplateEngineRepository.cs

@@ -0,0 +1,74 @@
+using ScadaLink.Commons.Entities.Instances;
+using ScadaLink.Commons.Entities.Templates;
+
+namespace ScadaLink.Commons.Interfaces.Repositories;
+
+public interface ITemplateEngineRepository
+{
+    // Template
+    Task<Template?> GetTemplateByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<Template?> GetTemplateWithChildrenAsync(int id, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<Template>> GetAllTemplatesAsync(CancellationToken cancellationToken = default);
+    Task AddTemplateAsync(Template template, CancellationToken cancellationToken = default);
+    Task UpdateTemplateAsync(Template template, CancellationToken cancellationToken = default);
+    Task DeleteTemplateAsync(int id, CancellationToken cancellationToken = default);
+
+    // TemplateAttribute
+    Task<TemplateAttribute?> GetTemplateAttributeByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<TemplateAttribute>> GetAttributesByTemplateIdAsync(int templateId, CancellationToken cancellationToken = default);
+    Task AddTemplateAttributeAsync(TemplateAttribute attribute, CancellationToken cancellationToken = default);
+    Task UpdateTemplateAttributeAsync(TemplateAttribute attribute, CancellationToken cancellationToken = default);
+    Task DeleteTemplateAttributeAsync(int id, CancellationToken cancellationToken = default);
+
+    // TemplateAlarm
+    Task<TemplateAlarm?> GetTemplateAlarmByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<TemplateAlarm>> GetAlarmsByTemplateIdAsync(int templateId, CancellationToken cancellationToken = default);
+    Task AddTemplateAlarmAsync(TemplateAlarm alarm, CancellationToken cancellationToken = default);
+    Task UpdateTemplateAlarmAsync(TemplateAlarm alarm, CancellationToken cancellationToken = default);
+    Task DeleteTemplateAlarmAsync(int id, CancellationToken cancellationToken = default);
+
+    // TemplateScript
+    Task<TemplateScript?> GetTemplateScriptByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<TemplateScript>> GetScriptsByTemplateIdAsync(int templateId, CancellationToken cancellationToken = default);
+    Task AddTemplateScriptAsync(TemplateScript script, CancellationToken cancellationToken = default);
+    Task UpdateTemplateScriptAsync(TemplateScript script, CancellationToken cancellationToken = default);
+    Task DeleteTemplateScriptAsync(int id, CancellationToken cancellationToken = default);
+
+    // TemplateComposition
+    Task<TemplateComposition?> GetTemplateCompositionByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<TemplateComposition>> GetCompositionsByTemplateIdAsync(int templateId, CancellationToken cancellationToken = default);
+    Task AddTemplateCompositionAsync(TemplateComposition composition, CancellationToken cancellationToken = default);
+    Task UpdateTemplateCompositionAsync(TemplateComposition composition, CancellationToken cancellationToken = default);
+    Task DeleteTemplateCompositionAsync(int id, CancellationToken cancellationToken = default);
+
+    // Instance
+    Task<Instance?> GetInstanceByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<Instance>> GetAllInstancesAsync(CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<Instance>> GetInstancesByTemplateIdAsync(int templateId, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<Instance>> GetInstancesBySiteIdAsync(int siteId, CancellationToken cancellationToken = default);
+    Task<Instance?> GetInstanceByUniqueNameAsync(string uniqueName, CancellationToken cancellationToken = default);
+    Task AddInstanceAsync(Instance instance, CancellationToken cancellationToken = default);
+    Task UpdateInstanceAsync(Instance instance, CancellationToken cancellationToken = default);
+    Task DeleteInstanceAsync(int id, CancellationToken cancellationToken = default);
+
+    // InstanceAttributeOverride
+    Task<IReadOnlyList<InstanceAttributeOverride>> GetOverridesByInstanceIdAsync(int instanceId, CancellationToken cancellationToken = default);
+    Task AddInstanceAttributeOverrideAsync(InstanceAttributeOverride attributeOverride, CancellationToken cancellationToken = default);
+    Task UpdateInstanceAttributeOverrideAsync(InstanceAttributeOverride attributeOverride, CancellationToken cancellationToken = default);
+    Task DeleteInstanceAttributeOverrideAsync(int id, CancellationToken cancellationToken = default);
+
+    // InstanceConnectionBinding
+    Task<IReadOnlyList<InstanceConnectionBinding>> GetBindingsByInstanceIdAsync(int instanceId, CancellationToken cancellationToken = default);
+    Task AddInstanceConnectionBindingAsync(InstanceConnectionBinding binding, CancellationToken cancellationToken = default);
+    Task UpdateInstanceConnectionBindingAsync(InstanceConnectionBinding binding, CancellationToken cancellationToken = default);
+    Task DeleteInstanceConnectionBindingAsync(int id, CancellationToken cancellationToken = default);
+
+    // Area
+    Task<Area?> GetAreaByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<IReadOnlyList<Area>> GetAreasBySiteIdAsync(int siteId, CancellationToken cancellationToken = default);
+    Task AddAreaAsync(Area area, CancellationToken cancellationToken = default);
+    Task UpdateAreaAsync(Area area, CancellationToken cancellationToken = default);
+    Task DeleteAreaAsync(int id, CancellationToken cancellationToken = default);
+
+    Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
+}