个人题库网站的搭建

{
  "id": "highway-chapters-1-1-747c70e1-q001",
  "module": "公路工程管理与实务 · 1.1 路基施工",
  "difficulty": 1,
  "type": "single",
  "question": "题干内容……",
  "options": [
    { "key": "A", "text": "选项 A" },
    { "key": "B", "text": "选项 B" }
  ],
  "correctAnswers": ["A"],
  "answer": "## 正确答案\nA\n\n## 解析\n这里是解析内容……",
  "tags": ["公路工程管理与实务", "单选题"],
  "source": "章节精讲",
  "questionImages": [
    "/question-assets/construction/highway/chapters/example/q001-1.webp"
  ]
}

iFace/
├─ api/
│  └─ auth.js                         # Vercel Serverless Function，用于 GitHub OAuth 登录和云同步授权
│
├─ docs/
│  └─ screenshots/                    # 项目截图，用于 README 或博客展示
│
├─ local-pdf-sources/                 # 本地 PDF 原题目录，已被 .gitignore 忽略，不应提交到 GitHub
│  ├─ highway/                        # 公路工程管理与实务 PDF
│  ├─ regulations/                    # 建设工程法规及相关知识 PDF
│  ├─ management/                     # 建设工程施工管理 PDF
│  ├─ past-exams/                     # 历年真题 PDF
│  └─ mock-exams/                     # 模拟试卷 PDF
│
├─ public/
│  ├─ icons/                          # PWA 图标，不同尺寸用于浏览器、桌面快捷方式等
│  ├─ questions/
│  │  └─ construction/                # 内置建工题库 JSON
│  │     ├─ catalog.json              # 轻量题库目录，题库页优先加载它，避免一次性加载全部答案
│  │     ├─ highway/                  # 公路工程管理与实务题库
│  │     ├─ regulations/              # 建设工程法规及相关知识题库
│  │     └─ management/               # 建设工程施工管理题库
│  │
│  └─ question-assets/
│     └─ construction/                # 题目配图资源，由 PDF 管线裁剪并转成 WebP
│        ├─ highway/                  # 公路工程相关题图
│        ├─ regulations/              # 法规相关题图
│        └─ management/               # 施工管理相关题图
│
├─ reports/
│  ├─ construction_bank_audit.json    # 题库审计报告，记录扫描结果和问题明细
│  ├─ construction_bank_audit.md      # 人类可读版审计报告
│  └─ construction_bank_repairs.json  # 保守修复脚本生成的修复记录
│
├─ scripts/
│  ├─ audit_construction_json.py      # 审计生成后的 JSON 题库，不重跑 PDF 构建
│  ├─ repair_construction_json.py     # 对高置信度错误进行保守修复
│  ├─ md_to_json.py                   # Markdown 题目转 JSON 的辅助脚本
│  └─ release.sh                      # 发布辅助脚本
│
├─ src/
│  ├─ assets/                         # 前端静态资源
│  │
│  ├─ components/
│  │  ├─ layout/
│  │  │  ├─ Navbar.tsx                # 顶部导航栏，“建工刷题助手”等品牌入口
│  │  │  └─ SettingsDrawer.tsx        # 设置抽屉，包含 AI 配置、刷题偏好、导入导出、云同步等
│  │  │
│  │  └─ ui/
│  │     ├─ AIPanel.tsx               # 题目 AI 辅助面板，用于解析、追问、点评
│  │     ├─ MarkdownRenderer.tsx      # Markdown 渲染组件，用于显示答案、解析、解答题分段
│  │     └─ index.tsx                 # 通用 UI 组件导出
│  │
│  ├─ data/
│  │  └─ schema.ts                    # 题目 JSON 数据结构定义，包括 single、multiple、essay
│  │
│  ├─ generated/
│  │  └─ constructionBank.ts          # PDF 管线自动生成的题库索引，不建议手动修改
│  │
│  ├─ hooks/
│  │  └─ useQuestions.ts              # 题库加载 Hook，连接页面和题库加载逻辑
│  │
│  ├─ lib/
│  │  ├─ db.ts                        # IndexedDB 本地数据库封装
│  │  ├─ gistSync.ts                  # GitHub Gist 云同步逻辑
│  │  ├─ mdImport.ts                  # Markdown 导入解析逻辑
│  │  ├─ questionLoader.ts            # 内置题库和自定义题库加载核心，支持 catalog 按需加载
│  │  └─ questionVisibility.ts        # 题库分类隐藏、显示偏好等过滤逻辑
│  │
│  ├─ pages/
│  │  ├─ Dashboard.tsx                # 首页仪表盘，展示总体进度、今日目标、快捷入口
│  │  ├─ ImportPage.tsx               # 导入页面，支持 JSON / Markdown 自定义题库导入
│  │  ├─ Practice.tsx                 # 刷题页，承载先答后看、边看边记、背题模式
│  │  ├─ QuestionDetail.tsx           # 题目详情页，展示完整题干、选项、图片、答案和解析
│  │  ├─ QuestionList.tsx             # 题库目录页，按科目、章节、真题、模拟题组织 7000+ 题
│  │  └─ WeakPoints.tsx               # 错题和薄弱点页面
│  │
│  ├─ store/
│  │  ├─ useAIStore.ts                # AI 配置、模型参数、系统提示词等状态
│  │  ├─ useAuthStore.ts              # GitHub 登录、OAuth 状态、云同步身份信息
│  │  └─ useStudyStore.ts             # 学习进度、做题记录、错题、收藏、笔记等状态
│  │
│  ├─ types/
│  │  └─ index.ts                     # 项目公共类型定义
│  │
│  ├─ App.tsx                         # 应用主入口，配置页面路由和整体布局
│  ├─ main.tsx                        # React 挂载入口
│  └─ index.css                       # 全局样式和 Tailwind 引入
│
├─ tools/
│  └─ pdf-pipeline/
│     ├─ build_construction_bank.py   # PDF 转 JSON 核心脚本，负责文本提取、清洗、分题、裁图
│     └─ README.md                    # PDF 管线说明，强调原始 PDF 不应提交
│
├─ .env.example                       # 环境变量示例，主要用于 GitHub OAuth 和云同步
├─ .gitignore                         # Git 忽略规则，包含 local-pdf-sources、PDF、构建产物等
├─ biome.json                         # Biome 代码格式化和检查配置
├─ index.html                         # Vite HTML 入口
├─ package.json                       # 项目依赖和 npm scripts
├─ README.md                          # 项目说明文档
├─ tsconfig.json                      # TypeScript 总配置
├─ vercel.json                        # Vercel 部署配置
└─ vite.config.ts                     # Vite 配置，包含 React、Tailwind、PWA、缓存策略等