Data model

Keystone lists grouped by authority, inventory, commerce and operations.

Every list is immutable through generic GraphQL. Writes use named commands.

Authority

ListPurpose
UserStaff login; status, onboardingStatus
RoleEleven can* flags
OrganizationLicensed business; jurisdictionCode, status
PremisesLicensed store; premisesCode, addressSnapshot, timezone, currencyCode
StorefrontSettingsPublic identity; unique per organization and premises
CannabisLicenseLicense number, type, authorizedActivities, dates
StaffCredentialallowedActivities, approvalLimitCents, dates
JurisdictionRulePackVersioned ages, hours, limits, tax, discounts, tenders, policies
Customer, EligibilityEvidenceBuyer and ID or registry check result

Inventory

ListPurpose
ProductMenu item
InventoryPackageTracked package: quantities in microunits, testStatus, COA, expiresAt, version
PackageHoldquarantine, test_hold, recall, discrepancy, authority, expiry
RegulatedManifestTransfer or receipt manifest
InventoryEventAppend-only custody ledger
RecallCaseSeven-stage recall

Commerce

ListPurpose
Register, RegisterShift, CashEventTills, sessions, drawer ledger
TenderConfiguration, PaymentProviderAccepted payments and adapters
Cart, CartLineReserved quantities
Sale, SaleLine, Tender, RefundReceipt and payments

Operations

AuditEvent, IdempotencyKey, OutboxEvent, StateEventInbox, IntegrationInstallation, ReconciliationRun, ComplianceIncident.

Quantities and money

Quantities are integer microunits. Money is integer minor units (cents). Currency must be a three-letter ISO 4217 code with two decimal places applies at onboarding.

On this page