Skip to main content

Domain & Data Model

Introduction​

The Domain & Data Model defines the main concepts, entities, information, and relationships that exist within the SalesFam platform. It focuses on what exists in the system and how those things relate to each other, before deciding how they will be stored in the database or accessed through APIs.

This layer provides the connection between the Functional Requirements and the technical implementation. It helps ensure that the system is built around the actual business concepts of SalesFam rather than around database tables or code structures.

Each functional requirement may introduce or use different domain entities. As the platform grows, this section will document those entities and their relationships for each functional area.

What This Section Defines​

  • Core domain entities and their purpose
  • Important data associated with each entity
  • Relationships between entities
  • Domain states and lifecycles
  • Business rules that affect the relationships between entities

What This Section Does Not Define​

This section does not define:

  • Database tables or SQL structure
  • API endpoints or request/response formats
  • Backend folder or code structure
  • Specific implementation technologies

Those are defined in their respective technical documentation sections (Database Design, API Endpoints).

Organization​

The Domain & Data Model is organized by Functional Requirement:

  • FR-01 — IAM
  • FR-02 — Merchant & Product Management
  • FR-03 — Rep Onboarding & Commission Contracts
  • FR-04 — Referral Attribution Engine
  • FR-05 — Checkout & Payment Processing
  • FR-06 — Webhook Processing & Order Finalization
  • FR-07 — Financial Ledger, Settlement & Payouts

Each FR contains the domain entities relevant to that functional area. Only FR-01 has been modeled so far.