Event.cs 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804
  1. using Comal.Classes;
  2. using Expressive;
  3. using InABox.Core;
  4. using InABox.Database;
  5. using System;
  6. using System.Collections;
  7. using System.Collections.Generic;
  8. using System.Diagnostics.CodeAnalysis;
  9. using System.Linq;
  10. using System.Reflection;
  11. using System.Text;
  12. using System.Text.Json;
  13. using System.Text.Json.Serialization;
  14. using System.Text.Json.Serialization.Metadata;
  15. using System.Threading.Tasks;
  16. namespace PRS.Shared.Events;
  17. public interface IEventData : IPolymorphicallySerialisable
  18. {
  19. IEvent Event { get; }
  20. IEnumerable<string> ReferencedVariables { get; }
  21. }
  22. public class EventData<T, TDataModel> : IEventData
  23. where T : IEvent<TDataModel>
  24. where TDataModel : IEventDataModel
  25. {
  26. public T Event { get; set; }
  27. /// <summary>
  28. /// A list of triggers for this event. If any of the triggers match, the event runs.
  29. /// </summary>
  30. public List<IEventTrigger<T, TDataModel>> Triggers { get; set; }
  31. public List<IEventAction<T>> Actions { get; set; }
  32. IEvent IEventData.Event => Event;
  33. public IEnumerable<string> ReferencedVariables =>
  34. Triggers.SelectMany(x => x.ReferencedVariables)
  35. .Concat(Actions.SelectMany(x => x.ReferencedVariables))
  36. .Distinct();
  37. public EventData(T eventData)
  38. {
  39. Event = eventData;
  40. Triggers = new List<IEventTrigger<T, TDataModel>>();
  41. Actions = new List<IEventAction<T>>();
  42. }
  43. [JsonConstructor]
  44. private EventData(): this(default) { }
  45. public Notification GenerateNotification(TDataModel model) => Event.GenerateNotification(model);
  46. }
  47. public static class EventUtils
  48. {
  49. #region Serialisation
  50. private static JsonSerializerOptions SerializationSettings()
  51. {
  52. var settings = Serialization.CreateSerializerSettings();
  53. settings.TypeInfoResolver = (settings.TypeInfoResolver ?? new DefaultJsonTypeInfoResolver())
  54. .WithAddedModifier(Serialization.WritablePropertiesOnly);
  55. return settings;
  56. }
  57. public static string Serialize(IEventData data)
  58. {
  59. return JsonSerializer.Serialize(data, typeof(IEventData), SerializationSettings());
  60. }
  61. public static IEventData Deserialize(string json)
  62. {
  63. return JsonSerializer.Deserialize<IEventData>(json, SerializationSettings())!;
  64. }
  65. #endregion
  66. #region Event Types
  67. private static Dictionary<Type, List<Type>>? _eventTriggerTypes;
  68. private static Dictionary<Type, List<Type>>? _eventActionTypes;
  69. private static List<Type>? _standardEventActionTypes;
  70. [MemberNotNullWhen(true, nameof(_eventTriggerTypes), nameof(_eventActionTypes), nameof(_standardEventActionTypes))]
  71. private static bool _loadedTypes { get; set; }
  72. [MemberNotNull(nameof(_eventTriggerTypes), nameof(_eventActionTypes), nameof(_standardEventActionTypes))]
  73. private static void LoadTypes()
  74. {
  75. if (_loadedTypes) return;
  76. _loadedTypes = true;
  77. _eventTriggerTypes = new();
  78. _eventActionTypes = new();
  79. _standardEventActionTypes = new();
  80. foreach(var type in CoreUtils.TypeList(x => true))
  81. {
  82. if (type.GetInterfaceDefinition(typeof(IEventTrigger<,>)) is Type eventTriggerInterface)
  83. {
  84. if (type.GetConstructor([]) is not null)
  85. {
  86. var eventType = eventTriggerInterface.GenericTypeArguments[0];
  87. eventType = eventType.IsGenericType ? eventType.GetGenericTypeDefinition() : eventType;
  88. _eventTriggerTypes.GetValueOrAdd(eventType).Add(type);
  89. }
  90. }
  91. else if(type.GetInterfaceDefinition(typeof(IStandardEventAction<>)) is Type standardEventAction)
  92. {
  93. if (type.GetConstructor([]) is not null)
  94. {
  95. _standardEventActionTypes.Add(type);
  96. }
  97. }
  98. else if (type.GetInterfaceDefinition(typeof(IEventAction<>)) is Type eventActionInterface)
  99. {
  100. if (type.GetConstructor([]) is not null)
  101. {
  102. var eventType = eventActionInterface.GenericTypeArguments[0];
  103. eventType = eventType.IsGenericType ? eventType.GetGenericTypeDefinition() : eventType;
  104. _eventActionTypes.GetValueOrAdd(eventType).Add(type);
  105. }
  106. }
  107. }
  108. }
  109. public static IEnumerable<Type> GetEventTriggerTypes(Type eventType)
  110. {
  111. LoadTypes();
  112. eventType = eventType.IsGenericType ? eventType.GetGenericTypeDefinition() : eventType;
  113. return _eventTriggerTypes.GetValueOrDefault(eventType) ?? Enumerable.Empty<Type>();
  114. }
  115. public static IEnumerable<Type> GetEventActionTypes(Type eventType)
  116. {
  117. LoadTypes();
  118. eventType = eventType.IsGenericType ? eventType.GetGenericTypeDefinition() : eventType;
  119. return _eventActionTypes.GetValueOrDefault(eventType) ?? Enumerable.Empty<Type>();
  120. }
  121. public static IEnumerable<Type> GetStandardEventActionTypes()
  122. {
  123. LoadTypes();
  124. return _standardEventActionTypes;
  125. }
  126. #endregion
  127. #region Execution
  128. private static bool Check<T, TDataModel>(EventData<T, TDataModel> ev, TDataModel dataModel)
  129. where T : IEvent<TDataModel>
  130. where TDataModel : IEventDataModel
  131. {
  132. return ev.Triggers.Count == 0 || ev.Triggers.Any(x => x.Check(dataModel));
  133. }
  134. public static void Run<T, TDataModel>(IStore store, Event ev, EventData<T, TDataModel> evData, TDataModel dataModel)
  135. where T : IEvent<TDataModel>
  136. where TDataModel : IEventDataModel
  137. {
  138. if (!Check(evData, dataModel)) return;
  139. foreach(var action in evData.Actions)
  140. {
  141. IEvent.RunAction(evData.Event, dataModel, action);
  142. }
  143. NotifySubscribers(store, ev, evData, dataModel);
  144. }
  145. public static void SendNotifications(IStore store, IEnumerable<(EventSubscriberType type, Notification notification)> notifications)
  146. {
  147. var toSave = new List<Notification>();
  148. foreach(var (type, notification) in notifications)
  149. {
  150. if(type == EventSubscriberType.Notification)
  151. {
  152. toSave.Add(notification);
  153. }
  154. else if(type == EventSubscriberType.Email)
  155. {
  156. var mailer = DbFactory.Mailer;
  157. if(mailer is not null)
  158. {
  159. if (mailer.Connect())
  160. {
  161. var msg = mailer.CreateMessage();
  162. // msg.From = DbFactory.EmailAddress;
  163. msg.To = [notification.Employee.Email];
  164. msg.Subject = notification.Title;
  165. msg.Body = notification.Description;
  166. var bOK = mailer.SendMessage(msg);
  167. }
  168. }
  169. }
  170. }
  171. store.Provider.Save(toSave);
  172. }
  173. private static void NotifySubscribers<T, TDataModel>(IStore store, Event ev, EventData<T, TDataModel> evData, TDataModel dataModel)
  174. where T : IEvent<TDataModel>
  175. where TDataModel : IEventDataModel
  176. {
  177. if (!ev.NotificationsEnabled) return;
  178. string? description;
  179. if (ev.NotificationExpression.IsNullOrWhiteSpace())
  180. {
  181. description = null;
  182. }
  183. else
  184. {
  185. var descriptionExpr = new CoreExpression(ev.NotificationExpression, typeof(string));
  186. if(!descriptionExpr.TryEvaluate<string>(dataModel).Get(out description, out var error))
  187. {
  188. CoreUtils.LogException(store.UserID, error, extra: "Error notifying subscribers", store.Logger);
  189. return;
  190. }
  191. }
  192. var subscribers = store.Provider.Query(
  193. new Filter<EventSubscriber>(x => x.Event.ID).IsEqualTo(ev.ID),
  194. Columns.None<EventSubscriber>().Add(x => x.Employee.ID).Add(x => x.Employee.Email).Add(x => x.SubscriberType))
  195. .ToArray<EventSubscriber>();
  196. SendNotifications(store, subscribers.Select(x =>
  197. {
  198. var notification = evData.GenerateNotification(dataModel);
  199. notification.Employee.CopyFrom(x.Employee);
  200. if (description is not null)
  201. {
  202. notification.Description = description;
  203. }
  204. return (x.SubscriberType, notification);
  205. }));
  206. }
  207. #endregion
  208. #region Event Cache
  209. private static bool _loadedCache = false;
  210. private static Dictionary<EventType, Dictionary<Type, List<(Event Event, IEventData EventData)>>> _entityEvents = new();
  211. private static Dictionary<Guid, (EventType, Type)> _entityEventMap = new();
  212. private static Dictionary<EventType, List<(Event Event, IEventData EventData)>> _genericEvents = new();
  213. private static Dictionary<Guid, EventType> _genericEventMap = new();
  214. public static Type GetEventType(EventType type)
  215. {
  216. switch (type)
  217. {
  218. case EventType.AfterSave:
  219. return typeof(SaveEvent<>);
  220. case EventType.Scheduled:
  221. return typeof(ScheduledEvent);
  222. default:
  223. throw new Exception($"Invalid event type {type}");
  224. }
  225. }
  226. public static void ReloadCache(IProvider provider)
  227. {
  228. _loadedCache = true;
  229. _entityEvents.Clear();
  230. _entityEventMap.Clear();
  231. _genericEvents.Clear();
  232. _genericEventMap.Clear();
  233. var events = provider.Query(
  234. new Filter<Event>(x => x.Enabled).IsEqualTo(true),
  235. Columns.None<Event>().Add(x => x.ID).Add(x => x.Code).Add(x => x.EventType).Add(x => x.Data).Add(x => x.NotificationExpression).Add(x => x.NotificationsEnabled))
  236. .ToObjects<Event>();
  237. foreach(var ev in events)
  238. {
  239. AddEvent(provider, ev);
  240. }
  241. }
  242. private static void AddGenericEvent(Event ev)
  243. {
  244. if(ev.Data is not null && ev.Data.Length != 0)
  245. {
  246. var data = Deserialize(ev.Data);
  247. var list = _genericEvents.GetValueOrAdd(ev.EventType);
  248. list.RemoveAll(x => x.Event.ID == ev.ID);
  249. list.Add((ev, data));
  250. _genericEventMap[ev.ID] = ev.EventType;
  251. }
  252. }
  253. private static void RemoveGenericEvent(Event ev)
  254. {
  255. if(_genericEventMap.Remove(ev.ID, out var evType))
  256. {
  257. if(_genericEvents.TryGetValue(evType, out var eventTypeEvents))
  258. {
  259. eventTypeEvents.RemoveAll(x => x.Event.ID == ev.ID);
  260. if(eventTypeEvents.Count == 0)
  261. {
  262. _genericEvents.Remove(evType);
  263. }
  264. }
  265. }
  266. }
  267. private static void AddEntityEvent(Event ev)
  268. {
  269. if(ev.Data is not null && ev.Data.Length != 0)
  270. {
  271. var data = Deserialize(ev.Data);
  272. var entityType = data.Event.GetType().GenericTypeArguments[0];
  273. var list = _entityEvents.GetValueOrAdd(ev.EventType).GetValueOrAdd(entityType);
  274. list.RemoveAll(x => x.Event.ID == ev.ID);
  275. list.Add((ev, data));
  276. _entityEventMap[ev.ID] = (ev.EventType, entityType);
  277. }
  278. }
  279. private static void RemoveEntityEvent(Event ev)
  280. {
  281. if(_entityEventMap.TryGetValue(ev.ID, out var item))
  282. {
  283. if(_entityEvents.TryGetValue(item.Item1, out var eventTypeEvents))
  284. {
  285. if(eventTypeEvents.TryGetValue(item.Item2, out var entityEvents))
  286. {
  287. entityEvents.RemoveAll(x => x.Event.ID == ev.ID);
  288. if(entityEvents.Count == 0)
  289. {
  290. eventTypeEvents.Remove(item.Item2);
  291. }
  292. }
  293. if(eventTypeEvents.Count == 0)
  294. {
  295. _entityEvents.Remove(item.Item1);
  296. }
  297. }
  298. _entityEventMap.Remove(ev.ID);
  299. }
  300. }
  301. public static void AddEvent(IProvider provider, Event ev)
  302. {
  303. if (!_loadedCache) ReloadCache(provider);
  304. var type = GetEventType(ev.EventType);
  305. if (type.HasInterface(typeof(IEntityEvent<>)))
  306. {
  307. AddEntityEvent(ev);
  308. }
  309. else
  310. {
  311. AddGenericEvent(ev);
  312. }
  313. }
  314. public static void RemoveEvent(IProvider provider, Event ev)
  315. {
  316. if (!_loadedCache) ReloadCache(provider);
  317. var type = GetEventType(ev.EventType);
  318. if (type.HasInterface(typeof(IEntityEvent<>)))
  319. {
  320. RemoveEntityEvent(ev);
  321. }
  322. else
  323. {
  324. RemoveGenericEvent(ev);
  325. }
  326. }
  327. #endregion
  328. #region Public Event Running Interface
  329. public static void AfterSave<T>(IStore store, T entity)
  330. where T : Entity, new()
  331. {
  332. if (!_loadedCache) ReloadCache(store.Provider);
  333. var events = _entityEvents.GetValueOrDefault(EventType.AfterSave)
  334. ?.GetValueOrDefault(typeof(T));
  335. if (events is null) return;
  336. foreach(var ev in events)
  337. {
  338. var eventData = (ev.EventData as EventData<SaveEvent<T>, SaveEventDataModel<T>>)!;
  339. var model = new SaveEventDataModel<T>(entity, store);
  340. eventData.Event.Init(store, ev.Event, eventData, model);
  341. Run(store, ev.Event, eventData, model);
  342. }
  343. }
  344. private static bool CheckEventSchedule(ScheduledEvent ev)
  345. {
  346. var now = DateTime.Now;
  347. switch (ev.Properties.Period)
  348. {
  349. case SchedulePeriod.Minute:
  350. case SchedulePeriod.Hour:
  351. case SchedulePeriod.Day:
  352. var dayOfWeekSettings = ev.Properties.DayOfWeekSettings.FirstOrDefault(x => x.DayOfWeek == now.DayOfWeek);
  353. if(dayOfWeekSettings is null || !dayOfWeekSettings.Enabled)
  354. {
  355. return false;
  356. }
  357. var start = now - now.TimeOfDay + dayOfWeekSettings.StartTime;
  358. var end = now - now.TimeOfDay + dayOfWeekSettings.EndTime;
  359. if(ev.Properties.Period == SchedulePeriod.Day)
  360. {
  361. if(ev.Properties.LastExecution < start && now >= start && (now.Date - ev.Properties.LastExecution.Date).TotalDays >= ev.Properties.Frequency)
  362. {
  363. ev.Properties.LastExecution = start;
  364. return true;
  365. }
  366. else
  367. {
  368. return false;
  369. }
  370. }
  371. else if(ev.Properties.Period == SchedulePeriod.Hour)
  372. {
  373. if(start <= now && now <= end)
  374. {
  375. var nowIntervals = Math.Floor((now - start).TotalHours / ev.Properties.Frequency);
  376. var lastIntervals = Math.Floor((ev.Properties.LastExecution - start).TotalHours / ev.Properties.Frequency);
  377. if(nowIntervals > lastIntervals)
  378. {
  379. ev.Properties.LastExecution = start.AddHours(nowIntervals * ev.Properties.Frequency);
  380. }
  381. return true;
  382. }
  383. else
  384. {
  385. return false;
  386. }
  387. }
  388. else if(ev.Properties.Period == SchedulePeriod.Minute)
  389. {
  390. if (start <= now && now <= end)
  391. {
  392. var nowIntervals = Math.Floor((now - start).TotalMinutes / ev.Properties.Frequency);
  393. var lastIntervals = Math.Floor((ev.Properties.LastExecution - start).TotalMinutes / ev.Properties.Frequency);
  394. if (nowIntervals > lastIntervals)
  395. {
  396. ev.Properties.LastExecution = start.AddMinutes(nowIntervals * ev.Properties.Frequency);
  397. }
  398. return true;
  399. }
  400. else
  401. {
  402. return false;
  403. }
  404. }
  405. else
  406. {
  407. throw new Exception("Invalid state");
  408. }
  409. case SchedulePeriod.Week:
  410. if (now >= ev.Properties.NextSchedule)
  411. {
  412. while (now >= ev.Properties.NextSchedule)
  413. {
  414. ev.Properties.NextSchedule += TimeSpan.FromDays(7 * ev.Properties.Frequency);
  415. }
  416. return true;
  417. }
  418. else
  419. {
  420. return false;
  421. }
  422. case SchedulePeriod.Month:
  423. if(now >= ev.Properties.NextSchedule)
  424. {
  425. while(now >= ev.Properties.NextSchedule)
  426. {
  427. ev.Properties.NextSchedule = ev.Properties.NextSchedule.AddMonths(ev.Properties.Frequency);
  428. }
  429. return true;
  430. }
  431. else
  432. {
  433. return false;
  434. }
  435. case SchedulePeriod.Year:
  436. if(now >= ev.Properties.NextSchedule)
  437. {
  438. while(now >= ev.Properties.NextSchedule)
  439. {
  440. ev.Properties.NextSchedule = ev.Properties.NextSchedule.AddYears(ev.Properties.Frequency);
  441. }
  442. return true;
  443. }
  444. else
  445. {
  446. return false;
  447. }
  448. default:
  449. throw new Exception("Invalid state");
  450. }
  451. }
  452. public static void CheckScheduledEvents()
  453. {
  454. var store = DbFactory.FindStore<Event>(Guid.Empty, "", Platform.DatabaseEngine, CoreUtils.GetVersion(), Logger.New());
  455. if (!_loadedCache) ReloadCache(store.Provider);
  456. var events = _genericEvents.GetValueOrDefault(EventType.Scheduled);
  457. if (events is null) return;
  458. foreach(var ev in events)
  459. {
  460. var eventData = (ev.EventData as EventData<ScheduledEvent, ScheduledEventDataModel>)!;
  461. if (CheckEventSchedule(eventData.Event))
  462. {
  463. var model = new ScheduledEventDataModel(ev.Event);
  464. Run(store, ev.Event, eventData, model);
  465. ev.Event.Data = Serialize(eventData);
  466. store.Provider.Save(ev.Event);
  467. }
  468. }
  469. }
  470. #endregion
  471. }
  472. #region DataModel Definition
  473. public interface IEventVariable
  474. {
  475. string Name { get; set; }
  476. Type Type { get; set; }
  477. }
  478. public class StandardEventVariable : IEventVariable
  479. {
  480. public string Name { get; set; }
  481. public Type Type { get; set; }
  482. public StandardEventVariable(string name, Type type)
  483. {
  484. Name = name;
  485. Type = type;
  486. }
  487. }
  488. public class ListEventVariable : IEventVariable
  489. {
  490. public string Name { get; set; }
  491. public Type Type { get; set; }
  492. public ListEventVariable(string name, Type type)
  493. {
  494. Name = name;
  495. Type = type;
  496. }
  497. }
  498. public interface IEventDataModelDefinition
  499. {
  500. IEnumerable<IEventVariable> GetVariables();
  501. IEventVariable? GetVariable(string name);
  502. }
  503. #endregion
  504. #region DataModel
  505. public interface IEventDataModel : IVariableProvider
  506. {
  507. bool TryGetVariable(string name, out object? value);
  508. bool IVariableProvider.TryGetValue(string variableName, out object? value)
  509. {
  510. return TryGetVariable(variableName, out value);
  511. }
  512. T RootModel<T>()
  513. where T : IEventDataModel
  514. {
  515. if(this is IChildEventDataModel child)
  516. {
  517. return child.Parent.RootModel<T>();
  518. }
  519. else if(this is T root)
  520. {
  521. return root;
  522. }
  523. else
  524. {
  525. throw new Exception($"Root model of wrong type; expected {typeof(T).FullName}; got {GetType().FullName}");
  526. }
  527. }
  528. }
  529. public interface ITypedEventDataModel : IEventDataModel
  530. {
  531. public Type EntityType { get; }
  532. }
  533. public interface IChildEventDataModel : IEventDataModel
  534. {
  535. IEventDataModel Parent { get; }
  536. }
  537. public class ChildEventDataModel : IChildEventDataModel
  538. {
  539. public IEventDataModel Parent { get; set; }
  540. public Dictionary<string, object?> Values { get; set; } = new Dictionary<string, object?>();
  541. public ChildEventDataModel(IEventDataModel parent)
  542. {
  543. Parent = parent;
  544. }
  545. public bool TryGetVariable(string name, out object? value)
  546. {
  547. return Values.TryGetValue(name, out value)
  548. || Parent.TryGetVariable(name, out value);
  549. }
  550. public void Init(IEventData data)
  551. {
  552. }
  553. }
  554. #endregion
  555. public interface IEvent : IPolymorphicallySerialisable
  556. {
  557. IEventDataModelDefinition DataModelDefinition();
  558. public static void RunAction(IEvent ev, IEventDataModel model, IEventAction action)
  559. {
  560. var dataModelDef = ev.DataModelDefinition();
  561. var values = new List<(string name, object? value)[]>() { Array.Empty<(string, object?)>() };
  562. foreach(var variable in action.ReferencedVariables)
  563. {
  564. var varDef = dataModelDef.GetVariable(variable);
  565. if(varDef is ListEventVariable)
  566. {
  567. if (model.TryGetVariable(varDef.Name, out var list) && list is IEnumerable enumerable)
  568. {
  569. var oldValues = values;
  570. values = new List<(string name, object? value)[]>();
  571. foreach(var item in enumerable)
  572. {
  573. foreach(var valueList in oldValues)
  574. {
  575. values.Add(valueList.Concatenate(new (string name, object? value)[]
  576. {
  577. (varDef.Name, item)
  578. }));
  579. }
  580. }
  581. }
  582. else
  583. {
  584. values.Clear();
  585. break;
  586. }
  587. }
  588. }
  589. if(values.Count > 0 && (values.Count > 1 || values[0].Length > 0))
  590. {
  591. var subModel = new ChildEventDataModel(model);
  592. foreach(var valueSet in values)
  593. {
  594. subModel.Values.Clear();
  595. foreach(var (name, value) in valueSet)
  596. {
  597. subModel.Values[name] = value;
  598. }
  599. action.Execute(subModel);
  600. }
  601. }
  602. else
  603. {
  604. action.Execute(model);
  605. }
  606. }
  607. }
  608. /// <summary>
  609. /// Indicates that this event type has properties that can be edited; <typeparamref name="TProperties"/> is used to edit these properties
  610. /// with a dynamic editor.
  611. /// </summary>
  612. public interface IPropertiesEvent<TProperties>
  613. where TProperties : BaseObject, new()
  614. {
  615. /// <summary>
  616. /// Create the properties object for editing.
  617. /// </summary>
  618. TProperties GetProperties();
  619. /// <summary>
  620. /// Given an edited properties object, save them again.
  621. /// </summary>
  622. void SetProperties(TProperties properties);
  623. }
  624. /// <summary>
  625. /// Indicates that this event is generic for type <typeparamref name="T"/>; if this interface is implemented,
  626. /// the main type <b>must</b> be generic, with only one generic type argument.
  627. /// </summary>
  628. public interface IEntityEvent<T>
  629. where T : Entity
  630. {
  631. }
  632. public interface IEvent<TDataModel> : IEvent
  633. {
  634. Notification GenerateNotification(TDataModel model);
  635. }
  636. public interface IEventTrigger : IPolymorphicallySerialisable
  637. {
  638. IEnumerable<string> ReferencedVariables { get; }
  639. string Description { get; }
  640. }
  641. public interface IEventTrigger<TEvent, TDataModel> : IEventTrigger
  642. where TEvent : IEvent<TDataModel>
  643. where TDataModel : IEventDataModel
  644. {
  645. bool Check(TDataModel dataModel);
  646. }
  647. public interface IEventTriggerParent<TEvent, TDataModel> : IEventTrigger<TEvent, TDataModel>
  648. where TEvent : IEvent<TDataModel>
  649. where TDataModel : IEventDataModel
  650. {
  651. public List<IEventTrigger<TEvent, TDataModel>> ChildTriggers { get; }
  652. }
  653. public class AndTrigger<TEvent, TDataModel> : IEventTrigger<TEvent, TDataModel>, IEventTriggerParent<TEvent, TDataModel>
  654. where TEvent : IEvent<TDataModel>
  655. where TDataModel : IEventDataModel
  656. {
  657. public List<IEventTrigger<TEvent, TDataModel>> ChildTriggers { get; set; } = new();
  658. public IEnumerable<string> ReferencedVariables => ChildTriggers.SelectMany(x => x.ReferencedVariables);
  659. public string Description => "And";
  660. public bool Check(TDataModel dataModel)
  661. {
  662. return ChildTriggers.All(x => x.Check(dataModel));
  663. }
  664. }
  665. public class OrTrigger<TEvent, TDataModel> : IEventTrigger<TEvent, TDataModel>, IEventTriggerParent<TEvent, TDataModel>
  666. where TEvent : IEvent<TDataModel>
  667. where TDataModel : IEventDataModel
  668. {
  669. public List<IEventTrigger<TEvent, TDataModel>> ChildTriggers { get; set; } = new();
  670. public IEnumerable<string> ReferencedVariables => ChildTriggers.SelectMany(x => x.ReferencedVariables);
  671. public string Description => "Or";
  672. public bool Check(TDataModel dataModel)
  673. {
  674. return ChildTriggers.Any(x => x.Check(dataModel));
  675. }
  676. }
  677. public interface IEventAction : IPolymorphicallySerialisable
  678. {
  679. IEnumerable<string> ReferencedVariables { get; }
  680. object? Execute(IEventDataModel dataModel);
  681. string Description { get; }
  682. }
  683. public interface IEventAction<TEvent> : IEventAction
  684. where TEvent : IEvent
  685. {
  686. }
  687. /// <summary>
  688. /// Marks this event action as being applicable to any event type.
  689. /// </summary>
  690. public interface IStandardEventAction<TEvent> : IEventAction<TEvent>
  691. where TEvent : IEvent
  692. {
  693. }