YamlResourceCollection.cs 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404
  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. RackPeekConfigMigrationDeserializer _deserializer)
  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 Task<IReadOnlyList<Resource>> GetByTagAsync(string name)
  159. {
  160. return Task.FromResult<IReadOnlyList<Resource>>(
  161. resourceCollection.Resources
  162. .Where(r => r.Tags.Contains(name))
  163. .ToList()
  164. );
  165. }
  166. public IReadOnlyList<Hardware> HardwareResources =>
  167. resourceCollection.Resources.OfType<Hardware>().ToList();
  168. public IReadOnlyList<SystemResource> SystemResources =>
  169. resourceCollection.Resources.OfType<SystemResource>().ToList();
  170. public IReadOnlyList<Service> ServiceResources =>
  171. resourceCollection.Resources.OfType<Service>().ToList();
  172. public Task<Resource?> GetByNameAsync(string name)
  173. {
  174. return Task.FromResult(resourceCollection.Resources.FirstOrDefault(r =>
  175. r.Name.Equals(name, StringComparison.OrdinalIgnoreCase)));
  176. }
  177. public Task<T?> GetByNameAsync<T>(string name) where T : Resource
  178. {
  179. var resource =
  180. resourceCollection.Resources.FirstOrDefault(r => r.Name.Equals(name, StringComparison.OrdinalIgnoreCase));
  181. return Task.FromResult(resource as T);
  182. }
  183. public Resource? GetByName(string name)
  184. {
  185. return resourceCollection.Resources.FirstOrDefault(r =>
  186. r.Name.Equals(name, StringComparison.OrdinalIgnoreCase));
  187. }
  188. public async Task LoadAsync()
  189. {
  190. // Read raw YAML so we can back it up exactly before any migration writes.
  191. var yaml = await fileStore.ReadAllTextAsync(filePath);
  192. if (string.IsNullOrWhiteSpace(yaml))
  193. {
  194. resourceCollection.Resources.Clear();
  195. return;
  196. }
  197. var version = _deserializer.GetSchemaVersion(yaml);
  198. // Guard: config is newer than this app understands.
  199. if (version > CurrentSchemaVersion)
  200. {
  201. throw new InvalidOperationException(
  202. $"Config schema version {version} is newer than this application supports ({CurrentSchemaVersion}).");
  203. }
  204. YamlRoot? root;
  205. // If older, backup first, then migrate step-by-step, then save.
  206. if (version < CurrentSchemaVersion)
  207. {
  208. await BackupOriginalAsync(yaml);
  209. root = await _deserializer.Deserialize(yaml) ?? new YamlRoot();
  210. // Ensure we persist the migrated root (with updated version)
  211. await SaveRootAsync(root);
  212. }
  213. else
  214. {
  215. root = await _deserializer.Deserialize(yaml);
  216. }
  217. resourceCollection.Resources.Clear();
  218. if (root?.Resources != null)
  219. {
  220. resourceCollection.Resources.AddRange(root.Resources);
  221. }
  222. }
  223. public Task AddAsync(Resource resource)
  224. {
  225. return UpdateWithLockAsync(list =>
  226. {
  227. if (list.Any(r => r.Name.Equals(resource.Name, StringComparison.OrdinalIgnoreCase)))
  228. throw new InvalidOperationException($"'{resource.Name}' already exists.");
  229. resource.Kind = GetKind(resource);
  230. list.Add(resource);
  231. });
  232. }
  233. public Task UpdateAsync(Resource resource)
  234. {
  235. return UpdateWithLockAsync(list =>
  236. {
  237. var index = list.FindIndex(r => r.Name.Equals(resource.Name, StringComparison.OrdinalIgnoreCase));
  238. if (index == -1) throw new InvalidOperationException("Not found.");
  239. resource.Kind = GetKind(resource);
  240. list[index] = resource;
  241. });
  242. }
  243. public Task DeleteAsync(string name)
  244. {
  245. return UpdateWithLockAsync(list =>
  246. list.RemoveAll(r => r.Name.Equals(name, StringComparison.OrdinalIgnoreCase)));
  247. }
  248. private async Task UpdateWithLockAsync(Action<List<Resource>> action)
  249. {
  250. await resourceCollection.FileLock.WaitAsync();
  251. try
  252. {
  253. action(resourceCollection.Resources);
  254. // Always write current schema version when app writes the file.
  255. var root = new YamlRoot
  256. {
  257. Version = CurrentSchemaVersion,
  258. Resources = resourceCollection.Resources
  259. };
  260. await SaveRootAsync(root);
  261. }
  262. finally
  263. {
  264. resourceCollection.FileLock.Release();
  265. }
  266. }
  267. // ----------------------------
  268. // Versioning + migration
  269. // ----------------------------
  270. private async Task BackupOriginalAsync(string originalYaml)
  271. {
  272. // Timestamped backup for safe rollback
  273. var backupPath = $"{filePath}.bak.{DateTime.UtcNow:yyyyMMddHHmmss}";
  274. await fileStore.WriteAllTextAsync(backupPath, originalYaml);
  275. }
  276. private async Task SaveRootAsync(YamlRoot? root)
  277. {
  278. var serializer = new SerializerBuilder()
  279. .WithNamingConvention(CamelCaseNamingConvention.Instance)
  280. .WithTypeConverter(new StorageSizeYamlConverter())
  281. .WithTypeConverter(new NotesStringYamlConverter())
  282. .ConfigureDefaultValuesHandling(
  283. DefaultValuesHandling.OmitNull |
  284. DefaultValuesHandling.OmitEmptyCollections
  285. )
  286. .Build();
  287. // Preserve ordering: version first, then resources
  288. var payload = new OrderedDictionary
  289. {
  290. ["version"] = root.Version,
  291. ["resources"] = (root.Resources ?? new List<Resource>()).Select(SerializeResource).ToList()
  292. };
  293. await fileStore.WriteAllTextAsync(filePath, serializer.Serialize(payload));
  294. }
  295. private string GetKind(Resource resource)
  296. {
  297. return resource switch
  298. {
  299. Server => "Server",
  300. Switch => "Switch",
  301. Firewall => "Firewall",
  302. Router => "Router",
  303. Desktop => "Desktop",
  304. Laptop => "Laptop",
  305. AccessPoint => "AccessPoint",
  306. Ups => "Ups",
  307. SystemResource => "System",
  308. Service => "Service",
  309. _ => throw new InvalidOperationException($"Unknown resource type: {resource.GetType().Name}")
  310. };
  311. }
  312. private OrderedDictionary SerializeResource(Resource resource)
  313. {
  314. var map = new OrderedDictionary
  315. {
  316. ["kind"] = GetKind(resource)
  317. };
  318. var serializer = new SerializerBuilder()
  319. .WithNamingConvention(CamelCaseNamingConvention.Instance)
  320. .WithTypeConverter(new NotesStringYamlConverter())
  321. .ConfigureDefaultValuesHandling(
  322. DefaultValuesHandling.OmitNull |
  323. DefaultValuesHandling.OmitEmptyCollections
  324. )
  325. .Build();
  326. var yaml = serializer.Serialize(resource);
  327. var props = new DeserializerBuilder()
  328. .Build()
  329. .Deserialize<Dictionary<string, object?>>(yaml);
  330. foreach (var (key, value) in props)
  331. if (!string.Equals(key, "kind", StringComparison.OrdinalIgnoreCase))
  332. map[key] = value;
  333. return map;
  334. }
  335. }
  336. public class YamlRoot
  337. {
  338. public int Version { get; set; }
  339. public List<Resource>? Resources { get; set; }
  340. }