| <!DOCTYPE html> |
| <html lang="en"> |
| <head> |
| <meta charset="UTF-8"> |
| <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| <title>Learning Engine API | QuantumCode</title> |
| <link rel="icon" type="image/x-icon" href="/static/favicon.ico"> |
| <script src="https://cdn.tailwindcss.com"></script> |
| <script src="https://unpkg.com/feather-icons"></script> |
| <style> |
| @import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&display=swap'); |
| |
| body { |
| font-family: 'Space Grotesk', sans-serif; |
| background-color: #0f172a; |
| color: #e2e8f0; |
| } |
| |
| .gradient-text { |
| background: linear-gradient(90deg, #7c3aed 0%, #2563eb 100%); |
| -webkit-background-clip: text; |
| background-clip: text; |
| color: transparent; |
| } |
| |
| .glass-card { |
| background: rgba(15, 23, 42, 0.7); |
| backdrop-filter: blur(10px); |
| border: 1px solid rgba(255, 255, 255, 0.1); |
| border-radius: 1rem; |
| } |
| |
| .endpoint-card { |
| border-left: 4px solid #7c3aed; |
| } |
| |
| code { |
| background: rgba(124, 58, 237, 0.2); |
| padding: 0.2rem 0.4rem; |
| border-radius: 0.25rem; |
| font-family: monospace; |
| } |
| </style> |
| </head> |
| <body class="min-h-screen"> |
| <nav class="px-6 py-4 flex justify-between items-center"> |
| <div class="flex items-center space-x-2"> |
| <i data-feather="cpu" class="text-indigo-500"></i> |
| <span class="text-xl font-bold gradient-text">QuantumCode</span> |
| </div> |
| <div class="flex items-center space-x-2"> |
| <a href="i18n-setup.html" class="flex items-center text-sm hover:text-indigo-400 transition-colors"> |
| <i data-feather="globe" class="w-4 h-4 mr-1"></i> |
| <span id="currentLang">EN</span> |
| </a> |
| </div> |
| <div class="hidden md:flex space-x-8"> |
| <a href="index.html" class="hover:text-indigo-400 transition-colors">Home</a> |
| <a href="index.html#features" class="hover:text-indigo-400 transition-colors">Features</a> |
| <a href="index.html#roadmap" class="hover:text-indigo-400 transition-colors">Roadmap</a> |
| <a href="data-architecture.html" class="hover:text-indigo-400 transition-colors">Data Architecture</a> |
| <a href="learning-engine.html" class="text-indigo-400">Learning Engine</a> |
| <a href="auth.html" class="hover:text-indigo-400 transition-colors">Login</a> |
| <a href="select-role.html" class="hover:text-indigo-400 transition-colors">Roles</a> |
| <a href="progress-report.html" class="hover:text-indigo-400 transition-colors">Progress</a> |
| <a href="self-talk-journal.html" class="hover:text-indigo-400 transition-colors">Self-Talk</a> |
| <a href="gamequest.html" class="hover:text-indigo-400 transition-colors">GameQuest</a> |
| </div> |
| </nav> |
| |
| <main class="container mx-auto px-4 py-16"> |
| <section class="max-w-6xl mx-auto mb-20"> |
| <h1 class="text-4xl md:text-5xl font-bold mb-6"> |
| <span class="gradient-text">Learning Engine</span> API Documentation |
| </h1> |
| <p class="text-xl text-slate-300 mb-10"> |
| RESTful API for managing courses, modules, lessons and tracking learning metrics. |
| </p> |
| |
| <div class="glass-card endpoint-card p-8 mb-12"> |
| <h2 class="text-2xl font-bold mb-6">Course Structure</h2> |
| <div class="mb-8"> |
| <h3 class="text-xl font-bold mb-4">Courses → Modules → Lessons Hierarchy</h3> |
| <div class="bg-slate-800/50 p-6 rounded-lg mb-6"> |
| <pre><code> |
| { |
| "course": { |
| "id": "string", |
| "title": "string", |
| "description": "string", |
| "modules": [ |
| { |
| "id": "string", |
| "title": "string", |
| "lessons": [ |
| { |
| "id": "string", |
| "title": "string", |
| "exercises": [ |
| { |
| "id": "string", |
| "type": "speaking|listening|vocabulary|grammar|speak-brave" |
| } |
| ] |
| } |
| ] |
| } |
| ] |
| } |
| } |
| </code></pre> |
| </div> |
| </div> |
| </div> |
|
|
| <div class="glass-card endpoint-card p-8 mb-12"> |
| <h2 class="text-2xl font-bold mb-6">API Endpoints</h2> |
| |
| <div class="mb-8"> |
| <h3 class="text-xl font-bold mb-4 flex items-center"> |
| <span class="px-3 py-1 bg-indigo-900/30 text-indigo-400 rounded mr-3">GET</span> |
| <code>/api/courses</code> |
| </h3> |
| <p class="text-slate-300 mb-4">Retrieve all available courses</p> |
| <div class="bg-slate-800/50 p-6 rounded-lg"> |
| <pre><code>// Response |
| [ |
| { |
| "id": "course-123", |
| "title": "Beginner English", |
| "description": "Basic English for beginners", |
| "language": "en", |
| "difficulty": "beginner" |
| } |
| ]</code></pre> |
| </div> |
| </div> |
| |
| <div class="mb-8"> |
| <h3 class="text-xl font-bold mb-4 flex items-center"> |
| <span class="px-3 py-1 bg-green-900/30 text-green-400 rounded mr-3">POST</span> |
| <code>/api/courses</code> |
| </h3> |
| <p class="text-slate-300 mb-4">Create a new course (Admin only)</p> |
| <div class="bg-slate-800/50 p-6 rounded-lg"> |
| <pre><code>// Request Body |
| { |
| "title": "Advanced English", |
| "description": "Advanced English course", |
| "language": "en", |
| "difficulty": "advanced" |
| } |
|
|
| // Response |
| { |
| "id": "course-456", |
| "status": "created" |
| }</code></pre> |
| </div> |
| </div> |
| </div> |
|
|
| <div class="glass-card endpoint-card p-8 mb-12"> |
| <h2 class="text-2xl font-bold mb-6">Progress Tracking</h2> |
| |
| <div class="mb-4"> |
| <h3 class="text-xl font-bold mb-4 flex items-center"> |
| <span class="px-3 py-1 bg-purple-900/30 text-purple-400 rounded mr-3">PATCH</span> |
| <code>/api/lessons/{lessonId}/progress</code> |
| </h3> |
| <p class="text-slate-300 mb-4">Update lesson progress metrics</p> |
| <div class="bg-slate-800/50 p-6 rounded-lg"> |
| <pre><code>// Request Body |
| { |
| "speaking": { |
| "score": 75, |
| "timeSpent": 120, |
| "attempts": 3 |
| }, |
| "listening": { |
| "score": 80, |
| "timeSpent": 90, |
| "attempts": 2 |
| }, |
| "vocabulary": { |
| "score": 90, |
| "timeSpent": 60, |
| "attempts": 1 |
| }, |
| "grammar": { |
| "score": 70, |
| "timeSpent": 150, |
| "attempts": 4 |
| }, |
| "speakBraveScore": { |
| "confidence": 85, |
| "clarity": 80, |
| "fluency": 75, |
| "emotionalImpact": 90, |
| "transcript": "I believe in my ability to speak English confidently...", |
| "emotions": [ |
| {"emotion": "happy", "score": 0.85}, |
| {"emotion": "neutral", "score": 0.12}, |
| {"emotion": "sad", "score": 0.03} |
| ], |
| "facialExpressions": [ |
| {"expression": "smile", "intensity": 0.8}, |
| {"expression": "eyeContact", "intensity": 0.7} |
| ] |
| }, |
| "confidence": 85, |
| "completionStatus": "completed", |
| "masteryPercentage": 78.75 |
| } |
|
|
| // Response |
| { |
| "lessonId": "lesson-789", |
| "updated": true, |
| "report": { |
| "totalTime": 420, |
| "totalAttempts": 10, |
| "weakestArea": "grammar", |
| "nextSteps": [ |
| "Review past tense exercises", |
| "Practice with audio drills", |
| "Complete bonus vocabulary quiz" |
| ] |
| } |
| }</code></pre> |
| </div> |
| </div> |
| </div> |
| |
| <div class="glass-card p-8 mb-12"> |
| <h2 class="text-2xl font-bold mb-6">VoiceTrack Module</h2> |
| <p class="text-slate-300 mb-6">Test the voice analysis API with real-time recording and feedback.</p> |
| <div class="grid md:grid-cols-2 gap-8 mb-12"> |
| <voice-track></voice-track> |
| <ai-dialog></ai-dialog> |
| </div> |
| <div class="mt-6"> |
| <h3 class="text-xl font-bold mb-4 flex items-center"> |
| <span class="px-3 py-1 bg-purple-900/30 text-purple-400 rounded mr-3">POST</span> |
| <code>/voice/analyze</code> |
| </h3> |
| <p class="text-slate-300 mb-4">Analyze voice recordings for pronunciation and confidence</p> |
| <div class="bg-slate-800/50 p-6 rounded-lg"> |
| <pre><code>// Request: Multipart form with audio file |
| // Response |
| { |
| "pronunciation": 85, |
| "confidence": 78, |
| "fluency": 82, |
| "clarity": 80, |
| "feedback": [ |
| "Work on vowel sounds", |
| "Good pacing overall", |
| "Slightly nervous tone detected" |
| ] |
| }</code></pre> |
| </div> |
| </div> |
| </div> |
| </section> |
| </main> |
| <script src="components/voice-track.js"></script> |
| <script src="components/ai-dialog.js"></script> |
| <footer class="py-12 border-t border-slate-800"> |
| <div class="container mx-auto px-4 text-center"> |
| <p class="text-slate-500 text-sm"> |
| © 2023 QuantumCode AI Architect. All rights reserved. |
| </p> |
| </div> |
| </footer> |
| <script> |
| |
| document.getElementById('currentLang').textContent = |
| document.cookie.match('(^|;)\\s*NEXT_LOCALE\\s*=\\s*([^;]+)')?.pop() || 'EN'; |
| |
| feather.replace(); |
| </script> |
| </body> |
| </html> |
