devops/encoach_frontend_v4
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Generation Page AI workflows + AI/Vector modules + exam session fixes

Browse Source 
Generation Page (complete rebuild):
- Full production-parity exam generation wizard with 4 IELTS modules
- Reading: AI passage gen, 5 exercise types (MCQ, Fill, Write, T/F, Match)
- Listening: 4 section types, AI context gen, TTS audio gen (ElevenLabs)
- Writing: Task 1/2, AI instruction gen, word limits, marks
- Speaking: 3 parts, AI script gen, avatar video gen (7 avatars)
- Per-module config: timer, CEFR difficulty, access, approval, rubrics
- Exam submission workflow (draft/published)

Exam Structures:
- New encoach.exam.structure model + CRUD controller
- ExamStructuresPage wired to real API

AI Module (encoach_ai):
- OpenAI service, ElevenLabs TTS, AWS Polly, ELAI avatars
- AI settings model with Odoo config parameters
- 7 generation endpoints (passage, exercises, instructions, scripts, context)

Vector Module (encoach_vector):
- pgvector integration for RAG-based content search
- Embedding service with sentence-transformers

Exam Session Fixes:
- Fixed ExamSession.tsx field mapping (question_type→type, exam_title→title)
- Fixed submit payload to include attempt_id and answers
- Fixed normalizeType to handle null/undefined

Tested: 12/12 API tests passed, browser-verified with real OpenAI calls
Made-with: Cursor
This commit is contained in:
Yamen Ahmad
2026-04-11 14:27:03 +04:00
parent 5b2ccbfeec
commit 74c2c9f2d2
30 changed files with 378 additions and 187 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
src/pages/ExamPage.tsx
View File

@@ -7,7 +7,7 @@ import AiTipBanner from "@/components/ai/AiTipBanner";
export default function ExamPage() {
return (
<div className="flex flex-col items-center justify-center min-h-[70vh] gap-4 max-w-md mx-auto">
<AiTipBanner tip="Based on your practice history, focus on Reading Part 3 (sentence completion) — your accuracy there is 58% vs 82% average. Budget 20 min for the writing section." variant="recommendation" />
<AiTipBanner context="exam" variant="recommendation" />
<Card className="border-0 shadow-sm w-full">
<CardContent className="p-8 text-center space-y-6">

2
src/pages/GrammarPage.tsx
View File

@@ -28,7 +28,7 @@ export default function GrammarPage() {
<p className="text-muted-foreground">Master grammar rules essential for IELTS.</p>
</div>
<AiTipBanner tip="You've completed 50% of grammar topics. Focus on Passive Voice next — it appears in 73% of IELTS Writing Task 1 questions and will boost your band score." variant="recommendation" />
<AiTipBanner context="grammar" variant="recommendation" />
<div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
<div className="lg:col-span-2 space-y-4">

4
src/pages/PaymentRecordPage.tsx
View File

@@ -52,7 +52,7 @@ export default function PaymentRecordPage() {
</div>
</div>
<AiTipBanner tip="PAY-003 (Tech Co) is unpaid and overdue. PMB-1004 failed — AI recommends sending an automated retry notification to Emma Brown." variant="recommendation" />
<AiTipBanner context="payment-record" variant="recommendation" />
<Tabs defaultValue="payments">
<TabsList>
@@ -61,7 +61,7 @@ export default function PaymentRecordPage() {
</TabsList>
<TabsContent value="payments" className="mt-4 space-y-4">
<AiReportNarrative narrative="Total revenue collected: $13,500 from 2 corporate payments. One commission of $2,000 remains unpaid. Collection rate: 67%. Trend: Q1 payments are on track but Tech Co requires follow-up." />
<AiReportNarrative report_type="payments" data={{ payments }} />
<Card className="border-0 shadow-sm">
<CardContent className="p-0">
<Table>

4
src/pages/RecordPage.tsx
View File

@@ -21,9 +21,9 @@ export default function RecordPage() {
<p className="text-muted-foreground">Browse assignment and exam attempt history.</p>
</div>
<AiTipBanner tip="The student's scores show an upward trend from 5.5 → 6.0 → 7.5 over the last 3 completed exams. Listening remains the weakest module — recommend targeted practice." variant="insight" />
<AiTipBanner context="record" variant="insight" />
<AiReportNarrative narrative="3 of 4 attempts completed with an average score of 6.3. Time management is good — all exams finished within allocated time. The Full Mock Exam is still in progress (67% time used). Strongest area: Reading (7.5), weakest: Listening (5.5)." />
<AiReportNarrative report_type="record" data={{ records }} />
<div className="flex flex-wrap gap-3 items-center">
<Select><SelectTrigger className="w-[160px]"><SelectValue placeholder="Entity" /></SelectTrigger>

6
src/pages/SettingsPage.tsx
View File

@@ -38,7 +38,7 @@ export default function SettingsPage() {
</TabsList>
<TabsContent value="codes" className="mt-4 space-y-4">
<AiTipBanner tip="2 batch codes have been unused for over 30 days. Consider sending reminder emails to the assigned entities or recycling unused codes." variant="insight" />
<AiTipBanner context="settings-codes" variant="insight" />
<div className="flex gap-2">
<Button size="sm"><Plus className="h-4 w-4 mr-1" /> Generate Single</Button>
<Button size="sm" variant="outline"><Copy className="h-4 w-4 mr-1" /> Generate Batch</Button>
@@ -66,7 +66,7 @@ export default function SettingsPage() {
</TabsContent>
<TabsContent value="packages" className="mt-4 space-y-4">
<AiTipBanner tip="Based on conversion data, the IELTS Pro package has the highest ROI. Consider increasing the Corporate Bundle discount to 30% to boost enterprise sign-ups." variant="recommendation" />
<AiTipBanner context="settings-packages" variant="recommendation" />
<div className="grid grid-cols-1 md:grid-cols-3 gap-4">
{packages.map((p) => (
<Card key={p.id} className="border-0 shadow-sm">
@@ -84,7 +84,7 @@ export default function SettingsPage() {
</TabsContent>
<TabsContent value="grading" className="mt-4 space-y-4">
<AiTipBanner tip="Current 0.5 increment scoring aligns with official IELTS band scoring. AI recommends keeping this configuration for standardised assessment." variant="tip" />
<AiTipBanner context="settings-grading" variant="tip" />
<Card className="border-0 shadow-sm max-w-lg">
<CardHeader><CardTitle className="text-base">Scoring Scale</CardTitle></CardHeader>
<CardContent className="space-y-4">

15
src/pages/StatsCorporatePage.tsx
View File

@@ -6,13 +6,6 @@ import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
import { BarChart, Bar, XAxis, YAxis, CartesianGrid, Tooltip, ResponsiveContainer, LineChart, Line, PieChart, Pie, Cell } from "recharts";
import AiReportNarrative from "@/components/ai/AiReportNarrative";
const tabNarratives: Record<string, string> = {
overview: "Writing scores (61%) are significantly lower than other modules. Consider allocating more teaching resources to writing workshops. Reading leads at 72%, suggesting current materials are effective.",
trends: "Scores have shown a consistent upward trend of +14 points over 6 months. The plateau in April correlates with mid-term exam stress. June's 72% is the highest recorded average this year.",
distribution: "B1 is the largest cohort at 30%, indicating most students are at intermediate level. Only 3% reach C2 — consider creating more advanced pathways to support progression from C1.",
comparison: "Attendance dropped 8% in the second week of March, correlating with the mid-term assignment deadline. Consider spacing deadlines more evenly across the term.",
};
const thresholds = ["0%", "50%", "70%", "90%"];
const barData = [
@@ -69,7 +62,7 @@ export default function StatsCorporatePage() {
</TabsList>
<TabsContent value="overview" className="mt-4">
<AiReportNarrative narrative={tabNarratives.overview} />
<AiReportNarrative report_type="corporate-overview" data={{ modules: barData }} />
<Card className="border-0 shadow-sm">
<CardHeader><CardTitle className="text-base">Average Score by Module</CardTitle></CardHeader>
<CardContent>
@@ -87,7 +80,7 @@ export default function StatsCorporatePage() {
</TabsContent>
<TabsContent value="trends" className="mt-4">
<AiReportNarrative narrative={tabNarratives.trends} />
<AiReportNarrative report_type="corporate-trends" data={{ trends: trendData }} />
<Card className="border-0 shadow-sm">
<CardHeader><CardTitle className="text-base">Score Trend Over Time</CardTitle></CardHeader>
<CardContent>
@@ -105,7 +98,7 @@ export default function StatsCorporatePage() {
</TabsContent>
<TabsContent value="distribution" className="mt-4">
<AiReportNarrative narrative={tabNarratives.distribution} />
<AiReportNarrative report_type="corporate-distribution" data={{ distribution: distData }} />
<Card className="border-0 shadow-sm">
<CardHeader><CardTitle className="text-base">Level Distribution</CardTitle></CardHeader>
<CardContent className="flex justify-center">
@@ -122,7 +115,7 @@ export default function StatsCorporatePage() {
</TabsContent>
<TabsContent value="comparison" className="mt-4">
<AiReportNarrative narrative={tabNarratives.comparison} />
<AiReportNarrative report_type="corporate-comparison" data={{ threshold }} />
<Card className="border-0 shadow-sm">
<CardContent className="p-8 text-center text-muted-foreground">Entity comparison charts will appear here based on selected filters.</CardContent>
</Card>

2
src/pages/admin/AiEnglishQuality.tsx
View File

@@ -113,7 +113,7 @@ export default function AiEnglishQuality() {
<Button
onClick={() =>
reject.mutate(
{ courseId, notes },
{ courseId, reason: notes },
{
onSuccess: () => {
toast.success("Rejected; regeneration requested.");

12
src/pages/admin/AiIeltsValidation.tsx
View File

@@ -38,13 +38,11 @@ export default function AiIeltsValidation() {
const send = (approved: boolean) => {
if (!preview) return;
const payload: Parameters<typeof submitReview.mutate>[0] = {
item_id: preview.id,
approved,
notes: approved ? undefined : notes,
checklist,
};
submitReview.mutate(payload, {
submitReview.mutate({
logId: preview.id,
action: approved ? "approve" : "reject",
examiner_notes: approved ? undefined : notes,
}, {
onSuccess: () => {
toast.success(approved ? "Approved." : "Rejected with notes.");
setPreview(null);

2
src/pages/student/AiEnglishCourse.tsx
View File

@@ -141,7 +141,7 @@ export default function AiEnglishCourse() {
.filter(Boolean)
: course?.learning_style ?? ["visual"];
createEnglish.mutate(
{ current_level: course?.current_level ?? "B1", target_level: tgt, learning_style: styles },
{ cefr_level: tgt || course?.current_level || "B1" },
{
onSuccess: () => {
qc.invalidateQueries({ queryKey: queryKeys.aiCourse.course(courseId) });

3
src/pages/student/AiIeltsCourse.tsx
View File

@@ -166,9 +166,8 @@ export default function AiIeltsCourse() {
const band = Number(targetBand || course?.target_level || 7);
createIelts.mutate(
{
exam_type: course?.exam_type ?? "academic",
skill: skillsRanked[0]?.skill ?? "writing",
target_band: Number.isFinite(band) ? band : 7,
skills: skillsRanked.map((s) => s.skill),
},
{
onSuccess: () => {

43
src/pages/student/ExamSession.tsx
View File

@@ -22,8 +22,8 @@ import { ScrollArea } from "@/components/ui/scroll-area";
import { Flag, ChevronLeft, ChevronRight, Pause, Play } from "lucide-react";
import { cn } from "@/lib/utils";
function normalizeType(t: string) {
return t.toLowerCase().replace(/\s+/g, "_");
function normalizeType(t: string | null | undefined) {
return (t ?? "").toLowerCase().replace(/\s+/g, "_");
}
function countWords(s: string) {
@@ -49,10 +49,26 @@ export default function ExamSession() {
const { examId: examIdParam } = useParams();
const examId = Number(examIdParam);
const navigate = useNavigate();
const { data: session, isLoading, isError } = useExamSession(examId);
const { data: rawSession, isLoading, isError } = useExamSession(examId);
const autoSave = useExamAutoSave();
const submitMut = useExamSubmit();
const session = useMemo(() => {
if (!rawSession) return rawSession;
const raw = rawSession as any;
return {
...raw,
title: raw.title || raw.exam_title || "",
sections: (raw.sections || []).map((s: any) => ({
...s,
questions: (s.questions || []).map((q: any) => ({
...q,
type: q.type || q.question_type || q.skill || "",
})),
})),
} as typeof rawSession;
}, [rawSession]);
const [sectionIdx, setSectionIdx] = useState(0);
const [questionIdx, setQuestionIdx] = useState(0);
const [answers, setAnswers] = useState<Map<number, ExamAnswer>>(new Map());
@@ -121,10 +137,11 @@ export default function ExamSession() {
useEffect(() => {
if (!session || !section) return;
const attemptId = (session as any)?.attempt_id;
const id = window.setInterval(() => {
autoSave.mutate({
examId,
payload: { section_id: section.id, answers: currentSectionAnswers() },
payload: { attempt_id: attemptId, section_id: section.id, answers: currentSectionAnswers() },
});
}, 10000);
return () => window.clearInterval(id);
@@ -439,12 +456,20 @@ export default function ExamSession() {
<Button
type="button"
onClick={() => {
submitMut.mutate(examId, {
onSuccess: () => {
setReviewOpen(false);
navigate(`/student/exam/${examId}/status`);
const attemptId = (session as any)?.attempt_id;
const allAnswers = Array.from(answers.entries()).map(([qId, a]) => ({
question_id: qId,
answer: a.answer ?? "",
}));
submitMut.mutate(
{ examId, attempt_id: attemptId, answers: allAnswers },
{
onSuccess: () => {
setReviewOpen(false);
navigate(`/student/exam/${examId}/status`);
},
},
});
);
}}
disabled={submitMut.isPending}
>

2
src/pages/student/StudentGrades.tsx
View File

@@ -29,7 +29,7 @@ export default function StudentGrades() {
<p className="text-muted-foreground">Track your academic performance.</p>
</div>
<AiReportNarrative narrative={`Your average grade is ${avgGrade}%. Your strongest area is essay writing with consistent scores above 80%. Focus on improving speaking scores — your last mock test scored 72%, which is below your average. AI recommends practicing with the IELTS Speaking Masterclass materials.`} />
<AiReportNarrative report_type="grades" data={{ avgGrade, highest, count: gradeRecords.length }} />
<div className="grid grid-cols-1 sm:grid-cols-3 gap-4">
<Card><CardContent className="pt-6 text-center"><p className="text-sm text-muted-foreground">Average</p><p className="text-3xl font-bold text-primary">{avgGrade}%</p></CardContent></Card>