feat(teacher-portal): 完整实现 teacher-portal 微前端
包含 settings/students/api、graphql、mocks、ui-tokens 设计令牌等
This commit is contained in:
SpecialX
@@ -1,293 +1,97 @@
|
||||
"use client";
|
||||
|
||||
import { useState, useEffect, useCallback } from "react";
|
||||
import { getToken } from "@/lib/auth";
|
||||
/**
|
||||
* Classes 页面 - 班级管理（只读列表）
|
||||
*
|
||||
* 数据来源（ARB-001 §1.2）：GraphQL ClassesQuery
|
||||
* - 返回当前教师 dataScope 范围内的班级列表
|
||||
* - P2 阶段为只读展示（Mutation 在 P3 启用）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
interface ClassItem {
|
||||
id: string;
|
||||
name: string;
|
||||
gradeId: string;
|
||||
description?: string;
|
||||
createdAt: number;
|
||||
updatedAt: number;
|
||||
}
|
||||
|
||||
interface ApiResponse<T> {
|
||||
success: boolean;
|
||||
data?: T;
|
||||
error?: { code: string; message: string };
|
||||
}
|
||||
import { useQuery } from "urql";
|
||||
import Link from "next/link";
|
||||
import { Loading, Empty } from "@edu/ui-components";
|
||||
import { ClassesQuery } from "@/lib/graphql";
|
||||
import type { Class } from "@/lib/graphql";
|
||||
|
||||
export default function ClassesPage() {
|
||||
const [classes, setClasses] = useState<ClassItem[]>([]);
|
||||
const [loading, setLoading] = useState(false);
|
||||
const [name, setName] = useState("");
|
||||
const [gradeId, setGradeId] = useState(
|
||||
"550e8400-e29b-41d4-a716-446655440000",
|
||||
);
|
||||
const [description, setDescription] = useState("");
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
|
||||
const authHeaders = (): Record<string, string> => {
|
||||
const token = getToken();
|
||||
return token ? { Authorization: `Bearer ${token}` } : {};
|
||||
};
|
||||
|
||||
const fetchClasses = useCallback(async () => {
|
||||
setLoading(true);
|
||||
setError(null);
|
||||
try {
|
||||
const res = await fetch("/api/v1/classes", {
|
||||
headers: authHeaders(),
|
||||
});
|
||||
const json: ApiResponse<ClassItem[]> = await res.json();
|
||||
if (json.success && json.data) {
|
||||
setClasses(json.data);
|
||||
} else {
|
||||
setError(json.error?.message || "Failed to load");
|
||||
}
|
||||
} catch (e) {
|
||||
setError(e instanceof Error ? e.message : "Network error");
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
}, []);
|
||||
|
||||
useEffect(() => {
|
||||
fetchClasses();
|
||||
}, [fetchClasses]);
|
||||
|
||||
const handleCreate = async (e: React.FormEvent) => {
|
||||
e.preventDefault();
|
||||
if (!name.trim()) return;
|
||||
try {
|
||||
const res = await fetch("/api/v1/classes", {
|
||||
method: "POST",
|
||||
headers: {
|
||||
"Content-Type": "application/json",
|
||||
...authHeaders(),
|
||||
},
|
||||
body: JSON.stringify({ name, gradeId, description }),
|
||||
});
|
||||
const json = await res.json();
|
||||
if (!json.success) {
|
||||
setError(json.error?.message || "Create failed");
|
||||
return;
|
||||
}
|
||||
setName("");
|
||||
setDescription("");
|
||||
await fetchClasses();
|
||||
} catch (e) {
|
||||
setError(e instanceof Error ? e.message : "Network error");
|
||||
}
|
||||
};
|
||||
|
||||
const handleDelete = async (id: string) => {
|
||||
try {
|
||||
const res = await fetch(`/api/v1/classes/${id}`, {
|
||||
method: "DELETE",
|
||||
headers: authHeaders(),
|
||||
});
|
||||
const json = await res.json();
|
||||
if (!json.success) {
|
||||
setError(json.error?.message || "Delete failed");
|
||||
return;
|
||||
}
|
||||
await fetchClasses();
|
||||
} catch (e) {
|
||||
setError(e instanceof Error ? e.message : "Network error");
|
||||
}
|
||||
};
|
||||
const [result] = useQuery({ query: ClassesQuery });
|
||||
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<header className="mb-8">
|
||||
<h1
|
||||
className="text-3xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
班级管理
|
||||
</h1>
|
||||
<p className="mt-1 text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
classes 域 CRUD · JWT 鉴权
|
||||
<h1 className="text-3xl font-serif text-ink">班级管理</h1>
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
GraphQL ClassesQuery · 按教师 dataScope 过滤
|
||||
</p>
|
||||
</header>
|
||||
|
||||
<div className="rule-thin mb-8" />
|
||||
|
||||
<div className="grid grid-cols-12 gap-8">
|
||||
<aside className="col-span-4">
|
||||
<h2
|
||||
className="text-xl mb-4"
|
||||
style={{ fontFamily: "var(--font-serif)" }}
|
||||
>
|
||||
新建班级
|
||||
<section>
|
||||
<div className="flex items-baseline justify-between mb-4">
|
||||
<h2 className="text-xl font-serif text-ink">
|
||||
班级列表
|
||||
<span className="ml-2 text-sm font-sans text-ink-muted">
|
||||
{result.data?.classes.length ?? 0} 个
|
||||
</span>
|
||||
</h2>
|
||||
<div className="rule-thin mb-4" />
|
||||
<form onSubmit={handleCreate} className="space-y-4">
|
||||
<div>
|
||||
<label
|
||||
className="block text-xs uppercase tracking-wide mb-1"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
班级名称
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
value={name}
|
||||
onChange={(e) => setName(e.target.value)}
|
||||
className="w-full px-3 py-2 bg-transparent border-b focus:outline-none focus:border-b-2"
|
||||
style={{
|
||||
borderColor: "var(--color-rule)",
|
||||
borderRadius: "6px 6px 0 0",
|
||||
}}
|
||||
placeholder="如：高三(1)班"
|
||||
required
|
||||
/>
|
||||
</div>
|
||||
<div>
|
||||
<label
|
||||
className="block text-xs uppercase tracking-wide mb-1"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
年级 ID
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
value={gradeId}
|
||||
onChange={(e) => setGradeId(e.target.value)}
|
||||
className="w-full px-3 py-2 bg-transparent border-b text-sm font-mono"
|
||||
style={{
|
||||
borderColor: "var(--color-rule)",
|
||||
borderRadius: "6px 6px 0 0",
|
||||
}}
|
||||
/>
|
||||
</div>
|
||||
<div>
|
||||
<label
|
||||
className="block text-xs uppercase tracking-wide mb-1"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
描述（可选）
|
||||
</label>
|
||||
<textarea
|
||||
value={description}
|
||||
onChange={(e) => setDescription(e.target.value)}
|
||||
className="w-full px-3 py-2 bg-transparent border-b resize-none"
|
||||
style={{
|
||||
borderColor: "var(--color-rule)",
|
||||
borderRadius: "6px 6px 0 0",
|
||||
}}
|
||||
rows={3}
|
||||
/>
|
||||
</div>
|
||||
<button
|
||||
type="submit"
|
||||
className="px-4 py-2 text-white text-sm tracking-wide transition-opacity hover:opacity-90"
|
||||
style={{ background: "var(--color-accent)", borderRadius: "6px" }}
|
||||
>
|
||||
创建班级
|
||||
</button>
|
||||
</form>
|
||||
</aside>
|
||||
</div>
|
||||
<div className="rule-thin mb-6" />
|
||||
|
||||
<section className="col-span-8">
|
||||
<div className="flex items-baseline justify-between mb-4">
|
||||
<h2 className="text-xl" style={{ fontFamily: "var(--font-serif)" }}>
|
||||
班级列表
|
||||
<span
|
||||
className="ml-2 text-sm font-sans"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
{classes.length} 个
|
||||
</span>
|
||||
</h2>
|
||||
<button
|
||||
onClick={fetchClasses}
|
||||
className="text-xs uppercase tracking-wide hover:opacity-70"
|
||||
style={{ color: "var(--color-accent)" }}
|
||||
>
|
||||
刷新
|
||||
</button>
|
||||
{result.fetching ? (
|
||||
<Loading lines={4} />
|
||||
) : result.error ? (
|
||||
<div className="mark-left mb-4 py-2 border-l-2 border-danger pl-md">
|
||||
<p className="text-sm px-3 text-danger">
|
||||
加载失败：{result.error.message}
|
||||
</p>
|
||||
</div>
|
||||
<div className="rule-thin mb-6" />
|
||||
|
||||
{error && (
|
||||
<div
|
||||
className="mark-left mb-4 py-2"
|
||||
style={{ borderColor: "var(--color-accent)" }}
|
||||
>
|
||||
<p
|
||||
className="text-sm px-3"
|
||||
style={{ color: "var(--color-accent)" }}
|
||||
) : !result.data?.classes || result.data.classes.length === 0 ? (
|
||||
<Empty title="暂无班级" description="请联系管理员分配班级" />
|
||||
) : (
|
||||
<ul className="space-y-0">
|
||||
{(result.data.classes as Class[]).map((cls) => (
|
||||
<li
|
||||
key={cls.id}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline border-b border-rule"
|
||||
>
|
||||
{error}
|
||||
</p>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{loading ? (
|
||||
<p className="text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
加载中...
|
||||
</p>
|
||||
) : classes.length === 0 ? (
|
||||
<p
|
||||
className="text-sm italic"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
暂无班级，从左侧创建第一个
|
||||
</p>
|
||||
) : (
|
||||
<ul className="space-y-0">
|
||||
{classes.map((cls) => (
|
||||
<li
|
||||
key={cls.id}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline"
|
||||
style={{ borderBottom: "1px solid var(--color-rule)" }}
|
||||
>
|
||||
<div className="col-span-7">
|
||||
<h3
|
||||
className="text-lg"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
{cls.name}
|
||||
</h3>
|
||||
{cls.description && (
|
||||
<p
|
||||
className="mt-1 text-sm"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
{cls.description}
|
||||
</p>
|
||||
)}
|
||||
</div>
|
||||
<div
|
||||
className="col-span-3 text-xs font-mono"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
<div className="col-span-7">
|
||||
<h3 className="text-lg font-serif text-ink">{cls.name}</h3>
|
||||
<p className="mt-1 text-tiny text-ink-muted">
|
||||
年级：{cls.gradeId}
|
||||
</p>
|
||||
</div>
|
||||
<div className="col-span-2 text-sm text-ink-muted">
|
||||
{cls.studentCount} 名学生
|
||||
</div>
|
||||
<div className="col-span-3 text-right flex justify-end gap-4">
|
||||
<Link
|
||||
href={`/students?classId=${cls.id}`}
|
||||
className="text-tiny uppercase tracking-wide text-accent hover:opacity-70"
|
||||
>
|
||||
{cls.id.slice(0, 8)}...
|
||||
</div>
|
||||
<div className="col-span-2 text-right">
|
||||
<button
|
||||
onClick={() => handleDelete(cls.id)}
|
||||
className="text-xs uppercase tracking-wide hover:opacity-70"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
删除
|
||||
</button>
|
||||
</div>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
)}
|
||||
</section>
|
||||
</div>
|
||||
查看学生
|
||||
</Link>
|
||||
<Link
|
||||
href={`/exams?classId=${cls.id}`}
|
||||
className="text-tiny uppercase tracking-wide text-ink-muted hover:opacity-70"
|
||||
>
|
||||
考试
|
||||
</Link>
|
||||
<Link
|
||||
href={`/homework?classId=${cls.id}`}
|
||||
className="text-tiny uppercase tracking-wide text-ink-muted hover:opacity-70"
|
||||
>
|
||||
作业
|
||||
</Link>
|
||||
</div>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
)}
|
||||
</section>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,139 +1,146 @@
|
||||
"use client";
|
||||
|
||||
import { useEffect, useState } from "react";
|
||||
import { getToken, getUser, type UserInfo } from "@/lib/auth";
|
||||
/**
|
||||
* Dashboard 页面 - 教师仪表盘
|
||||
*
|
||||
* 数据来源（ARB-001 §1.2）：GraphQL DashboardQuery
|
||||
* - 并行聚合：iam.me + iam.viewports + iam.permissions + classes.byTeacher
|
||||
* - 返回：user + classes + viewports + stats
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
interface DashboardData {
|
||||
user: { success: boolean; data?: { user: UserInfo } };
|
||||
classes: { success: boolean; data?: unknown[] };
|
||||
}
|
||||
import { useQuery } from "urql";
|
||||
import Link from "next/link";
|
||||
import { Loading, Empty } from "@edu/ui-components";
|
||||
import { DashboardQuery } from "@/lib/graphql";
|
||||
import type { Class } from "@/lib/graphql";
|
||||
|
||||
export default function DashboardPage() {
|
||||
const [data, setData] = useState<DashboardData | null>(null);
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [loading, setLoading] = useState(true);
|
||||
const user = getUser();
|
||||
const [result] = useQuery({ query: DashboardQuery });
|
||||
|
||||
useEffect(() => {
|
||||
const token = getToken();
|
||||
if (!token) return;
|
||||
(async () => {
|
||||
try {
|
||||
const res = await fetch("/api/v1/teacher/dashboard", {
|
||||
headers: { Authorization: `Bearer ${token}` },
|
||||
});
|
||||
const json = await res.json();
|
||||
if (json.success) {
|
||||
setData(json.data);
|
||||
} else {
|
||||
setError(json.error?.message || "加载失败");
|
||||
}
|
||||
} catch (e) {
|
||||
setError(e instanceof Error ? e.message : "网络错误");
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
})();
|
||||
}, []);
|
||||
if (result.fetching) {
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<Loading lines={5} />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const classesCount = Array.isArray(data?.classes?.data)
|
||||
? data!.classes.data.length
|
||||
: 0;
|
||||
if (result.error) {
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<header className="mb-8">
|
||||
<h1 className="text-3xl font-serif text-ink">欢迎</h1>
|
||||
</header>
|
||||
<div className="rule-thin mb-8" />
|
||||
<div className="mark-left py-2 mb-4 border-l-2 border-danger pl-md">
|
||||
<p className="text-sm px-3 text-danger">
|
||||
仪表盘加载失败：{result.error.message}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const data = result.data?.dashboard;
|
||||
if (!data) {
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<Empty title="暂无数据" description="仪表盘数据尚未就绪" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const { user, classes, stats } = data;
|
||||
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<header className="mb-8">
|
||||
<h1
|
||||
className="text-3xl"
|
||||
style={{ fontFamily: "var(--font-serif)", color: "var(--color-ink)" }}
|
||||
>
|
||||
欢迎，{user?.name || "老师"}
|
||||
</h1>
|
||||
<p className="mt-1 text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
{user?.email} · 角色：{user?.roles.join(", ") || "无"} · 数据范围：
|
||||
{user?.dataScope || "-"}
|
||||
<h1 className="text-3xl font-serif text-ink">欢迎，{user.name}</h1>
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
{user.email} · 角色：{user.roles.join(", ") || "无"} · 数据范围：
|
||||
{user.dataScope}
|
||||
</p>
|
||||
</header>
|
||||
|
||||
<div className="rule-thin mb-8" />
|
||||
|
||||
{loading ? (
|
||||
<p className="text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
加载中...
|
||||
</p>
|
||||
) : error ? (
|
||||
<div
|
||||
className="mark-left py-2 mb-4"
|
||||
style={{ borderColor: "var(--color-accent)" }}
|
||||
>
|
||||
<p className="text-sm px-3" style={{ color: "var(--color-accent)" }}>
|
||||
{error}
|
||||
{/* 统计卡片 */}
|
||||
<section className="grid grid-cols-3 gap-6 mb-10">
|
||||
<div className="p-6 border border-rule rounded-card">
|
||||
<p className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
班级总数
|
||||
</p>
|
||||
<p className="mt-3 text-4xl font-serif text-ink">{classes.length}</p>
|
||||
</div>
|
||||
<div className="p-6 border border-rule rounded-card">
|
||||
<p className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
考试总数
|
||||
</p>
|
||||
<p className="mt-3 text-4xl font-serif text-ink">
|
||||
{stats.totalExams}
|
||||
</p>
|
||||
</div>
|
||||
) : (
|
||||
<section className="grid grid-cols-3 gap-6">
|
||||
<div
|
||||
className="p-6 border"
|
||||
style={{ borderColor: "var(--color-rule)" }}
|
||||
<div className="p-6 border border-rule rounded-card">
|
||||
<p className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
待批改
|
||||
</p>
|
||||
<p className="mt-3 text-4xl font-serif text-accent">
|
||||
{stats.pendingGrading}
|
||||
</p>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
{/* 班级快览 */}
|
||||
<section>
|
||||
<div className="flex items-baseline justify-between mb-4">
|
||||
<h2 className="text-xl font-serif text-ink">
|
||||
我的班级
|
||||
<span className="ml-2 text-sm font-sans text-ink-muted">
|
||||
{classes.length} 个
|
||||
</span>
|
||||
</h2>
|
||||
<Link
|
||||
href="/classes"
|
||||
className="text-tiny uppercase tracking-wide text-accent hover:opacity-70"
|
||||
>
|
||||
<p
|
||||
className="text-xs uppercase tracking-wide"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
班级总数
|
||||
</p>
|
||||
<p
|
||||
className="mt-3 text-4xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
{classesCount}
|
||||
</p>
|
||||
</div>
|
||||
<div
|
||||
className="p-6 border"
|
||||
style={{ borderColor: "var(--color-rule)" }}
|
||||
>
|
||||
<p
|
||||
className="text-xs uppercase tracking-wide"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
权限点
|
||||
</p>
|
||||
<p
|
||||
className="mt-3 text-4xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
{user?.permissions.length ?? 0}
|
||||
</p>
|
||||
</div>
|
||||
<div
|
||||
className="p-6 border"
|
||||
style={{ borderColor: "var(--color-rule)" }}
|
||||
>
|
||||
<p
|
||||
className="text-xs uppercase tracking-wide"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
数据范围
|
||||
</p>
|
||||
<p
|
||||
className="mt-3 text-2xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
{user?.dataScope || "-"}
|
||||
</p>
|
||||
</div>
|
||||
</section>
|
||||
)}
|
||||
查看全部
|
||||
</Link>
|
||||
</div>
|
||||
<div className="rule-thin mb-6" />
|
||||
|
||||
{classes.length === 0 ? (
|
||||
<Empty title="暂无班级" description="请联系管理员分配班级" />
|
||||
) : (
|
||||
<ul className="space-y-0">
|
||||
{(classes as Class[]).slice(0, 5).map((cls) => (
|
||||
<li
|
||||
key={cls.id}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline border-b border-rule"
|
||||
>
|
||||
<div className="col-span-8">
|
||||
<h3 className="text-lg font-serif text-ink">{cls.name}</h3>
|
||||
<p className="mt-1 text-tiny text-ink-muted">
|
||||
年级：{cls.gradeId}
|
||||
</p>
|
||||
</div>
|
||||
<div className="col-span-2 text-sm text-ink-muted">
|
||||
{cls.studentCount} 名学生
|
||||
</div>
|
||||
<div className="col-span-2 text-right">
|
||||
<Link
|
||||
href={`/students?classId=${cls.id}`}
|
||||
className="text-tiny uppercase tracking-wide text-accent hover:opacity-70"
|
||||
>
|
||||
查看学生
|
||||
</Link>
|
||||
</div>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
)}
|
||||
</section>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,179 +1,96 @@
|
||||
"use client";
|
||||
|
||||
import { useState, useEffect, useCallback } from "react";
|
||||
import { getToken } from "@/lib/auth";
|
||||
/**
|
||||
* Exams 页面 - 考试管理
|
||||
*
|
||||
* 数据来源（contract.md §2.4）：GraphQL ClassExamsQuery（P3 扩展，MSW mock）
|
||||
* - 通过 URL ?classId=xxx 指定班级
|
||||
* - P2 阶段用 MSW mock 数据，待 teacher-bff P3 启用 core-edu 聚合
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
interface ExamItem {
|
||||
id: string;
|
||||
classId: string;
|
||||
title: string;
|
||||
description?: string;
|
||||
examDate: string;
|
||||
duration: string;
|
||||
totalScore: string;
|
||||
status: string;
|
||||
createdBy: string;
|
||||
createdAt: string;
|
||||
updatedAt: string;
|
||||
}
|
||||
import { useQuery } from "urql";
|
||||
import { useSearchParams } from "next/navigation";
|
||||
import { Suspense } from "react";
|
||||
import { Loading, Empty } from "@edu/ui-components";
|
||||
import { ClassExamsQuery, ClassQuery } from "@/lib/graphql";
|
||||
import type { ExamItem } from "@/lib/graphql";
|
||||
|
||||
interface ApiResponse<T> {
|
||||
success: boolean;
|
||||
data?: T;
|
||||
error?: { code: string; message: string };
|
||||
}
|
||||
function ExamsContent() {
|
||||
const searchParams = useSearchParams();
|
||||
const classId = searchParams.get("classId") ?? "";
|
||||
|
||||
export default function ExamsPage() {
|
||||
const [exams, setExams] = useState<ExamItem[]>([]);
|
||||
const [loading, setLoading] = useState(false);
|
||||
const [classId, setClassId] = useState(
|
||||
"00000000-0000-0000-0000-000000000001",
|
||||
);
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [classResult] = useQuery({
|
||||
query: ClassQuery,
|
||||
variables: { id: classId },
|
||||
pause: !classId,
|
||||
});
|
||||
|
||||
const authHeaders = (): Record<string, string> => {
|
||||
const token = getToken();
|
||||
return token ? { Authorization: `Bearer ${token}` } : {};
|
||||
};
|
||||
const [examsResult] = useQuery({
|
||||
query: ClassExamsQuery,
|
||||
variables: { classId },
|
||||
pause: !classId,
|
||||
});
|
||||
|
||||
const fetchExams = useCallback(async () => {
|
||||
if (!classId.trim()) return;
|
||||
setLoading(true);
|
||||
setError(null);
|
||||
try {
|
||||
const res = await fetch(
|
||||
`/api/v1/teacher/classes/${encodeURIComponent(classId)}/exams`,
|
||||
{ headers: authHeaders() },
|
||||
);
|
||||
const json: ApiResponse<ExamItem[]> = await res.json();
|
||||
if (json.success && json.data) {
|
||||
setExams(json.data);
|
||||
} else {
|
||||
setError(json.error?.message || "Failed to load");
|
||||
}
|
||||
} catch (e) {
|
||||
setError(e instanceof Error ? e.message : "Network error");
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
}, [classId]);
|
||||
if (!classId) {
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<Empty title="未指定班级" description="请从班级列表进入查看考试" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
useEffect(() => {
|
||||
fetchExams();
|
||||
}, [fetchExams]);
|
||||
const cls = classResult.data?.class;
|
||||
const exams = examsResult.data?.classExams ?? [];
|
||||
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<header className="mb-8">
|
||||
<h1
|
||||
className="text-3xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
考试管理
|
||||
<h1 className="text-3xl font-serif text-ink">
|
||||
{cls ? `${cls.name} - 考试管理` : "考试管理"}
|
||||
</h1>
|
||||
<p className="mt-1 text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
core-edu 域 · BFF 聚合查询
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
GraphQL ClassExamsQuery · core-edu 域（P3 扩展，MSW mock）
|
||||
</p>
|
||||
</header>
|
||||
|
||||
<div className="rule-thin mb-8" />
|
||||
|
||||
<div className="mb-6 flex items-baseline gap-3">
|
||||
<label
|
||||
className="text-xs uppercase tracking-wide"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
班级 ID
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
value={classId}
|
||||
onChange={(e) => setClassId(e.target.value)}
|
||||
className="flex-1 max-w-md px-3 py-2 bg-transparent border-b text-sm font-mono"
|
||||
style={{ borderColor: "var(--color-rule)" }}
|
||||
placeholder="输入班级 UUID"
|
||||
/>
|
||||
<button
|
||||
onClick={fetchExams}
|
||||
className="text-xs uppercase tracking-wide hover:opacity-70"
|
||||
style={{ color: "var(--color-accent)" }}
|
||||
>
|
||||
查询
|
||||
</button>
|
||||
</div>
|
||||
|
||||
{error && (
|
||||
<div
|
||||
className="mark-left mb-4 py-2"
|
||||
style={{ borderColor: "var(--color-accent)" }}
|
||||
>
|
||||
<p className="text-sm px-3" style={{ color: "var(--color-accent)" }}>
|
||||
{error}
|
||||
{examsResult.fetching ? (
|
||||
<Loading lines={4} />
|
||||
) : examsResult.error ? (
|
||||
<div className="mark-left mb-4 py-2 border-l-2 border-danger pl-md">
|
||||
<p className="text-sm px-3 text-danger">
|
||||
加载失败：{examsResult.error.message}
|
||||
</p>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{loading ? (
|
||||
<p className="text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
加载中...
|
||||
</p>
|
||||
) : exams.length === 0 ? (
|
||||
<p
|
||||
className="text-sm italic"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
该班级下暂无考试
|
||||
</p>
|
||||
<Empty title="暂无考试" description="该班级尚未创建考试" />
|
||||
) : (
|
||||
<ul className="space-y-0">
|
||||
{exams.map((exam) => (
|
||||
{(exams as ExamItem[]).map((exam) => (
|
||||
<li
|
||||
key={exam.id}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline"
|
||||
style={{ borderBottom: "1px solid var(--color-rule)" }}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline border-b border-rule"
|
||||
>
|
||||
<div className="col-span-7">
|
||||
<h3
|
||||
className="text-lg"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
{exam.title}
|
||||
</h3>
|
||||
<h3 className="text-lg font-serif text-ink">{exam.title}</h3>
|
||||
{exam.description && (
|
||||
<p
|
||||
className="mt-1 text-sm"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
{exam.description}
|
||||
</p>
|
||||
)}
|
||||
<p
|
||||
className="mt-1 text-xs"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<p className="mt-1 text-tiny text-ink-muted">
|
||||
考试时间: {new Date(exam.examDate).toLocaleString("zh-CN")}
|
||||
{" · "}
|
||||
时长 {exam.duration} 分钟
|
||||
{" · "}
|
||||
满分 {exam.totalScore}
|
||||
{" · "}时长 {exam.duration} 分钟
|
||||
{" · "}满分 {exam.totalScore}
|
||||
</p>
|
||||
</div>
|
||||
<div
|
||||
className="col-span-3 text-xs"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<div className="col-span-3 text-tiny text-ink-muted">
|
||||
状态: {exam.status}
|
||||
</div>
|
||||
<div
|
||||
className="col-span-2 text-right text-xs font-mono"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<div className="col-span-2 text-right text-tiny font-mono text-ink-muted">
|
||||
{exam.id.slice(0, 8)}...
|
||||
</div>
|
||||
</li>
|
||||
@@ -183,3 +100,17 @@ export default function ExamsPage() {
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default function ExamsPage() {
|
||||
return (
|
||||
<Suspense
|
||||
fallback={
|
||||
<div className="px-10 py-10">
|
||||
<Loading lines={3} />
|
||||
</div>
|
||||
}
|
||||
>
|
||||
<ExamsContent />
|
||||
</Suspense>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,174 +1,96 @@
|
||||
"use client";
|
||||
|
||||
import { useState, useEffect, useCallback } from "react";
|
||||
import { getToken } from "@/lib/auth";
|
||||
/**
|
||||
* Grades 页面 - 成绩查询
|
||||
*
|
||||
* 数据来源（contract.md §2.4）：GraphQL ExamGradesQuery（P3 扩展，MSW mock）
|
||||
* - 通过 URL ?examId=xxx 指定考试
|
||||
* - P2 阶段用 MSW mock 数据，待 teacher-bff P3 启用 core-edu 聚合
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
interface GradeItem {
|
||||
id: string;
|
||||
studentId: string;
|
||||
examId: string | null;
|
||||
homeworkId: string | null;
|
||||
score: string;
|
||||
feedback?: string;
|
||||
gradedBy: string;
|
||||
createdAt: string;
|
||||
updatedAt: string;
|
||||
}
|
||||
import { useState, Suspense } from "react";
|
||||
import { useQuery } from "urql";
|
||||
import { useSearchParams } from "next/navigation";
|
||||
import { Loading, Empty } from "@edu/ui-components";
|
||||
import { ExamGradesQuery } from "@/lib/graphql";
|
||||
import type { GradeItem } from "@/lib/graphql";
|
||||
|
||||
interface ApiResponse<T> {
|
||||
success: boolean;
|
||||
data?: T;
|
||||
error?: { code: string; message: string };
|
||||
}
|
||||
function GradesContent() {
|
||||
const searchParams = useSearchParams();
|
||||
const initialExamId = searchParams.get("examId") ?? "";
|
||||
const [examId, setExamId] = useState(initialExamId);
|
||||
|
||||
export default function GradesPage() {
|
||||
const [items, setItems] = useState<GradeItem[]>([]);
|
||||
const [loading, setLoading] = useState(false);
|
||||
const [examId, setExamId] = useState("");
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [gradesResult] = useQuery({
|
||||
query: ExamGradesQuery,
|
||||
variables: { examId },
|
||||
pause: !examId,
|
||||
});
|
||||
|
||||
const authHeaders = (): Record<string, string> => {
|
||||
const token = getToken();
|
||||
return token ? { Authorization: `Bearer ${token}` } : {};
|
||||
};
|
||||
|
||||
const fetchGrades = useCallback(async () => {
|
||||
if (!examId.trim()) return;
|
||||
setLoading(true);
|
||||
setError(null);
|
||||
try {
|
||||
const res = await fetch(
|
||||
`/api/v1/teacher/exams/${encodeURIComponent(examId)}/grades`,
|
||||
{ headers: authHeaders() },
|
||||
);
|
||||
const json: ApiResponse<GradeItem[]> = await res.json();
|
||||
if (json.success && json.data) {
|
||||
setItems(json.data);
|
||||
} else {
|
||||
setError(json.error?.message || "Failed to load");
|
||||
}
|
||||
} catch (e) {
|
||||
setError(e instanceof Error ? e.message : "Network error");
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
}, [examId]);
|
||||
|
||||
useEffect(() => {
|
||||
fetchGrades();
|
||||
}, [fetchGrades]);
|
||||
const grades = gradesResult.data?.examGrades ?? [];
|
||||
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<header className="mb-8">
|
||||
<h1
|
||||
className="text-3xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
成绩查询
|
||||
</h1>
|
||||
<p className="mt-1 text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
core-edu 域 · BFF 聚合查询
|
||||
<h1 className="text-3xl font-serif text-ink">成绩查询</h1>
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
GraphQL ExamGradesQuery · core-edu 域（P3 扩展，MSW mock）
|
||||
</p>
|
||||
</header>
|
||||
|
||||
<div className="rule-thin mb-8" />
|
||||
|
||||
<div className="mb-6 flex items-baseline gap-3">
|
||||
<label
|
||||
className="text-xs uppercase tracking-wide"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<label className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
考试 ID
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
value={examId}
|
||||
onChange={(e) => setExamId(e.target.value)}
|
||||
className="flex-1 max-w-md px-3 py-2 bg-transparent border-b text-sm font-mono"
|
||||
style={{ borderColor: "var(--color-rule)" }}
|
||||
className="flex-1 max-w-md px-3 py-2 bg-transparent border-b border-rule text-sm font-mono"
|
||||
placeholder="输入考试 UUID"
|
||||
/>
|
||||
<button
|
||||
onClick={fetchGrades}
|
||||
className="text-xs uppercase tracking-wide hover:opacity-70"
|
||||
style={{ color: "var(--color-accent)" }}
|
||||
>
|
||||
查询
|
||||
</button>
|
||||
</div>
|
||||
|
||||
{error && (
|
||||
<div
|
||||
className="mark-left mb-4 py-2"
|
||||
style={{ borderColor: "var(--color-accent)" }}
|
||||
>
|
||||
<p className="text-sm px-3" style={{ color: "var(--color-accent)" }}>
|
||||
{error}
|
||||
{gradesResult.fetching ? (
|
||||
<Loading lines={4} />
|
||||
) : gradesResult.error ? (
|
||||
<div className="mark-left mb-4 py-2 border-l-2 border-danger pl-md">
|
||||
<p className="text-sm px-3 text-danger">
|
||||
加载失败：{gradesResult.error.message}
|
||||
</p>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{loading ? (
|
||||
<p className="text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
加载中...
|
||||
</p>
|
||||
) : items.length === 0 ? (
|
||||
<p
|
||||
className="text-sm italic"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
{examId.trim() ? "该考试下暂无成绩" : "请输入考试 ID 查询成绩"}
|
||||
</p>
|
||||
) : !examId ? (
|
||||
<Empty title="请输入考试 ID" description="输入考试 UUID 后查询成绩" />
|
||||
) : grades.length === 0 ? (
|
||||
<Empty title="暂无成绩" description="该考试尚未录入成绩" />
|
||||
) : (
|
||||
<ul className="space-y-0">
|
||||
{items.map((g) => (
|
||||
{(grades as GradeItem[]).map((g) => (
|
||||
<li
|
||||
key={g.id}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline"
|
||||
style={{ borderBottom: "1px solid var(--color-rule)" }}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline border-b border-rule"
|
||||
>
|
||||
<div className="col-span-6">
|
||||
<h3
|
||||
className="text-lg"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
学生: {g.studentId}
|
||||
</h3>
|
||||
<h3 className="text-lg font-serif text-ink">{g.studentName}</h3>
|
||||
<p className="mt-1 text-tiny text-ink-muted">
|
||||
学生 ID: {g.studentId}
|
||||
</p>
|
||||
{g.feedback && (
|
||||
<p
|
||||
className="mt-1 text-sm"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
反馈: {g.feedback}
|
||||
</p>
|
||||
)}
|
||||
</div>
|
||||
<div
|
||||
className="col-span-2 text-2xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-accent)",
|
||||
}}
|
||||
>
|
||||
<div className="col-span-2 text-2xl font-serif text-accent">
|
||||
{g.score}
|
||||
</div>
|
||||
<div
|
||||
className="col-span-2 text-xs"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
评分人: {g.gradedBy}
|
||||
<div className="col-span-2 text-tiny text-ink-muted">
|
||||
{g.examId ? `考试: ${g.examId.slice(0, 8)}...` : "作业成绩"}
|
||||
</div>
|
||||
<div
|
||||
className="col-span-2 text-right text-xs font-mono"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<div className="col-span-2 text-right text-tiny font-mono text-ink-muted">
|
||||
{g.id.slice(0, 8)}...
|
||||
</div>
|
||||
</li>
|
||||
@@ -178,3 +100,17 @@ export default function GradesPage() {
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default function GradesPage() {
|
||||
return (
|
||||
<Suspense
|
||||
fallback={
|
||||
<div className="px-10 py-10">
|
||||
<Loading lines={3} />
|
||||
</div>
|
||||
}
|
||||
>
|
||||
<GradesContent />
|
||||
</Suspense>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,173 +1,94 @@
|
||||
"use client";
|
||||
|
||||
import { useState, useEffect, useCallback } from "react";
|
||||
import { getToken } from "@/lib/auth";
|
||||
/**
|
||||
* Homework 页面 - 作业管理
|
||||
*
|
||||
* 数据来源（contract.md §2.4）：GraphQL ClassHomeworkQuery（P3 扩展，MSW mock）
|
||||
* - 通过 URL ?classId=xxx 指定班级
|
||||
* - P2 阶段用 MSW mock 数据，待 teacher-bff P3 启用 core-edu 聚合
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
interface HomeworkItem {
|
||||
id: string;
|
||||
classId: string;
|
||||
title: string;
|
||||
description?: string;
|
||||
dueDate: string;
|
||||
status: string;
|
||||
createdBy: string;
|
||||
createdAt: string;
|
||||
updatedAt: string;
|
||||
}
|
||||
import { useQuery } from "urql";
|
||||
import { useSearchParams } from "next/navigation";
|
||||
import { Suspense } from "react";
|
||||
import { Loading, Empty } from "@edu/ui-components";
|
||||
import { ClassHomeworkQuery, ClassQuery } from "@/lib/graphql";
|
||||
import type { HomeworkItem } from "@/lib/graphql";
|
||||
|
||||
interface ApiResponse<T> {
|
||||
success: boolean;
|
||||
data?: T;
|
||||
error?: { code: string; message: string };
|
||||
}
|
||||
function HomeworkContent() {
|
||||
const searchParams = useSearchParams();
|
||||
const classId = searchParams.get("classId") ?? "";
|
||||
|
||||
export default function HomeworkPage() {
|
||||
const [items, setItems] = useState<HomeworkItem[]>([]);
|
||||
const [loading, setLoading] = useState(false);
|
||||
const [classId, setClassId] = useState(
|
||||
"00000000-0000-0000-0000-000000000001",
|
||||
);
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [classResult] = useQuery({
|
||||
query: ClassQuery,
|
||||
variables: { id: classId },
|
||||
pause: !classId,
|
||||
});
|
||||
|
||||
const authHeaders = (): Record<string, string> => {
|
||||
const token = getToken();
|
||||
return token ? { Authorization: `Bearer ${token}` } : {};
|
||||
};
|
||||
const [homeworkResult] = useQuery({
|
||||
query: ClassHomeworkQuery,
|
||||
variables: { classId },
|
||||
pause: !classId,
|
||||
});
|
||||
|
||||
const fetchHomework = useCallback(async () => {
|
||||
if (!classId.trim()) return;
|
||||
setLoading(true);
|
||||
setError(null);
|
||||
try {
|
||||
const res = await fetch(
|
||||
`/api/v1/teacher/classes/${encodeURIComponent(classId)}/homework`,
|
||||
{ headers: authHeaders() },
|
||||
);
|
||||
const json: ApiResponse<HomeworkItem[]> = await res.json();
|
||||
if (json.success && json.data) {
|
||||
setItems(json.data);
|
||||
} else {
|
||||
setError(json.error?.message || "Failed to load");
|
||||
}
|
||||
} catch (e) {
|
||||
setError(e instanceof Error ? e.message : "Network error");
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
}, [classId]);
|
||||
if (!classId) {
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<Empty title="未指定班级" description="请从班级列表进入查看作业" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
useEffect(() => {
|
||||
fetchHomework();
|
||||
}, [fetchHomework]);
|
||||
const cls = classResult.data?.class;
|
||||
const items = homeworkResult.data?.classHomework ?? [];
|
||||
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<header className="mb-8">
|
||||
<h1
|
||||
className="text-3xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
作业管理
|
||||
<h1 className="text-3xl font-serif text-ink">
|
||||
{cls ? `${cls.name} - 作业管理` : "作业管理"}
|
||||
</h1>
|
||||
<p className="mt-1 text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
core-edu 域 · BFF 聚合查询
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
GraphQL ClassHomeworkQuery · core-edu 域（P3 扩展，MSW mock）
|
||||
</p>
|
||||
</header>
|
||||
|
||||
<div className="rule-thin mb-8" />
|
||||
|
||||
<div className="mb-6 flex items-baseline gap-3">
|
||||
<label
|
||||
className="text-xs uppercase tracking-wide"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
班级 ID
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
value={classId}
|
||||
onChange={(e) => setClassId(e.target.value)}
|
||||
className="flex-1 max-w-md px-3 py-2 bg-transparent border-b text-sm font-mono"
|
||||
style={{ borderColor: "var(--color-rule)" }}
|
||||
placeholder="输入班级 UUID"
|
||||
/>
|
||||
<button
|
||||
onClick={fetchHomework}
|
||||
className="text-xs uppercase tracking-wide hover:opacity-70"
|
||||
style={{ color: "var(--color-accent)" }}
|
||||
>
|
||||
查询
|
||||
</button>
|
||||
</div>
|
||||
|
||||
{error && (
|
||||
<div
|
||||
className="mark-left mb-4 py-2"
|
||||
style={{ borderColor: "var(--color-accent)" }}
|
||||
>
|
||||
<p className="text-sm px-3" style={{ color: "var(--color-accent)" }}>
|
||||
{error}
|
||||
{homeworkResult.fetching ? (
|
||||
<Loading lines={4} />
|
||||
) : homeworkResult.error ? (
|
||||
<div className="mark-left mb-4 py-2 border-l-2 border-danger pl-md">
|
||||
<p className="text-sm px-3 text-danger">
|
||||
加载失败：{homeworkResult.error.message}
|
||||
</p>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{loading ? (
|
||||
<p className="text-sm" style={{ color: "var(--color-ink-muted)" }}>
|
||||
加载中...
|
||||
</p>
|
||||
) : items.length === 0 ? (
|
||||
<p
|
||||
className="text-sm italic"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
该班级下暂无作业
|
||||
</p>
|
||||
<Empty title="暂无作业" description="该班级尚未布置作业" />
|
||||
) : (
|
||||
<ul className="space-y-0">
|
||||
{items.map((hw) => (
|
||||
{(items as HomeworkItem[]).map((hw) => (
|
||||
<li
|
||||
key={hw.id}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline"
|
||||
style={{ borderBottom: "1px solid var(--color-rule)" }}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-baseline border-b border-rule"
|
||||
>
|
||||
<div className="col-span-7">
|
||||
<h3
|
||||
className="text-lg"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
{hw.title}
|
||||
</h3>
|
||||
<h3 className="text-lg font-serif text-ink">{hw.title}</h3>
|
||||
{hw.description && (
|
||||
<p
|
||||
className="mt-1 text-sm"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
{hw.description}
|
||||
</p>
|
||||
)}
|
||||
<p
|
||||
className="mt-1 text-xs"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<p className="mt-1 text-tiny text-ink-muted">
|
||||
截止: {new Date(hw.dueDate).toLocaleString("zh-CN")}
|
||||
</p>
|
||||
</div>
|
||||
<div
|
||||
className="col-span-3 text-xs"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<div className="col-span-3 text-tiny text-ink-muted">
|
||||
状态: {hw.status}
|
||||
</div>
|
||||
<div
|
||||
className="col-span-2 text-right text-xs font-mono"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<div className="col-span-2 text-right text-tiny font-mono text-ink-muted">
|
||||
{hw.id.slice(0, 8)}...
|
||||
</div>
|
||||
</li>
|
||||
@@ -177,3 +98,17 @@ export default function HomeworkPage() {
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default function HomeworkPage() {
|
||||
return (
|
||||
<Suspense
|
||||
fallback={
|
||||
<div className="px-10 py-10">
|
||||
<Loading lines={3} />
|
||||
</div>
|
||||
}
|
||||
>
|
||||
<HomeworkContent />
|
||||
</Suspense>
|
||||
);
|
||||
}
|
||||
|
||||
99
apps/teacher-portal/src/app/(app)/settings/page.tsx
Normal file
99
apps/teacher-portal/src/app/(app)/settings/page.tsx
Normal file
@@ -0,0 +1,99 @@
|
||||
"use client";
|
||||
|
||||
/**
|
||||
* Settings 页面 - 个人设置
|
||||
*
|
||||
* 数据来源（ARB-001 §1.2）：GraphQL MeQuery（只读展示）
|
||||
* - P2 阶段仅展示当前用户信息（P2 纯读，无 Mutation）
|
||||
* - P3+ 启用 UpdateUserMutation 后开启编辑功能
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import { useQuery } from "urql";
|
||||
import { Loading } from "@edu/ui-components";
|
||||
import { MeQuery } from "@/lib/graphql";
|
||||
|
||||
export default function SettingsPage() {
|
||||
const [result] = useQuery({ query: MeQuery });
|
||||
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<header className="mb-8">
|
||||
<h1 className="text-3xl font-serif text-ink">个人设置</h1>
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
GraphQL MeQuery · P2 只读展示（P3 启用编辑）
|
||||
</p>
|
||||
</header>
|
||||
|
||||
<div className="rule-thin mb-8" />
|
||||
|
||||
{result.fetching ? (
|
||||
<Loading lines={4} />
|
||||
) : result.error ? (
|
||||
<div className="mark-left mb-4 py-2 border-l-2 border-danger pl-md">
|
||||
<p className="text-sm px-3 text-danger">
|
||||
加载失败：{result.error.message}
|
||||
</p>
|
||||
</div>
|
||||
) : !result.data?.me ? (
|
||||
<p className="text-sm italic text-ink-muted">暂无用户信息</p>
|
||||
) : (
|
||||
<section className="max-w-2xl">
|
||||
<div className="mb-6">
|
||||
<h2 className="text-xl font-serif text-ink mb-2">基本信息</h2>
|
||||
<div className="rule-thin mb-4" />
|
||||
<dl className="space-y-4">
|
||||
<div className="grid grid-cols-3 gap-4 items-baseline">
|
||||
<dt className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
用户 ID
|
||||
</dt>
|
||||
<dd className="col-span-2 text-sm font-mono text-ink">
|
||||
{result.data.me.id}
|
||||
</dd>
|
||||
</div>
|
||||
<div className="grid grid-cols-3 gap-4 items-baseline">
|
||||
<dt className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
姓名
|
||||
</dt>
|
||||
<dd className="col-span-2 text-sm text-ink">
|
||||
{result.data.me.name}
|
||||
</dd>
|
||||
</div>
|
||||
<div className="grid grid-cols-3 gap-4 items-baseline">
|
||||
<dt className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
邮箱
|
||||
</dt>
|
||||
<dd className="col-span-2 text-sm text-ink">
|
||||
{result.data.me.email}
|
||||
</dd>
|
||||
</div>
|
||||
<div className="grid grid-cols-3 gap-4 items-baseline">
|
||||
<dt className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
角色
|
||||
</dt>
|
||||
<dd className="col-span-2 text-sm text-ink">
|
||||
{result.data.me.roles.join(", ") || "无角色"}
|
||||
</dd>
|
||||
</div>
|
||||
<div className="grid grid-cols-3 gap-4 items-baseline">
|
||||
<dt className="text-tiny uppercase tracking-wide text-ink-muted">
|
||||
数据范围
|
||||
</dt>
|
||||
<dd className="col-span-2 text-sm text-ink">
|
||||
{result.data.me.dataScope}
|
||||
</dd>
|
||||
</div>
|
||||
</dl>
|
||||
</div>
|
||||
|
||||
<div className="mt-8 p-4 border border-rule rounded-card bg-subtle">
|
||||
<p className="text-sm text-ink-muted">
|
||||
P2 阶段为只读模式，编辑功能（updateUser Mutation）将在 P3 启用。
|
||||
</p>
|
||||
</div>
|
||||
</section>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
109
apps/teacher-portal/src/app/(app)/students/page.tsx
Normal file
109
apps/teacher-portal/src/app/(app)/students/page.tsx
Normal file
@@ -0,0 +1,109 @@
|
||||
"use client";
|
||||
|
||||
/**
|
||||
* Students 页面 - 班级学生名单
|
||||
*
|
||||
* 数据来源（contract.md §2.4）：GraphQL ClassStudentsQuery（P3 扩展，MSW mock）
|
||||
* - 通过 URL ?classId=xxx 指定班级
|
||||
* - P2 阶段用 MSW mock 数据，待 teacher-bff P3 启用 iam 聚合
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import { useQuery } from "urql";
|
||||
import { useSearchParams } from "next/navigation";
|
||||
import { Suspense } from "react";
|
||||
import { Loading, Empty } from "@edu/ui-components";
|
||||
import { ClassStudentsQuery, ClassQuery } from "@/lib/graphql";
|
||||
import type { Student } from "@/lib/graphql";
|
||||
|
||||
function StudentsContent() {
|
||||
const searchParams = useSearchParams();
|
||||
const classId = searchParams.get("classId") ?? "";
|
||||
|
||||
// 班级详情（用于显示班级名称）
|
||||
const [classResult] = useQuery({
|
||||
query: ClassQuery,
|
||||
variables: { id: classId },
|
||||
pause: !classId,
|
||||
});
|
||||
|
||||
// 学生名单
|
||||
const [studentsResult] = useQuery({
|
||||
query: ClassStudentsQuery,
|
||||
variables: { classId },
|
||||
pause: !classId,
|
||||
});
|
||||
|
||||
if (!classId) {
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<Empty title="未指定班级" description="请从班级列表进入查看学生名单" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const cls = classResult.data?.class;
|
||||
const students = studentsResult.data?.classStudents ?? [];
|
||||
|
||||
return (
|
||||
<div className="px-10 py-10">
|
||||
<header className="mb-8">
|
||||
<h1 className="text-3xl font-serif text-ink">
|
||||
{cls ? `${cls.name} - 学生名单` : "学生名单"}
|
||||
</h1>
|
||||
<p className="mt-1 text-sm text-ink-muted">
|
||||
GraphQL ClassStudentsQuery · iam 数据聚合（P3 扩展，MSW mock）
|
||||
</p>
|
||||
</header>
|
||||
|
||||
<div className="rule-thin mb-8" />
|
||||
|
||||
{studentsResult.fetching ? (
|
||||
<Loading lines={6} />
|
||||
) : studentsResult.error ? (
|
||||
<div className="mark-left mb-4 py-2 border-l-2 border-danger pl-md">
|
||||
<p className="text-sm px-3 text-danger">
|
||||
加载失败：{studentsResult.error.message}
|
||||
</p>
|
||||
</div>
|
||||
) : students.length === 0 ? (
|
||||
<Empty title="暂无学生" description="该班级尚未录入学生信息" />
|
||||
) : (
|
||||
<ul className="space-y-0">
|
||||
{(students as Student[]).map((s) => (
|
||||
<li
|
||||
key={s.id}
|
||||
className="py-4 grid grid-cols-12 gap-4 items-center border-b border-rule"
|
||||
>
|
||||
<div className="col-span-5">
|
||||
<h3 className="text-lg font-serif text-ink">{s.name}</h3>
|
||||
<p className="mt-1 text-tiny text-ink-muted">{s.email}</p>
|
||||
</div>
|
||||
<div className="col-span-5 text-sm text-ink-muted">
|
||||
ID: {s.id}
|
||||
</div>
|
||||
<div className="col-span-2 text-right text-tiny font-mono text-ink-muted">
|
||||
{s.id.slice(0, 8)}...
|
||||
</div>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default function StudentsPage() {
|
||||
return (
|
||||
<Suspense
|
||||
fallback={
|
||||
<div className="px-10 py-10">
|
||||
<Loading lines={3} />
|
||||
</div>
|
||||
}
|
||||
>
|
||||
<StudentsContent />
|
||||
</Suspense>
|
||||
);
|
||||
}
|
||||
21
apps/teacher-portal/src/app/api/health/route.ts
Normal file
21
apps/teacher-portal/src/app/api/health/route.ts
Normal file
@@ -0,0 +1,21 @@
|
||||
/**
|
||||
* Liveness 健康检查 - /api/health
|
||||
*
|
||||
* 用途：k8s livenessProbe，判断进程是否存活。
|
||||
* 不检查依赖，仅返回进程状态。
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
* 关联：project_rules §12 可观测性规范
|
||||
*/
|
||||
|
||||
import { NextResponse } from "next/server";
|
||||
|
||||
export const dynamic = "force-dynamic";
|
||||
|
||||
export function GET(): NextResponse {
|
||||
return NextResponse.json({
|
||||
status: "ok",
|
||||
service: "teacher-portal",
|
||||
timestamp: new Date().toISOString(),
|
||||
});
|
||||
}
|
||||
28
apps/teacher-portal/src/app/api/ready/route.ts
Normal file
28
apps/teacher-portal/src/app/api/ready/route.ts
Normal file
@@ -0,0 +1,28 @@
|
||||
/**
|
||||
* Readiness 健康检查 - /api/ready
|
||||
*
|
||||
* 用途：k8s readinessProbe，判断是否准备好接收流量。
|
||||
* P2 阶段：teacher-portal 是纯前端，无外部依赖（GraphQL 走客户端），
|
||||
* readiness 检查仅返回进程状态。
|
||||
*
|
||||
* P3+ 扩展：当接入 MF Remote 时，可增加 Remote 可达性检查。
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
* 关联：project_rules §12 可观测性规范
|
||||
*/
|
||||
|
||||
import { NextResponse } from "next/server";
|
||||
|
||||
export const dynamic = "force-dynamic";
|
||||
|
||||
export function GET(): NextResponse {
|
||||
return NextResponse.json({
|
||||
status: "ok",
|
||||
service: "teacher-portal",
|
||||
timestamp: new Date().toISOString(),
|
||||
checks: {
|
||||
process: true,
|
||||
// P3+ 扩展：mfRemotes / graphqlEndpoint 等
|
||||
},
|
||||
});
|
||||
}
|
||||
@@ -1,43 +1,58 @@
|
||||
/**
|
||||
* teacher-portal 全局样式
|
||||
*
|
||||
* 引入 @edu/ui-tokens 三层设计令牌（primitive → semantic → tailwind-theme）
|
||||
* 维护者：ai13（teacher-portal）
|
||||
* 关联：project_rules §3.10、02-architecture-design.md §9
|
||||
*
|
||||
* 禁止规则（ESLint + project_rules §3.10）：
|
||||
* - 禁止 #hex 字面量（用 hsl(var(--*)) 或 Tailwind bg-* 类）
|
||||
* - 禁止 'Inter'/'Fraunces'/'JetBrains Mono' 字面量（用 var(--font-family-*))
|
||||
* - 禁止 font-size: Npx（用 var(--font-size-*) 或 Tailwind text-* 类）
|
||||
* - 禁止 Tailwind 任意值 w-[Npx]（用 --space-* 或默认阶梯）
|
||||
*/
|
||||
|
||||
@import "@edu/ui-tokens/all.css";
|
||||
|
||||
@tailwind base;
|
||||
@tailwind components;
|
||||
@tailwind utilities;
|
||||
|
||||
:root {
|
||||
--bg-paper: hsl(40, 20%, 98%);
|
||||
--color-ink: hsl(25, 3%, 15%);
|
||||
--color-ink-muted: hsl(30, 5%, 45%);
|
||||
--color-accent: hsl(220, 60%, 35%);
|
||||
--color-rule: hsl(30, 10%, 90%);
|
||||
--font-serif: 'Fraunces', Georgia, serif;
|
||||
--font-sans: 'Inter', system-ui, sans-serif;
|
||||
--font-mono: 'JetBrains Mono', monospace;
|
||||
@layer base {
|
||||
html,
|
||||
body {
|
||||
background: var(--bg-paper);
|
||||
color: var(--color-ink);
|
||||
font-family: var(--font-family-sans);
|
||||
-webkit-font-smoothing: antialiased;
|
||||
-moz-osx-font-smoothing: grayscale;
|
||||
}
|
||||
|
||||
h1,
|
||||
h2,
|
||||
h3,
|
||||
h4,
|
||||
h5,
|
||||
h6 {
|
||||
font-family: var(--font-family-serif);
|
||||
font-weight: var(--font-weight-semibold);
|
||||
letter-spacing: var(--letter-spacing-tight);
|
||||
}
|
||||
}
|
||||
|
||||
html, body {
|
||||
background: var(--bg-paper);
|
||||
color: var(--color-ink);
|
||||
font-family: var(--font-sans);
|
||||
-webkit-font-smoothing: antialiased;
|
||||
-moz-osx-font-smoothing: grayscale;
|
||||
}
|
||||
@layer components {
|
||||
/* 纸感分隔线 */
|
||||
.rule {
|
||||
border-top: 1px solid var(--color-rule);
|
||||
}
|
||||
|
||||
h1, h2, h3, h4, h5, h6 {
|
||||
font-family: var(--font-serif);
|
||||
font-weight: 600;
|
||||
letter-spacing: -0.01em;
|
||||
}
|
||||
.rule-thin {
|
||||
border-top: 2px solid var(--color-rule);
|
||||
}
|
||||
|
||||
/* 纸感分隔线 */
|
||||
.rule {
|
||||
border-top: 1px solid var(--color-rule);
|
||||
}
|
||||
|
||||
.rule-thin {
|
||||
border-top: 2px solid var(--color-rule);
|
||||
}
|
||||
|
||||
/* 左侧竖线标记（节点展开样式）*/
|
||||
.mark-left {
|
||||
border-left: 2px solid var(--color-rule);
|
||||
padding-left: 12px;
|
||||
/* 左侧竖线标记（节点展开样式） */
|
||||
.mark-left {
|
||||
border-left: 2px solid var(--color-rule);
|
||||
padding-left: var(--space-md);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,14 +1,40 @@
|
||||
import './globals.css';
|
||||
import type { Metadata } from 'next';
|
||||
import { Inter, Fraunces, JetBrains_Mono } from 'next/font/google';
|
||||
import "./globals.css";
|
||||
import type { Metadata } from "next";
|
||||
import { Inter, Fraunces, JetBrains_Mono } from "next/font/google";
|
||||
import { GraphQLProvider } from "./providers";
|
||||
import { ErrorBoundary } from "@edu/ui-components";
|
||||
|
||||
const inter = Inter({ subsets: ['latin'], variable: '--font-inter' });
|
||||
const fraunces = Fraunces({ subsets: ['latin'], variable: '--font-fraunces' });
|
||||
const mono = JetBrains_Mono({ subsets: ['latin'], variable: '--font-mono' });
|
||||
/**
|
||||
* 字体加载（next/font/google self-host）
|
||||
*
|
||||
* 通过 CSS 变量暴露字体族，业务代码用 var(--font-family-sans/serif/mono)
|
||||
* 禁止字体名字面量（project_rules §3.10）
|
||||
*
|
||||
* 03-long-term-architecture.md §3.5 字体加载策略：
|
||||
* - font-display: swap（FOUT，优先文本可见性）
|
||||
* - 首屏字体 preload，次屏 lazy
|
||||
*/
|
||||
const inter = Inter({
|
||||
subsets: ["latin"],
|
||||
variable: "--font-inter",
|
||||
display: "swap",
|
||||
});
|
||||
|
||||
const fraunces = Fraunces({
|
||||
subsets: ["latin"],
|
||||
variable: "--font-fraunces",
|
||||
display: "swap",
|
||||
});
|
||||
|
||||
const mono = JetBrains_Mono({
|
||||
subsets: ["latin"],
|
||||
variable: "--font-jetbrains-mono",
|
||||
display: "swap",
|
||||
});
|
||||
|
||||
export const metadata: Metadata = {
|
||||
title: 'Edu Teacher Portal',
|
||||
description: 'K12 智慧教务平台 - 教师端',
|
||||
title: "Edu Teacher Portal",
|
||||
description: "K12 智慧教务平台 - 教师端",
|
||||
};
|
||||
|
||||
export default function RootLayout({
|
||||
@@ -17,8 +43,15 @@ export default function RootLayout({
|
||||
children: React.ReactNode;
|
||||
}) {
|
||||
return (
|
||||
<html lang="zh-CN" className={`${inter.variable} ${fraunces.variable} ${mono.variable}`}>
|
||||
<body>{children}</body>
|
||||
<html
|
||||
lang="zh-CN"
|
||||
className={`${inter.variable} ${fraunces.variable} ${mono.variable}`}
|
||||
>
|
||||
<body>
|
||||
<ErrorBoundary>
|
||||
<GraphQLProvider>{children}</GraphQLProvider>
|
||||
</ErrorBoundary>
|
||||
</body>
|
||||
</html>
|
||||
);
|
||||
}
|
||||
|
||||
61
apps/teacher-portal/src/app/providers.tsx
Normal file
61
apps/teacher-portal/src/app/providers.tsx
Normal file
@@ -0,0 +1,61 @@
|
||||
"use client";
|
||||
|
||||
/**
|
||||
* GraphQLProvider - urql client 单例 Provider
|
||||
*
|
||||
* 总裁裁决 §2.17 方案 A：Shell（teacher-portal）暴露 GraphQLProvider，
|
||||
* Remote（student/parent/admin-portal）复用同一 client 单例。
|
||||
*
|
||||
* ARB-002 §2.2：通过 MF exposes './GraphQLProvider' 暴露给 Remote。
|
||||
*
|
||||
* MSW 启用：NEXT_PUBLIC_API_MOCKING=enabled 时在客户端注册 Service Worker
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import { useEffect, useMemo, useState } from "react";
|
||||
import { Provider } from "urql";
|
||||
import type { ReactNode } from "react";
|
||||
import { GraphQLClientContext } from "@edu/hooks";
|
||||
import { createGraphQLClient } from "@/lib/graphql";
|
||||
import { initMocks } from "@/mocks";
|
||||
|
||||
export interface GraphQLProviderProps {
|
||||
children: ReactNode;
|
||||
}
|
||||
|
||||
/**
|
||||
* GraphQLProvider
|
||||
*
|
||||
* 初始化 urql client 单例，通过 React Context 注入给所有子组件 + Remote。
|
||||
* MF shared singleton 配置确保 Remote 复用同一 client 实例（ARB-002 §2.2）。
|
||||
*
|
||||
* MSW 初始化在客户端渲染前异步完成，避免请求未拦截。
|
||||
*/
|
||||
export function GraphQLProvider({ children }: GraphQLProviderProps): ReactNode {
|
||||
const client = useMemo(() => createGraphQLClient(), []);
|
||||
const [mswReady, setMswReady] = useState(false);
|
||||
|
||||
useEffect(() => {
|
||||
let mounted = true;
|
||||
initMocks().finally(() => {
|
||||
if (mounted) setMswReady(true);
|
||||
});
|
||||
return () => {
|
||||
mounted = false;
|
||||
};
|
||||
}, []);
|
||||
|
||||
// MSW 未启用时直接渲染（initMocks 内部判断）
|
||||
if (!mswReady && process.env.NEXT_PUBLIC_API_MOCKING === "enabled") {
|
||||
return null;
|
||||
}
|
||||
|
||||
return (
|
||||
<GraphQLClientContext.Provider value={client}>
|
||||
<Provider value={client}>{children}</Provider>
|
||||
</GraphQLClientContext.Provider>
|
||||
);
|
||||
}
|
||||
|
||||
export default GraphQLProvider;
|
||||
@@ -1,123 +1,126 @@
|
||||
"use client";
|
||||
|
||||
import { useState, useEffect, useCallback } from "react";
|
||||
/**
|
||||
* AppShell - MF Shell 布局容器
|
||||
*
|
||||
* 职责（02-architecture-design.md §1.2）：
|
||||
* 1. 左侧导航树（viewports GraphQL query，ARB-001 §1.2）
|
||||
* 2. 主内容区（children slot）
|
||||
* 3. 路由守卫（未登录跳转 /login）
|
||||
* 4. 用户信息 + 登出
|
||||
* 5. 按 requiredPermission 过滤视口（F7 权限点）
|
||||
*
|
||||
* 数据来源（ARB-002 §2.4 ai13 执行项 #3）：
|
||||
* - viewports: GraphQL ViewportsQuery（替代 REST /api/v1/teacher/viewports）
|
||||
* - user: GraphQL MeQuery（在 DashboardPage 已加载，AppShell 从 localStorage 兜底）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import { useEffect, useMemo } from "react";
|
||||
import { useRouter, usePathname } from "next/navigation";
|
||||
import Link from "next/link";
|
||||
import { useQuery } from "urql";
|
||||
import { ErrorBoundary, Loading } from "@edu/ui-components";
|
||||
import { usePermission } from "@edu/hooks";
|
||||
import { ViewportsQuery, MeQuery } from "@/lib/graphql";
|
||||
import type { ViewportItem, User } from "@/lib/graphql";
|
||||
import { getToken, getUser, logout } from "@/lib/auth";
|
||||
|
||||
interface ViewportItem {
|
||||
key: string;
|
||||
label: string;
|
||||
route: string;
|
||||
icon: string | null;
|
||||
sortOrder: string;
|
||||
requiredPermission: string | null;
|
||||
/**
|
||||
* 权限上下文：从 localStorage 读取（登录时由 iam 返回并存储）。
|
||||
* P3+ 改为 GraphQL me query 实时拉取（usePermission hook 接受 context props）。
|
||||
*/
|
||||
function buildPermissionContext(user: User | null) {
|
||||
if (!user) return null;
|
||||
// localStorage UserInfo 包含 permissions 字段（iam /iam/permissions/effective 返回）
|
||||
const stored = getUser();
|
||||
return {
|
||||
permissions: stored?.permissions ?? [],
|
||||
roles: user.roles,
|
||||
dataScope: user.dataScope,
|
||||
};
|
||||
}
|
||||
|
||||
export default function AppShell({ children }: { children: React.ReactNode }) {
|
||||
const router = useRouter();
|
||||
const pathname = usePathname();
|
||||
const [viewports, setViewports] = useState<ViewportItem[]>([]);
|
||||
const [loading, setLoading] = useState(true);
|
||||
const [mounted, setMounted] = useState(false);
|
||||
|
||||
const fetchViewports = useCallback(async () => {
|
||||
// 路由守卫：未登录跳转 /login
|
||||
useEffect(() => {
|
||||
const token = getToken();
|
||||
if (!token) {
|
||||
router.replace("/login");
|
||||
return;
|
||||
}
|
||||
try {
|
||||
const res = await fetch("/api/v1/teacher/viewports", {
|
||||
headers: { Authorization: `Bearer ${token}` },
|
||||
});
|
||||
if (res.status === 401) {
|
||||
logout();
|
||||
return;
|
||||
}
|
||||
const json = await res.json();
|
||||
if (json.success && json.data) {
|
||||
setViewports(json.data);
|
||||
}
|
||||
} catch {
|
||||
// 网络错误，保持空视口
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
}, [router]);
|
||||
|
||||
useEffect(() => {
|
||||
setMounted(true);
|
||||
const token = getToken();
|
||||
if (!token) {
|
||||
router.replace("/login");
|
||||
return;
|
||||
}
|
||||
fetchViewports();
|
||||
}, [router, fetchViewports]);
|
||||
// GraphQL: viewports query（替代 REST /api/v1/teacher/viewports）
|
||||
const [viewportsResult] = useQuery({
|
||||
query: ViewportsQuery,
|
||||
});
|
||||
|
||||
// 防止 SSR 闪烁
|
||||
if (!mounted) return null;
|
||||
// GraphQL: me query（实时获取当前用户信息，替代 localStorage 读取）
|
||||
const [meResult] = useQuery({
|
||||
query: MeQuery,
|
||||
});
|
||||
|
||||
const user = getUser();
|
||||
const user = meResult.data?.me ?? null;
|
||||
const permissionContext = useMemo(
|
||||
() => buildPermissionContext(user ?? null),
|
||||
[user],
|
||||
);
|
||||
const { hasPermission } = usePermission({ context: permissionContext });
|
||||
|
||||
// 按权限过滤视口（F7: requiredPermission 为 null 表示公开视口）
|
||||
const visibleViewports = useMemo(() => {
|
||||
const list: ViewportItem[] = viewportsResult.data?.viewports ?? [];
|
||||
return list.filter(
|
||||
(vp) => !vp.requiredPermission || hasPermission(vp.requiredPermission),
|
||||
);
|
||||
}, [viewportsResult, hasPermission]);
|
||||
|
||||
// 视口加载中：占位（避免导航闪烁）
|
||||
if (viewportsResult.fetching && visibleViewports.length === 0) {
|
||||
return (
|
||||
<div className="min-h-screen bg-paper">
|
||||
<Loading lines={5} />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
// 视口加载错误：ErrorBoundary 兜底（不阻塞主内容）
|
||||
const viewportError = viewportsResult.error ? (
|
||||
<p className="px-3 py-2 text-tiny text-danger">
|
||||
导航加载失败：{viewportsResult.error.message}
|
||||
</p>
|
||||
) : null;
|
||||
|
||||
return (
|
||||
<div
|
||||
className="min-h-screen flex"
|
||||
style={{ background: "var(--bg-paper)" }}
|
||||
>
|
||||
<div className="min-h-screen flex bg-paper">
|
||||
{/* 左侧栏：导航树 */}
|
||||
<aside
|
||||
className="w-56 flex-shrink-0 border-r relative flex flex-col"
|
||||
style={{
|
||||
borderColor: "var(--color-rule)",
|
||||
background: "var(--bg-paper)",
|
||||
}}
|
||||
>
|
||||
<aside className="w-56 flex-shrink-0 border-r border-rule bg-paper flex flex-col">
|
||||
<div className="px-6 py-6">
|
||||
<h1
|
||||
className="text-xl"
|
||||
style={{
|
||||
fontFamily: "var(--font-serif)",
|
||||
color: "var(--color-ink)",
|
||||
}}
|
||||
>
|
||||
Edu
|
||||
</h1>
|
||||
<p
|
||||
className="text-xs mt-1"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
教师端
|
||||
</p>
|
||||
<h1 className="text-xl font-serif text-ink">Edu</h1>
|
||||
<p className="mt-1 text-tiny text-ink-muted">教师端</p>
|
||||
</div>
|
||||
<div className="rule-thin mx-6" />
|
||||
|
||||
<nav className="mt-4 px-3">
|
||||
{loading ? (
|
||||
<p
|
||||
className="text-xs px-3 py-2"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
加载导航...
|
||||
</p>
|
||||
{viewportError}
|
||||
{visibleViewports.length === 0 && !viewportError ? (
|
||||
<p className="px-3 py-2 text-tiny text-ink-muted">暂无可用视口</p>
|
||||
) : (
|
||||
viewports.map((vp) => {
|
||||
visibleViewports.map((vp) => {
|
||||
const active = pathname === vp.route;
|
||||
return (
|
||||
<Link
|
||||
key={vp.key}
|
||||
href={vp.route}
|
||||
className="block px-3 py-2 text-sm transition-colors"
|
||||
style={{
|
||||
color: active ? "var(--color-accent)" : "var(--color-ink)",
|
||||
borderLeft: active
|
||||
? "2px solid var(--color-accent)"
|
||||
: "2px solid transparent",
|
||||
fontFamily: active
|
||||
? "var(--font-serif)"
|
||||
: "var(--font-inter)",
|
||||
}}
|
||||
className={`block px-3 py-2 text-sm transition-colors ${
|
||||
active
|
||||
? "text-accent border-l-2 border-accent font-serif"
|
||||
: "text-ink border-l-2 border-transparent font-sans hover:text-accent"
|
||||
}`}
|
||||
>
|
||||
{vp.label}
|
||||
</Link>
|
||||
@@ -127,27 +130,18 @@ export default function AppShell({ children }: { children: React.ReactNode }) {
|
||||
</nav>
|
||||
|
||||
{/* 底部：用户信息 + 登出 */}
|
||||
<div
|
||||
className="mt-auto px-6 py-4 border-t"
|
||||
style={{ borderColor: "var(--color-rule)" }}
|
||||
>
|
||||
<div className="mt-auto px-6 py-4 border-t border-rule">
|
||||
{user && (
|
||||
<div className="mb-2">
|
||||
<p className="text-sm" style={{ color: "var(--color-ink)" }}>
|
||||
{user.name}
|
||||
</p>
|
||||
<p
|
||||
className="text-xs"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
>
|
||||
<p className="text-sm text-ink">{user.name}</p>
|
||||
<p className="text-tiny text-ink-muted">
|
||||
{user.roles.join(", ") || "无角色"}
|
||||
</p>
|
||||
</div>
|
||||
)}
|
||||
<button
|
||||
onClick={logout}
|
||||
className="text-xs uppercase tracking-wide hover:opacity-70"
|
||||
style={{ color: "var(--color-ink-muted)" }}
|
||||
className="text-tiny uppercase tracking-wide text-ink-muted hover:opacity-70"
|
||||
>
|
||||
退出登录
|
||||
</button>
|
||||
@@ -155,7 +149,28 @@ export default function AppShell({ children }: { children: React.ReactNode }) {
|
||||
</aside>
|
||||
|
||||
{/* 中间：内容区（纸面） */}
|
||||
<main className="flex-1 overflow-auto">{children}</main>
|
||||
<main className="flex-1 overflow-auto">
|
||||
<ErrorBoundary
|
||||
fallback={(error, reset) => (
|
||||
<div
|
||||
role="alert"
|
||||
className="flex min-h-[200px] flex-col items-center justify-center gap-4 p-8"
|
||||
>
|
||||
<h2 className="text-lg font-serif text-ink">页面出错了</h2>
|
||||
<p className="text-sm text-ink-muted">{error.message}</p>
|
||||
<button
|
||||
type="button"
|
||||
onClick={reset}
|
||||
className="px-4 py-2 text-sm text-ink-on-accent bg-accent rounded-button hover:bg-accent-hover"
|
||||
>
|
||||
重试
|
||||
</button>
|
||||
</div>
|
||||
)}
|
||||
>
|
||||
{children}
|
||||
</ErrorBoundary>
|
||||
</main>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,4 +1,10 @@
|
||||
// 认证工具：token 存储 + 路由保护
|
||||
/**
|
||||
* 认证工具：token 存储 + 路由保护
|
||||
*
|
||||
* F12 裁决：P2 用 localStorage（accessToken + userInfo），P6 迁移 httpOnly cookie
|
||||
* 维护者：ai13（teacher-portal）
|
||||
* 关联：02-architecture-design.md §2.1 会话状态
|
||||
*/
|
||||
|
||||
const TOKEN_KEY = "edu_access_token";
|
||||
const USER_KEY = "edu_user_info";
|
||||
@@ -48,12 +54,17 @@ export function isAuthenticated(): boolean {
|
||||
return getToken() !== null;
|
||||
}
|
||||
|
||||
// 调用 Gateway 登录接口
|
||||
/**
|
||||
* 调用 Gateway 登录接口
|
||||
*
|
||||
* 非 GraphQL（认证前提，MF 依赖认证，F12 裁决）
|
||||
* 路径：POST /api/auth/login（经 next.config.js rewrites 代理到 api-gateway）
|
||||
*/
|
||||
export async function login(
|
||||
email: string,
|
||||
password: string,
|
||||
): Promise<{ user: UserInfo; token: string }> {
|
||||
const res = await fetch("/api/v1/iam/login", {
|
||||
const res = await fetch("/api/auth/login", {
|
||||
method: "POST",
|
||||
headers: { "Content-Type": "application/json" },
|
||||
body: JSON.stringify({ email, password }),
|
||||
|
||||
302
apps/teacher-portal/src/lib/graphql.ts
Normal file
302
apps/teacher-portal/src/lib/graphql.ts
Normal file
@@ -0,0 +1,302 @@
|
||||
/**
|
||||
* GraphQL client + queries/mutations（ARB-001 P2 第一版 schema）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
* 关联：coord.md §1 ARB-001、02-architecture-design.md §4
|
||||
*
|
||||
* schema 来源：packages/shared-ts/contracts/graphql/teacher-bff.graphql（ai03 维护）
|
||||
* P2 第一版 Query 范围（ARB-001 §1.2）：dashboard / viewports / me / classes / class（5 个）
|
||||
* P2 不包含 Mutation（P3+ 扩展）
|
||||
*
|
||||
* 错误处理（ARB-001 §1.3）：
|
||||
* - BFF 始终返回 ActionState 信封（success/errors/data）
|
||||
* - GraphQL errors[].extensions.code = BFF_TEACHER_*（G14 裁决）
|
||||
* - 前端按前缀路由 i18n key（F11: error.teacher_bff.<code_snake>）
|
||||
*/
|
||||
|
||||
import { createClient, cacheExchange, fetchExchange } from "urql";
|
||||
import { gql } from "urql";
|
||||
import type { Client } from "urql";
|
||||
|
||||
// ============ Types（对齐 ARB-001 §1.2 schema） ============
|
||||
|
||||
export type DataScope =
|
||||
"SELF" | "CLASS" | "GRADE" | "SCHOOL" | "DISTRICT" | "ALL";
|
||||
|
||||
export type ExamStatus =
|
||||
"DRAFT" | "PUBLISHED" | "IN_PROGRESS" | "GRADING" | "SCORED" | "ARCHIVED";
|
||||
|
||||
export type SubmissionStatus = "NOT_SUBMITTED" | "SUBMITTED" | "GRADED";
|
||||
|
||||
export interface User {
|
||||
id: string;
|
||||
email: string;
|
||||
name: string;
|
||||
roles: string[];
|
||||
dataScope: DataScope;
|
||||
}
|
||||
|
||||
export interface ViewportItem {
|
||||
key: string;
|
||||
label: string;
|
||||
route: string;
|
||||
icon: string | null;
|
||||
sortOrder: string;
|
||||
requiredPermission: string | null;
|
||||
}
|
||||
|
||||
export interface Class {
|
||||
id: string;
|
||||
name: string;
|
||||
gradeId: string;
|
||||
studentCount: number;
|
||||
}
|
||||
|
||||
export interface DashboardStats {
|
||||
totalExams: number;
|
||||
pendingGrading: number;
|
||||
todayHomework: number;
|
||||
}
|
||||
|
||||
export interface DashboardData {
|
||||
user: User;
|
||||
classes: Class[];
|
||||
viewports: ViewportItem[];
|
||||
stats: DashboardStats;
|
||||
}
|
||||
|
||||
// ============ urql client 单例（总裁 §2.17 方案 A） ============
|
||||
|
||||
/**
|
||||
* 创建 urql client 单例
|
||||
*
|
||||
* Shell（teacher-portal）调用此函数创建 client，通过 GraphQLProvider 注入给所有 Remote。
|
||||
* token 从 localStorage 读取（F12: P2 用 localStorage，P6 迁移 httpOnly cookie）。
|
||||
*/
|
||||
export function createGraphQLClient(): Client {
|
||||
const url =
|
||||
process.env.NEXT_PUBLIC_TEACHER_BFF_GRAPHQL_URL ||
|
||||
"/api/v1/teacher/graphql";
|
||||
|
||||
return createClient({
|
||||
url,
|
||||
fetchOptions: () => {
|
||||
const headers: Record<string, string> = {
|
||||
"Content-Type": "application/json",
|
||||
};
|
||||
|
||||
// F12: P2 token 存 localStorage
|
||||
if (typeof window !== "undefined") {
|
||||
const token = window.localStorage.getItem("edu_access_token");
|
||||
if (token) {
|
||||
headers["Authorization"] = `Bearer ${token}`;
|
||||
}
|
||||
}
|
||||
|
||||
return { headers };
|
||||
},
|
||||
exchanges: [cacheExchange, fetchExchange],
|
||||
});
|
||||
}
|
||||
|
||||
// ============ P2 Query（ARB-001 §1.2，5 个 Must Have） ============
|
||||
|
||||
/** 仪表盘聚合查询（并行：iam.me + iam.viewports + iam.permissions + classes.byTeacher） */
|
||||
export const DashboardQuery = gql`
|
||||
query Dashboard {
|
||||
dashboard {
|
||||
user {
|
||||
id
|
||||
email
|
||||
name
|
||||
roles
|
||||
dataScope
|
||||
}
|
||||
classes {
|
||||
id
|
||||
name
|
||||
gradeId
|
||||
studentCount
|
||||
}
|
||||
viewports {
|
||||
key
|
||||
label
|
||||
route
|
||||
icon
|
||||
sortOrder
|
||||
requiredPermission
|
||||
}
|
||||
stats {
|
||||
totalExams
|
||||
pendingGrading
|
||||
todayHomework
|
||||
}
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
/** 视口配置查询（导航） */
|
||||
export const ViewportsQuery = gql`
|
||||
query Viewports {
|
||||
viewports {
|
||||
key
|
||||
label
|
||||
route
|
||||
icon
|
||||
sortOrder
|
||||
requiredPermission
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
/** 当前用户信息查询 */
|
||||
export const MeQuery = gql`
|
||||
query Me {
|
||||
me {
|
||||
id
|
||||
email
|
||||
name
|
||||
roles
|
||||
dataScope
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
/** 班级列表查询（按教师 dataScope 过滤） */
|
||||
export const ClassesQuery = gql`
|
||||
query Classes {
|
||||
classes {
|
||||
id
|
||||
name
|
||||
gradeId
|
||||
studentCount
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
/** 班级详情查询 */
|
||||
export const ClassQuery = gql`
|
||||
query Class($id: ID!) {
|
||||
class(id: $id) {
|
||||
id
|
||||
name
|
||||
gradeId
|
||||
studentCount
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
// ============ P3 Query/Mutation（MSW mock，待 teacher-bff P3+ 实现） ============
|
||||
// 以下查询对应 workline.md §3 P3-P5 交付物，schema 尚未在 ARB-001 P2 第一版中定义。
|
||||
// 开发期通过 MSW 拦截返回 mock 响应；上游就绪后由 ai03 在 teacher-bff.graphql 扩展。
|
||||
|
||||
/** 学生信息（iam 数据，经 teacher-bff 聚合） */
|
||||
export interface Student {
|
||||
id: string;
|
||||
name: string;
|
||||
email: string;
|
||||
avatarUrl: string | null;
|
||||
}
|
||||
|
||||
/** 班级学生名单查询（P3 扩展，MSW mock） */
|
||||
export const ClassStudentsQuery = gql`
|
||||
query ClassStudents($classId: ID!) {
|
||||
classStudents(classId: $classId) {
|
||||
id
|
||||
name
|
||||
email
|
||||
avatarUrl
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
/** 考试项（core-edu 域） */
|
||||
export interface ExamItem {
|
||||
id: string;
|
||||
classId: string;
|
||||
title: string;
|
||||
description: string | null;
|
||||
examDate: string;
|
||||
duration: number;
|
||||
totalScore: number;
|
||||
status: ExamStatus;
|
||||
}
|
||||
|
||||
/** 班级考试列表查询（P3 扩展，MSW mock） */
|
||||
export const ClassExamsQuery = gql`
|
||||
query ClassExams($classId: ID!) {
|
||||
classExams(classId: $classId) {
|
||||
id
|
||||
classId
|
||||
title
|
||||
description
|
||||
examDate
|
||||
duration
|
||||
totalScore
|
||||
status
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
/** 作业项（core-edu 域） */
|
||||
export interface HomeworkItem {
|
||||
id: string;
|
||||
classId: string;
|
||||
title: string;
|
||||
description: string | null;
|
||||
dueDate: string;
|
||||
status: SubmissionStatus;
|
||||
}
|
||||
|
||||
/** 班级作业列表查询（P3 扩展，MSW mock） */
|
||||
export const ClassHomeworkQuery = gql`
|
||||
query ClassHomework($classId: ID!) {
|
||||
classHomework(classId: $classId) {
|
||||
id
|
||||
classId
|
||||
title
|
||||
description
|
||||
dueDate
|
||||
status
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
/** 成绩项（core-edu 域） */
|
||||
export interface GradeItem {
|
||||
id: string;
|
||||
studentId: string;
|
||||
studentName: string;
|
||||
examId: string | null;
|
||||
homeworkId: string | null;
|
||||
score: number;
|
||||
feedback: string | null;
|
||||
}
|
||||
|
||||
/** 考试成绩列表查询（P3 扩展，MSW mock） */
|
||||
export const ExamGradesQuery = gql`
|
||||
query ExamGrades($examId: ID!) {
|
||||
examGrades(examId: $examId) {
|
||||
id
|
||||
studentId
|
||||
studentName
|
||||
examId
|
||||
homeworkId
|
||||
score
|
||||
feedback
|
||||
}
|
||||
}
|
||||
`;
|
||||
|
||||
/** 更新用户信息 Mutation（P3 扩展，MSW mock） */
|
||||
export const UpdateUserMutation = gql`
|
||||
mutation UpdateUser($input: UpdateUserInput!) {
|
||||
updateUser(input: $input) {
|
||||
id
|
||||
email
|
||||
name
|
||||
roles
|
||||
dataScope
|
||||
}
|
||||
}
|
||||
`;
|
||||
12
apps/teacher-portal/src/mocks/browser.ts
Normal file
12
apps/teacher-portal/src/mocks/browser.ts
Normal file
@@ -0,0 +1,12 @@
|
||||
/**
|
||||
* MSW Browser Setup - 浏览器端 Service Worker 注册
|
||||
*
|
||||
* 用法：在客户端入口（如 providers.tsx 或 layout）调用 setupWorker()
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import { setupWorker } from "msw/browser";
|
||||
import { handlers } from "./handlers";
|
||||
|
||||
export const worker = setupWorker(...handlers);
|
||||
33
apps/teacher-portal/src/mocks/fixtures/classes.ts
Normal file
33
apps/teacher-portal/src/mocks/fixtures/classes.ts
Normal file
@@ -0,0 +1,33 @@
|
||||
/**
|
||||
* Mock 班级数据（classes 域）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import type { Class } from "@/lib/graphql";
|
||||
|
||||
export const mockClasses: Class[] = [
|
||||
{
|
||||
id: "550e8400-e29b-41d4-a716-446655440010",
|
||||
name: "高三(1)班",
|
||||
gradeId: "grade-12",
|
||||
studentCount: 32,
|
||||
},
|
||||
{
|
||||
id: "550e8400-e29b-41d4-a716-446655440011",
|
||||
name: "高三(2)班",
|
||||
gradeId: "grade-12",
|
||||
studentCount: 30,
|
||||
},
|
||||
{
|
||||
id: "550e8400-e29b-41d4-a716-446655440012",
|
||||
name: "高三(3)班",
|
||||
gradeId: "grade-12",
|
||||
studentCount: 28,
|
||||
},
|
||||
];
|
||||
|
||||
/** Mock 班级详情查找（按 id） */
|
||||
export function findClass(id: string): Class | null {
|
||||
return mockClasses.find((c) => c.id === id) ?? null;
|
||||
}
|
||||
43
apps/teacher-portal/src/mocks/fixtures/exams.ts
Normal file
43
apps/teacher-portal/src/mocks/fixtures/exams.ts
Normal file
@@ -0,0 +1,43 @@
|
||||
/**
|
||||
* Mock 考试数据（core-edu 域）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import type { ExamItem } from "@/lib/graphql";
|
||||
|
||||
export function generateMockExams(classId: string): ExamItem[] {
|
||||
const now = Date.now();
|
||||
return [
|
||||
{
|
||||
id: `${classId}-exam-001`,
|
||||
classId,
|
||||
title: "2026 春季期中考试",
|
||||
description: "覆盖第 1-6 章内容",
|
||||
examDate: new Date(now + 7 * 24 * 60 * 60 * 1000).toISOString(),
|
||||
duration: 120,
|
||||
totalScore: 150,
|
||||
status: "PUBLISHED",
|
||||
},
|
||||
{
|
||||
id: `${classId}-exam-002`,
|
||||
classId,
|
||||
title: "单元测试 - 函数与导数",
|
||||
description: null,
|
||||
examDate: new Date(now + 14 * 24 * 60 * 60 * 1000).toISOString(),
|
||||
duration: 60,
|
||||
totalScore: 100,
|
||||
status: "DRAFT",
|
||||
},
|
||||
{
|
||||
id: `${classId}-exam-003`,
|
||||
classId,
|
||||
title: "月考 - 数学综合",
|
||||
description: "全册综合测试",
|
||||
examDate: new Date(now - 7 * 24 * 60 * 60 * 1000).toISOString(),
|
||||
duration: 90,
|
||||
totalScore: 120,
|
||||
status: "SCORED",
|
||||
},
|
||||
];
|
||||
}
|
||||
26
apps/teacher-portal/src/mocks/fixtures/grades.ts
Normal file
26
apps/teacher-portal/src/mocks/fixtures/grades.ts
Normal file
@@ -0,0 +1,26 @@
|
||||
/**
|
||||
* Mock 成绩数据（core-edu 域）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import type { GradeItem } from "@/lib/graphql";
|
||||
|
||||
export function generateMockGrades(examId: string): GradeItem[] {
|
||||
const grades: GradeItem[] = [];
|
||||
for (let i = 1; i <= 30; i++) {
|
||||
const score = Math.floor(Math.random() * 40) + 60;
|
||||
const feedback =
|
||||
score < 70 ? "需要加强基础练习" : score > 90 ? "表现出色" : null;
|
||||
grades.push({
|
||||
id: `${examId}-grade-${i}`,
|
||||
studentId: `${examId.slice(0, -3)}${String(i).padStart(3, "0")}`,
|
||||
studentName: `学生${String(i).padStart(2, "0")}`,
|
||||
examId,
|
||||
homeworkId: null,
|
||||
score,
|
||||
feedback,
|
||||
});
|
||||
}
|
||||
return grades;
|
||||
}
|
||||
37
apps/teacher-portal/src/mocks/fixtures/homework.ts
Normal file
37
apps/teacher-portal/src/mocks/fixtures/homework.ts
Normal file
@@ -0,0 +1,37 @@
|
||||
/**
|
||||
* Mock 作业数据（core-edu 域）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import type { HomeworkItem } from "@/lib/graphql";
|
||||
|
||||
export function generateMockHomework(classId: string): HomeworkItem[] {
|
||||
const now = Date.now();
|
||||
return [
|
||||
{
|
||||
id: `${classId}-hw-001`,
|
||||
classId,
|
||||
title: "函数练习题",
|
||||
description: "课本 P45 第 1-10 题",
|
||||
dueDate: new Date(now + 3 * 24 * 60 * 60 * 1000).toISOString(),
|
||||
status: "NOT_SUBMITTED",
|
||||
},
|
||||
{
|
||||
id: `${classId}-hw-002`,
|
||||
classId,
|
||||
title: "导数应用题",
|
||||
description: null,
|
||||
dueDate: new Date(now + 7 * 24 * 60 * 60 * 1000).toISOString(),
|
||||
status: "SUBMITTED",
|
||||
},
|
||||
{
|
||||
id: `${classId}-hw-003`,
|
||||
classId,
|
||||
title: "月考错题订正",
|
||||
description: "订正月考全部错题，并写解题思路",
|
||||
dueDate: new Date(now - 2 * 24 * 60 * 60 * 1000).toISOString(),
|
||||
status: "GRADED",
|
||||
},
|
||||
];
|
||||
}
|
||||
22
apps/teacher-portal/src/mocks/fixtures/students.ts
Normal file
22
apps/teacher-portal/src/mocks/fixtures/students.ts
Normal file
@@ -0,0 +1,22 @@
|
||||
/**
|
||||
* Mock 学生名单（iam 数据，经 teacher-bff 聚合）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import type { Student } from "@/lib/graphql";
|
||||
|
||||
/** 按班级 ID 生成学生名单（固定 30 名） */
|
||||
export function generateMockStudents(classId: string): Student[] {
|
||||
const students: Student[] = [];
|
||||
for (let i = 1; i <= 30; i++) {
|
||||
const id = `${classId.slice(0, -3)}${String(i).padStart(3, "0")}`;
|
||||
students.push({
|
||||
id,
|
||||
name: `学生${String(i).padStart(2, "0")}`,
|
||||
email: `student${i}@edu.test`,
|
||||
avatarUrl: null,
|
||||
});
|
||||
}
|
||||
return students;
|
||||
}
|
||||
39
apps/teacher-portal/src/mocks/fixtures/user.ts
Normal file
39
apps/teacher-portal/src/mocks/fixtures/user.ts
Normal file
@@ -0,0 +1,39 @@
|
||||
/**
|
||||
* Mock 用户数据（iam 域）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
* 关联：contract.md §4.2 MSW 拦截策略
|
||||
*/
|
||||
|
||||
import type { User } from "@/lib/graphql";
|
||||
|
||||
export const mockUser: User = {
|
||||
id: "550e8400-e29b-41d4-a716-446655440001",
|
||||
email: "teacher@edu.test",
|
||||
name: "张老师",
|
||||
roles: ["teacher"],
|
||||
dataScope: "GRADE",
|
||||
};
|
||||
|
||||
/** localStorage 中存储的 UserInfo（含 permissions 字段） */
|
||||
export const mockUserInfo = {
|
||||
...mockUser,
|
||||
permissions: [
|
||||
"DASHBOARD_READ",
|
||||
"VIEWPORT_READ",
|
||||
"CLASS_READ",
|
||||
"CLASS_READ_OWN",
|
||||
"STUDENT_READ_OWN",
|
||||
"EXAM_READ_OWN",
|
||||
"HOMEWORK_READ_OWN",
|
||||
"GRADE_READ_OWN",
|
||||
"GRADE_READ_CHILD",
|
||||
"USER_READ_OWN",
|
||||
],
|
||||
};
|
||||
|
||||
/** Mock JWT token（与 api-gateway DEV_MODE 公钥配对） */
|
||||
export const mockToken =
|
||||
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9." +
|
||||
btoa(JSON.stringify(mockUserInfo)) +
|
||||
".mock-signature";
|
||||
58
apps/teacher-portal/src/mocks/fixtures/viewports.ts
Normal file
58
apps/teacher-portal/src/mocks/fixtures/viewports.ts
Normal file
@@ -0,0 +1,58 @@
|
||||
/**
|
||||
* Mock 视口数据（iam 4 层视口模型，contract.md §2.4）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import type { ViewportItem } from "@/lib/graphql";
|
||||
|
||||
export const mockViewports: ViewportItem[] = [
|
||||
{
|
||||
key: "dashboard",
|
||||
label: "仪表盘",
|
||||
route: "/dashboard",
|
||||
icon: null,
|
||||
sortOrder: "01",
|
||||
requiredPermission: "DASHBOARD_READ",
|
||||
},
|
||||
{
|
||||
key: "classes",
|
||||
label: "班级管理",
|
||||
route: "/classes",
|
||||
icon: null,
|
||||
sortOrder: "02",
|
||||
requiredPermission: "CLASS_READ",
|
||||
},
|
||||
{
|
||||
key: "exams",
|
||||
label: "考试管理",
|
||||
route: "/exams",
|
||||
icon: null,
|
||||
sortOrder: "03",
|
||||
requiredPermission: "EXAM_READ_OWN",
|
||||
},
|
||||
{
|
||||
key: "homework",
|
||||
label: "作业管理",
|
||||
route: "/homework",
|
||||
icon: null,
|
||||
sortOrder: "04",
|
||||
requiredPermission: "HOMEWORK_READ_OWN",
|
||||
},
|
||||
{
|
||||
key: "grades",
|
||||
label: "成绩查询",
|
||||
route: "/grades",
|
||||
icon: null,
|
||||
sortOrder: "05",
|
||||
requiredPermission: "GRADE_READ_OWN",
|
||||
},
|
||||
{
|
||||
key: "settings",
|
||||
label: "个人设置",
|
||||
route: "/settings",
|
||||
icon: null,
|
||||
sortOrder: "99",
|
||||
requiredPermission: "USER_READ_OWN",
|
||||
},
|
||||
];
|
||||
174
apps/teacher-portal/src/mocks/handlers.ts
Normal file
174
apps/teacher-portal/src/mocks/handlers.ts
Normal file
@@ -0,0 +1,174 @@
|
||||
/**
|
||||
* MSW Handlers - 拦截所有 HTTP / GraphQL 请求返回 mock 数据
|
||||
*
|
||||
* 拦截路径（contract.md §2.3 + §4.2）：
|
||||
* - POST /api/auth/login → 返回固定 JWT + UserInfo
|
||||
* - POST /api/v1/teacher/graphql → 按 operationName 返回对应 GraphQL 响应
|
||||
*
|
||||
* 切换：NEXT_PUBLIC_API_MOCKING=enabled 时启用（见 src/mocks/index.ts）
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import { http, HttpResponse } from "msw";
|
||||
import { mockUser, mockUserInfo, mockToken } from "./fixtures/user";
|
||||
import { mockViewports } from "./fixtures/viewports";
|
||||
import { mockClasses, findClass } from "./fixtures/classes";
|
||||
import { generateMockStudents } from "./fixtures/students";
|
||||
import { generateMockExams } from "./fixtures/exams";
|
||||
import { generateMockHomework } from "./fixtures/homework";
|
||||
import { generateMockGrades } from "./fixtures/grades";
|
||||
|
||||
/** ActionState 信封（coord-final-decisions F9 + 总裁 §3.4 方案 B） */
|
||||
function envelope<T>(data: T) {
|
||||
return { success: true, errors: null, data };
|
||||
}
|
||||
|
||||
/** GraphQL 响应体（urql 期望 { data: ... }） */
|
||||
function graphqlData<T>(data: T) {
|
||||
return HttpResponse.json({ data });
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据 operationName 路由 GraphQL mock 响应
|
||||
*
|
||||
* 对应 graphql.ts 的 5 个 P2 Query + 4 个 P3 Query + 1 个 Mutation。
|
||||
*/
|
||||
function handleGraphQL(
|
||||
operationName: string,
|
||||
variables: Record<string, unknown>,
|
||||
) {
|
||||
switch (operationName) {
|
||||
case "Dashboard":
|
||||
return graphqlData({
|
||||
dashboard: {
|
||||
user: mockUser,
|
||||
classes: mockClasses,
|
||||
viewports: mockViewports,
|
||||
stats: {
|
||||
totalExams: 8,
|
||||
pendingGrading: 12,
|
||||
todayHomework: 3,
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
case "Viewports":
|
||||
return graphqlData({ viewports: mockViewports });
|
||||
|
||||
case "Me":
|
||||
return graphqlData({ me: mockUser });
|
||||
|
||||
case "Classes":
|
||||
return graphqlData({ classes: mockClasses });
|
||||
|
||||
case "Class": {
|
||||
const id = variables.id as string;
|
||||
return graphqlData({ class: findClass(id) });
|
||||
}
|
||||
|
||||
case "ClassStudents": {
|
||||
const classId = variables.classId as string;
|
||||
return graphqlData({ classStudents: generateMockStudents(classId) });
|
||||
}
|
||||
|
||||
case "ClassExams": {
|
||||
const classId = variables.classId as string;
|
||||
return graphqlData({ classExams: generateMockExams(classId) });
|
||||
}
|
||||
|
||||
case "ClassHomework": {
|
||||
const classId = variables.classId as string;
|
||||
return graphqlData({ classHomework: generateMockHomework(classId) });
|
||||
}
|
||||
|
||||
case "ExamGrades": {
|
||||
const examId = variables.examId as string;
|
||||
return graphqlData({ examGrades: generateMockGrades(examId) });
|
||||
}
|
||||
|
||||
case "UpdateUser": {
|
||||
const input = variables.input as { name?: string; email?: string };
|
||||
return graphqlData({
|
||||
updateUser: { ...mockUser, ...input },
|
||||
});
|
||||
}
|
||||
|
||||
default:
|
||||
return HttpResponse.json(
|
||||
{
|
||||
errors: [
|
||||
{
|
||||
message: `Mock 未覆盖的 GraphQL operation: ${operationName}`,
|
||||
extensions: { code: "BFF_TEACHER_NOT_IMPLEMENTED" },
|
||||
},
|
||||
],
|
||||
},
|
||||
{ status: 200 },
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
export const handlers = [
|
||||
// POST /api/auth/login → 登录
|
||||
http.post("*/api/auth/login", async ({ request }) => {
|
||||
const body = (await request.json()) as {
|
||||
email?: string;
|
||||
password?: string;
|
||||
};
|
||||
if (!body.email || !body.password) {
|
||||
return HttpResponse.json(
|
||||
{
|
||||
success: false,
|
||||
error: { code: "GW_UNAUTHORIZED", message: "邮箱和密码必填" },
|
||||
},
|
||||
{ status: 400 },
|
||||
);
|
||||
}
|
||||
return HttpResponse.json(
|
||||
envelope({
|
||||
user: mockUserInfo,
|
||||
tokens: { accessToken: mockToken, refreshToken: "mock-refresh" },
|
||||
}),
|
||||
);
|
||||
}),
|
||||
|
||||
// POST /api/v1/teacher/graphql → GraphQL endpoint
|
||||
http.post("*/api/v1/teacher/graphql", async ({ request }) => {
|
||||
const body = (await request.json()) as {
|
||||
operationName?: string;
|
||||
query?: string;
|
||||
variables?: Record<string, unknown>;
|
||||
};
|
||||
|
||||
const operationName =
|
||||
body.operationName ?? extractOperationName(body.query);
|
||||
const variables = body.variables ?? {};
|
||||
|
||||
return handleGraphQL(operationName, variables);
|
||||
}),
|
||||
|
||||
// GET /api/health → liveness
|
||||
http.get("*/api/health", () =>
|
||||
HttpResponse.json({ status: "ok", service: "teacher-portal" }),
|
||||
),
|
||||
|
||||
// GET /api/ready → readiness
|
||||
http.get("*/api/ready", () =>
|
||||
HttpResponse.json({
|
||||
status: "ok",
|
||||
service: "teacher-portal",
|
||||
checks: { msw: true },
|
||||
}),
|
||||
),
|
||||
];
|
||||
|
||||
/**
|
||||
* 从 query 字符串提取 operationName
|
||||
* 兜底：当客户端未传 operationName 时从 query 文本提取
|
||||
*/
|
||||
function extractOperationName(query?: string): string {
|
||||
if (!query) return "Unknown";
|
||||
const match = query.match(/(?:query|mutation)\s+(\w+)/);
|
||||
return match?.[1] ?? "Unknown";
|
||||
}
|
||||
37
apps/teacher-portal/src/mocks/index.ts
Normal file
37
apps/teacher-portal/src/mocks/index.ts
Normal file
@@ -0,0 +1,37 @@
|
||||
/**
|
||||
* MSW 启用入口 - 按 NEXT_PUBLIC_API_MOCKING 环境变量条件启用
|
||||
*
|
||||
* 启用方式：在 .env 中设置 NEXT_PUBLIC_API_MOCKING=enabled
|
||||
* 关闭方式：删除该变量或设为 disabled
|
||||
*
|
||||
* 在客户端入口（providers.tsx）调用 initMocks() 触发注册。
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
const MOCKING_ENABLED = process.env.NEXT_PUBLIC_API_MOCKING === "enabled";
|
||||
|
||||
async function initMocks(): Promise<void> {
|
||||
if (!MOCKING_ENABLED) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (typeof window === "undefined") {
|
||||
// 服务端：启用 node server
|
||||
const { server } = await import("./server");
|
||||
server.listen({
|
||||
onUnhandledRequest: "bypass",
|
||||
});
|
||||
} else {
|
||||
// 客户端：注册 Service Worker
|
||||
const { worker } = await import("./browser");
|
||||
await worker.start({
|
||||
onUnhandledRequest: "bypass",
|
||||
serviceWorker: {
|
||||
url: "/mockServiceWorker.js",
|
||||
},
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
export { initMocks, MOCKING_ENABLED };
|
||||
13
apps/teacher-portal/src/mocks/server.ts
Normal file
13
apps/teacher-portal/src/mocks/server.ts
Normal file
@@ -0,0 +1,13 @@
|
||||
/**
|
||||
* MSW Server Setup - Node.js 端 mock（用于 SSR + 测试）
|
||||
*
|
||||
* Next.js App Router 在服务端渲染时会调用 GraphQL（urql 支持 SSR），
|
||||
* 需要在服务端也启用 MSW 拦截。
|
||||
*
|
||||
* 维护者：ai13（teacher-portal）
|
||||
*/
|
||||
|
||||
import { setupServer } from "msw/node";
|
||||
import { handlers } from "./handlers";
|
||||
|
||||
export const server = setupServer(...handlers);
|
||||
Reference in New Issue
Block a user