Technical Requirements

Technical Requirements

Technical Requirements Jonathan Poland

Technical requirements are specifications for a technology such as a system or application. It is common to define technical requirements with commanding verbs such as will, shall and must. Technical requirements are an opportunity to communicate business expectations for the end-to-end operational quality of a technology. As such, it can be a bad idea to fully delegate them to implementors, although they should certainly contribute. Technical requirements are typically designed to be smart. In many cases, technical requirements are specified at several levels of detail. For example, an initial requirement for a “flat structure” for a user interface may be later expanded with detailed specifications of screen flows and navigation.

Availability

The system will maintain availability of 99.99%.

Reliability

The system will maintain a mean time between failures of greater than 60 days.

Performance

The system will have an average page load time of less than 2 seconds.

Throughput

The system will handle 1,000 concurrent users while meeting performance objectives.

Standards

The system will comply with our architectural and security requirements with links to relevant standards.

Authentication & Authorization

The system will conform to our policy for authentication and authorization with links to relevant standards.

Serviceability

Changes and upgrades to the system will not require total outages.

Maintainability

Logging will be sufficient to quickly identify and resolve system problems with a mean time to repair of less than one hour for high severity incidents.

Accessibility

All videos will have accurate closed captioning.

Privacy

The user interface will not allow employees to view customer birth dates stored in the customer database.

Human Error

The system will detect when a price entered by a user is more than 10% from the realtime market price. This will result in a confirmation screen that warns the user of the discrepancy.

System Errors

System errors will result in an error code that will be communicated to the user. This code will be well documented in the help desk system to expedite support and incident resolution.

Information Security

User credentials and all personally identifiable information will be encrypted in storage and transit.

Audit Trail

Access to the database will result in logs including a high priority alert that is triggered for sensitive operations such as a database dump.

Internal Controls

The only persons that will have access to the decryption keys for customer data will be officially designated as data stewards. Data stewards will be prohibited from accessing databases and will not be given the authorizations required to do so.

Data

Customer data will be sourced from the customer database without permanently storing these fields in the billing system.

Data Migration

Historical customer invoices will be accurately migrated to the new system and will be viewable from the customer invoice screen.

Data Quality

The data migration will confirm that the billing rate is accurate for every customer.

Usability

Users will be able to permanently turn off each individual smart feature from the user preferences menu.

Productivity

Sales people will be able to generate a quotation using a single screen. It will be possible to regenerate the quotation without entering all fields again.

Structure

The sales system will have a flat hierarchy of screens whereby no screens are at a depth of greater than 3.

Interoperability

The website will work on all major operating systems, devices and browsers as specified in the current customer technology requirements [link to this document].

Vendor Lock-in

The system will be based on custom code and open source without any dependency on proprietary technologies.

Loose Coupling

The system will continue to fully function when the billing API is down with the exception of any functions that depend on uncached data from this API.

Transitional Requirements

The old billing system will remain fully operational for a period of 3 months after the launch as a reference that can be used to confirm the correctness of calculations, user interfaces and migrated data.

Magical Thinking Jonathan Poland

Magical Thinking

Introduction to Magical Thinking Magical thinking is a type of irrational belief that involves attributing causality to events that are…

What is Force Majeure? Jonathan Poland

What is Force Majeure?

Force majeure refers to circumstances beyond the control of a party that prevent them from fulfilling their obligations under a…

Human Capital Jonathan Poland

Human Capital

Human capital refers to the future productive potential of people, which is often difficult to estimate directly. Instead, it is…

Technology 101 Jonathan Poland

Technology 101

Technology is an important component of every business, constantly reshaping entire industries. Keeping pace with new and emerging technology can…

Risk Evaluation Jonathan Poland

Risk Evaluation

Risk evaluation is the process of identifying and assessing the risks that an organization or individual may face. It is…

Ground Rules Jonathan Poland

Ground Rules

Ground rules are rules or guidelines that are established at the beginning of a meeting, activity, or other situation to…

What If Analysis Jonathan Poland

What If Analysis

What-if analysis is the process of considering and evaluating hypothetical outcomes. It is a common technique used in early stage…

Ai Websites (Q3 2023) Jonathan Poland

Ai Websites (Q3 2023)

A simple resource dump of Ai websites we found during Q3 2023. Human AI Ethical, transparent, and beneficial AI development…

Product Knowledge Jonathan Poland

Product Knowledge

Product knowledge refers to the ability to effectively communicate information and answer questions about a product or service. This knowledge…

Learn More

Competitor Analysis Jonathan Poland

Competitor Analysis

Competitor analysis is the process of gathering and analyzing information about competitors in a market in order to understand their…

Customer Service Jonathan Poland

Customer Service

Customer service is the practice of providing support, assistance, and guidance to customers before, during, and after a purchase. This…

Market Forces Jonathan Poland

Market Forces

The interaction that shapes a market economy. Market forces are the factors that determine the supply and demand for a…

Communication Channels Jonathan Poland

Communication Channels

A communication channel refers to the various means of transmitting information and messages between individuals or organizations. There are many…

Test Marketing Jonathan Poland

Test Marketing

Test marketing involves testing different marketing strategies or variations on customers in order to gather data and evaluate their effectiveness.…

Types of Efficiency Jonathan Poland

Types of Efficiency

Efficiency refers to the relationship between the amount of input used to produce something and the amount of output that…

Project Stakeholder Jonathan Poland

Project Stakeholder

A stakeholder is anyone or any group that is impacted by a project. This includes individuals or teams who are…

Scaling 101 Jonathan Poland

Scaling 101

Scaling is the process of increasing the size, scope, or reach of a business, product, or service. This can involve…

Toxic Positivity Jonathan Poland

Toxic Positivity

Top-down and bottom-up are opposing approaches to thinking, analysis, design, decision-making, strategy, management, and communication. The top-down approach begins with…