Merge pull request #1 from jmayer913/v1.0.0/VersionBranch

V1.0.0/version branch

Author: jmayer913

JMayer.Example.WebAssemblyBlazor.Shared/Data/Assets/Asset.cs

@@ -0,0 +1,105 @@
+using JMayer.Data.Data;
+
+namespace JMayer.Example.WebAssemblyBlazor.Shared.Data.Assets;
+
+/// <summary>
+/// The class represents an asset (equipment) that needs to be monitored and work orders can be preformed on it.
+/// </summary>
+public class Asset : UserEditableDataObject
+{
+    /// <summary>
+    /// The property gets/sets the common category for the asset.
+    /// </summary>
+    public string? Category { get; set; }
+
+    /// <summary>
+    /// The property gets/sets if the asset is online.
+    /// </summary>
+    public bool IsOnline { get; set; } = true;
+
+    /// <summary>
+    /// The property gets/sets the make of the asset.
+    /// </summary>
+    public string? Make { get; set; }
+
+    /// <summary>
+    /// The property gets/sets who makes the asset.
+    /// </summary>
+    public string? Manufacturer { get; set; }
+
+    /// <summary>
+    /// The property gets/sets the identifier the manufacturer uses for the asset.
+    /// </summary>
+    public string? ManufacturerNumber { get; set; }
+
+    /// <summary>
+    /// The property gets the parent path as if this asset is the parent.
+    /// </summary>
+    /// <remarks>
+    /// This is only used by the backend when updating the parent path.
+    /// </remarks>
+    internal string MeAsParentPath
+    {
+        get => ParentID == null ? Name : $"{ParentPath}/{Name}";
+    }
+
+    /// <summary>
+    /// The property gets/sets the model for the asset.
+    /// </summary>
+    public string? Model { get; set; }
+
+    /// <summary>
+    /// The property gets/sets id for the parent of this asset.
+    /// </summary>
+    public long? ParentID { get; set; }
+
+    /// <summary>
+    /// The property gets/sets the path of parents for this asset.
+    /// </summary>
+    public string? ParentPath { get; set; }
+
+    /// <summary>
+    /// The property gets/sets the how import the asset is to the system.
+    /// </summary>
+    public Priority Priority { get; set; } = Priority.Medium;
+
+    /// <summary>
+    /// The property gets/sets the storage location the asset is located in.
+    /// </summary>
+    /// <remarks>
+    /// Only an equipment asset can be assigned a storage location.
+    /// </remarks>
+    public long StorageLocationId { get; set; }
+
+    /// <summary>
+    /// The property gets/sets what the asset represents.
+    /// </summary>
+    public AssetType Type { get; set; } = AssetType.Equipment;
+
+    /// <inheritdoc/>
+    public Asset() : base() { }
+
+    /// <inheritdoc/>
+    public Asset(Asset copy) : base(copy) { }
+
+    /// <inheritdoc/>
+    public override void MapProperties(DataObject dataObject)
+    {
+        base.MapProperties(dataObject);
+
+        if (dataObject is Asset asset)
+        {
+            Category = asset.Category;
+            IsOnline = asset.IsOnline;
+            Make = asset.Make;
+            Manufacturer = asset.Manufacturer;
+            ManufacturerNumber = asset.ManufacturerNumber;
+            Model = asset.Model;
+            ParentID = asset.ParentID;
+            ParentPath = asset.ParentPath;
+            Priority = asset.Priority;
+            StorageLocationId = asset.StorageLocationId;
+            Type = asset.Type;
+        }
+    }
+}

JMayer.Example.WebAssemblyBlazor.Shared/Data/Assets/AssetEqualityComparer.cs

@@ -0,0 +1,39 @@
+using System.Diagnostics.CodeAnalysis;
+
+namespace JMayer.Example.WebAssemblyBlazor.Shared.Data.Assets;
+
+/// <summary>
+/// The class manages comparing two Asset objects.
+/// </summary>
+public class AssetEqualityComparer : IEqualityComparer<Asset>
+{
+    /// <inheritdoc/>
+    public bool Equals(Asset? x, Asset? y)
+    {
+        if (x == null || y == null)
+        {
+            return false;
+        }
+
+        return x.Category == y.Category &&
+               x.CreatedOn == y.CreatedOn &&
+               x.Description == y.Description &&
+               x.Integer64ID == y.Integer64ID &&
+               x.LastEditedOn == y.LastEditedOn &&
+               x.IsOnline == y.IsOnline &&
+               x.Make == y.Make &&
+               x.Manufacturer == y.Manufacturer &&
+               x.ManufacturerNumber == y.ManufacturerNumber &&
+               x.Model == y.Model &&
+               x.Name == y.Name &&
+               x.ParentID == y.ParentID &&
+               x.Priority == y.Priority &&
+               x.Type == y.Type;
+    }
+
+    /// <inheritdoc/>
+    public int GetHashCode([DisallowNull] Asset obj)
+    {
+        throw new NotImplementedException();
+    }
+}

JMayer.Example.WebAssemblyBlazor.Shared/Data/Assets/AssetType.cs

@@ -0,0 +1,27 @@
+namespace JMayer.Example.WebAssemblyBlazor.Shared.Data.Assets;
+
+/// <summary>
+/// The enumeration for the general types of assets.
+/// </summary>
+public enum AssetType
+{
+    /// <summary>
+    /// An asset which represents an equipment that needs to be monitored. This
+    /// type can be taken online/offline and work orders can be created for it.
+    /// </summary>
+    Equipment,
+    
+    /// <summary>
+    /// An asset which represents an area of storage. This type can have storage
+    /// locations;  where assets or parts are stored for inventory purposes. It cannot
+    /// be taken online/offline and work orders cannot be created for it.
+    /// </summary>
+    Area,
+
+    /// <summary>
+    /// An asset which represents a common grouping of assets. Area or equipment assets
+    /// would have this as a parent asset. It cannot be taken online/offline and work orders 
+    /// cannot be created for it.
+    /// </summary>
+    Group,
+}

JMayer.Example.WebAssemblyBlazor.Shared/Data/Assets/StorageLocation.cs

@@ -0,0 +1,56 @@
+using JMayer.Data.Data;
+using System.ComponentModel.DataAnnotations;
+
+namespace JMayer.Example.WebAssemblyBlazor.Shared.Data.Assets;
+
+/// <summary>
+/// The class represents a storage location for an area asset.
+/// </summary>
+/// <remarks>
+/// The OwnerId in the SubUserEditableDataObject will represent an asset.
+/// </remarks>
+public class StorageLocation : SubUserEditableDataObject
+{
+    /// <summary>
+    /// The property gets/sets the friendly name (locations concatenated).
+    /// </summary>
+    public string FriendlyName
+    {
+        get => $"{LocationA}{(!string.IsNullOrWhiteSpace(LocationB) ? $" {LocationB}" : string.Empty)}{(!string.IsNullOrWhiteSpace(LocationC) ? $" {LocationC}" : string.Empty)}";
+    }
+
+    /// <summary>
+    /// The property gets/sets the name of the A location for the storage location.
+    /// </summary>
+    [Required]
+    public string LocationA { get; set; } = string.Empty;
+
+    /// <summary>
+    /// The property gets/sets the name of the B location for the storage location.
+    /// </summary>
+    public string LocationB { get; set; } = string.Empty;
+
+    /// <summary>
+    /// The property gets/sets the name of the C location for the storage location.
+    /// </summary>
+    public string LocationC { get; set; } = string.Empty;
+
+    /// <inheritdoc/>
+    public StorageLocation() : base() { }
+
+    /// <inheritdoc/>
+    public StorageLocation(StorageLocation copy) : base(copy) { }
+
+    /// <inheritdoc/>
+    public override void MapProperties(DataObject dataObject)
+    {
+        base.MapProperties(dataObject);
+
+        if (dataObject is  StorageLocation storageLocation)
+        {
+            LocationA = storageLocation.LocationA;
+            LocationB = storageLocation.LocationB;
+            LocationC = storageLocation.LocationC;
+        }
+    }
+}

JMayer.Example.WebAssemblyBlazor.Shared/Data/Parts/Part.cs

@@ -0,0 +1,61 @@
+using JMayer.Data.Data;
+
+namespace JMayer.Example.WebAssemblyBlazor.Shared.Data.Parts;
+
+/// <summary>
+/// The class represents a part to be used for repairing an asset.
+/// </summary>
+public class Part : UserEditableDataObject
+{
+    /// <summary>
+    /// The property gets/sets the common category for the part.
+    /// </summary>
+    public string? Category { get; set; }
+
+    /// <summary>
+    /// The property gets/sets the make of the part.
+    /// </summary>
+    public string? Make { get; set; }
+
+    /// <summary>
+    /// The property gets/sets who makes the part.
+    /// </summary>
+    public string? Manufacturer { get; set; }
+
+    /// <summary>
+    /// The property gets/sets the identifier the manufacturer uses for the part.
+    /// </summary>
+    public string? ManufacturerNumber { get; set; }
+
+    /// <summary>
+    /// The property gets/sets the model for the part.
+    /// </summary>
+    public string? Model { get; set; }
+
+    /// <summary>
+    /// The property gets/sets is no longer procedured by the manfacturer.
+    /// </summary>
+    public bool Obsolete { get; set; }
+
+    /// <inheritdoc/>
+    public Part() : base() { }
+
+    /// <inheritdoc/>
+    public Part(Part copy) : base(copy) { }
+
+    /// <inheritdoc/>
+    public override void MapProperties(DataObject dataObject)
+    {
+        base.MapProperties(dataObject);
+
+        if (dataObject is Part partDataObject)
+        {
+            Category = partDataObject.Category;
+            Make = partDataObject.Make;
+            Manufacturer = partDataObject.Manufacturer;
+            ManufacturerNumber = partDataObject.ManufacturerNumber;
+            Model = partDataObject.Model;
+            Obsolete = partDataObject.Obsolete;
+        }
+    }
+}

JMayer.Example.WebAssemblyBlazor.Shared/Data/Parts/PartEqualityComparer.cs

@@ -0,0 +1,36 @@
+using System.Diagnostics.CodeAnalysis;
+
+namespace JMayer.Example.WebAssemblyBlazor.Shared.Data.Parts;
+
+/// <summary>
+/// The class manages comparing two Part objects.
+/// </summary>
+public class PartEqualityComparer : IEqualityComparer<Part>
+{
+    /// <inheritdoc/>
+    public bool Equals(Part? x, Part? y)
+    {
+        if (x == null || y == null)
+        {
+            return false;
+        }
+
+        return x.Category == y.Category &&
+               x.CreatedOn == y.CreatedOn &&
+               x.Description == y.Description &&
+               x.Integer64ID == y.Integer64ID &&
+               x.LastEditedOn == y.LastEditedOn &&
+               x.Make == y.Make &&
+               x.Manufacturer == y.Manufacturer &&
+               x.ManufacturerNumber == y.ManufacturerNumber &&
+               x.Model == y.Model &&
+               x.Name == y.Name &&
+               x.Obsolete == y.Obsolete;
+    }
+
+    /// <inheritdoc/>
+    public int GetHashCode([DisallowNull] Part obj)
+    {
+        throw new NotImplementedException();
+    }
+}

JMayer.Example.WebAssemblyBlazor.Shared/Data/Parts/Stock.cs

@@ -0,0 +1,53 @@
+using JMayer.Data.Data;
+using System.ComponentModel.DataAnnotations;
+
+namespace JMayer.Example.WebAssemblyBlazor.Shared.Data.Parts;
+
+/// <summary>
+/// The class represents stock for a part at a particular storage location.
+/// </summary>
+/// <remarks>
+/// The OwnerId in the SubUserEditableDataObject will represent a part.
+/// </remarks>
+public class Stock : SubUserEditableDataObject
+{
+    /// <summary>
+    /// The property gets/sets the amount of stock at the location for the part.
+    /// </summary>
+    [Required]
+    [Range(0, int.MaxValue)]
+    public decimal Amount { get; set; }
+
+    /// <summary>
+    /// The property gets/sets the id for the storage location the part is stored at.
+    /// </summary>
+    [Required]
+    public long StorageLocationId { get; set; }
+
+    /// <summary>
+    /// The property gets/sets the name for the storage location the part is stored at.
+    /// </summary>
+    /// <remarks>
+    /// This is only used to display the storage location name in the card grid.
+    /// </remarks>
+    public string StorageLocationName { get; set; } = string.Empty;
+
+    /// <inheritdoc/>
+    public Stock() : base() { }
+
+    /// <inheritdoc/>
+    public Stock(Stock copy) : base(copy) { }
+
+    /// <inheritdoc/>
+    public override void MapProperties(DataObject dataObject)
+    {
+        base.MapProperties(dataObject);
+
+        if (dataObject is Stock stock)
+        {
+            Amount = stock.Amount;
+            StorageLocationId = stock.StorageLocationId;
+            StorageLocationName = stock.StorageLocationName;
+        }
+    }
+}

JMayer.Example.WebAssemblyBlazor.Shared/Data/Priority.cs

@@ -0,0 +1,11 @@
+namespace JMayer.Example.WebAssemblyBlazor.Shared.Data;
+
+/// <summary>
+/// The enumration for the priority so the user understands how imported an object is.
+/// </summary>
+public enum Priority
+{
+    Low,
+    Medium,
+    High,
+}