This repository contains the design specifications, build plans, research, and open questions for the Pretec B2B commerce platform being delivered by Geta.
| Document | What it covers |
|---|---|
| Specification Roadmap & Index | Start here — master index of every integration/service/capability and which specs exist vs. still need writing |
| Commerce Platform Overview | Top-level spec: systems, responsibilities, data flows, all capabilities |
| Pretec Service API | Sub-spec for the Geta-built .NET service (Price, Cart, Quote, Orders) |
| Customer Overview Specification | Customer-facing Phase 1 overview: scope, user experience, systems, responsibilities, open decisions |
| Product Integration Specification | Product/category flow from RamBase to Struct using Mosaik Harmony |
| Document | What it covers |
|---|---|
| Service API — Build Phase Plan | Task-by-task build plan for the Pretec Service API with assumptions register |
| Service API — API Discovery Plan | Discovery plan for RamBase and Mosaik API contract research |
| Document | What it covers |
|---|---|
| Mosaik Platform Contracts | Mosaik API contract shapes the Service API must mirror |
| RamBase API Audit | Findings from auditing the RamBase API (auth, endpoints, pagination, orders) |
| Service API Decisions | Key technical decisions: cart schema, Cognito model, Istio routing, resilience |
| Document | What it covers |
|---|---|
| Team Requirements — Phase 1 | Developer profiles needed for Phase 1 (Frontend, Backend, Platform/DevOps) |
| Open Questions for Pretec | Outstanding questions Pretec must answer; resolved items marked |
| Customer Questions | Additional questions from customer sessions |
docs/service-overview v4.png— current architecture diagram (v4)
Delivery team: Geta — builds the Storefront customization, Pretec Service API, Harmony sync configuration, and all integrations.
Platform: Mosaik — provides Harmony (sync engine), Storefront starterkit (Next.js/React), and Maestro (backoffice). Consumed as a SaaS platform.
Source systems:
- RamBase — ERP; source of truth for products, pricing, inventory, customers, orders
- Struct — PIM; product enrichment and assets
- Sanity — headless CMS; editorial content
Key custom build: The Pretec Service API (.NET 10, ASP.NET Core) wraps RamBase and exposes live Price, Cart, Quote, and Order operations to the Storefront — mirroring Mosaik's standard API contracts so the starterkit can be reused without forking.
Environments: test, staging/UAT, production (three only — staging doubles as UAT).