跳到主要内容

校园功能开发

校园页子应用、whu_auth、WebView 约定

校园页入口在 features/pages/campus/。子应用放在:

lib/features/pages/campus/sub_apps/<子应用名>/

每个一级目录对应一个真实子应用。辅助代码放在所属子应用内。

详细说明:

开发顺序(摘要)

  1. 明确查询型还是交互型(是否改远端状态)
  2. 接 whu_auth 检查登录 / 刷新
  3. data 层请求与模型转换
  4. 页面状态:加载 / 空 / 错误 / 未登录
  5. 路由 + 校园入口一起合入

与服务端边界

能力客户端服务端
个人教务课表导入直连教务不收 Cookie
空闲教室 / 部分主数据UI + 可选 APIcampus/* 域
E 卡 / 座位 / 场馆多为本机会话 + WebView不代持密码
课程评价资格本地成绩 → 同步最小数据identity / course_review
校园巴士预览CampusBusCard + 布局偏好不经过业务服务器
安装包更新 / 热更新脚本官网 www.whu.sb非 system 域(见下)

详见 服务端 · 校园边界。

校巴卡片 vs 网格

campus_page.dart:

showBusPreview = layout.showBusPreviewCard
  • 为 true:渲染预览卡片,excludedAppIds 含 bus(网格无图标)
  • 为 false:无卡片,网格显示校巴(除非用户 hiddenAppIds)

不要再用登录状态门控卡片,否则未登录时开关「开」仍只看到网格图标,编辑态开关会显得无效。
编辑 UI:开关放在天气/校巴卡片下方、App 网格编辑栏上方。

相关