How Sponti is structured
Sponti has a clear entity model. Understanding how each piece relates to the others makes the whole system intuitive to navigate.
The big picture
The chain at a glance
Everything in Sponti flows in a simple hierarchy:
A Business is your storefront. It has one or more Venues (physical locations). You build a Product catalog (reusable templates), and publish Deals from those products at specific venues.
Supporting this are two more entities: the Account (your Stripe payout connection) and your Team (the people who manage the business with you).
Relationships
One business, many things
Each business is the root of its own world. Here is exactly how many of each entity a business can have:
A business can have one venue or many โ each a separate physical location.
A business can list as many products as it offers. Each is a reusable template.
Each business has exactly one Stripe payout account. This is strict.
A business has one Admin and any number of Co-admins, Managers, and Members.
Deals are created from products. A business publishes as many deals as it has capacity for.
๐ก Tip
The entities
Each entity explained
Business
Your storefront on Sponti
The Business is the top-level entity. It represents your brand or company โ what customers see and recognize. It holds your display name, logo, gallery, support contacts, and category. A user can create multiple businesses. A business must be verified before its deals are visible to customers.
Venue
Where the deal takes place
A Venue is a physical location under your business โ a branch, shop, studio, restaurant table, hotel, or event space. Venues carry a name, address (set by map pin), country, state, and timezone. The timezone is used to resolve deal timing โ customers see local times, not UTC. One Business can have multiple Venues.
Product
The reusable deal template
A Product is a template for a deal โ a haircut, a yoga class, a room type, a dinner menu, a mystery box. You create products once in your catalog, then publish deals from them at any time. Products define the deal type (appointment, walk-in, ticket, pickup, or stay), the title, cover image, and service configuration.
Deal
What customers actually book
A Deal is a time-limited, discounted offer published from a Product at a specific Venue. Deals are created by opening a product in your catalog and tapping 'Create deal' on it โ not from a standalone screen. Each deal has a start time, end time, original price, deal price, and availability count. When a customer books, the slot count decreases by one. Once the count reaches zero or the window closes, the deal ends.
Account
Your Stripe payout connection
The Account is the payout entity โ your Stripe Connect account linked to this business. It handles all payments and payouts. A business has exactly one account (1:1 relationship). Without a connected account, deals from this business cannot be published. Account statuses: missing, setup, pending, connected, rejected. Only Admin and Co-admin can manage the account.
Team
The people who run the business
A Team is the set of users with access to a business. Each member has one of four roles: Admin (full access), Co-admin (same as Admin, for co-owners), Manager (can manage deals and catalog, no payout access), or Member (view and limited operational access). Invitations are sent and accepted through the Sponti app.
How they connect
Entity relationships
To publish a deal, these relationships must exist:
๐ก Tip