“华研慧学”小程序产品系统

一、立项原因（拟解决的产品问题）
本项目立项旨在解决家校信息不对称、家长对孩子学习"看不见、看不懂、跟不上"的核心痛点：
1. 学情不透明——家长仅靠考试与老师口头反馈了解孩子，信息滞后、颗粒度粗；本项目以周对比/周环比量化呈现数据采集、规划练习、新增错题、学习视频等行为。
2. 报告黑盒化——家长只见分数、不知短板；通过 AI 诊断报告（能力总评、答题情况、掌握状态、提升建议）与学习报告（学情诊断、发展追踪）将分数转化为可执行建议。
3. 错题难沉淀——错题散落于学校作业、试卷、平台练习；错题集统一归集，按学科/题型/难度/来源筛选，支持数学公式渲染。
4. 缺规划闭环——结合知识图谱「低频/中频/高频/必考点」标签，构建"诊断→规划→练习→批改→再诊断"闭环。
5. 触达门槛高——微信登录+扫码绑定即用，无需下载 App。
二、行业场景与业务背景
所属 K12 教育科技（EdTech）/ AI 智慧教育 / 家校共育 赛道。在"教育数字化""AI 赋能教育"政策与行业趋势下，教育平台由"卖课"转向"数据驱动的个性化学习服务"。「华研慧学」即在此背景下构建的 AI 学习平台，本项目是其面向 C 端家长的微信小程序端。
服务对象：K12 学生家长。**覆盖范围**：小学、初中、高中全学段（一至高三 12 个年级），语文、数学、英语、物理、化学、生物、政治、历史、地理、道法等全学科。
业务链路：学生完成学校作业、学校试卷、平台练习三类任务 → 平台 AI 诊断与知识图谱分析（待下载→待提交→待批改→已批改）→ 家长扫码绑定查看学情，形成"学生学→平台诊断→家长监督"家校协同闭环。

一、功能模块清单（7 大模块 / 13 个页面，主包 + 2 分包）
1. 首页（学习情况）｜2. 学生管理｜3. 诊断报告｜4. 学习报告｜5. 学习规划｜6. 错题集｜7. 个人信息
二、主要功能描述
1. 首页（学习情况）：登录后数据总览。以「周对比 / 周环比」呈现**数据采集、规划练习、新增错题、学习视频**四项指标，并提供诊断报告、学习报告、学习规划、错题集四大入口，含未登录提示、学生切换与扫码绑定。
2. 学生管理：学生列表、扫码添加、绑定/解绑/切换学生，支持多孩子管理，是其他数据模块的前提。
3. 诊断报告：列表 + 详情。详情含**个人情况、能力总评、答题情况、掌握状态、提升建议**五个维度，配答题状态、知识掌握、半圆进度图等组件呈现 AI 诊断结论。
4. 学习报告：列表 + 详情。含**学习总评、学情诊断、发展追踪**三个维度，侧重阶段性学习过程与趋势。
5. 学习规划：列表 + 新旧两版详情页。展示平台生成的个性化学习规划，新版结合错题/试卷内容，落地"诊断→规划→练习"闭环。
6. 错题集：列表 + 题目解析。支持按来源（学校作业/试卷、平台练习）、题型、难度、时间范围多维筛选；解析页支持富文本与数学公式（TeX/MathML）渲染。
7. 个人信息：家长信息查看与修改、头像上传。
技术支撑：微信快捷登录与 token 续期、统一请求/上传封装、自定义导航栏、分包预加载与 mathjax 拆包优化。

一、可承接的具体任务（按模块）
1. 小程序框架搭建：uni-app + Vue3 + TS 工程配置、分包划分、tabBar、自定义导航栏（适配状态栏/胶囊）、easycom 按需引入。
2. 请求层封装：`fetch.ts` 统一请求/上传，token 拼接、loading 与错误码映射、登录态失效（code 9/11/12）自动重登。
3. 登录与学生管理：微信 `uni.login` 快捷登录、扫码绑定/解绑/切换学生。
4. 学情主页：周对比/周环比四指标数据看板与四大入口。
5. 报告模块：诊断报告（五维度）、学习报告（三维度）列表与详情。
6. 学习规划：列表 + 新旧两版详情页。
7. 错题集：多维筛选列表 + 题目解析页。
8. 数学公式渲染组件：`RenderMathJax`（mathjax-full + marked）。
9. 打包优化：ES2017 转译、可选链兼容、mathjax 拆包插件。
二、技术栈与架构
技术栈：uni-app（Vue 3.5）、TypeScript、Vite 5、Pinia、Sass、uv-ui、u-charts、mathjax-full + marked。
架构：主包（首页/我的）+ `package-sub`（报告/规划/学生）+ `package-mistakes`（错题）分包架构；`preloadRule` 预加载；API 分层封装（fetch → api → pages）。
三、亮点与难点
亮点：分包 + mathjax 独立拆包控制主包体积；自研构建插件解决小