How kenshincommits/fizzy works
Fizzi combines a 3D storefront, an admin CRM, and an Express/MongoDB API. The customer journey runs from browsing and behavioral events through lead scoring and pipeline updates; shoppers can also talk with Fulky, whose Retell webhook feeds CRM updates. Admin users inspect and manage customers, leads, orders, and analytics. The README documents the major capabilities and end-to-end flow; sampled source confirms selected UI, controller, and service relationships, while many subsystem details remain unsampled.
Main entry points: page.tsx Shop and pages · app.ts REST API · scoringService.ts Lead scoring · Lead.ts MongoDB records
Components 28
Storefront
- Shop and pages
src/app/shop/page.tsx - 3D landing experience
src/app/page.tsx - Page slices
src/slices/Carousel/index.tsx - 3D product view
src/components/Product3D.tsx - Fulky voice assistant
src/components/FulkyVoiceAssistant.tsx - Login and signup
src/app/login/page.tsx - Session helpers
src/lib/auth.ts - Prismic content client
src/prismicio.ts
Admin CRM
- CRM workspace
admin/src/App.tsx - CRM pages
admin/src/pages - Customer profiles
admin/src/components/CustomerProfile.tsx - CRM state
admin/src/lib/store.tsx - API client
admin/src/lib/api.ts
Backend API
- REST API
backend/src/app.ts - Admin routes
backend/src/routes/adminRoutes.ts - Admin handlers
backend/src/controllers/adminController.ts - Agent handlers
backend/src/controllers/agentController.ts - Retell integration
backend/src/integrations/retell/retellService.ts - Retell webhook
backend/src/webhooks/retellWebhook.ts - Live updates
backend/src/realtime/socketManager.ts - MongoDB records
backend/src/models/Lead.ts
Lead Intelligence
- Event processing
backend/src/services/eventProcessingService.ts - Lead scoring
backend/src/services/scoringService.ts - Behavior analysis
backend/src/services/behaviorService.ts - Pipeline stages
backend/src/services/pipelineService.ts
Other components
- Shopper
- CRM administrator
- Retell AI
Connections 31
- Shopper → Shop and pages: browses
README.md - Shopper → 3D landing experience: views
README.md - 3D landing experience → Page slices: renders
src/app/page.tsx - Shop and pages → 3D product view: renders
src/app/shop/page.tsx - Shop and pages → Fulky voice assistant: offers
README.md - Shopper → Login and signup: authenticates
README.md - Login and signup → Session helpers: stores session
src/app/login/page.tsx - 3D landing experience → Prismic content client: loads content
src/app/page.tsx - Shop and pages → REST API: sends events
README.md - Fulky voice assistant → REST API: requests call
README.md - REST API → Retell AI: proxies call
README.md - Retell AI → Retell webhook: posts transcript
README.md - Retell webhook → MongoDB records: updates records
README.md - Retell webhook → Live updates: broadcasts update
README.md - Shop and pages → Event processing: emits behavior events
README.md - Event processing → Lead scoring: scores events
README.md - Lead scoring → MongoDB records: updates lead
- Pipeline stages → MongoDB records: reads and saves lead
backend/src/services/pipelineService.ts - Lead scoring → Pipeline stages: advances stage
- Agent handlers → Behavior analysis: calculates behavior
backend/src/controllers/agentController.ts - Agent handlers → Retell integration: initiates calls
backend/src/controllers/agentController.ts - CRM administrator → CRM workspace: manages CRM
README.md - CRM workspace → CRM pages: routes pages
admin/src/App.tsx - CRM workspace → Customer profiles: opens profile
admin/src/App.tsx - CRM pages → CRM state: reads and updates
admin/src/pages/Pipeline.tsx - CRM state → API client: loads and mutates data
admin/src/lib/store.tsx - API client → REST API: calls REST API
README.md - REST API → Admin routes: mounts routes
- Admin routes → Admin handlers: dispatches handlers
backend/src/routes/adminRoutes.ts - Admin handlers → MongoDB records: reads and writes records
backend/src/controllers/adminController.ts - Admin handlers → Lead scoring: manages scoring rules
backend/src/controllers/adminController.ts