AI Tutor Bot Requirements for EnglishGang.com
Budget: $3,000 – $5,000 USD
1. Overview
The AI tutor bot is a standalone web-based application for www.englishgang.com, accessible via a dedicated login button on the WordPress homepage (e.g., bot.englishgang.com). It assists Thai students (ages 8-45, beginner to intermediate English levels) in learning English through personalized, voice-based interactions, integrating with ~1,000 PDF lessons stored in Google Drive. The bot supports role-playing, real-time corrections, gamification (daily streaks, avatar customization), and a subscription model with a 3-day free trial using Stripe (THB support). It operates independently of the existing CodeIgniter portal, with its own database and authentication system, supporting mobile, desktop, and tablet devices. Budget: ~$5,000-5,200 USD. Timeline: 2-3 months.
2. Functional Requirements
2.1 User Onboarding and Teacher Creation
Access: A "Join AI Tutor!" button on the WordPress homepage links to the bot’s login/signup page (e.g., bot.englishgang.com/login). No integration with WordPress/CodeIgniter user systems; bot uses independent authentication.
Welcome Screen: Post-signup/trial, display an animated "Build Your Teacher!" page with Thai-friendly aesthetics (e.g., kawaii-style, confetti effects). Features:
Choose bot gender (male: Teacher Sam; female: Teacher Jenny).
Select name from 3-5 Thai-inspired options (e.g., Teacher Aom, Teacher Chai) or custom input.
Pick avatar looks: 3 hair colors/styles, 2 skin tones. Budget: ~$800.
Explain rewards: "Study daily to earn swag like hats for your teacher!"
Student Profile: Collect data via signup (age, English level, optional goals/hobbies). Teachers upload student summary (personality, goals like "pass TOEIC") via admin panel text box, updatable as needed.
2.2 Lesson Interaction
PDF Integration: Bot extracts text from ~1,000 PDF lessons (Google Drive, accessed via links) using pdfplumber. Displays PDF side-by-side with bot avatar in split-screen (React-based UI). Bot controls scrolling but allows student requests (e.g., "Go back to page 3") to clarify sections.
Summarizes sections (e.g., "This is about family—key words: mother, father").
Beginner levels: "Repeat after me" style (e.g., "Say: Hello!").
Intermediate/advanced: Conversational, with advanced classes featuring monologues on topics (e.g., foods, mobile phones, healthy lifestyles). Bot provides feedback post-monologue (strengths, improvements), allows retry.
Session Recording: Text transcripts of each session saved to Google Drive (student-specific folder). Audio (MP3, 128kbps) recorded for 100 users × 1 hr/day (~7.2 GB/month, compressed). If storage exceeds budget, prioritize text.
Teacher Videos: MP4s (Google Drive links) transcribed (e.g., Whisper, ~$200) to inform bot’s teaching style (tone, pacing). Not shown in-class.
2.3 Voice Interaction
Speech-to-Text/Text-to-Speech: Uses Google Cloud Speech/AssemblyAI for recognition, ElevenLabs for TTS (Thai/English). Thai for explanations (except English vocab, e.g., "She PLAYSSS with the dog"). If student says "I don’t know" twice, explain in Thai, confirm understanding, then resume English.
Corrections: Real-time, max 2/min:
Kids: Correct major errors blocking understanding (e.g., "I go yesterday" → "Great try! Say 'I went yesterday'").
Adults: Correct grammar (e.g., "She play" → "It’s 'She PLAYSSS'—try it!") and pronunciation (if 95% confident via speech recognition, e.g., missing 's' on verbs).
Idle Handling: Check every 3 min ("Let's keep learning together! Are you there?"). At 9 min: "You’ve been idle for almost 10 minutes. I’ll leave in 60 seconds if I don’t hear you." End after 10 min idle, save progress.
2.4 Role-Playing
Kids: Bot leads, starting simple (e.g., "We’re at the park—introduce yourself!"), progressing to complex (e.g., "Order ice cream"). 2-3 min, 30-sec debrief ("What words did you use?"). Offer repeat ("Fun? Let’s do another!").
Adults: Bot suggests lesson-tied scenarios (e.g., "Let’s order food, or suggest your own!") or adapts user input (e.g., "job interview"). Topics: Bangkok traffic, Thai food, likes/dislikes.
Off-Topic: Relate to lesson (e.g., "Pizza is a fun word—let’s use it in our restaurant role-play!"). After 20 sec, redirect (e.g., "That’s interesting! Let’s focus on the lesson to improve your English."). If persistent, firm redirect: "We must get back to the lesson—learning English is key for your goals!"
Frequency: Trigger after ~50% lesson progress or student request.
2.5 Feedback
Post-Session Feedback: 1-min MP4 video (avatar speaking, English top/Thai bottom subtitles) covering strengths (e.g., "Great job with new vocab!") and improvements (e.g., "Try adding 's' to verbs like 'She plays'"). Stored in Google Drive (student folder, MP4/MP3 for Apple/Android compatibility).
2.6 Gamification
Daily Streaks: 10 min/day minimum. 1-day grace period; email if at risk ("Your streak ends tomorrow—log in for 10 min!").
Rewards: Day 1: Head accessory (hat/hairclip, 3 options). Day 2: Pants (3 options). Day 3: Shirt (3 options). Day 4+: Points (10 base +1/streak day; e.g., Day 5 = 11 pts). Items priced 5-100 pts (e.g., 5pt sticker, 100pt outfit). Display on avatar/dashboard. Budget: ~$800.
Avatar Customization: Students see updated teacher (e.g., Jenny with hat) in sessions/dashboard.
2.7 User Dashboard
Displays: Bot avatar (updates if gender switched), name (Jenny/Sam), daily streak counter, lessons completed, Google Drive feedback links. Modular React code for future additions.
2.8 Payments and Subscriptions
Stripe Integration: THB support, credit cards/Thai banks. 3-day free trial, auto-converts to paid (admin can adjust manually). Promo codes: 25%, 50%, 100% off first month. Auto-end trial if unsubscribed, notify via email.
Email Sequence: Via SendGrid (existing plan, ~100 emails/day free tier):
Day 1: Welcome, tips for bot use.
Day 2: Encourage role-play, highlight rewards.
Day 3: Nudge to subscribe ("Trial ends today—join now!").
2.9 Student Learning Adaptation
Stores: Hobbies, likes/dislikes, activities, pets, grammar errors (e.g., missing 's'), pronunciation issues. References in fun way (e.g., "You love soccer—let’s role-play a game commentary!").
Rule-based adaptation: Kids (more repeats if struggling); adults (focus corrections on repeat errors). Future ML possible if budget expands.
3. Non-Functional Requirements
Devices: Mobile, desktop, tablet (Chrome/Safari, microphone/camera access). Optimize UI (e.g., larger mobile buttons).
Performance: Handle 100 users × 1 hr/day. Text storage: ~MBs/month. Audio: ~7.2 GB/month (compressed MP3). Video: ~1-2 GB/month (MP4).
Privacy: Thailand PDPA-compliant (Google Drive storage, separate database).
Scalability: Modular React/Node.js for future features.
Accessibility: Bilingual subtitles, clear voice prompts for young users.
4. Technical Stack
Framework: React (frontend) + Node.js (backend) with Express, deployed on subdomain (e.g., bot.englishgang.com).
Authentication: Firebase Auth or JWT (email/password, Google SSO). Independent from WordPress/CodeIgniter.
Frontend: React for UI (PDF split-screen, avatar animations, dashboard). PDF.js for PDF rendering, WebRTC for voice.
Backend: Node.js for logic, MongoDB for profiles, streaks, rewards, session data.
AI/Voice: Google Cloud Speech/AssemblyAI for speech-to-text, ElevenLabs for TTS (Thai/English).
PDF Extraction: pdfplumber for text, PDF.js for display.
Payments/Emails: Stripe API (THB), SendGrid API (existing plan).
Storage: Google Drive API for feedback (MP4/MP3), transcripts, audio (~7.2 GB/month for 100 users).
Video Analysis: Optional transcription (Whisper) for teacher MP4s to inform bot style (~$200, include if budget allows).
Hosting: DigitalOcean/AWS (~$10-20/month), SSL via Let’s Encrypt.
WordPress Integration: Add "Join AI Tutor!" button on homepage (custom link to bot login).
5. Budget Breakdown
Core (voice, PDF, role-play): ~$2,600
Dashboard, subscriptions, emails: ~$1,000
Gamification (streaks, rewards): ~$800
Avatar creation (basic, 3 options each): ~$800
Feedback videos (MP4, subtitles): ~$400
Hosting/auth setup: ~$400
Total: No more than $5,000
6. Timeline
Month 1: Voice interaction, PDF integration, basic UI, hosting setup.
Month 2: Dashboard, payments, gamification, emails.
Month 3: Role-plays, feedback videos, testing/polish.
Hiring: Freelancer.com/Fiverr, seek React/Node.js + WebRTC/PDF.js experience.
7. Success Metrics
Retention rate, lesson completion rate, user feedback surveys, average session length, correction frequency (to track improvement).
The AI tutor bot is a standalone web-based application for www.englishgang.com, accessible via a dedicated login button on the WordPress homepage (e.g., bot.englishgang.com). It assists Thai students (ages 8-45, beginner to intermediate English levels) in learning English through personalized, voice-based interactions, integrating with ~1,000 PDF lessons stored in Google Drive. The bot supports role-playing, real-time corrections, gamification (daily streaks, avatar customization), and a subscription model with a 3-day free trial using Stripe (THB support). It operates independently of the existing CodeIgniter portal, with its own database and authentication system, supporting mobile, desktop, and tablet devices. Budget: ~$5,000-5,200 USD. Timeline: 2-3 months.
2. Functional Requirements
2.1 User Onboarding and Teacher Creation
Access: A "Join AI Tutor!" button on the WordPress homepage links to the bot’s login/signup page (e.g., bot.englishgang.com/login). No integration with WordPress/CodeIgniter user systems; bot uses independent authentication.
Welcome Screen: Post-signup/trial, display an animated "Build Your Teacher!" page with Thai-friendly aesthetics (e.g., kawaii-style, confetti effects). Features:
Choose bot gender (male: Teacher Sam; female: Teacher Jenny).
Select name from 3-5 Thai-inspired options (e.g., Teacher Aom, Teacher Chai) or custom input.
Pick avatar looks: 3 hair colors/styles, 2 skin tones. Budget: ~$800.
Explain rewards: "Study daily to earn swag like hats for your teacher!"
Student Profile: Collect data via signup (age, English level, optional goals/hobbies). Teachers upload student summary (personality, goals like "pass TOEIC") via admin panel text box, updatable as needed.
2.2 Lesson Interaction
PDF Integration: Bot extracts text from ~1,000 PDF lessons (Google Drive, accessed via links) using pdfplumber. Displays PDF side-by-side with bot avatar in split-screen (React-based UI). Bot controls scrolling but allows student requests (e.g., "Go back to page 3") to clarify sections.
Summarizes sections (e.g., "This is about family—key words: mother, father").
Beginner levels: "Repeat after me" style (e.g., "Say: Hello!").
Intermediate/advanced: Conversational, with advanced classes featuring monologues on topics (e.g., foods, mobile phones, healthy lifestyles). Bot provides feedback post-monologue (strengths, improvements), allows retry.
Session Recording: Text transcripts of each session saved to Google Drive (student-specific folder). Audio (MP3, 128kbps) recorded for 100 users × 1 hr/day (~7.2 GB/month, compressed). If storage exceeds budget, prioritize text.
Teacher Videos: MP4s (Google Drive links) transcribed (e.g., Whisper, ~$200) to inform bot’s teaching style (tone, pacing). Not shown in-class.
2.3 Voice Interaction
Speech-to-Text/Text-to-Speech: Uses Google Cloud Speech/AssemblyAI for recognition, ElevenLabs for TTS (Thai/English). Thai for explanations (except English vocab, e.g., "She PLAYSSS with the dog"). If student says "I don’t know" twice, explain in Thai, confirm understanding, then resume English.
Corrections: Real-time, max 2/min:
Kids: Correct major errors blocking understanding (e.g., "I go yesterday" → "Great try! Say 'I went yesterday'").
Adults: Correct grammar (e.g., "She play" → "It’s 'She PLAYSSS'—try it!") and pronunciation (if 95% confident via speech recognition, e.g., missing 's' on verbs).
Idle Handling: Check every 3 min ("Let's keep learning together! Are you there?"). At 9 min: "You’ve been idle for almost 10 minutes. I’ll leave in 60 seconds if I don’t hear you." End after 10 min idle, save progress.
2.4 Role-Playing
Kids: Bot leads, starting simple (e.g., "We’re at the park—introduce yourself!"), progressing to complex (e.g., "Order ice cream"). 2-3 min, 30-sec debrief ("What words did you use?"). Offer repeat ("Fun? Let’s do another!").
Adults: Bot suggests lesson-tied scenarios (e.g., "Let’s order food, or suggest your own!") or adapts user input (e.g., "job interview"). Topics: Bangkok traffic, Thai food, likes/dislikes.
Off-Topic: Relate to lesson (e.g., "Pizza is a fun word—let’s use it in our restaurant role-play!"). After 20 sec, redirect (e.g., "That’s interesting! Let’s focus on the lesson to improve your English."). If persistent, firm redirect: "We must get back to the lesson—learning English is key for your goals!"
Frequency: Trigger after ~50% lesson progress or student request.
2.5 Feedback
Post-Session Feedback: 1-min MP4 video (avatar speaking, English top/Thai bottom subtitles) covering strengths (e.g., "Great job with new vocab!") and improvements (e.g., "Try adding 's' to verbs like 'She plays'"). Stored in Google Drive (student folder, MP4/MP3 for Apple/Android compatibility).
2.6 Gamification
Daily Streaks: 10 min/day minimum. 1-day grace period; email if at risk ("Your streak ends tomorrow—log in for 10 min!").
Rewards: Day 1: Head accessory (hat/hairclip, 3 options). Day 2: Pants (3 options). Day 3: Shirt (3 options). Day 4+: Points (10 base +1/streak day; e.g., Day 5 = 11 pts). Items priced 5-100 pts (e.g., 5pt sticker, 100pt outfit). Display on avatar/dashboard. Budget: ~$800.
Avatar Customization: Students see updated teacher (e.g., Jenny with hat) in sessions/dashboard.
2.7 User Dashboard
Displays: Bot avatar (updates if gender switched), name (Jenny/Sam), daily streak counter, lessons completed, Google Drive feedback links. Modular React code for future additions.
2.8 Payments and Subscriptions
Stripe Integration: THB support, credit cards/Thai banks. 3-day free trial, auto-converts to paid (admin can adjust manually). Promo codes: 25%, 50%, 100% off first month. Auto-end trial if unsubscribed, notify via email.
Email Sequence: Via SendGrid (existing plan, ~100 emails/day free tier):
Day 1: Welcome, tips for bot use.
Day 2: Encourage role-play, highlight rewards.
Day 3: Nudge to subscribe ("Trial ends today—join now!").
2.9 Student Learning Adaptation
Stores: Hobbies, likes/dislikes, activities, pets, grammar errors (e.g., missing 's'), pronunciation issues. References in fun way (e.g., "You love soccer—let’s role-play a game commentary!").
Rule-based adaptation: Kids (more repeats if struggling); adults (focus corrections on repeat errors). Future ML possible if budget expands.
3. Non-Functional Requirements
Devices: Mobile, desktop, tablet (Chrome/Safari, microphone/camera access). Optimize UI (e.g., larger mobile buttons).
Performance: Handle 100 users × 1 hr/day. Text storage: ~MBs/month. Audio: ~7.2 GB/month (compressed MP3). Video: ~1-2 GB/month (MP4).
Privacy: Thailand PDPA-compliant (Google Drive storage, separate database).
Scalability: Modular React/Node.js for future features.
Accessibility: Bilingual subtitles, clear voice prompts for young users.
4. Technical Stack
Framework: React (frontend) + Node.js (backend) with Express, deployed on subdomain (e.g., bot.englishgang.com).
Authentication: Firebase Auth or JWT (email/password, Google SSO). Independent from WordPress/CodeIgniter.
Frontend: React for UI (PDF split-screen, avatar animations, dashboard). PDF.js for PDF rendering, WebRTC for voice.
Backend: Node.js for logic, MongoDB for profiles, streaks, rewards, session data.
AI/Voice: Google Cloud Speech/AssemblyAI for speech-to-text, ElevenLabs for TTS (Thai/English).
PDF Extraction: pdfplumber for text, PDF.js for display.
Payments/Emails: Stripe API (THB), SendGrid API (existing plan).
Storage: Google Drive API for feedback (MP4/MP3), transcripts, audio (~7.2 GB/month for 100 users).
Video Analysis: Optional transcription (Whisper) for teacher MP4s to inform bot style (~$200, include if budget allows).
Hosting: DigitalOcean/AWS (~$10-20/month), SSL via Let’s Encrypt.
WordPress Integration: Add "Join AI Tutor!" button on homepage (custom link to bot login).
5. Budget Breakdown
Core (voice, PDF, role-play): ~$2,600
Dashboard, subscriptions, emails: ~$1,000
Gamification (streaks, rewards): ~$800
Avatar creation (basic, 3 options each): ~$800
Feedback videos (MP4, subtitles): ~$400
Hosting/auth setup: ~$400
Total: No more than $5,000
6. Timeline
Month 1: Voice interaction, PDF integration, basic UI, hosting setup.
Month 2: Dashboard, payments, gamification, emails.
Month 3: Role-plays, feedback videos, testing/polish.
Hiring: Freelancer.com/Fiverr, seek React/Node.js + WebRTC/PDF.js experience.
7. Success Metrics
Retention rate, lesson completion rate, user feedback surveys, average session length, correction frequency (to track improvement).