Apollo 2 — Generic Recommendation Engine (2026–Present)
A domain-agnostic recommendation chatbot powered by FastAPI and Next.js. Swap a catalog JSON and adapter to recommend any item type — credit cards, retail products, or services.
Architecture
- Backend: FastAPI + Pydantic v2 — generic
CatalogItemmodel with pluggable domain adapters, scoring weights, and router patterns - Frontend: Next.js 15 + Tailwind CSS v4 — theme, labels, and display fields driven by domain configuration
- Adapters: One file per domain handles catalog ingestion and field mapping
Key Design Decisions
- Domain-agnostic core: The engine has no hardcoded knowledge of any specific domain; all domain specifics live in adapter + config files
- Pluggable catalog: Add a new domain by writing one adapter file, one catalog JSON, and one config — no engine changes required
- Production-oriented patterns: Structured endpoints, operations orchestration, and environment-based configuration