Product Requirements Document: Internal Asset Tracker

This is a censored copy which has removed any sensitive information. It was originally prepared by Ria Pacheco, August 2022

 

Table of Contents

Part I: Business Case and Execution

 

Part II: Execution Criteria and Solutions


 

 

Part I: Business Case and Execution

Introduction

With thousands of valve sensor and compute-related hardware units installed (or waiting for M&R) on thousands of Pads across Canada and the United States, the need for a tool was identified for tracking each piece's unique static information, dynamic location & condition-related statuses, and the progress of core M&R processes as each piece transitions through standard procedures in the lab.

Historical Execution

Sensitive Information Removed


 

 

1.1 Objective(s): Visibility

The metrics listed in this section are guided by high-level conversations with the Director of Hardware and typical best practices asserted by organizations like Society for Maintenance & Reliability Professionals. Upon follow-up, all metrics will be captured by discovery activities in partnership with the hardware organization.

(a) Availability

Proportion of time the equipment is able to be used for its intended purpose. This is a starting lagging indicator1.

(TotalHoursDowntimeHoursTotalHours)×100%
Potential Product Questions
  1. By design, how long is each piece of equipment supposed to stay in the field versus the lab?
  2. What conditions might impact its overall operation over time?
  3. What time, materials, and resources have been provided to the Hardware team to design equipment for optimized availability

(b) Utilization

Proportion of the time that equipment is available that is used for its intended purpose. This is a leading indicator that ultimately concerns itself with the frequency with which equipment breaks down1.

(TotalHoursDowntimeHoursStandbyHoursTotalHoursDowntimeHours)×100%
Potential Product Questions
  1. How long is each piece of equipment in operation before requiring maintenance?
  2. How long is each piece of equipment in operation before requiring repair?
  3. How can we better track downtime versus standby hours?

(c) Reliability

Proportion of time the equipment does not fulfill its intended purpose - measured by Mean Time Between Failures (MTBF).

(TotalHoursDowntimeHoursStandbyHoursNumberOfFailures)×100%
Potential Product Questions
  1. How can we potentially track failure against indicators of reasonable errors made in the field?

 

Minimum Summary Metrics

At minimum (and in addition to minimum data reqs outlined by previous efforts), the following indicators should be considered when developing the UX (not to be confused with IxD) and may require the creative insight of data and backend expertise on our team:

  1. Total Hours
  2. Downtime Hours
  3. Standby Hours
  4. Mean Time Between Failures

 


 

 

1.2 Target Groups

Follow-up discovery activities will explore collaboratively with each intended target group listed in this section to understand core needs, workflows, and operational requirements.

MFG / M&R Teams ["TG1"]

The teams responsible for equipment manufacturing, maintenance, and repair are those that serve the high-complexity engineering practices in hardware product design, technical documentation of procedures, and testing against high-impact conditions. They are motivated by high ops-impact design, military-grade equipment resilience, and clockwork synchronicity for M&R procedures.

Field Operations / Shop Teams ["TG2"]

The teams responsible for implementation, emergency escalations with customers, and the ongoing smooth execution of field operations. These units are composed of RTOC, field technician contractors, and the business units required for the success of their mandates; and are motivated by low-volume support tickets, high customer satisfaction scores, and the ultimate success of the operator's core operation

Executive Team / Business Units ["TG3"]

The teams ultimately held accountable to company shareholders. They are composed of C-suite, VP, and Director-level team members and are motivated by fulfilling the business objectives and expected financial returns they've been acquired to satisfy by company shareholders

 


 

 

1.3 Product Incentives

Time Series Data Logging

Capture data through low-level detail logging and a focused query system. The (proposed) HistoryLog object captures the following details whenever an asset is touched ["the event"]

[Additional data prohibited from being shared]

Incentive(s)

 

MFG Success Metrics

By providing the availability of recorded expectations through MFG metrics of success in the system, we're able to observe with true leading indicators, how well the design of each piece of equipment matches to different operational scenarios and are empowered to fine-tune them over time. This feature is not hashed out yet, but will likely surround captured decisions over the metrics provided in the first section and will be reviewed dynamically over time. A key piece for the Asset Tracker tool its ability to be able to measure any adjustments over time and against any location or procedure being performed, to provide high-impact insights to the MFG & Engineering process.

Considerations
  1. What time, materials, and resources have been provided to the hardware team to design equipment for optimized availability?
  2. By design, how long is each equipment supposed to stay in operation?
Incentives

Captured M&R Processes

By separating the concerns for maintenance, repair, and reliability testing against the time-recorded stages of each we're better able to refine and hone in our lab & general M&R processes. These process include:

Incentives

 


 

 

Part II: Execution Criteria and Solutions

2.1 Data Requirements

As a product focused on capturing and enabling the visibility of asset/process metrics, of which can be relied upon to support capital-intensive operations including general supply-chain management, insights for profilitability, and flexibility in adaptable supply levels / processes to achieve financial priorities mandated by shareholders OR to achieve emergency cashflow to enable business security, the product must follow traditional data requirements implemented by a data-focused discovery, planning, and technical execution process. These must consider (at minimum) the following:

 

Entity Integrity

Criteria

Each data table must have its own primary key ["PK"] and column(s) chosen as PKs are both unique and not null. This enables the ability to work with consistent objects, perform queries that return consistent results, and much more.

Current State

Sensitive Information Removed

 

Referential Integrity

Criteria

Any foreign key ["FK"] value should be in one of 2 states.

  1. FK value refers to a primary key value of some table in the database
  2. May occasionally return null to explicitly indicate that there is no relationship between the objects represented in the db or that this relationship is unknown.
Current State

Sensitive Information Removed

 

User-Defined Integrity

Criteria

Understanding of end-user goals, user execution states, UX that supports consistency, and general user queries is required to understand central data tables to act as primary nodes to limit human error

Current State

Sensitive Information Removed

 

2.2 Solutions for Data

(a) Process Implementation Options

Discovery Process

A re-discovery process for use-cases, no longer framed by a perspective of scarcity (since many typical process stages could not be supported by data-expertise or a long-term view for this product's development, given limited resources) should be performed.

Prioritization and Selection of Tech Stack alongside UX Discovery

Technical tools, frameworks, and additional external (development) features are selected to enable integration among all CBT tools as well as enough flexibility to support future use-cases of Asset Tracker's roadmap.

Database, Middleware, and Frontend Development

Actual development cycle time

 

(b) Technical Implementation Options

All solutions have been boiled down to two potential options since any options that can be configured from re-considering any aspect of either would produce marginal (yet still potentially significant) differences in terms of execution OR outcome.

Sensitive Information Removed

Broken down by Technical Task, Execution Option Details, expected Result / Condition, and Execution Stack and Time

 

 

 


1 Reliability and Availability are related by not directly. It is possible to have equipment break down frequently for very short periods, resulting in a reasonable level of availability