Upload 47 files

App.tsx

@@ -17,6 +17,8 @@ const Games = React.lazy(() => import('./pages/Games').then(module => ({ default
 const AttendancePage = React.lazy(() => import('./pages/Attendance').then(module => ({ default: module.AttendancePage })));
 const Profile = React.lazy(() => import('./pages/Profile').then(module => ({ default: module.Profile })));
 const WishesAndFeedback = React.lazy(() => import('./pages/WishesAndFeedback').then(module => ({ default: module.WishesAndFeedback })));
+// NEW: AI Assistant Page
+const AIAssistant = React.lazy(() => import('./pages/AIAssistant').then(module => ({ default: module.AIAssistant })));
 
 import { Login } from './pages/Login';
 import { User, UserRole } from './types';
@@ -124,6 +126,7 @@ const AppContent: React.FC = () => {
       case 'games': return <Games />; 
       case 'attendance': return <AttendancePage />;
       case 'wishes': return <WishesAndFeedback />;
+      case 'ai-assistant': return <AIAssistant />; // NEW
       case 'profile': return <Profile />;
       default: return <Dashboard onNavigate={(view) => setCurrentView(view)} />;
     }
@@ -143,6 +146,7 @@ const AppContent: React.FC = () => {
     games: '互动教学中心',
     attendance: '考勤管理',
     wishes: '心愿与反馈',
+    'ai-assistant': 'AI 智能助教',
     profile: '个人中心'
   };
 

components/Sidebar.tsx

@@ -1,6 +1,6 @@
 
 import React from 'react';
-import { LayoutDashboard, Users, BookOpen, GraduationCap, Settings, LogOut, FileText, School, UserCog, Palette, X, Building, Gamepad2, CalendarCheck, UserCircle, MessageSquare } from 'lucide-react';
+import { LayoutDashboard, Users, BookOpen, GraduationCap, Settings, LogOut, FileText, School, UserCog, Palette, X, Building, Gamepad2, CalendarCheck, UserCircle, MessageSquare, Bot } from 'lucide-react';
 import { UserRole } from '../types';
 
 interface SidebarProps {
@@ -17,6 +17,7 @@ export const Sidebar: React.FC<SidebarProps> = ({ currentView, onChangeView, use
   // PRINCIPAL has access to almost everything ADMIN has, except 'schools' management
   const menuItems = [
     { id: 'dashboard', label: '工作台', icon: LayoutDashboard, roles: [UserRole.ADMIN, UserRole.PRINCIPAL, UserRole.TEACHER, UserRole.STUDENT] },
+    { id: 'ai-assistant', label: 'AI 智能助教', icon: Bot, roles: [UserRole.TEACHER, UserRole.STUDENT] }, // NEW
     { id: 'attendance', label: '考勤管理', icon: CalendarCheck, roles: [UserRole.TEACHER, UserRole.PRINCIPAL] }, 
     { id: 'games', label: '互动教学', icon: Gamepad2, roles: [UserRole.TEACHER, UserRole.STUDENT] }, // Removed PRINCIPAL
     { id: 'wishes', label: '心愿与反馈', icon: MessageSquare, roles: [UserRole.ADMIN, UserRole.PRINCIPAL, UserRole.TEACHER, UserRole.STUDENT] }, // NEW

metadata.json

@@ -1,5 +1,5 @@
 {
-  "name": "智慧校园管理系统",
+  "name": "（AI）智慧校园管理系统",
   "description": "一个综合性的学生管理系统仪表板，具有基于角色的访问控制、学生档案、课程管理和绩效分析功能。",
   "requestFramePermissions": []
 }

pages/AIAssistant.tsx

@@ -0,0 +1,338 @@
+
+import React, { useState, useRef, useEffect } from 'react';
+import { api } from '../services/api';
+import { AIChatMessage, OralAssessment } from '../types';
+import { Bot, Mic, Square, Play, Volume2, Send, CheckCircle, Brain, Sparkles, Loader2, StopCircle } from 'lucide-react';
+import { Emoji } from '../components/Emoji';
+
+// Utility to handle Base64 conversion
+const blobToBase64 = (blob: Blob): Promise<string> => {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onloadend = () => {
+      const base64String = (reader.result as string).split(',')[1];
+      resolve(base64String);
+    };
+    reader.onerror = reject;
+    reader.readAsDataURL(blob);
+  });
+};
+
+// Utility to decode and play PCM audio (standard Web Audio API)
+const playPCMAudio = async (base64Audio: string, audioContext: AudioContext) => {
+    try {
+        const binaryString = window.atob(base64Audio);
+        const len = binaryString.length;
+        const bytes = new Uint8Array(len);
+        for (let i = 0; i < len; i++) {
+            bytes[i] = binaryString.charCodeAt(i);
+        }
+        
+        // Gemini TTS raw output usually needs specific handling. 
+        // If it's pure PCM, we need to wrap it. However, the Gemini API usually returns standard formats if requested or PCM.
+        // Assuming raw PCM 24kHz mono based on documentation typically seen.
+        const int16Data = new Int16Array(bytes.buffer);
+        const float32Data = new Float32Array(int16Data.length);
+        for (let i = 0; i < int16Data.length; i++) {
+            float32Data[i] = int16Data[i] / 32768.0;
+        }
+
+        const buffer = audioContext.createBuffer(1, float32Data.length, 24000); // Gemini Flash TTS default
+        buffer.getChannelData(0).set(float32Data);
+
+        const source = audioContext.createBufferSource();
+        source.buffer = buffer;
+        source.connect(audioContext.destination);
+        source.start();
+    } catch (e) {
+        console.error("Audio playback error:", e);
+    }
+};
+
+export const AIAssistant: React.FC = () => {
+    const [activeTab, setActiveTab] = useState<'chat' | 'assessment'>('chat');
+    
+    // Chat State
+    const [messages, setMessages] = useState<AIChatMessage[]>([]);
+    const [inputMode, setInputMode] = useState<'text' | 'audio'>('text');
+    const [textInput, setTextInput] = useState('');
+    const [isRecording, setIsRecording] = useState(false);
+    const [isProcessing, setIsProcessing] = useState(false);
+    
+    // Assessment State
+    const [assessmentTopic, setAssessmentTopic] = useState('请描述你最喜欢的一个季节及其原因。');
+    const [assessmentResult, setAssessmentResult] = useState<any>(null);
+
+    // Audio Refs
+    const mediaRecorderRef = useRef<MediaRecorder | null>(null);
+    const audioChunksRef = useRef<Blob[]>([]);
+    const audioContextRef = useRef<AudioContext | null>(null);
+
+    useEffect(() => {
+        // Init Audio Context
+        // @ts-ignore
+        const AudioCtor = window.AudioContext || window.webkitAudioContext;
+        audioContextRef.current = new AudioCtor();
+        
+        // Initial welcome message
+        if (messages.length === 0) {
+            setMessages([{
+                id: 'welcome',
+                role: 'model',
+                text: '你好！我是你的 AI 智能助教。你可以问我任何学习上的问题，或者切换到“口语测评”模式来练习口语。',
+                timestamp: Date.now()
+            }]);
+        }
+    }, []);
+
+    const startRecording = async () => {
+        try {
+            const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+            const mediaRecorder = new MediaRecorder(stream);
+            mediaRecorderRef.current = mediaRecorder;
+            audioChunksRef.current = [];
+
+            mediaRecorder.ondataavailable = (event) => {
+                if (event.data.size > 0) {
+                    audioChunksRef.current.push(event.data);
+                }
+            };
+
+            mediaRecorder.start();
+            setIsRecording(true);
+        } catch (error) {
+            console.error("Error accessing microphone:", error);
+            alert("无法访问麦克风");
+        }
+    };
+
+    const stopRecording = () => {
+        if (mediaRecorderRef.current && isRecording) {
+            mediaRecorderRef.current.stop();
+            setIsRecording(false);
+            
+            mediaRecorderRef.current.onstop = async () => {
+                const audioBlob = new Blob(audioChunksRef.current, { type: 'audio/wav' });
+                const base64Audio = await blobToBase64(audioBlob);
+                
+                if (activeTab === 'chat') {
+                    handleChatSubmit(undefined, base64Audio);
+                } else {
+                    handleAssessmentSubmit(base64Audio);
+                }
+                
+                // Stop all tracks
+                mediaRecorderRef.current?.stream.getTracks().forEach(track => track.stop());
+            };
+        }
+    };
+
+    const handleChatSubmit = async (text?: string, audioBase64?: string) => {
+        if (!text && !audioBase64) return;
+
+        // Optimistic UI Update
+        const newUserMsg: AIChatMessage = {
+            id: Date.now().toString(),
+            role: 'user',
+            text: text || '(语音消息)',
+            isAudioMessage: !!audioBase64,
+            timestamp: Date.now()
+        };
+        setMessages(prev => [...prev, newUserMsg]);
+        setTextInput('');
+        setIsProcessing(true);
+
+        try {
+            const response = await api.ai.chat({ text, audio: audioBase64 });
+            
+            const newAiMsg: AIChatMessage = {
+                id: (Date.now() + 1).toString(),
+                role: 'model',
+                text: response.text,
+                audio: response.audio,
+                timestamp: Date.now()
+            };
+            setMessages(prev => [...prev, newAiMsg]);
+
+            // Auto play audio if response contains it
+            if (response.audio && audioContextRef.current) {
+                playPCMAudio(response.audio, audioContextRef.current);
+            }
+
+        } catch (error) {
+            console.error("Chat error:", error);
+            setMessages(prev => [...prev, { id: Date.now().toString(), role: 'model', text: '抱歉，我遇到了一点问题，请稍后再试。', timestamp: Date.now() }]);
+        } finally {
+            setIsProcessing(false);
+        }
+    };
+
+    const handleAssessmentSubmit = async (audioBase64: string) => {
+        setIsProcessing(true);
+        setAssessmentResult(null);
+        try {
+            const result = await api.ai.evaluate({
+                question: assessmentTopic,
+                audio: audioBase64
+            });
+            setAssessmentResult(result);
+        } catch (error) {
+            console.error("Eval error:", error);
+            alert("评分失败，请重试");
+        } finally {
+            setIsProcessing(false);
+        }
+    };
+
+    const playMessageAudio = (b64: string) => {
+        if (audioContextRef.current) playPCMAudio(b64, audioContextRef.current);
+    };
+
+    return (
+        <div className="h-full flex flex-col bg-slate-50 overflow-hidden">
+            {/* Header Tabs */}
+            <div className="bg-white border-b border-gray-200 px-6 pt-4 flex gap-6 shrink-0 shadow-sm z-10">
+                <button onClick={() => setActiveTab('chat')} className={`pb-3 text-sm font-bold border-b-2 transition-colors flex items-center gap-2 ${activeTab === 'chat' ? 'border-blue-500 text-blue-600' : 'border-transparent text-gray-500 hover:text-gray-700'}`}>
+                    <Bot size={18} className={activeTab === 'chat' ? 'text-blue-500' : ''}/> AI 助教 (问答)
+                </button>
+                <button onClick={() => setActiveTab('assessment')} className={`pb-3 text-sm font-bold border-b-2 transition-colors flex items-center gap-2 ${activeTab === 'assessment' ? 'border-purple-500 text-purple-600' : 'border-transparent text-gray-500 hover:text-gray-700'}`}>
+                    <Mic size={18} className={activeTab === 'assessment' ? 'text-purple-500' : ''}/> 口语/背诵测评
+                </button>
+            </div>
+
+            {/* TAB: CHAT */}
+            {activeTab === 'chat' && (
+                <div className="flex-1 flex flex-col max-w-4xl mx-auto w-full h-full relative">
+                    <div className="flex-1 overflow-y-auto p-4 space-y-4 pb-24 custom-scrollbar">
+                        {messages.map(msg => (
+                            <div key={msg.id} className={`flex gap-3 ${msg.role === 'user' ? 'flex-row-reverse' : ''}`}>
+                                <div className={`w-10 h-10 rounded-full flex items-center justify-center shrink-0 ${msg.role === 'model' ? 'bg-blue-100 text-blue-600' : 'bg-gray-200 text-gray-600'}`}>
+                                    {msg.role === 'model' ? <Sparkles size={20}/> : <Bot size={20}/>}
+                                </div>
+                                <div className={`max-w-[80%] p-3 rounded-2xl text-sm ${msg.role === 'user' ? 'bg-blue-600 text-white rounded-tr-none' : 'bg-white border border-gray-200 text-gray-800 rounded-tl-none shadow-sm'}`}>
+                                    {msg.text}
+                                    {msg.audio && (
+                                        <button onClick={() => playMessageAudio(msg.audio!)} className="mt-2 flex items-center gap-2 text-xs bg-blue-50 text-blue-600 px-3 py-1.5 rounded-full hover:bg-blue-100 border border-blue-100 transition-colors w-fit">
+                                            <Volume2 size={14}/> 播放语音
+                                        </button>
+                                    )}
+                                </div>
+                            </div>
+                        ))}
+                        {isProcessing && (
+                            <div className="flex gap-3">
+                                <div className="w-10 h-10 rounded-full bg-blue-100 text-blue-600 flex items-center justify-center">
+                                    <Loader2 className="animate-spin" size={20}/>
+                                </div>
+                                <div className="text-sm text-gray-400 self-center">AI 正在思考中...</div>
+                            </div>
+                        )}
+                    </div>
+
+                    <div className="p-4 bg-white border-t border-gray-200 shrink-0">
+                        <div className="flex items-center gap-2 max-w-4xl mx-auto bg-gray-100 p-1.5 rounded-full border border-gray-200">
+                            <button 
+                                onClick={() => setInputMode(inputMode === 'text' ? 'audio' : 'text')}
+                                className="p-2 rounded-full hover:bg-white text-gray-500 transition-colors"
+                                title={inputMode === 'text' ? '切换语音' : '切换文字'}
+                            >
+                                {inputMode === 'text' ? <Mic size={20}/> : <Square size={20}/>}
+                            </button>
+                            
+                            {inputMode === 'text' ? (
+                                <input 
+                                    className="flex-1 bg-transparent border-none outline-none px-2 text-sm"
+                                    placeholder="输入问题..."
+                                    value={textInput}
+                                    onChange={e => setTextInput(e.target.value)}
+                                    onKeyDown={e => e.key === 'Enter' && handleChatSubmit(textInput)}
+                                />
+                            ) : (
+                                <div className="flex-1 text-center text-sm font-medium text-blue-600 animate-pulse">
+                                    {isRecording ? '正在录音... 点击停止' : '点击麦克风开始说话'}
+                                </div>
+                            )}
+
+                            {inputMode === 'text' ? (
+                                <button onClick={() => handleChatSubmit(textInput)} className="p-2 bg-blue-600 rounded-full text-white hover:bg-blue-700 disabled:opacity-50" disabled={!textInput.trim() || isProcessing}>
+                                    <Send size={18}/>
+                                </button>
+                            ) : (
+                                <button 
+                                    onMouseDown={startRecording}
+                                    onMouseUp={stopRecording}
+                                    // Touch support for mobile
+                                    onTouchStart={startRecording}
+                                    onTouchEnd={stopRecording}
+                                    className={`p-3 rounded-full text-white transition-all ${isRecording ? 'bg-red-500 scale-110 shadow-lg ring-4 ring-red-200' : 'bg-blue-600 hover:bg-blue-700'}`}
+                                >
+                                    {isRecording ? <StopCircle size={20}/> : <Mic size={20}/>}
+                                </button>
+                            )}
+                        </div>
+                        <p className="text-center text-[10px] text-gray-400 mt-2">Gemini Flash-Lite 模型提供支持</p>
+                    </div>
+                </div>
+            )}
+
+            {/* TAB: ASSESSMENT */}
+            {activeTab === 'assessment' && (
+                <div className="flex-1 p-6 overflow-y-auto">
+                    <div className="max-w-3xl mx-auto space-y-6">
+                        {/* Topic Card */}
+                        <div className="bg-white p-6 rounded-2xl border border-purple-100 shadow-sm">
+                            <h3 className="text-lg font-bold text-gray-800 mb-2 flex items-center">
+                                <Brain className="mr-2 text-purple-600"/> 今日测评题目
+                            </h3>
+                            <textarea 
+                                className="w-full bg-purple-50/50 border border-purple-100 rounded-xl p-4 text-gray-700 font-medium text-lg resize-none focus:ring-2 focus:ring-purple-200 outline-none"
+                                value={assessmentTopic}
+                                onChange={e => setAssessmentTopic(e.target.value)}
+                                rows={3}
+                            />
+                            <div className="mt-4 flex justify-center">
+                                <button 
+                                    onMouseDown={startRecording}
+                                    onMouseUp={stopRecording}
+                                    onTouchStart={startRecording}
+                                    onTouchEnd={stopRecording}
+                                    disabled={isProcessing}
+                                    className={`px-8 py-4 rounded-full font-bold text-white flex items-center gap-3 shadow-lg transition-all ${isRecording ? 'bg-red-500 scale-105' : 'bg-gradient-to-r from-purple-600 to-indigo-600 hover:shadow-purple-200 hover:scale-105'}`}
+                                >
+                                    {isProcessing ? <Loader2 className="animate-spin"/> : (isRecording ? <StopCircle/> : <Mic/>)}
+                                    {isProcessing ? 'AI 正在评分...' : (isRecording ? '松开结束录音' : '按住开始回答')}
+                                </button>
+                            </div>
+                        </div>
+
+                        {/* Result Card */}
+                        {assessmentResult && (
+                            <div className="bg-white p-6 rounded-2xl border border-gray-200 shadow-lg animate-in slide-in-from-bottom-4">
+                                <div className="flex items-center justify-between border-b border-gray-100 pb-4 mb-4">
+                                    <h3 className="font-bold text-xl text-gray-800">测评报告</h3>
+                                    <div className={`text-3xl font-black ${assessmentResult.score >= 80 ? 'text-green-500' : assessmentResult.score >= 60 ? 'text-yellow-500' : 'text-red-500'}`}>
+                                        {assessmentResult.score}<span className="text-sm text-gray-400 ml-1">分</span>
+                                    </div>
+                                </div>
+                                
+                                <div className="space-y-4">
+                                    <div className="bg-gray-50 p-4 rounded-xl">
+                                        <p className="text-xs font-bold text-gray-500 uppercase mb-1">AI 听到的内容 (识别文本)</p>
+                                        <p className="text-gray-700 leading-relaxed">{assessmentResult.transcription}</p>
+                                    </div>
+                                    <div>
+                                        <p className="text-xs font-bold text-gray-500 uppercase mb-2">AI 点评建议</p>
+                                        <div className="p-4 bg-purple-50 text-purple-900 rounded-xl border border-purple-100 text-sm leading-relaxed">
+                                            <Emoji symbol="👨‍🏫" className="mr-2"/>
+                                            {assessmentResult.feedback}
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                        )}
+                    </div>
+                </div>
+            )}
+        </div>
+    );
+};

server.js

@@ -7,6 +7,12 @@ const {
     WishModel, FeedbackModel
 } = require('./models');
 
+// Initialize Gemini
+const { GoogleGenAI, Type, Modality } = require("@google/genai");
+// Note: GoogleGenAI client is initialized inside requests to use process.env.API_KEY dynamically if needed, 
+// but here we follow standard pattern.
+const ai = new GoogleGenAI({ apiKey: process.env.API_KEY });
+
 // ... (existing setup code, middleware, connectDB, helpers)
 const express = require('express');
 const mongoose = require('mongoose');
@@ -22,7 +28,7 @@ const MONGO_URI = 'mongodb+srv://dv890a:db8822723@chatpro.gw3v0v7.mongodb.net/ch
 const app = express();
 app.use(compression());
 app.use(cors());
-app.use(bodyParser.json({ limit: '10mb' })); 
+app.use(bodyParser.json({ limit: '50mb' })); // Increased limit for audio
 app.use(express.static(path.join(__dirname, 'dist'), {
   setHeaders: (res, filePath) => {
     if (filePath.endsWith('.html')) {
@@ -33,6 +39,7 @@ app.use(express.static(path.join(__dirname, 'dist'), {
   }
 }));
 
+// ... (DB Connection and helpers remain the same) ...
 const InMemoryDB = { schools: [], users: [], isFallback: false };
 const connectDB = async () => {
   try {
@@ -93,8 +100,120 @@ const generateStudentNo = async () => {
     return `${year}${random}`;
 };
 
+// --- NEW AI ROUTES ---
+
+// Scenario 1: AI Chat (Audio In -> AI Think -> Text + Audio Out)
+app.post('/api/ai/chat', async (req, res) => {
+    const { text, audio } = req.body; // audio is base64 string
+    
+    try {
+        const parts = [];
+        if (audio) {
+            parts.push({
+                inlineData: {
+                    mimeType: 'audio/wav', // Assuming browser sends WAV or compatible
+                    data: audio
+                }
+            });
+        }
+        if (text) {
+            parts.push({ text: text });
+        }
+        
+        if (parts.length === 0) return res.status(400).json({ error: 'No input provided' });
+
+        // Step 1: Thinking (Gemini Flash Lite for low latency)
+        const thinkingResponse = await ai.models.generateContent({
+            model: 'gemini-2.5-flash-lite',
+            contents: { parts: parts },
+            config: {
+                systemInstruction: "你是一位友善、耐心且知识渊博的中小学AI助教。请用简洁、鼓励性的语言回答学生的问题。如果学生使用语音，你也应当在回答中体现出自然的口语风格。",
+            }
+        });
+        
+        const answerText = thinkingResponse.text || "抱歉，我没有听清，请再说一遍。";
+
+        // Step 2: Speaking (Gemini TTS)
+        const ttsResponse = await ai.models.generateContent({
+            model: "gemini-2.5-flash-preview-tts",
+            contents: [{ parts: [{ text: answerText }] }],
+            config: {
+                responseModalities: [Modality.AUDIO],
+                speechConfig: {
+                    voiceConfig: {
+                        prebuiltVoiceConfig: { voiceName: 'Kore' }, // 'Puck', 'Charon', 'Kore', 'Fenrir', 'Zephyr'
+                    },
+                },
+            },
+        });
+
+        const audioBytes = ttsResponse.candidates?.[0]?.content?.parts?.[0]?.inlineData?.data;
+
+        res.json({
+            text: answerText,
+            audio: audioBytes // Base64 PCM data
+        });
+
+    } catch (e) {
+        console.error("AI Chat Error:", e);
+        res.status(500).json({ error: e.message });
+    }
+});
+
+// Scenario 2: Evaluation (Question + Audio Answer -> AI Score)
+app.post('/api/ai/evaluate', async (req, res) => {
+    const { question, audio } = req.body;
+
+    if (!question || !audio) return res.status(400).json({ error: 'Missing question or audio' });
+
+    try {
+        // Evaluate using Multimodal capability
+        const response = await ai.models.generateContent({
+            model: 'gemini-2.5-flash-lite',
+            contents: {
+                parts: [
+                    { text: `请作为一名严谨的口语考官，对学生的回答进行评分。
+                             题目是：${question}。
+                             学生的回答在音频中。
+                             请分析学生的：
+                             1. 内容准确性 (是否回答了问题)
+                             2. 语言表达 (流畅度、词汇)
+                             3. 情感/语调
+                             请返回 JSON 格式，包含 score (0-100), feedback (简短评语), transcription (你听到的内容)。` },
+                    {
+                        inlineData: {
+                            mimeType: 'audio/wav',
+                            data: audio
+                        }
+                    }
+                ]
+            },
+            config: {
+                responseMimeType: "application/json",
+                responseSchema: {
+                    type: Type.OBJECT,
+                    properties: {
+                        score: { type: Type.NUMBER },
+                        feedback: { type: Type.STRING },
+                        transcription: { type: Type.STRING }
+                    },
+                    required: ["score", "feedback", "transcription"]
+                }
+            }
+        });
+
+        res.json(JSON.parse(response.text));
+
+    } catch (e) {
+        console.error("AI Eval Error:", e);
+        res.status(500).json({ error: e.message });
+    }
+});
+
+
 // ... (Rest of Existing Routes) ...
 app.get('/api/classes/:className/teachers', async (req, res) => {
+// ... existing code ...
     const { className } = req.params;
     const schoolId = req.headers['x-school-id'];
     const normalize = (s) => (s || '').replace(/\s+/g, '');
@@ -451,4 +570,4 @@ app.delete('/api/attendance/calendar/:id', async (req, res) => { await SchoolCal
 app.post('/api/batch-delete', async (req, res) => { if(req.body.type==='student') await Student.deleteMany({_id:{$in:req.body.ids}}); if(req.body.type==='score') await Score.deleteMany({_id:{$in:req.body.ids}}); res.json({}); });
 
 app.get('*', (req, res) => { res.sendFile(path.join(__dirname, 'dist', 'index.html')); });
-app.listen(PORT, () => console.log(`🚀 Server running on port ${PORT}`));
+app.listen(PORT, () => console.log(`🚀 Server running on port ${PORT}`));

services/api.ts

@@ -1,5 +1,6 @@
 
-import { User, ClassInfo, SystemConfig, Subject, School, Schedule, GameSession, StudentReward, LuckyDrawConfig, Attendance, LeaveRequest, AchievementConfig, SchoolCalendarEntry, TeacherExchangeConfig, Wish, Feedback } from '../types';
+// ... existing imports
+import { User, ClassInfo, SystemConfig, Subject, School, Schedule, GameSession, StudentReward, LuckyDrawConfig, Attendance, LeaveRequest, AchievementConfig, SchoolCalendarEntry, TeacherExchangeConfig, Wish, Feedback, AIChatMessage } from '../types';
 
 const getBaseUrl = () => {
   let isProd = false;
@@ -267,5 +268,11 @@ export const api = {
       create: (data: Partial<Feedback>) => request('/feedback', { method: 'POST', body: JSON.stringify(data) }),
       update: (id: string, data: { status?: string, reply?: string }) => request(`/feedback/${id}`, { method: 'PUT', body: JSON.stringify(data) }),
       ignoreAll: (targetId: string) => request('/feedback/ignore-all', { method: 'POST', body: JSON.stringify({ targetId }) }),
+  },
+
+  // NEW: AI Endpoints
+  ai: {
+      chat: (data: { text?: string, audio?: string }) => request('/ai/chat', { method: 'POST', body: JSON.stringify(data) }),
+      evaluate: (data: { question: string, audio: string }) => request('/ai/evaluate', { method: 'POST', body: JSON.stringify(data) }),
   }
 };

types.ts

@@ -3,8 +3,29 @@
 
 // ... existing types
 
-// New Types for Wish Tree and Feedback Wall
+// AI Assistant Types
 
+export interface AIChatMessage {
+  id: string;
+  role: 'user' | 'model';
+  text?: string;
+  audio?: string; // Base64 encoded audio for playback
+  isAudioMessage?: boolean; // Was the input/output audio based?
+  timestamp: number;
+}
+
+export interface OralAssessment {
+  id: string;
+  topic: string;
+  difficulty: string;
+  studentAudio?: string;
+  score?: number;
+  feedback?: string;
+  transcription?: string; // What the AI heard
+  status: 'IDLE' | 'RECORDING' | 'ANALYZING' | 'COMPLETED';
+}
+
+// ... rest of the file
 export type WishStatus = 'PENDING' | 'FULFILLED';
 
 export interface Wish {