Domain Concepts¶
This document defines the core terminology and business concepts used throughout the Sartiq platform. Understanding these concepts is essential for effective communication across teams.
Overview¶
Sartiq's domain model revolves around transforming products into visual content through configurable shootings. The platform produces on-model photography, lifestyle visuals, and video content — all through automated, AI-powered workflows.
Organizations own resources (products, shootings, subjects, styles). Users belong to organizations and perform actions on those resources.
erDiagram
User {
string name
string email
}
User }o--o{ Organization : belongs_to
User }o--o{ Subject : can_use
Organization {
string name
}
Organization ||--o{ Product : owns
Organization ||--o{ Subject : owns
Organization ||--o{ Shooting : owns
Organization ||--o{ ShootingGuidelines : owns
Product {
string name
string sku
string cover_image
}
Subject {
string name
string cover_image
}
ShootingGuidelines {
string name
string file_format
}
ShootingGuidelines }o--|| ResolutionPreset : resolution
ShootingGuidelines }o--o{ Subject : subjects
ShootingGuidelines ||--o{ PosePreset : poses
ShootingGuidelines ||--o| SetDesign : set_design
ResolutionPreset {
int width
int height
}
PosePreset {
string name
string prompt
}
SetDesign {
int id
}
Shooting {
string name
string shot_status
date due_date
}
Shooting ||--o{ ShootingLook : contains
ShootingLook }o--|| Product : features
ShootingLook }o--|| Subject : features
ShootingLook }o--o{ ShootingGuidelines : uses
ShootingLook ||--o{ Shot : produces
Shot {
string status
string shot_type
}
Concepts¶
-
Physical items to showcase in generated imagery
-
Identities (AI or real) appearing in generated content
-
Complete photo shoot sessions containing multiple looks
-
Specific configurations combining subject, product, guidelines, and style
-
Single deliverable images for specific shot types
-
Definitions of framing and view angle
-
Visual aesthetics and creative direction
-
Guidelines (ShootingGuidelines)
Reusable shooting parameters: resolution, format, subjects, poses, and set design
-
AI tasks and their outputs
Entity Relationships Summary¶
Hierarchy¶
Organization
├── Users (many-to-many via user_organization)
├── Products
├── Subjects
├── Styles
├── Guidelines (ShootingGuidelines)
│ ├── ResolutionPreset
│ ├── Subjects (N-N)
│ ├── PosePreset(s)
│ └── SetDesign (optional)
│ ├── BackgroundPreset
│ │ └── BackgroundPresetFraming(s)
│ ├── SetBaseImage(s)
│ └── SetReferenceImage(s)
├── Shot Types (custom)
└── Shootings
└── Shooting Look
├── Subject (optional)
├── Product (main, optional)
├── ShootingGuidelines
├── Style (optional)
└── Shots
└── Revisions
└── Images
Key Relationships¶
| Entity A | Relationship | Entity B |
|---|---|---|
| User | belongs to many | Organizations |
| User | can use | Subjects (if public) |
| Organization | owns many | Products, Subjects, Shootings, Styles, ShootingGuidelines |
| Shooting | contains many | Shooting Looks |
| Shooting Look | references | Subject, Product, ShootingGuidelines, Style |
| Shooting Look | produces many | Shots |
| Shot | has one | Shot Type |
| Shot | has many | Revisions |
| Revision | contains many | Images |
| Generation | produces many | Predictions |
Glossary¶
| Term | Definition |
|---|---|
| Organization | Customer entity using the platform, owns resources |
| User | Person with platform access, belongs to one or more organizations |
| Product | Physical item to be showcased in generated imagery |
| Subject | Identity (AI or real) appearing in generated content |
| Shooting | Container for a set of related shooting looks |
| Shooting Look | Configuration combining subject, product, guidelines, and style |
| ShootingGuidelines | Reusable shooting parameters: resolution, format, subjects, poses, and optional set design |
| ResolutionPreset | Per-user or per-organization output dimension preset applied via ShootingGuidelines |
| PosePreset | Named pose with a prompt, scoped to a single shot type, with a pose reference image |
| SetDesign | Optional resource controlling the shooting environment (lighting, background, base images) |
| BackgroundPreset | Background image set within a SetDesign, with per-framing variants |
| SetBaseImage | Pre-generated subject image with correct lighting/background from a SetDesign, used as VTO source |
| SetReferenceImage | Source image that controlled SetDesign generation in external tools (tracking only) |
| Shot | Single deliverable image for a specific shot type |
| Shot Type | Definition of framing and view angle for an image |
| Revision | Version of a shot with associated images |
| Style | Visual aesthetic applied to generations |
| Generation | AI task that produces content |
| Prediction | Single output (image/video) from a generation |
| MediaResource | Central content-addressable file tracking entity for all platform media. See MediaResource Lifecycle |
| GPS | Generative Production System — Sartiq's core platform concept |
| SKU | Stock Keeping Unit — unique product identifier |
| Seed | Random number controlling AI generation reproducibility |