Service - Unit Standard: Difference between revisions

From Izara Wiki
Jump to navigation Jump to search
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 14: Line 14:
* 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
* 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
* 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
== Making Inactive ==
* Although Izara Supply does not manage stock levels, Units can be set to active/inactive so old or sold out Units can be marked as inactive, making queries easier to return only in stock Units
* For example a roll of fabric is out of stock/inactive when it's unitTrackedProperty of yards reaches 0
* Achieve this by setting inactiveIfZero in yards unitTrackedProperty


= Units that track costing properties =
= Units that track costing properties =


* The cost of Units passing through the supply chain can also be handled using unitTrackedProperty
* 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
* each raw material has a unitTrackedProperty that is it's cost (eg costPerBag) or cost per unitTrackedProperty value (eg costPerYard)
* example 1 tracked Unit of a bag of 1000 buttons would have a cost unitTrackedProperty for it's full cost
* example 1 tracked Unit of a bag of 1000 buttons would have a remainingCost 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
* 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


Line 45: Line 51:
},
},
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="JavaScript">
{
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"
},
]
},
</syntaxhighlight>
= relationshipSchemas =
<syntaxhighlight lang="JavaScript">
[
  {
    "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",
          }
        }
      ]
    }
  }
]
</syntaxhighlight>
* currently active unitTrackedProperty for each unitTypeTrackedProperty for a unitStandard
<syntaxhighlight lang="JavaScript">
[
  {
    "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",
          }
        }
      ]
    }
  }
]
</syntaxhighlight>
* 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 =
= Working documents =

Latest revision as of 23:18, 2 September 2025

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

Making Inactive

  • Although Izara Supply does not manage stock levels, Units can be set to active/inactive so old or sold out Units can be marked as inactive, making queries easier to return only in stock Units
  • For example a roll of fabric is out of stock/inactive when it's unitTrackedProperty of yards reaches 0
  • Achieve this by setting inactiveIfZero in yards unitTrackedProperty

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 (eg costPerBag) or cost per unitTrackedProperty value (eg costPerYard)
  • example 1 tracked Unit of a bag of 1000 buttons would have a remainingCost 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
	]
},

Working documents

Unit Standard