Marketplace Entities¶
Why This Exists¶
This document defines Marketplace Domain entities with identity.
Owner¶
The owner is the Chief Product Officer and Enterprise Architect.
Business Value¶
Clear entities support marketplace listings, search, discovery, quote requests, support requests, matching, and visibility workflows.
Entity Catalogue¶
| Entity | Purpose | Key attributes | Business rules | Relationships | MVP status |
|---|---|---|---|---|---|
| Marketplace Listing | Provider listing. | ListingId, provider type, category, status, visibility. | Must have approved category. | References provider source. | MVP |
| Marketplace Provider | Provider represented in marketplace. | ProviderId, type, display name, source ref. | Must identify participant type. | May reference Supplier or Funding. | MVP |
| Provider Category | Browsing category. | CategoryId, name, parent, status. | Category names must be controlled. | Used by listings/search. | MVP |
| Search Session | Search interaction. | SearchSessionId, query, filters, context. | Must preserve filters used. | Produces results. | Later |
| Search Result | Result item. | ResultId, listing ID, rank, reason. | Must reference listing. | Belongs to search session. | Later |
| Marketplace Match | Match record. | MatchId, OrganizationId, listing ID, score. | Must include reason. | Uses Organization context. | MVP |
| Quote Request | Quote request workflow. | RequestId, OrganizationId, listing ID, status. | Must identify requested provider. | May reference Supplier quote later. | MVP |
| Support Request | Support request workflow. | SupportRequestId, type, status, provider. | Must define request type. | Supports advisors/providers. | MVP |
| Verification Display | Display record of verification signal. | DisplayId, signal source, status. | Must reference source domain. | Display-only. | MVP |
| Recommendation Display | Provider recommendation shown to customer. | DisplayId, Intelligence ref, listing IDs. | Must preserve source recommendation. | References Intelligence. | MVP |
Entity Rule¶
Marketplace entities must not become canonical stores for supplier performance, funding products, organization facts, contract state, or intelligence reasoning.