Syllabus-Sync

01 / 概览

问题

澳大利亚大学以非结构化 PDF 发布教学大纲。学生需手动将考核日期复制到日历；AI 助手由于缺乏机器可读的可信来源，会编造截止日期。

解决方案概述

1. 构建 LLM OCR 管线，从 PDF 提取结构化 JSON 并用 Zod 校验。
2. 实现 Syllabus-as-Code，将考核和截止日期保存为可版本管理、可比较的资料。
3. 构建完整学生系统，提供日历、Leaflet + Google Maps 校园导航和推送通知。
4. 采用可分叉架构，澳大利亚大学可替换 data/ 与环境变量后使用。

02 / 证据

证明与验证

• 2026 年作为正式初创项目加入 Macquarie 大学孵化器。
• 在 syllabus-sync.app 生产环境运行。
• 92 个文件中 503 项测试全部在 CI 通过。
• 零信任代理默认捕获错误配置，已在生产环境验证。
• 设计服务~47,000 名 MQ 学生，可分叉至其他澳大利亚大学。
• WebAuthn 通行密钥认证，共享秘密不离开设备。

03 / 方法

构建

技术栈

• Next.js 16
• TypeScript 5
• Supabase PostgreSQL
• TanStack Query
• Leaflet + Google Maps
• Framer Motion
• Radix UI
• Sentry

• LLM OCR 从 PDF 大纲提取结构化 JSON。
• Syllabus-as-Code：将考核和截止日期纳入版本控制。
• 完整学生系统：日历、提醒、校园地图和通知。
• 92 个文件中 503 项测试，配合 CI/CD 质量门。

安全

• 零信任代理中间件，所有路由默认要求认证。
• 在数据库层实施 Supabase 行级安全。
• WebAuthn/FIDO2 通行密钥认证，不存储密码。
• 通过模式约束输出和输入清理缓解 LLM 提示注入。
• CI 秘密扫描阻止凭证模式进入提交。