Contract reference for the G3N Retail Stack: shared conventions (auth, pagination, errors), integration walkthroughs, and domain models, plus per-service surfaces with request/response shapes and OpenAPI links.
Use Start Here, Common, and the Stack Story to orient, then drill into each service page and MCP protocol to implement API Gateway and direct-Lambda workflows consistently.
The fastest onboarding path: reading order, critical invariants, and direct links to walkthroughs and the common contract.
Comprehensive, contract-only story of the stack: how services work, how they relate, and what is implemented vs pending.
Three end-to-end validation scenarios with detailed use cases, test bundles, and the latest QA results.
Full stack SOPs, objectives, operations inventory, and an expanded use-case catalog across all domains.
Quality assurance catalog: all tests, verbose use cases, super-usecase suites, and harness outcomes.
Shared conventions across services: envelope, build metadata, pagination, auth/context passthrough, error patterns, walkthroughs, and best practices.
Core identity, email verification, passcodes, and payment methods. Public stat via API Gateway `/uas/stat`; all other ops via direct Lambda/CLI.
Session issuance/validation with sliding TTL, per-user caps, sweeping/archival, and list/get/close surfaces under `/usm/session/*`.
Org spine, invitations, cost centres, facilities (physical/legal/logical), zones, owners/members/teams. Custom domain base path `/ofm/*`.
Opaque tenant-scoped object storage with inline JSON ≤256 KB and presigned uploads (gzip >256 KB, 128 MB cap), tags, TTL doom, and presigned downloads.
Org-scoped product/vendor metadata with suppliers, styles/variants/OGMs, identifiers/aliases/barcodes, comments (attachments), kits, and cross-sell links.
Publish-time stamping/control plane for projecting PVM variants into channel+facility-specific products with immutable revisions and an online pointer.
Inventory, stock movements, ownership/possession states, and warehouse operations at logical facility scope.
Temporal pricing, promotions, and price resolution by facility/channel with approval guardrails.
Sales orders, fulfillment, returns, backorders, and approvals tied to PMC sellability.
Procurement worksheets, POs, receiving, matching, and vendor workflows with PVM onboarding hooks.
Customer master, loyalty programs, earn/redeem policies, and engagement readiness.
Attribution models, earnings, holds/clawbacks, and payout readiness.
Accounting-ready export events and downstream integration support.
Event catalog, webhooks, CDC feeds, and bulk import/export for downstream integrations.
Owner-scoped event subscriptions delivered to customer-managed SQS queues.
Tenant offboarding: request, export window freeze, export, and purge with archival retention.