Platform architecture

Phase 1 deliverables. The full documents live in the repository under docs/.

• System architecture

  Components, responsibilities and integration boundaries.

  docs/01-architecture.md

• Source-of-truth matrix

  Which system owns which data, and the snapshot rule.

  docs/02-source-of-truth.md

• Route map

  Public, portal, admin and server endpoints.

  docs/03-route-map.md

• Database domain plan

  Nine Supabase domains and their invariants.

  docs/04-database-domain-plan.md

• RLS access matrix

  Roles, per-table access and enforcement rules.

  docs/05-rls-access-matrix.md

• Supplier imports

  Transports, pipeline, idempotency, adapter shape.

  docs/06-supplier-import-architecture.md

• Product enrichment

  Provider adapter, provenance, licence constraints.

  docs/07-enrichment-architecture.md

• Shopify boundaries

  Publication and order directions, prohibited patterns.

  docs/08-shopify-boundaries.md

• Repair workflow

  Lifecycle, quote versioning, payment boundary.

  docs/09-repair-workflow-boundaries.md

• Environments and secrets

  Variables, secret names, rotation.

  docs/10-environments-and-secrets.md

• Staging and production

  Environments, promotion flow, release checklist.

  docs/11-staging-and-production.md

• Backup and rollback

  Recovery targets and rollback layers.

  docs/12-backup-and-rollback.md

• Phased roadmap

  Fifteen phases with exit criteria.

  docs/13-roadmap.md

• Repository structure

  Folder layout and code conventions.

  docs/14-repository-structure.md

No database schema, supplier connection, Shopify credential or payment configuration exists yet. Phase 2 begins only on approval.