Vectis Commerce Platform¶
Vectis is a B2B-first headless commerce platform built with Python (FastAPI), SvelteKit, PostgreSQL, Redpanda, and Temporal. It replaces a legacy WooCommerce stack with a purpose-built system for wholesale and hybrid B2B/B2C commerce.
Key Capabilities¶
- B2B + B2C in one platform — channel-based commerce modes (wholesale, retail, hybrid)
- Five-level pricing — managed prices, location, account, group, and default tiers with multi-currency support
- Configurable order state machine — transitions, guards, and side-effects defined per deployment
- Extension system — strategy-mediated business logic with channel-scoped activation
- Event-driven architecture — in-process EventBus + Redpanda for inter-service communication
- Durable workflows — Temporal for order lifecycle, recurring orders, approvals, and all background tasks
Quick Links¶
| I want to... | Go to... |
|---|---|
| Set up a local dev environment | Quick Start |
| Understand the architecture | Architecture |
| Add a backend module | Modules Guide |
| Build an extension | Extensions Guide |
| Work with the GraphQL API | API Overview |
| Understand the order flow | Orders |
| Set up pricing and currencies | Pricing |
| Deploy to production | Deployment |
Tech Stack¶
| Layer | Technology |
|---|---|
| Backend API | Python 3.12, FastAPI, SQLAlchemy 2.0 (async), Strawberry GraphQL |
| Storefront | SvelteKit 2, Tailwind CSS, Lucide icons |
| Admin Panel | SvelteKit 2, Tailwind CSS, Lucide icons |
| Database | PostgreSQL 16 |
| Cache / Sessions | Redis 7 |
| Event Streaming | Redpanda (Kafka-compatible) |
| Workflows | Temporal |
| Search | Meilisearch |
| Object Storage | S3-compatible (MinIO in dev) |
Project Status¶
The platform is in active development. All 14 strategy interfaces are implemented, 26 core modules are built, and the end-to-end checkout pipeline (tax, shipping, payment, promotions) is wired.