Welcome
SynapseAI B2B Wholesale Platform Documentation
SynapseAI B2B Wholesale Platform
Welcome to the comprehensive documentation for SynapseAI - an AI-powered B2B wholesale commerce platform. This documentation uses FlavorFlux, a fictional adaptive CPG brand, as the example use case to demonstrate the platform's capabilities.
🚀 Quick Navigation
Getting Started
Getting Started
Quick start guide and project overview
Backend Setup
Configure and run the FastAPI backend
Frontend Setup
Build and deploy the React frontend
Deployment
Deploy to AWS with Terraform
Understanding the System
Architecture
System design and technical overview
C4 Architecture
Detailed C4 model diagrams
User Scenarios
Personas, workflows, and AI impact
Scripts & Utilities
Maintenance and data sync tools
🎯 What is SynapseAI?
SynapseAI is an intelligent B2B wholesale commerce platform that powers conversational AI-driven ordering, inventory management, and campaign automation for CPG brands.
About FlavorFlux (Demo Brand)
FlavorFlux is our fictional demo brand - representing an adaptive CPG yogurt drink brand. Throughout this documentation, FlavorFlux serves as the example to showcase SynapseAI's capabilities.
Key Features
🤖 Conversational AI
- Natural language ordering
- Product search and recommendations
- Cart management through chat
- Multi-turn dialogue support
📊 AI-Powered Intelligence
- Demand forecasting with AWS Forecast
- Predictive reordering for inventory optimization
- Campaign template generation with Amazon Bedrock
- Community sentiment analysis
🛒 B2B Commerce
- Integration with Commercetools for products, carts, and orders
- Voucherify for promotions and loyalty programs
- Real-time inventory tracking
- Order history and reordering
🎯 Human-in-the-Loop
- Approval workflows for high-value orders
- Risk mitigation for unusual patterns
- Audit trails for compliance
- Notification systems
🏗️ SynapseAI Technology Stack
Backend
- FastAPI: High-performance Python web framework
- LangGraph: Stateful AI agent orchestration (SynapseAI core)
- LiteLLM: Multi-provider LLM interface
- Redis: Session and cache management
- MCP: Model Context Protocol for integrations
Frontend
- React 18: Modern UI library
- Vite: Lightning-fast build tool
- TanStack Router: Type-safe routing
- TanStack Query: Server state management
- Shadcn/ui: Beautiful component library
- Tailwind CSS: Utility-first styling
Infrastructure
- AWS ECS Fargate: Serverless containers
- AWS ALB: Load balancing
- AWS ElastiCache: Redis cluster
- AWS ECR: Container registry
- Terraform: Infrastructure as Code
External Services
- Commercetools: E-commerce platform
- Voucherify: Promotions engine
- AWS Bedrock: AI foundation models
- AWS Forecast: Demand prediction
📖 Documentation Structure
Setup Guides
- Getting Started - Overview and quick start
- Backend Setup - Backend installation and configuration
- Frontend Setup - Frontend development guide
- Deployment - Production deployment with Terraform
Architecture & Design
- Architecture - High-level system architecture
- C4 Architecture - Detailed C4 model diagrams
- User Scenarios - User personas and workflows
Tools & Utilities
- Scripts - Maintenance scripts and utilities
🎯 User Personas
🥇 Sarah - Store Representative
Goal: Maintain optimal inventory levels and prevent stockouts
AI Enhancement: Predictive reordering reduces stockouts by 40% and improves inventory turnover by 30%
🥈 Daniel - B2B Retail Buyer
Goal: Secure trending products with optimal quantities and pricing
AI Enhancement: Demand forecasting reduces obsolete inventory by 35% and improves sell-through by 25%
🥉 Emily - B2B Admin
Goal: Configure effective trade promotions quickly and accurately
AI Enhancement: Campaign template AI reduces setup time by 60% and increases engagement by 30%
🚦 Getting Started
Ready to dive in? Here's the recommended path:
- Start with Getting Started - Understand the project and set up your environment
- Follow Backend Setup - Get the backend running locally
- Set up the Frontend - Build and run the user interface
- Review Architecture - Understand how everything fits together
- Explore User Scenarios - See the platform in action
- Deploy with Deployment Guide - Take it to production
📊 SynapseAI System Overview
🤝 Contributing
This is an internal project. For questions or contributions, please contact the development team.
📝 License
Proprietary - All rights reserved.
🔗 Quick Links
📞 Support
For technical support or questions:
- Email: support@synapseai.com
- Slack: #synapseai-support
- Issue Tracker: GitHub Issues
Platform: SynapseAI v1.0.0
Demo Brand: FlavorFlux
Last Updated: November 2024