Service - Unit Standard

Overview

Handler service for the standard unit that tracks a single item.

Repository

https://bitbucket.org/izara-supply-units/izara-supply-units-unit-standard

Units that contain quantity properties

• Izara Supply is not used for stock management, but used to follow units we want to track, which in some cases might themselves have a quantity inside them (example bag of 1000 buttons or 200 yard roll of fabric)
• instead of tracking each button or each yard (or inch) we track the bag or roll only
• user can use a unitTrackedProperty to record the quantity inside the tracked Unit
• the unitTrackedProperty can then be used in Service - Transform Units to break down any number of individual Units into any number of other Units. This allows for changing a roll with unitTrackedProperty of yards into multiple yard Units, or different raw material Units into a group of clothing Units
• eg if have 1 tracked bag of 1000 buttons can transform into 10 shirts (100 buttons each shirt), the bag is one tracked Unit, and gets transformed into 10 tracked Unit shirts along with any other raw material

Units that track costing properties

• The cost of Units passing through the supply chain can also be handled using unitTrackedProperty
• each raw material has a unitTrackedProperty that is it's cost
• example 1 tracked Unit of a bag of 1000 buttons would have a cost unitTrackedProperty for it's full cost
• calculatedProperties in transformUnits can spread that cost (and all other materials used) across the new tracked Units created, saving the total into a new property in the outputUnits

objectSchemas

{
	objectType: "unitStandard",
	extendObjType: {
		serviceTag: "unitManager",
		objectType: "unit",
	},
	storageResources:{
		"xxx":{
			storageType: "graph",
			graphServerTag: "xx",
		}
	},
	fieldNames: {
		// from stage objectType
	},
	identifiers: [
		// from stage objectType
	]
},

{
	objectType: "unitTrackedProperty",
    belongTo: { // in future add RBAC to eg Units
		serviceTag: "unitStandard",
		objectType: "unitStandard"
	},
	storageResources:{
		"xxx":{
			storageType: "graph",
			graphServerTag: "xx",
		}
	},
	fieldNames: {
		unitTrackedPropertyId: {
			type: "string",
            randomOnCreate: true
		},
		propertyValue: {
			type: "string", // so can adjust any type of property, will need cast type in logic
			requiredOnCreate: true,
			canUpdate: true,
		},
	},
	identifiers: [
		{
			fieldName: "unitTrackedPropertyId"
		},
	]
},

relationshipSchemas

[
  {
    "hasUnitTrackedProperty": {
      storageResources:{
		"xxx":{
			storageType: "graph",
			graphServerTag: "xx",
		}
      },
      links: [
        {
          storageResourceTags: ["xxx"],
          canDelete: true,
          from: {
            objType: {
              serviceTag: "unitStandard",
              objectType: "unitStandard"
            },
            linkType: "one",
          },
          to: {
            objType: {
              serviceTag: "unitStandard",
              objectType: "unitTrackedProperty"
            },
            linkType: "many",
          }
        }
      ]
    }
  }
]

• currently active unitTrackedProperty for each unitTypeTrackedProperty for a unitStandard

[
  {
    "oldUnitTrackedProperty": {
      storageResources:{
		"xxx":{
			storageType: "graph",
			graphServerTag: "xx",
		}
      },
      fieldNames: {
			"fromTimestamp": {
			  type: "timestamp",
			  requiredOnCreate: true,
			},
			"toTimestamp": {
			  type: "timestamp",
			  requiredOnCreate: true,
			}
		},   
      links: [
        {
          storageResourceTags: ["xxx"],
          canDelete: true,
          from: {
            objType: {
              serviceTag: "unitStandard",
              objectType: "unitStandard"
            },
            linkType: "one",
          },
          to: {
            objType: {
              serviceTag: "unitStandard",
              objectType: "unitTrackedProperty"
            },
            linkType: "many",
          }
        }
      ]
    }
  }
]

• old unitTrackedProperties for a unitStandard
• when a change is made to a unitTrackedProperty propertyValue a new unitTrackedProperty is created and hasUnitTrackedProperty links to unitStandard, while old hasUnitTrackedProperty relationship is removed and replaced with a oldUnitTrackedProperty

Working documents

Unit Standard