feat: add product expansion suite

Makefile

@@ -1,6 +1,6 @@
 .DEFAULT_GOAL := help
 
-APP_DIR := lexilingo_app
+APP_DIR := flutter-app
 FLUTTER ?= flutter
 DART ?= dart
 

admin-service/src/App.tsx

@@ -10,7 +10,8 @@ import {
   LayoutDashboard, Users, BookOpen, Layers, FileText,
   PenTool, BarChart3, Languages, Trophy, ShoppingBag,
   Megaphone, ScrollText, Activity, Settings,
-  Shield, Database, Bot, ArrowRight, ArrowLeft, MessageSquare, Swords, Bell
+  Shield, Database, Bot, ArrowRight, ArrowLeft, MessageSquare, Swords, Bell,
+  ClipboardCheck, Gauge
 } from "lucide-react";
 
 // Lazy-loaded components
@@ -31,9 +32,11 @@ const AdsPage = lazy(() => import("./pages/AdsPage").then(m => ({ default: m.Ads
 const LogsPage = lazy(() => import("./pages/LogsPage").then(m => ({ default: m.LogsPage })));
 const MonitoringPage = lazy(() => import("./pages/MonitoringPage").then(m => ({ default: m.MonitoringPage })));
 const ContentLabPage = lazy(() => import("./pages/ContentLabPage").then(m => ({ default: m.ContentLabPage })));
+const ContentQaQueuePage = lazy(() => import("./pages/ContentQaQueuePage").then(m => ({ default: m.ContentQaQueuePage })));
 const DatabasePage = lazy(() => import("./pages/DatabasePage").then(m => ({ default: m.DatabasePage })));
 const AiModelsPage = lazy(() => import("./pages/AiModelsPage").then(m => ({ default: m.AiModelsPage })));
 const ContentAnalyticsPage = lazy(() => import("./pages/ContentAnalyticsPage").then(m => ({ default: m.ContentAnalyticsPage })));
+const AiQualityDashboardPage = lazy(() => import("./pages/AiQualityDashboardPage").then(m => ({ default: m.AiQualityDashboardPage })));
 const SystemSettingsPage = lazy(() => import("./pages/SystemSettingsPage").then(m => ({ default: m.SystemSettingsPage })));
 const AdminManagementPage = lazy(() => import("./pages/AdminManagementPage").then(m => ({ default: m.AdminManagementPage })));
 const AiChatSettingsPage = lazy(() => import("./pages/AiChatSettingsPage").then(m => ({ default: m.AiChatSettingsPage })));
@@ -60,7 +63,9 @@ const AppRoutes = () => {
     { to: "/admin/lessons", label: t.nav.lessons, icon: <FileText size={18} /> },
     { to: "/admin/topics", label: t.nav.topics, icon: <MessageSquare size={18} /> },
     { to: "/admin/content-lab", label: t.nav.grammarTest, icon: <PenTool size={18} /> },
+    { to: "/admin/content-qa", label: t.nav.contentQaQueue, icon: <ClipboardCheck size={18} /> },
     { to: "/admin/content-analytics", label: t.nav.contentAnalytics, icon: <BarChart3 size={18} /> },
+    { to: "/admin/ai-quality", label: t.nav.aiQuality, icon: <Gauge size={18} /> },
     { to: "/admin/vocabulary", label: t.nav.vocabulary, icon: <Languages size={18} /> },
     { to: "/admin/achievements", label: t.nav.achievements, icon: <Trophy size={18} /> },
     { to: "/admin/shop", label: t.nav.shop, icon: <ShoppingBag size={18} /> },
@@ -104,7 +109,9 @@ const AppRoutes = () => {
               <Route path="/admin/lessons" element={<LessonsPage />} />
               <Route path="/admin/topics" element={<TopicsPage />} />
               <Route path="/admin/content-lab" element={<ContentLabPage />} />
+              <Route path="/admin/content-qa" element={<ContentQaQueuePage />} />
               <Route path="/admin/content-analytics" element={<ContentAnalyticsPage />} />
+              <Route path="/admin/ai-quality" element={<AiQualityDashboardPage />} />
               <Route path="/admin/vocabulary" element={<VocabularyPage />} />
               <Route path="/admin/achievements" element={<AchievementsPage />} />
               <Route path="/admin/shop" element={<ShopPage />} />

admin-service/src/lib/adminApi.ts

@@ -280,6 +280,8 @@ export const uploadBadgeImage = async (file: File): Promise<AdminResponse<{ url:
 // Shop Management
 // ============================================================================
 
+export type ShopItemEffects = Record<string, unknown>;
+
 export type ShopItemType = {
   id: string;
   name: string;
@@ -289,6 +291,7 @@ export type ShopItemType = {
   is_available: boolean;
   stock_quantity?: number | null;
   icon_url?: string | null;
+  effects?: ShopItemEffects | null;
 };
 
 export const listShopItems = async (includeUnavailable = true) =>
@@ -303,17 +306,19 @@ export const createShopItem = async (params: {
   price_gems: number;
   is_available?: boolean;
   stock_quantity?: number;
-}) => {
-  const url = new URL(`${ENV.backendUrl}/admin/shop`);
-  Object.entries(params).forEach(([k, v]) => { if (v !== undefined) url.searchParams.set(k, String(v)); });
-  return apiFetch<AdminResponse<ShopItemType>>(url.toString(), { method: "POST" });
-};
+  icon_url?: string;
+  effects?: ShopItemEffects;
+}) =>
+  apiFetch<AdminResponse<ShopItemType>>(`${ENV.backendUrl}/admin/shop`, {
+    method: "POST",
+    body: JSON.stringify(params),
+  });
 
-export const updateShopItem = async (id: string, params: Partial<ShopItemType>) => {
-  const url = new URL(`${ENV.backendUrl}/admin/shop/${id}`);
-  Object.entries(params).forEach(([k, v]) => { if (v !== undefined) url.searchParams.set(k, String(v)); });
-  return apiFetch<AdminResponse<ShopItemType>>(url.toString(), { method: "PUT" });
-};
+export const updateShopItem = async (id: string, params: Partial<ShopItemType>) =>
+  apiFetch<AdminResponse<ShopItemType>>(`${ENV.backendUrl}/admin/shop/${id}`, {
+    method: "PUT",
+    body: JSON.stringify(params),
+  });
 
 export const deleteShopItem = async (id: string) =>
   apiFetch<AdminResponse<{ deleted: boolean }>>(`${ENV.backendUrl}/admin/shop/${id}`, {

admin-service/src/lib/aiQualityApi.test.ts

@@ -0,0 +1,37 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const { apiFetchMock } = vi.hoisted(() => ({
+  apiFetchMock: vi.fn(),
+}));
+
+vi.mock("./api", () => ({
+  apiFetch: apiFetchMock,
+}));
+
+vi.mock("./env", () => ({
+  ENV: {
+    backendUrl: "https://backend.example/api/v1",
+  },
+}));
+
+import { getAiQualitySummary } from "./aiQualityApi";
+
+describe("aiQualityApi", () => {
+  beforeEach(() => {
+    apiFetchMock.mockReset();
+    apiFetchMock.mockResolvedValue({
+      events: [],
+      summary: { total_events: 0 },
+      total: 0,
+      source: "ai:audit:all",
+    });
+  });
+
+  it("loads the backend AI audit quality summary with a bounded limit", async () => {
+    await getAiQualitySummary(250);
+
+    expect(apiFetchMock).toHaveBeenCalledWith(
+      "https://backend.example/api/v1/ai-audit/quality-summary?limit=250",
+    );
+  });
+});

admin-service/src/lib/aiQualityApi.ts

@@ -0,0 +1,58 @@
+import { apiFetch } from "./api";
+import { ENV } from "./env";
+
+export type AiQualityEndpointBreakdown = {
+  endpoint: string;
+  total: number;
+  failures: number;
+  average_latency_ms: number;
+};
+
+export type AiQualityFailure = {
+  request_id?: string | null;
+  user_id?: string | null;
+  endpoint?: string | null;
+  status?: string | null;
+  latency_ms?: number | null;
+  received_at?: string | null;
+  error?: string | null;
+};
+
+export type AiQualitySummary = {
+  total_events: number;
+  success_count: number;
+  failure_count: number;
+  success_rate: number;
+  average_latency_ms: number;
+  p95_latency_ms: number;
+  lexi: {
+    events: number;
+    failures: number;
+    average_latency_ms: number;
+  };
+  stt: {
+    failures: number;
+  };
+  tts: {
+    failures: number;
+  };
+  correction: {
+    events: number;
+    failures: number;
+    average_score: number;
+  };
+  endpoint_breakdown: AiQualityEndpointBreakdown[];
+  latest_failures: AiQualityFailure[];
+};
+
+export type AiQualityResponse = {
+  events: unknown[];
+  summary: AiQualitySummary;
+  total: number;
+  source: string;
+};
+
+export const getAiQualitySummary = (limit = 500) =>
+  apiFetch<AiQualityResponse>(
+    `${ENV.backendUrl}/ai-audit/quality-summary?limit=${encodeURIComponent(limit)}`,
+  );

admin-service/src/lib/contentAgentApi.test.ts

@@ -16,11 +16,13 @@ vi.mock("./env", () => ({
 
 import {
   applyContentAgentJob,
+  buildContentQaQueue,
   cancelContentAgentJob,
   createContentAgentJob,
   getContentAgentJob,
   getContentAgentPreview,
   listContentAgentJobs,
+  listContentQaQueue,
   retryContentAgentJob,
   uploadContentAgentFile,
 } from "./contentAgentApi";
@@ -121,4 +123,36 @@ describe("contentAgentApi", () => {
       total: 4,
     });
   });
+
+  it("builds a content QA queue from agent job statuses", () => {
+    const queue = buildContentQaQueue([
+      { id: "ready", status: "preview_ready" },
+      { id: "failed", status: "failed" },
+      { id: "done", status: "completed" },
+      { id: "running", status: "generating" },
+    ] as any);
+
+    expect(queue.total).toBe(4);
+    expect(queue.reviewable.map((job) => job.id)).toEqual(["ready"]);
+    expect(queue.failed.map((job) => job.id)).toEqual(["failed"]);
+    expect(queue.applied.map((job) => job.id)).toEqual(["done"]);
+  });
+
+  it("loads content QA queue through the jobs endpoint", async () => {
+    apiFetchMock.mockResolvedValueOnce({
+      data: {
+        jobs: [
+          { id: "job-1", status: "preview_ready" },
+          { id: "job-2", status: "failed" },
+        ],
+        total: 2,
+      },
+    });
+
+    await expect(listContentQaQueue()).resolves.toMatchObject({
+      reviewable: [{ id: "job-1" }],
+      failed: [{ id: "job-2" }],
+      total: 2,
+    });
+  });
 });

admin-service/src/lib/contentAgentApi.ts

@@ -201,6 +201,13 @@ export type ContentAgentJobList = {
   total: number;
 };
 
+export type ContentQaQueue = {
+  reviewable: ContentAgentJob[];
+  failed: ContentAgentJob[];
+  applied: ContentAgentJob[];
+  total: number;
+};
+
 type ApiEnvelope<T> = {
   success?: boolean;
   data?: T;
@@ -297,6 +304,26 @@ export const listContentAgentJobs = async (): Promise<ContentAgentJobList> => {
   };
 };
 
+export const buildContentQaQueue = (
+  jobs: readonly ContentAgentJob[],
+): ContentQaQueue => {
+  const reviewable = jobs.filter((job) => job.status === "preview_ready");
+  const failed = jobs.filter((job) => job.status === "failed");
+  const applied = jobs.filter((job) => job.status === "completed");
+
+  return {
+    reviewable,
+    failed,
+    applied,
+    total: jobs.length,
+  };
+};
+
+export const listContentQaQueue = async (): Promise<ContentQaQueue> => {
+  const { jobs } = await listContentAgentJobs();
+  return buildContentQaQueue(jobs);
+};
+
 export const getContentAgentJob = async (
   jobId: string,
 ): Promise<ContentAgentJob> => {

admin-service/src/lib/i18n/en.ts

@@ -67,7 +67,9 @@ const en: Translations = {
     lessons: "Lessons",
     topics: "Topics",
     grammarTest: "Grammar & Tests",
+    contentQaQueue: "Content QA",
     contentAnalytics: "Content Analytics",
+    aiQuality: "AI Quality",
     vocabulary: "Vocabulary",
     achievements: "Achievements",
     shop: "Shop",
@@ -479,6 +481,13 @@ const en: Translations = {
     stockQuantity: "Stock Quantity",
     unlimitedPlaceholder: "Leave blank = unlimited",
     updateFailed: "Update failed",
+    useTemplate: "Use Template",
+    templateApplied: "Template applied for this item type — adjust as needed before saving.",
+    iconUrl: "Icon URL",
+    iconUrlPlaceholder: "e.g. assets/icon-library/clock_freeze.png",
+    effectsLabel: "Effects (JSON)",
+    effectsHint: "e.g. {\"seconds\": 10} — determines how this item behaves in-game.",
+    effectsInvalidJson: "Effects must be valid JSON, e.g. {\"seconds\": 10}",
   },
 
   // ============== Ads/Banner ==============

admin-service/src/lib/i18n/vi.ts

@@ -65,7 +65,9 @@ const vi = {
     lessons: "Bài học",
     topics: "Topic chat",
     grammarTest: "Ngữ pháp & Kiểm tra",
+    contentQaQueue: "QA nội dung",
     contentAnalytics: "Phân tích nội dung",
+    aiQuality: "Chất lượng AI",
     vocabulary: "Từ vựng",
     achievements: "Thành tựu",
     shop: "Cửa hàng",
@@ -477,6 +479,13 @@ const vi = {
     stockQuantity: "Số lượng kho",
     unlimitedPlaceholder: "Để trống = vô hạn",
     updateFailed: "Cập nhật thất bại",
+    useTemplate: "Dùng mẫu",
+    templateApplied: "Đã điền mẫu cho loại item này — có thể chỉnh lại trước khi lưu.",
+    iconUrl: "URL icon",
+    iconUrlPlaceholder: "VD: assets/icon-library/clock_freeze.png",
+    effectsLabel: "Hiệu ứng (JSON)",
+    effectsHint: "VD: {\"seconds\": 10} — quyết định cách item này hoạt động trong game.",
+    effectsInvalidJson: "Hiệu ứng phải là JSON hợp lệ, ví dụ {\"seconds\": 10}",
   },
 
   // ============== Ads/Banner ==============