--- sidebar_position: 2 title: Business Case --- # Business Case ## Preface Martin Engineering requires a reliable and standardized mechanism to extract information from HUB that supports its most common day-to-day business processes. The extraction capability should enable retrieval of records based on their created and updated timestamps, allowing downstream systems and integrations to efficiently identify and process new or modified data. To address this requirement, we propose the implementation of a DataHUB Service that will act as the central access layer for HUB data extraction. This service will provide a unified and controlled interface for accessing HUB data while leveraging a combination of: - Dedicated Service Accounts for system-to-system integrations. - Standard HUB Role-Based Permissions to enforce data access controls and security policies. By adopting this approach, the DataHUB Service will deliver a consistent, secure, and compliant framework for data extraction. Access to data through each endpoint will be governed by the permissions assigned to the service account initiating the request, ensuring that consumers can only retrieve information they are authorized to access. This architecture promotes standardization across integrations, simplifies data access management, and provides a scalable foundation for future HUB data extraction requirements. --- ## Business Value The proposed DataHUB Service provides a centralized, secure, and standardized mechanism for extracting HUB data, enabling Portal Owners to efficiently support key business processes. By leveraging service accounts and existing HUB permissions, the solution reduces integration complexity, improves data accessibility, strengthens governance and compliance, and ensures that downstream systems can reliably access only the data they are authorized to consume. This approach enhances operational efficiency, supports scalable integrations, and establishes a consistent foundation for future reporting, analytics, and automation initiatives. --- ## Current Process / Workflow Currently, Martin Engineering must submit ad hoc requests to HOIST whenever HUB data is required for reporting, integration, or operational purposes. In response, HOIST manually generates and delivers data extracts for the specific entity being requested. This process presents several challenges: - Manual effort and dependency on HOIST resources for every data request. - Longer turnaround times, which can delay business operations and decision-making. - Increased risk of human error during data extraction, preparation, and delivery. - Lack of standardization, resulting in inconsistent extraction methods and formats. - Limited scalability, as the process becomes increasingly difficult to manage as data volume and integration needs grow. - No self-service capability for consuming systems to retrieve data on demand. As a result, the current approach is both inefficient and prone to errors, creating operational overhead for both Martin Engineering and HOIST while limiting the organization's ability to access timely and reliable HUB data. --- ## Desired Outcomes & Desired Process / Workflow The proposed solution is to implement a secure and standardized DataHUB REST API framework that enables authorized systems to extract HUB data on demand. Key objectives include: - Development of a suite of REST APIs that expose HUB data sets in a consistent and scalable manner. - Support for incremental data extraction using `CreatedOn` and `UpdatedOn` timestamps, allowing consumers to retrieve only new or modified records. - Integration with the existing HUB permission model to control access at the data-set level. - Example: `Can Extract Visits` permission. - Enable secure access through service accounts, ensuring all data retrieval is governed by existing authorization controls. ### Data Sets in Scope - Quotes - Quote → Lines - Quotes → Charges - Quotes → Labor Worksheet - Quotes → Additional Information - Quotes → Quotation Details - Visits - Visits → Quotes - Visits → Service Records - Visits → Forms - Visits → Work Tasks - Service Records - Forms - Forms => Answers - Time Report - Form Builder - Form definition - Question definitions The desired outcome is a self-service, reliable, and secure data extraction capability that eliminates manual data requests while providing efficient access to business-critical HUB information.