​

AI Coach

​

What It Does

• Daily and weekly planning
• Study strategies for specific subjects
• Motivation and mindset coaching
• Time management optimization
• Recovery and break recommendations

​

Why It Matters

• Balancing competing demands (training vs studying)
• Energy management across physical and mental tasks
• Variable schedules with competitions and travel
• Isolation from typical academic support systems
• Time constraints that make traditional tutoring difficult

• Being available 24/7 whenever you need guidance
• Understanding the student-athlete context specifically
• Providing instant feedback without judgment
• Learning from your actual patterns and preferences
• Offering strategies proven effective for your situation

​

How to Use It

​

Starting Your First Conversation

1. Navigate to AI Coach page
2. Choose a quick action button, or
3. Type your question in the input field
4. Click Send or press Enter
5. Coach responds with personalized advice
6. Continue the conversation as needed

​

Quick Action Prompts

​

Example Conversations

​

Types of Questions to Ask

• “How should I structure my week?”
• “What should I prioritize today?”
• “Help me plan for exam week”
• “I have a competition Saturday, how do I adjust?”

• “What’s the best way to study for [subject]?”
• “How can I improve my grade in [subject]?”
• “I have 3 exams next week, how do I prepare?”
• “What study method works for [topic]?”

• “I’m feeling overwhelmed”
• “How do I stay consistent?”
• “I missed my goals this week”
• “How do other student-athletes manage this?”

• “Should I study before or after training?”
• “How long should my breaks be?”
• “When is the best time to study [subject]?”
• “How do I recover faster between tasks?”

​

Technical Details

​

AI Architecture

​

API Endpoint

• CORS configuration for web app
• Rate limiting (30 requests per minute per IP)
• Request validation and sanitization
• Groq API communication
• Error handling and fallbacks

const rateLimit = new Map<string, number[]>();

const ip = req.headers['x-real-ip'] || req.socket.remoteAddress;
const now = Date.now();
const times = rateLimit.get(ip) || [];
const validTimes = times.filter(t => now - t < 60000); // last minute

if (validTimes.length >= 30) {
  return res.status(429).json({ 
    error: "Too many requests", 
    code: 429 
  });
}

validTimes.push(now);
rateLimit.set(ip, validTimes);

​

Context Building

function buildContext() {
  return {
    userProfile: {
      name: user.name,
      sport: user.mainSport,
      waterGoal: user.waterGoal
    },
    dailyRoutine: {
      totalCognitiveLoad: routine.cognitiveLoad,
      totalPhysicalLoad: routine.physicalLoad
    },
    language: settings.language,
    activeTasks: tasks.filter(t => t.status !== 'completed'),
    todayPomodoros: pomodoroStore.sessionsCompleted,
    habits: habits.map(h => ({
      name: h.title,
      streak: h.currentStreak
    })),
    subjects: subjects.map(s => ({
      name: s.name,
      average: academicsStore.getWeightedAverage(s.id),
      nextExam: s.nextExamDate
    })),
    upcomingEvents: calendar.getUpcomingEvents(7),
    totalResources: resources.length
  };
}

​

System Prompt

const systemPrompt = `Eres Routine Optimizer AI Coach. Ayudas a estudiantes-deportistas.
Contexto del usuario:
- Nombre: ${context.userName}
- Deporte principal: ${context.mainSport}
- Tareas activas: ${context.activeTasks.join(', ')}
- Pomodoros de hoy: ${context.todayPomodoros}
Responde en ${context.language}, sé directo, motivador y claro.`;

• Its role (student-athlete coach)
• User’s specific situation
• Current state (tasks, progress)
• Communication style (direct, motivating)

​

Model Selection

• Fast inference (< 1 second response time)
• Strong reasoning capabilities
• Cost-effective for high volume
• Supports multi-language responses

const groqResponse = await fetch('https://api.groq.com/openai/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.GROQ_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'llama3-8b-8192',
    messages: [
      { role: 'system', content: systemPrompt },
      { role: 'user', content: userMessage }
    ]
  })
});

​

State Management

interface ChatMessage {
  id: string;
  role: 'user' | 'assistant';
  content: string;
  timestamp?: string;
}

interface ChatState {
  messages: ChatMessage[];
  isLoading: boolean;
  addMessage: (message: ChatMessage) => void;
  clearMessages: () => void;
  setLoading: (loading: boolean) => void;
}

​

Components

• Main chat interface
• Message history display
• Input field with send button
• Quick action buttons
• Loading states

• User messages: Right-aligned, primary color
• Assistant messages: Left-aligned, muted background
• Avatar icons distinguish speakers
• Rounded corners and smooth animations

​

Error Handling

1. Client-side validation (src/features/ai-coach/services/aiService.ts:27)
   • Checks for empty messages
   • Validates context structure
   • Handles network errors
2. API-level validation (api/ai.ts:49)
   • Validates request body
   • Checks message length (max 2000 chars)
   • Enforces rate limits
3. Graceful degradation
   • 429 (Too many requests): “You’ve sent too many messages…”
   • 503 (Service unavailable): “AI service unavailable…”
   • Network error: “Connection error. Check your internet.”

​

Security & Privacy

​

API Key Security

• Never exposed to client
• Accessed only in serverless function
• Rotated periodically
• Monitored for usage patterns

​

Best Practices

​

Limitations

• Persistent conversation history
• Proactive suggestions based on patterns
• Direct integration (“Schedule this for me”)
• Voice input/output support
• Multi-modal responses (charts, schedules)

​

Integration with Other Features

• Task Management: Coach sees active tasks and can suggest priorities
• Pomodoro Timer: Uses today’s focus time in recommendations
• Academic Tracking: Knows your grades and can suggest study focus
• Habits & Goals: References your goals for motivational context
• Smart Routines: Understands your schedule and energy patterns
• Calendar: Aware of upcoming events and deadlines

​

Language Support

• English
• Spanish (default)
• Portuguese
• French