Skip to content

Obsidian757/bobabot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ§‹ BobaBot - AI-Powered Franchise Automation Platform

Intelligent customer loyalty, operations management, and marketing automation for Boba Tea franchises in Southeast Asia.


🎯 Mission

Transform traditional franchise operations into AI-driven, data-centric businesses that maximize customer lifetime value, operational efficiency, and revenue growth.


πŸ—οΈ System Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                     CUSTOMER INTERFACE                       β”‚
β”‚  QR Code β†’ Mobile Web App β†’ Sign-up/Order/Loyalty          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    BOBABOT CORE AGENT                        β”‚
β”‚                                                              β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”‚
β”‚  β”‚  Customer Data Manager                              β”‚    β”‚
β”‚  β”‚  β€’ Profile capture & storage                       β”‚    β”‚
β”‚  β”‚  β€’ Purchase history tracking                       β”‚    β”‚
β”‚  β”‚  β€’ Loyalty points calculation                      β”‚    β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
β”‚                                                              β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”‚
β”‚  β”‚  Marketing Automation Engine (AI-Powered)          β”‚    β”‚
β”‚  β”‚  β€’ Behavioral analysis (Vertex AI/OpenRouter)      β”‚    β”‚
β”‚  β”‚  β€’ Personalized message generation                 β”‚    β”‚
β”‚  β”‚  β€’ Automated campaign triggers                     β”‚    β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
β”‚                                                              β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”‚
β”‚  β”‚  Operations Manager                                 β”‚    β”‚
β”‚  β”‚  β€’ Inventory tracking                               β”‚    β”‚
β”‚  β”‚  β€’ Sales analytics & reporting                     β”‚    β”‚
β”‚  β”‚  β€’ Demand prediction (AI)                          β”‚    β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                   INTEGRATION LAYER                          β”‚
β”‚                  (Zapier MCP Orchestration)                  β”‚
β”‚                                                              β”‚
β”‚  β€’ Google Sheets (Customer DB, Sales Data)                  β”‚
β”‚  β€’ Vertex AI (Predictions, Sentiment, Content)              β”‚
β”‚  β€’ OpenRouter (Multi-model AI routing)                      β”‚
β”‚  β€’ Canva (Marketing materials generation)                   β”‚
β”‚  β€’ Gmail (Email communications)                             β”‚
β”‚  β€’ Airtable (CRM & franchise management)                    β”‚
β”‚  β€’ Notion (Documentation & SOPs)                            β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸš€ Core Features

1. Customer Data Capture

  • QR code-based sign-up system
  • Social login integration (Zalo, phone, email)
  • Automatic profile creation
  • Purchase history tracking

2. AI-Powered Marketing Automation

  • "We Miss You" Campaign: Auto-triggers when customer inactive 30+ days
  • Birthday Rewards: Automatic special offers on birthdays
  • Personalized Recommendations: AI suggests products based on history
  • TikTok Integration: Track ROI from social media campaigns
  • Sentiment Analysis: Monitor customer satisfaction in real-time

3. Operations Intelligence

  • Real-time inventory tracking
  • Automated sales reporting (daily/weekly/monthly)
  • Demand forecasting using AI
  • Stock reorder alerts
  • Multi-location analytics

4. Content Generation

  • AI-generated marketing copy (Vietnamese/English)
  • Automatic promotional materials via Canva
  • Social media content creation
  • Email campaign generation

πŸ’» Technology Stack

Frontend

  • Framework: React + Vite
  • Styling: Tailwind CSS
  • Mobile-First: Progressive Web App (PWA)
  • QR Integration: HTML5 QR Code Scanner

Backend

  • Runtime: Node.js
  • Deployment: Cloudflare Workers (edge computing)
  • Database: Google Sheets (pilot), Cloudflare D1 (production)
  • API: RESTful + Webhooks

AI & Integrations

  • Primary AI: Google Vertex AI (via Zapier MCP)
  • Secondary AI: OpenRouter (Claude, GPT-4, Gemini)
  • Automation: Zapier MCP (111 tools available)
  • Design: Canva API
  • Communication: Gmail API

πŸ“Š Key Performance Indicators (KPIs)

Customer Metrics

  • Adoption Rate: % of customers joining loyalty program
  • Visit Frequency: Average visits per month (loyalty vs. non-loyalty)
  • Retention Rate: % of customers returning within 30 days
  • Lifetime Value: Average revenue per customer

Marketing Metrics

  • Campaign Redemption Rate: % of offers redeemed
  • Sentiment Score: Average customer satisfaction (AI-analyzed)
  • Engagement Rate: % of customers responding to campaigns

Operational Metrics

  • Time Saved: Hours saved on manual reporting
  • Inventory Accuracy: % reduction in stockouts/waste
  • Revenue Lift: % increase in sales vs. baseline

🎯 Pilot Program (3 Months)

Phase 1: Setup (Month 1)

  • Deploy system to 2-3 pilot stores
  • Train staff on customer sign-up process
  • Configure initial marketing campaigns
  • Set up data collection

Phase 2: Live Operation (Month 2-3)

  • Monitor customer adoption
  • Track campaign performance
  • Gather feedback from staff and customers
  • Iterate on features

Phase 3: Measurement & Reporting

  • Generate comprehensive KPI report
  • Create investor presentation
  • Prepare for scale-up to 100+ franchises

πŸ’° Pilot Program Budget: $25,000

Category Amount Details
Development $10,000 Backend developer (Upwork, 2 months)
Infrastructure $4,500 Cloud hosting, APIs, hardware
Marketing $6,000 Materials, incentives, logistics
Contingency $4,500 Buffer for unexpected costs

πŸ“ˆ Scale-Up Economics (100 Franchises)

Revenue Potential

  • Per-Store Revenue Lift: 15-25% (industry benchmark)
  • Average Store Revenue: $50,000/month
  • Total Monthly Revenue: $5,000,000
  • Incremental Revenue: $750,000 - $1,250,000/month

Operating Costs

  • Platform Costs: $388/month (all 100 stores)
  • Cost per Store: $3.88/month
  • ROI: 3,000%+

πŸ” Data Privacy & Security

  • GDPR Compliant: Customer data handling
  • Encrypted Storage: All sensitive data encrypted
  • Access Control: Role-based permissions
  • Audit Logs: Complete activity tracking

🌍 Localization

  • Primary Language: Vietnamese
  • Secondary Language: English
  • Currency: Vietnamese Dong (VND)
  • Payment Integration: Local payment gateways

πŸ“ž Support & Maintenance

  • 24/7 Monitoring: Automated system health checks
  • WhatsApp Support: Dedicated support channel for staff
  • Monthly Updates: Feature releases and improvements
  • Training Materials: Video tutorials (HeyGen AI-generated)

πŸš€ Future Roadmap

Phase 1 (Months 1-3): Pilot

  • Core features deployment
  • Data collection
  • KPI validation

Phase 2 (Months 4-6): Scale

  • Expand to 20 franchises
  • Add advanced analytics
  • Integrate payment processing

Phase 3 (Months 7-12): Platform

  • Open to external franchises
  • White-label options
  • API marketplace

Phase 4 (Year 2+): Ecosystem

  • Multi-brand support
  • Regional expansion (Thailand, Philippines, Indonesia)
  • Franchise management SaaS platform

πŸ“„ License

Proprietary - 12th House AI


πŸ‘₯ Team

Built by: Manus AI Agent Company: 12th House AI Mission: "Seeing the Unseen: AI Agents for Automation, Compliance, and Growth"


πŸ“§ Contact

For inquiries about BobaBot or franchise partnerships, contact 12th House AI.


Version: 1.0.0-alpha Last Updated: November 14, 2025

About

AI-Powered Franchise Automation Platform for Boba Tea franchises in Southeast Asia

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages