Project Structure¶

vectis/
├── backend/              # Python FastAPI application
│   ├── vectis/
│   │   ├── core/         # App factory, config, middleware, strategy, events, database
│   │   ├── modules/      # ~40 domain modules (see below)
│   │   ├── extensions/   # ~45 ext_* packages (payment, shipping, fraud, storage, email, AI, etc.)
│   │   ├── events/       # Redpanda producer/consumer, JSON Schema registry
│   │   └── worker.py     # Temporal worker entry point
│   ├── alembic/          # Database migrations
│   ├── Dockerfile / Dockerfile.prod  # Dev + multi-stage production images
│   └── tests/            # pytest test suite (~1,670 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/              # check_resolver_redefs.py, check_no_core_extension_imports.py, sync_admin_extensions.py, backup_postgres.sh, verify_backup_restore.py
├── docker-compose.yml    # Full development environment (incl. Prometheus + Grafana)
├── docker-compose.prod.yml
└── Makefile              # `make check` runs the full local gate (~25s)

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)