YamlResourceCollection.cs 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412
  1. using System.Collections.Specialized;
  2. using RackPeek.Domain.Resources;
  3. using RackPeek.Domain.Resources.AccessPoints;
  4. using RackPeek.Domain.Resources.Desktops;
  5. using RackPeek.Domain.Resources.Firewalls;
  6. using RackPeek.Domain.Resources.Hardware;
  7. using RackPeek.Domain.Resources.Laptops;
  8. using RackPeek.Domain.Resources.Routers;
  9. using RackPeek.Domain.Resources.Servers;
  10. using RackPeek.Domain.Resources.Services;
  11. using RackPeek.Domain.Resources.Switches;
  12. using RackPeek.Domain.Resources.SystemResources;
  13. using RackPeek.Domain.Resources.UpsUnits;
  14. using YamlDotNet.Core;
  15. using YamlDotNet.Serialization;
  16. using YamlDotNet.Serialization.NamingConventions;
  17. namespace RackPeek.Domain.Persistence.Yaml;
  18. public class ResourceCollection
  19. {
  20. public readonly SemaphoreSlim FileLock = new(1, 1);
  21. public List<Resource> Resources { get; } = new();
  22. }
  23. public sealed class YamlResourceCollection(
  24. string filePath,
  25. ITextFileStore fileStore,
  26. ResourceCollection resourceCollection,
  27. IResourceYamlMigrationService migrationService)
  28. : IResourceCollection
  29. {
  30. // Bump this when your YAML schema changes, and add a migration step below.
  31. private static readonly int CurrentSchemaVersion = RackPeekConfigMigrationDeserializer.ListOfMigrations.Count;
  32. public Task<bool> Exists(string name)
  33. {
  34. return Task.FromResult(resourceCollection.Resources.Exists(r =>
  35. r.Name.Equals(name, StringComparison.OrdinalIgnoreCase)));
  36. }
  37. public Task<string?> GetKind(string? name)
  38. {
  39. return Task.FromResult(resourceCollection.Resources.FirstOrDefault(r =>
  40. r.Name.Equals(name, StringComparison.OrdinalIgnoreCase))?.Kind);
  41. }
  42. public Task<IReadOnlyList<(Resource, string)>> GetByLabelAsync(string name)
  43. {
  44. var result = resourceCollection.Resources
  45. .Where(r => r.Labels != null && r.Labels.TryGetValue(name, out _))
  46. .Select(r => (r, r.Labels![name]))
  47. .ToList()
  48. .AsReadOnly();
  49. return Task.FromResult<IReadOnlyList<(Resource, string)>>(result);
  50. }
  51. public Task<Dictionary<string, int>> GetLabelsAsync()
  52. {
  53. var result = resourceCollection.Resources
  54. .SelectMany(r => r.Labels ?? Enumerable.Empty<KeyValuePair<string, string>>())
  55. .Where(kvp => !string.IsNullOrWhiteSpace(kvp.Key))
  56. .GroupBy(kvp => kvp.Key)
  57. .ToDictionary(g => g.Key, g => g.Count());
  58. return Task.FromResult(result);
  59. }
  60. public Task<IReadOnlyList<(Resource, string)>> GetResourceIpsAsync()
  61. {
  62. var result = new List<(Resource, string)>();
  63. var allResources = resourceCollection.Resources;
  64. // Build fast lookup for systems
  65. var systemsByName = allResources
  66. .OfType<SystemResource>()
  67. .ToDictionary(s => s.Name, StringComparer.OrdinalIgnoreCase);
  68. // Cache resolved system IPs (prevents repeated recursion)
  69. var resolvedSystemIps = new Dictionary<string, string?>(StringComparer.OrdinalIgnoreCase);
  70. foreach (var resource in allResources)
  71. {
  72. switch (resource)
  73. {
  74. case SystemResource system:
  75. {
  76. var ip = ResolveSystemIp(system, systemsByName, resolvedSystemIps);
  77. if (!string.IsNullOrWhiteSpace(ip))
  78. result.Add((system, ip));
  79. break;
  80. }
  81. case Service service:
  82. {
  83. var ip = ResolveServiceIp(service, systemsByName, resolvedSystemIps);
  84. if (!string.IsNullOrWhiteSpace(ip))
  85. result.Add((service, ip));
  86. break;
  87. }
  88. }
  89. }
  90. return Task.FromResult((IReadOnlyList<(Resource, string)>)result);
  91. }
  92. private string? ResolveSystemIp(
  93. SystemResource system,
  94. Dictionary<string, SystemResource> systemsByName,
  95. Dictionary<string, string?> cache)
  96. {
  97. // Return cached result if already resolved
  98. if (cache.TryGetValue(system.Name, out var cached))
  99. return cached;
  100. // Direct IP wins
  101. if (!string.IsNullOrWhiteSpace(system.Ip))
  102. {
  103. cache[system.Name] = system.Ip;
  104. return system.Ip;
  105. }
  106. // Must have exactly one parent
  107. if (system.RunsOn?.Count != 1)
  108. {
  109. cache[system.Name] = null;
  110. return null;
  111. }
  112. var parentName = system.RunsOn.First();
  113. if (!systemsByName.TryGetValue(parentName, out var parent))
  114. {
  115. cache[system.Name] = null;
  116. return null;
  117. }
  118. var resolved = ResolveSystemIp(parent, systemsByName, cache);
  119. cache[system.Name] = resolved;
  120. return resolved;
  121. }
  122. private string? ResolveServiceIp(
  123. Service service,
  124. Dictionary<string, SystemResource> systemsByName,
  125. Dictionary<string, string?> cache)
  126. {
  127. // Direct IP wins
  128. if (!string.IsNullOrWhiteSpace(service.Network?.Ip))
  129. return service.Network!.Ip;
  130. // Must have exactly one parent
  131. if (service.RunsOn?.Count != 1)
  132. return null;
  133. var parentName = service.RunsOn.First();
  134. if (!systemsByName.TryGetValue(parentName, out var parent))
  135. return null;
  136. return ResolveSystemIp(parent, systemsByName, cache);
  137. }
  138. public Task<Dictionary<string, int>> GetTagsAsync()
  139. {
  140. var result = resourceCollection.Resources
  141. .SelectMany(r => r.Tags) // flatten all tag arrays
  142. .Where(t => !string.IsNullOrWhiteSpace(t))
  143. .GroupBy(t => t)
  144. .ToDictionary(g => g.Key, g => g.Count());
  145. return Task.FromResult(result);
  146. }
  147. public Task<IReadOnlyList<T>> GetAllOfTypeAsync<T>()
  148. {
  149. return Task.FromResult<IReadOnlyList<T>>(resourceCollection.Resources.OfType<T>().ToList());
  150. }
  151. public Task<IReadOnlyList<Resource>> GetDependantsAsync(string name)
  152. {
  153. var result = resourceCollection.Resources
  154. .Where(r => r.RunsOn.Any(p => p.Equals(name, StringComparison.OrdinalIgnoreCase)))
  155. .ToList();
  156. return Task.FromResult<IReadOnlyList<Resource>>(result);
  157. }
  158. public async Task Merge(string incomingYaml, MergeMode mode)
  159. {
  160. if (string.IsNullOrWhiteSpace(incomingYaml))
  161. return;
  162. await resourceCollection.FileLock.WaitAsync();
  163. try
  164. {
  165. var incomingRoot = await migrationService.DeserializeAsync(incomingYaml);
  166. var incomingResources = incomingRoot.Resources ?? new List<Resource>();
  167. var merged = ResourceCollectionMerger.Merge(
  168. resourceCollection.Resources,
  169. incomingResources,
  170. mode);
  171. resourceCollection.Resources.Clear();
  172. resourceCollection.Resources.AddRange(merged);
  173. var rootToSave = new YamlRoot
  174. {
  175. Version = RackPeekConfigMigrationDeserializer.ListOfMigrations.Count,
  176. Resources = resourceCollection.Resources
  177. };
  178. await SaveRootAsync(rootToSave);
  179. }
  180. finally
  181. {
  182. resourceCollection.FileLock.Release();
  183. }
  184. }
  185. public Task<IReadOnlyList<Resource>> GetByTagAsync(string name)
  186. {
  187. return Task.FromResult<IReadOnlyList<Resource>>(
  188. resourceCollection.Resources
  189. .Where(r => r.Tags.Contains(name))
  190. .ToList()
  191. );
  192. }
  193. public IReadOnlyList<Hardware> HardwareResources =>
  194. resourceCollection.Resources.OfType<Hardware>().ToList();
  195. public IReadOnlyList<SystemResource> SystemResources =>
  196. resourceCollection.Resources.OfType<SystemResource>().ToList();
  197. public IReadOnlyList<Service> ServiceResources =>
  198. resourceCollection.Resources.OfType<Service>().ToList();
  199. public Task<Resource?> GetByNameAsync(string name)
  200. {
  201. return Task.FromResult(resourceCollection.Resources.FirstOrDefault(r =>
  202. r.Name.Equals(name, StringComparison.OrdinalIgnoreCase)));
  203. }
  204. public Task<T?> GetByNameAsync<T>(string name) where T : Resource
  205. {
  206. var resource =
  207. resourceCollection.Resources.FirstOrDefault(r => r.Name.Equals(name, StringComparison.OrdinalIgnoreCase));
  208. return Task.FromResult(resource as T);
  209. }
  210. public Resource? GetByName(string name)
  211. {
  212. return resourceCollection.Resources.FirstOrDefault(r =>
  213. r.Name.Equals(name, StringComparison.OrdinalIgnoreCase));
  214. }
  215. public async Task LoadAsync()
  216. {
  217. var yaml = await fileStore.ReadAllTextAsync(filePath);
  218. var root = await migrationService.DeserializeAsync(
  219. yaml,
  220. async originalYaml => await BackupOriginalAsync(originalYaml),
  221. async migratedRoot => await SaveRootAsync(migratedRoot)
  222. );
  223. resourceCollection.Resources.Clear();
  224. if (root.Resources != null)
  225. resourceCollection.Resources.AddRange(root.Resources);
  226. }
  227. public Task AddAsync(Resource resource)
  228. {
  229. return UpdateWithLockAsync(list =>
  230. {
  231. if (list.Any(r => r.Name.Equals(resource.Name, StringComparison.OrdinalIgnoreCase)))
  232. throw new InvalidOperationException($"'{resource.Name}' already exists.");
  233. resource.Kind = GetKind(resource);
  234. list.Add(resource);
  235. });
  236. }
  237. public Task UpdateAsync(Resource resource)
  238. {
  239. return UpdateWithLockAsync(list =>
  240. {
  241. var index = list.FindIndex(r => r.Name.Equals(resource.Name, StringComparison.OrdinalIgnoreCase));
  242. if (index == -1) throw new InvalidOperationException("Not found.");
  243. resource.Kind = GetKind(resource);
  244. list[index] = resource;
  245. });
  246. }
  247. public Task DeleteAsync(string name)
  248. {
  249. return UpdateWithLockAsync(list =>
  250. list.RemoveAll(r => r.Name.Equals(name, StringComparison.OrdinalIgnoreCase)));
  251. }
  252. private async Task UpdateWithLockAsync(Action<List<Resource>> action)
  253. {
  254. await resourceCollection.FileLock.WaitAsync();
  255. try
  256. {
  257. action(resourceCollection.Resources);
  258. // Always write current schema version when app writes the file.
  259. var root = new YamlRoot
  260. {
  261. Version = CurrentSchemaVersion,
  262. Resources = resourceCollection.Resources
  263. };
  264. await SaveRootAsync(root);
  265. }
  266. finally
  267. {
  268. resourceCollection.FileLock.Release();
  269. }
  270. }
  271. // ----------------------------
  272. // Versioning + migration
  273. // ----------------------------
  274. private async Task BackupOriginalAsync(string originalYaml)
  275. {
  276. // Timestamped backup for safe rollback
  277. var backupPath = $"{filePath}.bak.{DateTime.UtcNow:yyyyMMddHHmmss}";
  278. await fileStore.WriteAllTextAsync(backupPath, originalYaml);
  279. }
  280. private async Task SaveRootAsync(YamlRoot? root)
  281. {
  282. var serializer = new SerializerBuilder()
  283. .WithNamingConvention(CamelCaseNamingConvention.Instance)
  284. .WithTypeConverter(new StorageSizeYamlConverter())
  285. .WithTypeConverter(new NotesStringYamlConverter())
  286. .ConfigureDefaultValuesHandling(
  287. DefaultValuesHandling.OmitNull |
  288. DefaultValuesHandling.OmitEmptyCollections
  289. )
  290. .Build();
  291. // Preserve ordering: version first, then resources
  292. var payload = new OrderedDictionary
  293. {
  294. ["version"] = root.Version,
  295. ["resources"] = (root.Resources ?? new List<Resource>()).Select(SerializeResource).ToList()
  296. };
  297. await fileStore.WriteAllTextAsync(filePath, serializer.Serialize(payload));
  298. }
  299. private string GetKind(Resource resource)
  300. {
  301. return resource switch
  302. {
  303. Server => "Server",
  304. Switch => "Switch",
  305. Firewall => "Firewall",
  306. Router => "Router",
  307. Desktop => "Desktop",
  308. Laptop => "Laptop",
  309. AccessPoint => "AccessPoint",
  310. Ups => "Ups",
  311. SystemResource => "System",
  312. Service => "Service",
  313. _ => throw new InvalidOperationException($"Unknown resource type: {resource.GetType().Name}")
  314. };
  315. }
  316. private OrderedDictionary SerializeResource(Resource resource)
  317. {
  318. var map = new OrderedDictionary
  319. {
  320. ["kind"] = GetKind(resource)
  321. };
  322. var serializer = new SerializerBuilder()
  323. .WithNamingConvention(CamelCaseNamingConvention.Instance)
  324. .WithTypeConverter(new NotesStringYamlConverter())
  325. .ConfigureDefaultValuesHandling(
  326. DefaultValuesHandling.OmitNull |
  327. DefaultValuesHandling.OmitEmptyCollections
  328. )
  329. .Build();
  330. var yaml = serializer.Serialize(resource);
  331. var props = new DeserializerBuilder()
  332. .Build()
  333. .Deserialize<Dictionary<string, object?>>(yaml);
  334. foreach (var (key, value) in props)
  335. if (!string.Equals(key, "kind", StringComparison.OrdinalIgnoreCase))
  336. map[key] = value;
  337. return map;
  338. }
  339. }
  340. public class YamlRoot
  341. {
  342. public int Version { get; set; }
  343. public List<Resource>? Resources { get; set; }
  344. }