Products Domain

The Products domain encompasses tangible and intangible offerings created by an organization to address customer needs and deliver value. This domain integrates products into business architecture, connecting them with capabilities, value streams, policies, and stakeholders across the enterprise ecosystem.

Schema Version: 2.1
Schema Location: /schemas/products.schema.json
Specification: JSON Schema Draft-07

Overview

What is a Product?

A product represents any tangible or intangible offering that an organization creates, develops, or provides to deliver value to customers, stakeholders, or markets. Products can range from:

• Physical goods — Hardware, equipment, manufactured items
• Software applications — Desktop apps, mobile apps, web platforms
• Services — Consulting, maintenance, support offerings
• Reports and data — Analytics dashboards, datasets, business reports
• Intellectual property — Patents, licenses, proprietary technologies

In the context of enterprise architecture, products serve as key value delivery mechanisms that connect organizational capabilities with customer needs.

Purpose and Value

The Products domain enables architects and planners to:

• Track product portfolio by documenting all offerings in a structured format
• Manage lifecycle from concept through retirement
• Connect to capabilities by linking products to enabling capabilities
• Measure performance through embedded metrics and KPIs
• Support governance by linking products to compliance requirements

For Data Engineers

The Products domain maps directly to data product concepts:

• Product → Data Product in your catalog
• Product Features → Data product capabilities
• Target Market → Data consumers and use cases
• Quality Metrics → Data quality dimensions
• Lifecycle Stage → Data product maturity

Domain Attributes

Core Attributes

Attribute	Type	Description	Required
title	String	Name or title of the Product	✓
description	String	Detailed explanation of what the Product entails	✓
purpose	String	Intended purpose or function within the Organization	✓
owner	String	Individual or team responsible for the Product	✓
orgUnitTitle	String	Organization unit(s) to which the Product is linked
productCategory	Enum	Broad categorization of product type
productType	Enum	Specific type of product
targetMarket	Enum	Primary market or customer segment
businessModel	Enum	Revenue or value delivery model
lifecycleStage	Enum	Current stage in product lifecycle
lifecycleManagement	String	Strategies for managing from inception to retirement
marketCompetitiveness	String	Analysis of how the Product compares with competitors
customerFeedback	String	Data on customer satisfaction and Product performance
userBase	String	Description of current user base
usage	String	How the product is typically used
dependencies	String	Other products, processes, or systems required
relatedProducts	String	Products that are related or linked
integrations	String	Systems or platforms the product integrates with
technologyStack	String	Underlying technologies used
performanceIndicators	String	Metrics used to measure success and performance
qualityMetrics	String	Quality assessment measures
adoptionMetrics	String	Usage and adoption measurements
revenueModel	String	How the product generates revenue or value
costs	String	Development, maintenance, and operational costs
pricingStrategy	Enum	Pricing approach
channels	Array[Enum]	Distribution and delivery channels
customerSegments	Array[Enum]	Target customer segments
valueProposition	String	Core value delivered to customers
competitiveAdvantage	String	What differentiates from competitors
risks	String	Potential risks associated with the Product
riskCategories	Array[Enum]	Categories of risks
complianceRequirements	Array[Enum]	Regulatory and compliance needs
securityRequirements	String	Security and privacy requirements
improvementOpportunities	String	Areas for enhancement or improvement
roadmap	String	Future development plans
strategicAlignment	String	Alignment with organizational goals
sustainability	String	Environmental and sustainability considerations
accessibility	String	Accessibility features and compliance
localization	String	Multi-language and regional adaptations
productFeatures	Array[Object]	Specific features of the product

Enumeration Values

Product Category (productCategory)

Value	Description	Example
Physical Product	Tangible manufactured goods	Railway equipment, sensors, hardware devices
Digital Product	Software and digital offerings	Mobile apps, web platforms, digital tools
Service Product	Service-based offerings	Consulting services, maintenance services
Information Product	Data and knowledge products	Reports, datasets, analytics dashboards
Platform Product	Technology platforms	APIs, development platforms, marketplaces
Hybrid Product	Combination of physical and digital	IoT devices with software, smart systems

Product Type (productType)

Value	Description	Example
Hardware	Physical devices and equipment	Sensors, computers, machinery
Software	Applications and programs	Desktop apps, mobile apps, web applications
Platform	Technology platforms and frameworks	Development platforms, APIs, operating systems
SaaS	Software as a Service	Cloud-based applications, subscription software
Report	Information and analysis reports	Business reports, compliance reports, dashboards
Dataset	Structured data products	Databases, data feeds, analytics datasets
API	Application programming interfaces	REST APIs, GraphQL APIs, integration services
Component	Reusable components	Software libraries, hardware components
System	Complete integrated systems	Enterprise systems, integrated solutions
Tool	Specialized tools and utilities	Development tools, analysis tools
Content	Digital content products	Documentation, training materials, multimedia
Intellectual Property	Patents, licenses, and IP	Patents, trademarks, licensed technologies

Target Market (targetMarket)

Value	Description	Example
Internal	Internal organizational use	Employee tools, internal systems
External	External customer market	Customer-facing products
B2B	Business-to-business	Enterprise software, corporate services
B2C	Business-to-consumer	Consumer applications, retail products
B2G	Business-to-government	Government solutions, public sector
Partner	Partner and channel market	Partner platforms, reseller tools

Business Model (businessModel)

Value	Description	Example
One-time Purchase	Single transaction purchase	Hardware, perpetual licenses
Subscription	Recurring subscription model	SaaS, membership services
Freemium	Free with premium options	Free tier with paid upgrades
Open Source	Open source with optional services	Community edition with enterprise support
Usage Based	Pay-per-use pricing	API calls, storage usage
License	Licensing model	Software licenses, IP licensing
Advertising	Ad-supported model	Free products with advertising

Lifecycle Stage (lifecycleStage)

Value	Description	Example
Concept	Initial ideation phase	New product ideas, market research
Development	Active development	Building and testing
Launch	Market introduction	Go-to-market, initial release
Growth	Market adoption and scaling	User acquisition, feature expansion
Maturity	Stable market position	Maintenance, optimization
Decline	Decreasing market relevance	Reduced investment, sunset planning
Retirement	End of life	Decommissioning, migration

Pricing Strategy (pricingStrategy)

Value	Description	Example
Cost Plus	Cost plus margin pricing	Manufacturing + markup
Value Based	Pricing based on perceived value	Premium positioning
Competitive	Pricing based on competition	Market rate matching
Penetration	Low price for market entry	Initial discount pricing
Skimming	High initial price, later reduced	Premium launch, later discounts

Distribution Channels (channels)

Value	Description
Direct Sales	Direct sales team
Online Platform	E-commerce and web sales
Partner Channel	Resellers and partners
Retail	Physical retail locations
App Store	Application marketplaces
API Marketplace	API distribution platforms

Customer Segments (customerSegments)

Value	Description
Enterprise	Large enterprise customers
SMB	Small and medium businesses
Government	Government and public sector
Consumer	Individual consumers
Developer	Software developers
Partner	Channel partners

Product Feature Elements

Attribute	Type	Description
title	String	Name/title of the feature
description	String	Detailed explanation of the feature
purpose	String	Intended purpose/benefit of the feature
owner	String	Individual/team responsible for the feature
featureType	Enum	Type of feature: Core, Enhancement, Integration, Security, Analytics
priority	Enum	Feature priority: Critical, High, Medium, Low
status	Enum	Development status: Planned, In Development, Released, Deprecated
userStories	String	Associated user stories or requirements
acceptanceCriteria	String	Criteria for feature acceptance
dependencies	String	Related dependencies
releaseVersion	String	Version in which feature was/will be released

Domain Relationships

The Products domain integrates with other metamodel domains:

Target Domain	Relationship Type	Description
Capabilities	Enablement	Capabilities enable product delivery
Services	Realization	Services may realize products
Customer	Consumption	Customers consume products
Value Stream	Delivery	Products delivered through value streams
Information	Content	Products contain or produce information
Technology	Implementation	Technology implements products
Channel	Distribution	Channels distribute products
Market	Positioning	Market position drives product strategy
Performance	Measurement	Performance metrics measure product success
Policy	Compliance	Products comply with policies

Examples

Example 1: Information Product

{
  "title": "Track Quality Index Report",
  "description": "Monthly analysis of track geometry and maintenance metrics across the rail network",
  "purpose": "Track maintenance planning and quality assurance decision support",
  "owner": "Track Quality Analysis Team",
  "orgUnitTitle": "Track Maintenance Division",
  "productCategory": "Information Product",
  "productType": "Report",
  "targetMarket": "Internal",
  "businessModel": "Open Source",
  "lifecycleStage": "Maturity",
  "lifecycleManagement": "Monthly updates, annual review process",
  "marketCompetitiveness": "Industry-leading accuracy of 98.5%",
  "customerFeedback": "User satisfaction: 4.2/5.0",
  "userBase": "500 active users across 12 departments",
  "usage": "Daily reporting, weekly analysis, monthly planning",
  "dependencies": "Track measurement systems, analysis software",
  "relatedProducts": "Rail Wear Report, Bridge Condition Index",
  "integrations": "ERP system, mobile apps, third-party analytics",
  "technologyStack": "Python, PostgreSQL, React, AWS cloud infrastructure",
  "performanceIndicators": "Accuracy: 98.5%, Timeliness: 99%",
  "qualityMetrics": "Defect rate: 0.1%, Customer satisfaction: 4.2/5",
  "adoptionMetrics": "Monthly active users: 450, Feature adoption: 78%",
  "revenueModel": "Internal cost center allocation",
  "costs": "Development: $200K, Annual maintenance: $50K",
  "valueProposition": "Reduce maintenance costs by 30% through predictive analytics",
  "competitiveAdvantage": "Real-time processing with 99.9% accuracy",
  "risks": "Data quality issues, reporting delays",
  "riskCategories": ["Technical", "Operational"],
  "complianceRequirements": ["Industry Standards"],
  "securityRequirements": "Data encryption, access controls, audit trails",
  "improvementOpportunities": "Add predictive analytics, mobile access",
  "roadmap": "Q2: Mobile app, Q4: AI-powered insights",
  "strategicAlignment": "Supports track safety and efficiency goals",
  "sustainability": "Cloud-hosted to reduce energy consumption",
  "accessibility": "WCAG 2.1 compliant, screen reader support",
  "localization": "Available in English, Spanish, French",
  "productFeatures": [
    {
      "title": "Interactive Dashboard",
      "description": "Real-time visualization of track quality metrics",
      "purpose": "Enable quick identification of problem areas",
      "owner": "Dashboard Development Team",
      "featureType": "Core",
      "priority": "Critical",
      "status": "Released",
      "releaseVersion": "2.0"
    },
    {
      "title": "Predictive Maintenance Alerts",
      "description": "AI-powered predictions for maintenance needs",
      "purpose": "Proactive maintenance scheduling",
      "owner": "AI Analytics Team",
      "featureType": "Enhancement",
      "priority": "High",
      "status": "In Development",
      "releaseVersion": "3.0"
    }
  ]
}

Example 2: Digital Platform Product

{
  "title": "Customer Analytics Platform",
  "description": "Self-service analytics platform for customer behavior analysis and segmentation",
  "purpose": "Enable data-driven customer insights across the organization",
  "owner": "Chief Data Officer",
  "orgUnitTitle": "Data and Analytics Division",
  "productCategory": "Digital Product",
  "productType": "Platform",
  "targetMarket": "Internal",
  "businessModel": "Subscription",
  "lifecycleStage": "Growth",
  "customerSegments": ["Enterprise"],
  "channels": ["Online Platform", "API Marketplace"],
  "valueProposition": "Democratize customer insights with self-service analytics",
  "competitiveAdvantage": "Pre-built customer analytics models with 2-minute insights",
  "pricingStrategy": "Value Based",
  "performanceIndicators": "User adoption rate, query response time, insight generation",
  "qualityMetrics": "Data freshness: <1 hour, Uptime: 99.9%"
}

Implementation Guidelines

Product Modeling Best Practices

1. Start with value proposition — Define customer value before features
2. Track lifecycle stage — Update regularly as product matures
3. Connect to capabilities — Link products to enabling capabilities
4. Measure what matters — Include relevant performance metrics
5. Plan for retirement — Include sunset criteria from the start

Product Portfolio View

OpenMetadata Integration

For Data Platform Teams

When integrating with OpenMetadata, map Product entities as follows:

Orthogramic Element	OpenMetadata Entity	Notes
Information Product	Data Product	Direct mapping for data products
Product	Dashboard /Pipeline	For analytics products
Product Features	Data Product Properties	Capabilities of data product
Target Market	Consumers	Who uses the product
Quality Metrics	Data Quality Tests	Product quality measures
Lifecycle Stage	Custom Property	Track product maturity

# Example: Create OpenMetadata Data Product from Orthogramic Product
def create_om_data_product(product):
    """
    Map Orthogramic Product to OpenMetadata Data Product
    """
    return {
        "name": product["title"].lower().replace(" ", "_"),
        "displayName": product["title"],
        "description": product["description"],
        "fullyQualifiedName": f"dataproduct.{product['title'].lower().replace(' ', '_')}",
        "owner": {
            "name": product["owner"],
            "type": "user"
        },
        "domain": product.get("orgUnitTitle", ""),
        "assets": [],  # Link to tables, dashboards, pipelines
        "experts": [],
        "tags": [
            {"tagFQN": f"ProductCategory.{product['productCategory'].replace(' ', '')}"},
            {"tagFQN": f"Lifecycle.{product['lifecycleStage']}"}
        ],
        "extension": {
            "valueProposition": product.get("valueProposition"),
            "targetMarket": product.get("targetMarket"),
            "businessModel": product.get("businessModel")
        }
    }

Schema Reference

• Repository: Orthogramic/Orthogramic_Metamodel
• Schema Location: /schemas/products.schema.json
• Version: 2.1
• Specification: JSON Schema Draft-07
• License: Creative Commons Attribution-ShareAlike 4.0 (CC BY-SA 4.0)

---

Previous: Strategy Domain | Next: Services Domain