Skip to main content

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: product.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​

AttributeTypeDescriptionRequired
productIDStringUnique identifier for the Product, e.g. PROD-001✓
titleStringName or title of the Product✓
descriptionStringDetailed explanation of what the Product entails✓
purposeStringIntended purpose or function within the Organization✓
ownerStringIndividual or team responsible for the Product✓
orgUnitTitleStringOrganization unit(s) to which the Product is linked
orgUnitIDStringID of the organization unit (see orgUnitTitle)
productCategoryEnumBroad categorization of product type
productTypeEnumSpecific type of product
targetMarketEnumPrimary market or customer segment
businessModelEnumRevenue or value delivery model
lifecycleStageEnumCurrent stage in product lifecycle
lifecycleManagementStringStrategies for managing from inception to retirement
marketCompetitivenessStringAnalysis of how the Product compares with competitors
customerFeedbackStringData on customer satisfaction and Product performance
userBaseStringDescription of current user base
usageStringHow the product is typically used
dependenciesStringOther products, processes, or systems required
relatedProductsStringProducts that are related or linked
relatedProductIDsArray[String]IDs of related Products (unique)
integrationsStringSystems or platforms the product integrates with
technologyStackStringUnderlying technologies used
performanceIndicatorsStringMetrics used to measure success and performance
qualityMetricsStringQuality assessment measures
adoptionMetricsStringUsage and adoption measurements
revenueModelStringHow the product generates revenue or value
costsStringDevelopment, maintenance, and operational costs
pricingStrategyEnumPricing approach
channelsArray[Enum]Distribution and delivery channels
customerSegmentsArray[Enum]Types of customer the product targets
customerSegmentIDsArray[String]IDs of the specific customer segments the product targets (records in the Customer domain; unique)
valuePropositionStringCore value delivered to customers
competitiveAdvantageStringWhat differentiates from competitors
risksStringPotential risks associated with the Product
riskCategoriesArray[Enum]Categories of risks
complianceRequirementsArray[Enum]Regulatory and compliance needs
securityRequirementsStringSecurity and privacy requirements
improvementOpportunitiesStringAreas for enhancement or improvement
roadmapStringFuture development plans
strategicAlignmentStringAlignment with organizational goals
sustainabilityStringEnvironmental and sustainability considerations
accessibilityStringAccessibility features and compliance
localizationStringMulti-language and regional adaptations
productFeaturesArray[Object]Specific features of the product (see Product Feature)

Strategic Empathy Attributes​

These optional flags record whether a product's design accounts for the people who use it and are affected by it.

AttributeTypeDescriptionRequired
userEmpathyMappingIntegratedBooleanWhether empathy maps and user personas are used consistently in product development
ethicalAIByDesignBooleanFor AI-driven products, whether ethical considerations and potential empathetic impacts are designed in
accessibilityFeaturesBooleanWhether the product includes features addressing diverse user needs and challenges

A product record must have productID, title, description, purpose and owner, and may not carry fields other than those listed above. Name-only links (orgUnitTitle, relatedProducts) can be paired with their ID fields (orgUnitID, relatedProductIDs).

Enumeration Values​

Product Category (productCategory)​

ValueDescriptionExample
physicalProductTangible manufactured goodsRailway equipment, sensors, hardware devices
digitalProductSoftware and digital offeringsMobile apps, web platforms, digital tools
serviceProductService-based offeringsConsulting services, maintenance services
informationProductData and knowledge productsReports, datasets, analytics dashboards
platformProductTechnology platformsAPIs, development platforms, marketplaces
hybridProductCombination of physical and digitalIoT devices with software, smart systems

Product Type (productType)​

ValueDescriptionExample
hardwarePhysical devices and equipmentSensors, computers, machinery
softwareApplications and programsDesktop apps, mobile apps, web applications
platformTechnology platforms and frameworksDevelopment platforms, APIs, operating systems
saasSoftware as a ServiceCloud-based applications, subscription software
reportInformation and analysis reportsBusiness reports, compliance reports, dashboards
datasetStructured data productsDatabases, data feeds, analytics datasets
apiApplication programming interfacesREST APIs, GraphQL APIs, integration services
componentReusable componentsSoftware libraries, hardware components
systemComplete integrated systemsEnterprise systems, integrated solutions
toolSpecialized tools and utilitiesDevelopment tools, analysis tools
contentDigital content productsDocumentation, training materials, multimedia
intellectualPropertyPatents, licenses, and IPPatents, trademarks, licensed technologies

Target Market (targetMarket)​

ValueDescriptionExample
internalInternal organizational useEmployee tools, internal systems
externalExternal customer marketCustomer-facing products
b2bBusiness-to-businessEnterprise software, corporate services
b2cBusiness-to-consumerConsumer applications, retail products
b2gBusiness-to-governmentGovernment solutions, public sector
b2eBusiness-to-employeeEmployee benefit platforms, workforce apps
partnerPartner and channel marketPartner platforms, reseller tools
developerSoftware developersSDKs, developer APIs

Business Model (businessModel)​

ValueDescriptionExample
oneTimePurchaseSingle transaction purchaseHardware, perpetual licenses
subscriptionRecurring subscription modelSaaS, membership services
freemiumFree with premium optionsFree tier with paid upgrades
usageBasedPay-per-use pricingAPI calls, storage usage
advertisingAd-supported modelFree products with advertising
marketplaceRevenue from transactions between third partiesCommission on marketplace sales
licensingLicensing modelSoftware licenses, IP licensing
openSourceOpen source with optional servicesCommunity edition with enterprise support
enterpriseNegotiated enterprise agreementsSite licences, enterprise contracts
channelSold through intermediariesReseller and distributor agreements
internalServiceProvided to internal users as a funded serviceInternal reports, shared platforms
internalToolTool built for internal useEmployee tools, operational utilities

Lifecycle Stage (lifecycleStage)​

lifecycleStage accepts the shared delivery lifecycle list from common.schema.json (the first ten values) or one of the product-specific market lifecycle values (the last five).

ValueDescriptionExample
ideationIdea being exploredOpportunity assessment
planningScope and approach being plannedBusiness case, roadmap
designBeing designedPrototypes, specifications
developmentActive developmentBuilding and testing
implementationBeing implemented or rolled outPilot deployment
launchMarket introductionGo-to-market, initial release
operationalIn normal operationLive product in steady use
enhancementBeing extended with new featuresMajor feature release
optimizationBeing tuned for performance or costCost reduction, performance work
retirementEnd of lifeDecommissioning, migration
conceptInitial ideation phaseNew product ideas, market research
growthMarket adoption and scalingUser acquisition, feature expansion
maturityStable market positionMaintenance, optimization
declineDecreasing market relevanceReduced investment, sunset planning
maintenanceKept running with minimal changeBug fixes, security patches

Pricing Strategy (pricingStrategy)​

ValueDescriptionExample
costPlusCost plus margin pricingManufacturing + markup
valueBasedPricing based on perceived valuePremium positioning
competitivePricing based on competitionMarket rate matching
penetrationLow price for market entryInitial discount pricing
skimmingHigh initial price, later reducedPremium launch, later discounts
freemiumFree basic tier, paid premium tierFree plan with paid upgrades
dynamicPrice varies with demand or conditionsTime-of-day or demand-based pricing
bundleSold as part of a packageProduct suites
usageBasedPrice follows consumptionPer API call, per gigabyte

Distribution Channels (channels)​

ValueDescription
directSalesDirect sales team
onlinePlatformE-commerce and web sales
partnerChannelResellers and partners
retailPhysical retail locations
mobileAppMobile apps and app stores
apiAPIs, API platforms and developer portals
subscriptionServiceDelivered as part of a subscription
marketplaceThird-party marketplaces, including API marketplaces
internalDistributionDistributed within the organization

Customer Segments (customerSegments)​

customerSegments lists the types of customer a product targets. Named segments, such as "Railway Operators", are records in the Customer domain; reference them by ID in customerSegmentIDs.

ValueDescription
enterpriseLarge enterprise customers
smbSmall and medium businesses
governmentGovernment and public sector
consumerIndividual consumers
developerSoftware developers
partnerChannel partners
startupEarly-stage companies
educationSchools, universities and training providers
healthcareHealthcare providers and organizations
financialBanks, insurers and other financial institutions
internalUsers within the organization (internal products)

Product Feature Elements​

Each entry in productFeatures is a product feature: a specific capability, function or characteristic of the product that delivers value.

Product Feature (productFeature)​

AttributeTypeDescriptionRequired
titleStringName or title of the feature✓
descriptionStringDetailed explanation of the feature✓
purposeStringIntended purpose or benefit of the feature✓
ownerStringIndividual or team responsible for the feature
orgUnitTitleStringOrganization unit(s) involved in the feature
orgUnitIDStringID of the organization unit (see orgUnitTitle)
featureTypeEnumType of feature (see below)
priorityEnumDevelopment and business priority: shared priority list (low, medium, high, critical)
complexityEnumTechnical complexity: shared complexity list (simple, moderate, complex, highlyComplex)
userStoriesStringUser stories or use cases related to the feature
acceptanceCriteriaStringCriteria for accepting the feature
technicalSpecificationsStringTechnical details and requirements of the feature
dependenciesStringTechnical or business dependencies
integrationRequirementsStringIntegration needs with other systems
performanceRequirementsStringPerformance benchmarks and standards
securityRequirementsStringSecurity specifications
usabilityRequirementsStringUser experience and usability needs
testingRequirementsStringTesting and quality assurance needs
releasePlanStringPlan for releasing the feature, including target versions
rolloutStrategyEnumFeature rollout approach (see below)
targetAudienceStringSpecific users or groups for the feature
businessValueStringBusiness value and impact
successMetricsStringMetrics to measure feature success
feedbackStringUser feedback and feature reception
maintenanceRequirementsStringOngoing maintenance and support needs
documentationRequirementsStringDocumentation and training needs

A product feature must have title, description and purpose, and may not carry other fields.

Feature Type (featureType)​

ValueDescription
coreFeatureEssential functionality of the product
premiumFeatureFunctionality offered at a higher tier
addOnOptional extension sold or enabled separately
integrationConnection to another system or platform
customizationConfiguration or tailoring for a customer
enhancementImprovement to existing functionality

Rollout Strategy (rolloutStrategy)​

ValueDescription
bigBangReleased to all users at once
phasedReleased in planned stages
canaryReleased to a small group first to detect problems
betaReleased to volunteer or selected testers
geographicReleased region by region
segmentReleased to one customer segment at a time

Domain Relationships​

The Products domain integrates with other metamodel domains:

Target DomainRelationship TypeDescription
CapabilitiesEnablementCapabilities enable product delivery
ServicesRealizationServices may realize products
CustomerConsumptionCustomers consume products
Value StreamDeliveryProducts delivered through value streams
InformationContentProducts contain or produce information
TechnologyImplementationTechnology implements products
ChannelDistributionChannels distribute products
MarketPositioningMarket position drives product strategy
PerformanceMeasurementPerformance metrics measure product success
PolicyComplianceProducts comply with policies

Examples​

Example 1: Information Product​

{
"productID": "PROD-001",
"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": "informationProduct",
"productType": "report",
"targetMarket": "internal",
"businessModel": "internalService",
"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": [
"technology",
"operational"
],
"complianceRequirements": [
"industryStandards"
],
"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": "coreFeature",
"priority": "critical",
"releasePlan": "Released in version 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",
"complexity": "complex",
"releasePlan": "In development for version 3.0",
"rolloutStrategy": "phased"
}
]
}

Example 2: Digital Platform Product​

{
"productID": "PROD-005",
"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": "digitalProduct",
"productType": "platform",
"targetMarket": "internal",
"businessModel": "subscription",
"lifecycleStage": "growth",
"customerSegments": [
"internal"
],
"channels": [
"onlinePlatform",
"api"
],
"valueProposition": "Democratize customer insights with self-service analytics",
"competitiveAdvantage": "Pre-built customer analytics models with 2-minute insights",
"pricingStrategy": "valueBased",
"performanceIndicators": "User adoption rate, query response time, insight generation",
"qualityMetrics": "Data freshness: <1 hour, Uptime: 99.9%",
"userEmpathyMappingIntegrated": true,
"accessibilityFeatures": true
}

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:

Triodian ElementOpenMetadata EntityNotes
Information ProductData ProductDirect mapping for data products
ProductDashboard /PipelineFor analytics products
Product FeaturesData Product PropertiesCapabilities of data product
Target MarketConsumersWho uses the product
Quality MetricsData Quality TestsProduct quality measures
Lifecycle StageCustom PropertyTrack product maturity
# Example: Create OpenMetadata Data Product from Triodian Product
def create_om_data_product(product):
"""
Map Triodian 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​


Previous: Strategy Domain | Next: Services Domain