Project Structure¶

vectis/
├── backend/              # Python FastAPI application
│   ├── vectis/
│   │   ├── core/         # App factory, config, middleware, strategy, events, database
│   │   ├── modules/      # 53 domain modules (see below)
│   │   ├── extensions/   # Namespace anchor only (`__init__.py`) — extensions live in the sibling repo (see below)
│   │   ├── cli_ext.py    # `vectis ext lint` CLI — lints extension packages (e.g. the dev-linked enterprise-extensions checkout)
│   │   ├── events/       # Redpanda producer/consumer, JSON Schema registry
│   │   └── worker.py     # Temporal worker entry point
│   ├── vectis_sdk/       # Frozen import surface for extensions
│   ├── vectis_testkit/   # Test helpers for extension authors (linted by `make check`)
│   ├── alembic/          # Core database migrations (extensions ship their own chains)
│   ├── extensions.lock   # Install-set source of truth — `make lock-extensions`
│   ├── scripts/          # Gate + tooling scripts (see below)
│   ├── Dockerfile / Dockerfile.prod  # Dev + multi-stage production images
│   └── tests/            # pytest test suite (~2,260 tests)
├── admin/                # SvelteKit admin dashboard
│   └── src/
│       ├── lib/          # Components, help JSON, Houdini ops ($lib/houdini/), houdiniClient.ts
│       └── routes/       # ~40 admin routes (incl. refund-approvals, workflow-faults, affiliates, packaging)
├── storefront/           # SvelteKit B2B/B2C storefront
│   └── src/
│       ├── lib/          # Components, i18n, format, Houdini ops ($lib/houdini/), houdiniClient.ts
│       └── routes/       # Product pages, cart, checkout, account, affiliates portal
├── infra/                # grafana dashboards, prometheus config, deployment scripts
├── migrator/             # WooCommerce → Vectis data migration CLI
├── docs/                 # Internal runbooks: constitution, conventions, REDPANDA_TOPICS, DR_RUNBOOK, DEPLOYMENT_DIGITALOCEAN, CUSTOMER_ONBOARDING_PILOT, CACHING, EXTENSION_GUIDE
├── scripts/              # test.sh, verify_setup.sh (gate scripts live in backend/scripts/: check_resolver_redefs.py, check_no_core_extension_imports.py, check_extension_imports.py + extension_import_allowlist.json, check_core_migrations_ext_tables.py, check_model_drift.py, export_extensions_lock.py, sync_admin_extensions.py, backup_postgres.sh, verify_backup_restore.py)
├── docker-compose.yml    # Full development environment (incl. Prometheus + Grafana); mounts ../enterprise-extensions
├── docker-compose.prod.yml
└── Makefile              # `make check` runs the full local gate (~25s)
../enterprise-extensions/ # Sibling repo — all 48 ext_* packages (see Extensions below)

vectis/modules/{name}/
├── __init__.py
├── models.py        # SQLAlchemy ORM models
├── services.py      # Business logic (service layer)
├── resolvers.py     # Strawberry GraphQL resolvers
├── strategies.py    # ABC strategy interfaces (if applicable)
└── workflows.py     # Temporal workflows (if applicable)