feat: select school terms and smooth refractive Dock motion

mobile/test/school/login_flow_test.dart

@@ -2,6 +2,32 @@ import 'package:flutter_test/flutter_test.dart';
 import 'package:hepan_everyday/features/school/school_login_flow.dart';
 
 void main() {
+  test(
+    'exam redirect compares selected xq rather than only the shared path',
+    () {
+      final flow = SchoolLoginFlow();
+      final target = Uri.parse(
+        'https://yjsjy.uestc.edu.cn/pyxx/pygl/kskcxx/index?xq=72',
+      );
+      flow.begin(target);
+      expect(
+        flow.onLoaded(
+          target.replace(query: 'xq=72&view=student'),
+          authenticated: true,
+        ),
+        isNull,
+      );
+      expect(
+        flow.onLoaded(target.replace(query: 'xq=73'), authenticated: true),
+        target,
+      );
+      flow.begin(target);
+      expect(
+        flow.onLoaded(target.replace(query: ''), authenticated: true),
+        target,
+      );
+    },
+  );
   test(
     'repeated school login bounces have a bounded automatic redirect budget',
     () {

mobile/test/school/school_page_probe_js_test.cjs

@@ -11,8 +11,8 @@ const timetable = 'https://yjsjy.uestc.edu.cn/pyxx/pygl/xskbcx/index/1';
 function term(id) {
   const result = {
     selectedIndex: 1,
-    options: [false, false].map(selected => ({
-      selected,
+    options: [false, false].map((selected, index) => ({
+      selected, value: String(73 - index),
       setAttribute() { this.selected = true; },
       removeAttribute() { this.selected = false; },
     })),
@@ -56,6 +56,7 @@ assert.equal(probe(doc('https://yjsjy.uestc.edu.cn/pyxx/jzsso/login')).authentic
 
 const top = probe(doc(timetable, {table: true}));
 assert.equal(top.pages.length, 1);
+assert.deepEqual(top.terms, [73, 72], 'bounded school term choices contain only dropdown IDs');
 assert.match(top.pages[0].html, /value="1" selected="selected"/);
 assert.doesNotMatch(top.pages[0].html, /value="0" selected/);
 

mobile/test/school/school_session_flow_test.dart

@@ -3,6 +3,7 @@ import 'dart:async';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:webview_flutter_platform_interface/webview_flutter_platform_interface.dart';
 import 'package:hepan_everyday/features/school/school_session.dart';
+import 'package:hepan_everyday/domain/school_term.dart';
 import 'package:hepan_everyday/features/school/school_exam_adapter.dart';
 
 import '../support/fake_school_web.dart';
@@ -26,7 +27,7 @@ void main() {
   }
 
   test('graduate logout function automatically opens timetable without an exit anchor', () async {
-    await session.open();
+    await session.openTimetable(term: SchoolTerm(73));
     platform.web.javascript = (script) async =>
         script.contains("typeof window.logout")
         ? schoolPageEvidence(topUrl: platform.web.url!, authenticated: true)
@@ -37,7 +38,7 @@ void main() {
   });
 
   test('manual graduate page reads recognized embedded timetable instead of restarting login', () async {
-    await session.open();
+    await session.openTimetable(term: SchoolTerm(73));
     const home = 'https://yjsjy.uestc.edu.cn/pyxx/home/index';
     platform.web.url = home;
     platform.web.javascript = (_) async => schoolPageEvidence(
@@ -53,7 +54,7 @@ void main() {
   test(
     'closed authentication screen ignores later page-finished callbacks',
     () async {
-      await session.open();
+      await session.openTimetable(term: SchoolTerm(73));
       session.setReadingActive(true);
       session.setReadingActive(false);
       platform.web.javascript = (_) async =>
@@ -68,7 +69,7 @@ void main() {
   test(
     'asynchronous timetable DOM is imported without another navigation',
     () async {
-      await session.open();
+      await session.openTimetable(term: SchoolTerm(73));
       session.setReadingActive(true);
       var ready = false;
       platform.web.javascript = (_) async => schoolPageEvidence(
@@ -88,7 +89,7 @@ void main() {
   );
 
   test('stale script response cannot cancel polling on a newer page', () async {
-    await session.open();
+    await session.openTimetable(term: SchoolTerm(73));
     session.setReadingActive(true);
     final old = Completer<Object>();
     platform.web.javascript = (_) => old.future;
@@ -116,7 +117,7 @@ void main() {
   });
 
   test('external document evidence cannot become a school import', () async {
-    await session.open();
+    await session.openTimetable(term: SchoolTerm(73));
     platform.web.url = SchoolSession.timetableUrl.toString();
     for (final url in [
       'https://evil.test/pyxx/pygl/xskbcx/index/1',
@@ -135,7 +136,7 @@ void main() {
   });
 
   test('read-current recovery imports a frame and never reloads SSO', () async {
-    await session.open();
+    await session.openTimetable(term: SchoolTerm(73));
     const home = 'http://yjsjy.uestc.edu.cn/pyxx/home/index';
     platform.web.url = home;
     platform.web.javascript = (_) async => schoolPageEvidence(
@@ -152,7 +153,7 @@ void main() {
   test(
     'authenticated graduate root dashboard automatically opens timetable',
     () async {
-      await session.open();
+      await session.openTimetable(term: SchoolTerm(73));
       const home = 'http://yjsjy.uestc.edu.cn/pyxx?targetUrl=-1';
       final decision = await platform.delegate.navigation(
         const NavigationRequest(url: home, isMainFrame: true),
@@ -169,7 +170,7 @@ void main() {
   test(
     'obsolete automatic request failure preserves a newer pending import',
     () async {
-      await session.open();
+      await session.openTimetable(term: SchoolTerm(73));
       final oldRequest = Completer<void>();
       platform.web.request = (_) => oldRequest.future;
       platform.web.javascript = (_) async =>
@@ -190,7 +191,7 @@ void main() {
   );
 
   test('actual session follows service login then reads exam HTML', () async {
-    await session.openExams();
+    await session.openExams(term: SchoolTerm(73));
     expect(platform.web.loads.single, SchoolSession.authUrl.toString());
     navigate('https://idas.uestc.edu.cn/authserver/login?service=graduate');
     await flushSchoolEvents();
@@ -216,7 +217,7 @@ void main() {
   test(
     'obsolete main-frame error cannot interrupt a newer exam read',
     () async {
-      await session.openExams();
+      await session.openExams(term: SchoolTerm(73));
       platform.web.javascript = (_) async => schoolPageEvidence(
         topUrl: platform.web.url!,
         html: examHtml(),
@@ -240,11 +241,11 @@ void main() {
   test(
     'open waits for logout so old clearing cannot blank the new login',
     () async {
-      await session.open();
+      await session.openTimetable(term: SchoolTerm(73));
       platform.cookies.clearing = Completer<bool>();
       final closing = session.logout();
       await flushSchoolEvents();
-      final reopening = session.openExams();
+      final reopening = session.openExams(term: SchoolTerm(73));
       await flushSchoolEvents();
       platform.cookies.clearing!.complete(true);
       await closing;
@@ -257,11 +258,11 @@ void main() {
   test(
     'acknowledging an old saved draft preserves a newer pending import',
     () async {
-      await session.openExams();
+      await session.openExams(term: SchoolTerm(73));
       final old = SchoolExamAdapter.extract(examHtml());
       session.pendingExams = old;
       final generation = session.pageGeneration;
-      await session.openExams();
+      await session.openExams(term: SchoolTerm(73));
       final newer = SchoolExamAdapter.extract(examHtml(room: '品学楼A101'));
       session.pendingExams = newer;
       expect(
@@ -283,7 +284,7 @@ void main() {
   test(
     'native logout failure is reported and subsequent login can recover',
     () async {
-      await session.open();
+      await session.openTimetable(term: SchoolTerm(73));
       session.connectionState = SchoolConnectionState.connected;
       platform.cookies.clearing = Completer<bool>();
       final closing = session.logout();
@@ -294,12 +295,12 @@ void main() {
       expect(await result, isTrue);
       expect(session.connectionState, isNot(SchoolConnectionState.connected));
       expect(session.message, contains('退出未完成'));
-      await session.openExams();
+      await session.openExams(term: SchoolTerm(73));
       expect(platform.web.loads.last, SchoolSession.authUrl.toString());
     },
   );
   test('university HTTP identity redirect upgrades to HTTPS with service preserved', () async {
-    await session.open();
+    await session.openTimetable(term: SchoolTerm(73));
     const redirect =
         'http://idas.uestc.edu.cn/authserver/login?service=http%3A%2F%2Fyjsjy.uestc.edu.cn%2Fpyxx%2Fjzsso%2Flogin';
     final decision = await platform.delegate.navigation(

mobile/test/school/term_picker_widget_test.dart

@@ -0,0 +1,119 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:hepan_everyday/app/app_controller.dart';
+import 'package:hepan_everyday/domain/app_snapshot.dart';
+import 'package:hepan_everyday/domain/school_term.dart';
+import 'package:hepan_everyday/features/school/school_auth_page.dart';
+import 'package:hepan_everyday/features/school/school_session.dart';
+import 'package:webview_flutter_platform_interface/webview_flutter_platform_interface.dart';
+
+import '../support/fake_school_web.dart';
+import '../support/fakes.dart';
+
+// Native WebView rendering is unavailable to widget tests. All session and
+// authentication logic still uses the real controller through the platform.
+class _WidgetSchoolPlatform extends FakeSchoolPlatform {
+  @override
+  PlatformWebViewWidget createPlatformWebViewWidget(
+    PlatformWebViewWidgetCreationParams params,
+  ) => _WebSurface(params);
+}
+
+class _WebSurface extends PlatformWebViewWidget {
+  _WebSurface(super.params) : super.implementation();
+  @override
+  Widget build(BuildContext context) => const SizedBox.expand();
+}
+
+void main() {
+  testWidgets(
+    'picker waits for school login and selected row only imports on confirmation',
+    (tester) async {
+      final platform = _WidgetSchoolPlatform();
+      WebViewPlatform.instance = platform;
+      final session = SchoolSession();
+      final controller = AppController(
+        MemoryStore(),
+        FakeNotifications(),
+        FakeCalendar(),
+        () => DateTime(2026, 10, 13),
+      );
+      await controller.initialize();
+      await session.openExams();
+      await tester.pumpWidget(
+        MaterialApp(
+          home: SchoolAuthPage(session: session, controller: controller),
+        ),
+      );
+      await tester.pumpAndSettle();
+      expect(find.text('选择学校学期'), findsNothing);
+      const home = 'https://yjsjy.uestc.edu.cn/pyxx/home/index';
+      platform.web.url = home;
+      platform.web.javascript = (_) async =>
+          schoolPageEvidence(topUrl: home, authenticated: true);
+      platform.delegate.started(home);
+      platform.delegate.finished(home);
+      await tester.pumpAndSettle();
+      expect(find.text('选择学校学期'), findsOneWidget);
+      await tester.tap(find.text('2025-2026年春'));
+      await tester.pump();
+      expect(platform.web.loads.length, 1);
+      expect(controller.snapshot.schoolTerm, isNull);
+      await tester.tap(find.text('导入所选学期'));
+      await tester.pump();
+      expect(
+        platform.web.loads.last,
+        'https://yjsjy.uestc.edu.cn/pyxx/pygl/kskcxx/index?xq=72',
+      );
+      expect(controller.snapshot.schoolTerm, isNull);
+      await tester.pumpWidget(const SizedBox());
+      session.dispose();
+      controller.dispose();
+    },
+  );
+
+  testWidgets('canceling a connected term change leaves saved term intact', (
+    tester,
+  ) async {
+    final platform = _WidgetSchoolPlatform();
+    WebViewPlatform.instance = platform;
+    final session = SchoolSession();
+    final controller = AppController(
+      MemoryStore(AppSnapshot(schoolTerm: SchoolTerm(72))),
+      FakeNotifications(),
+      FakeCalendar(),
+      () => DateTime(2026, 10, 13),
+    );
+    await controller.initialize();
+    session.connectionState = SchoolConnectionState.connected;
+    await session.openTimetable(term: SchoolTerm(72), chooseTerm: true);
+    await tester.pumpWidget(
+      MaterialApp(
+        home: Builder(
+          builder: (context) => TextButton(
+            onPressed: () => Navigator.of(context).push(
+              MaterialPageRoute<void>(
+                builder: (_) =>
+                    SchoolAuthPage(session: session, controller: controller),
+              ),
+            ),
+            child: const Text('打开学校'),
+          ),
+        ),
+      ),
+    );
+    await tester.tap(find.text('打开学校'));
+    await tester.pumpAndSettle();
+    expect(find.text('选择学校学期'), findsOneWidget);
+    await tester.tap(find.text('2026-2027年秋'));
+    await tester.tap(find.text('取消'));
+    await tester.pumpAndSettle();
+    expect(find.text('选择学校学期'), findsNothing);
+    expect(platform.web.loads, isEmpty);
+    expect(session.selectedTerm, SchoolTerm(72));
+    expect(controller.snapshot.schoolTerm, SchoolTerm(72));
+    await tester.pumpWidget(const SizedBox());
+    session.dispose();
+    controller.dispose();
+  });
+}

mobile/test/school/term_selection_test.dart

@@ -0,0 +1,181 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:webview_flutter_platform_interface/webview_flutter_platform_interface.dart';
+import 'package:hepan_everyday/features/school/school_session.dart';
+import 'package:hepan_everyday/features/school/school_page_probe.dart';
+import 'package:hepan_everyday/domain/school_term.dart';
+
+import 'dart:convert';
+
+import '../support/fake_school_web.dart';
+import 'recognized_timetable_test.dart' show fixture;
+import 'exam_adapter_test.dart' show examHtml;
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+  test(
+    'first online import waits for an explicit term even on a ready table',
+    () async {
+      final platform = FakeSchoolPlatform();
+      WebViewPlatform.instance = platform;
+      final session = SchoolSession();
+      addTearDown(session.dispose);
+      await session.open();
+      const url = 'https://yjsjy.uestc.edu.cn/pyxx/pygl/xskbcx/index/73';
+      platform.web.url = url;
+      platform.web.javascript = (_) async =>
+          schoolPageEvidence(topUrl: url, authenticated: true, html: fixture());
+      platform.delegate.started(url);
+      platform.delegate.finished(url);
+      await flushSchoolEvents();
+      expect(session.pendingDraft, isNull);
+      expect(session.finding, isFalse);
+      expect(session.needsTermSelection, isTrue);
+    },
+  );
+
+  test('signed out change waits for authentication then explicit choice before requesting exams', () async {
+    final platform = FakeSchoolPlatform();
+    WebViewPlatform.instance = platform;
+    final session = SchoolSession();
+    addTearDown(session.dispose);
+    await session.openExams(term: SchoolTerm(73), chooseTerm: true);
+    expect(session.needsTermSelection, isFalse);
+    expect(
+      platform.web.loads.single,
+      'https://yjsjy.uestc.edu.cn/pyxx/jzsso/login',
+    );
+    const home = 'https://yjsjy.uestc.edu.cn/pyxx/home/index';
+    platform.web.url = home;
+    platform.web.javascript = (_) async =>
+        schoolPageEvidence(topUrl: platform.web.url!, authenticated: true);
+    platform.delegate.started(home);
+    platform.delegate.finished(home);
+    await flushSchoolEvents();
+    expect(session.needsTermSelection, isTrue);
+    expect(platform.web.loads.length, 1);
+    await session.selectTerm(SchoolTerm(72));
+    expect(
+      platform.web.loads.last,
+      'https://yjsjy.uestc.edu.cn/pyxx/pygl/kskcxx/index?xq=72',
+    );
+    expect(session.needsTermSelection, isFalse);
+  });
+
+  test('connected change prompts immediately without replacing imported data or navigating', () async {
+    final platform = FakeSchoolPlatform();
+    WebViewPlatform.instance = platform;
+    final session = SchoolSession();
+    addTearDown(session.dispose);
+    session.connectionState = SchoolConnectionState.connected;
+    await session.openTimetable(term: SchoolTerm(72), chooseTerm: true);
+    expect(session.needsTermSelection, isTrue);
+    expect(platform.web.loads, isEmpty);
+    expect(session.selectedTerm, SchoolTerm(72));
+    expect(session.pendingDraft, isNull);
+    expect(session.termChoices.first.id, 73);
+    expect(session.termChoices.last.id, 1);
+    await session.selectTerm(SchoolTerm(71));
+    expect(
+      platform.web.loads.single,
+      'https://yjsjy.uestc.edu.cn/pyxx/pygl/xskbcx/index/71',
+    );
+  });
+
+  test('timetable selected DOM term must match request before an import can become pending', () async {
+    final platform = FakeSchoolPlatform();
+    WebViewPlatform.instance = platform;
+    final session = SchoolSession();
+    addTearDown(session.dispose);
+    session.connectionState = SchoolConnectionState.connected;
+    await session.openTimetable(term: SchoolTerm(72));
+    platform.web.javascript = (_) async =>
+        schoolPageEvidence(topUrl: platform.web.url!, html: fixture());
+    platform.delegate.started(platform.web.url!);
+    platform.delegate.finished(platform.web.url!);
+    await flushSchoolEvents();
+    expect(session.pendingDraft, isNull);
+    platform.web.javascript = (_) async => schoolPageEvidence(
+      topUrl: platform.web.url!,
+      html: fixture().replaceFirst('value="73"', 'value="72"'),
+    );
+    await session.readCurrentPage();
+    expect(session.pendingDraft?.schoolTerm, SchoolTerm(72));
+  });
+
+  test(
+    'exam selected DOM term must match requested query before saving',
+    () async {
+      final platform = FakeSchoolPlatform();
+      WebViewPlatform.instance = platform;
+      final session = SchoolSession();
+      addTearDown(session.dispose);
+      session.connectionState = SchoolConnectionState.connected;
+      await session.openExams(term: SchoolTerm(72));
+      platform.web.javascript = (_) async => schoolPageEvidence(
+        topUrl: platform.web.url!,
+        html: examHtml(),
+        kind: 'exams',
+      );
+      platform.delegate.started(platform.web.url!);
+      platform.delegate.finished(platform.web.url!);
+      await flushSchoolEvents();
+      expect(session.pendingExams, isNull);
+      platform.web.javascript = (_) async => schoolPageEvidence(
+        topUrl: platform.web.url!,
+        html: examHtml().replaceFirst('value="73"', 'value="72"'),
+        kind: 'exams',
+      );
+      await session.readCurrentPage();
+      expect(session.pendingExams?.termId, '72');
+    },
+  );
+
+  test(
+    're-authentication retains chosen term and unfinished picker intent',
+    () async {
+      final platform = FakeSchoolPlatform();
+      WebViewPlatform.instance = platform;
+      final session = SchoolSession();
+      addTearDown(session.dispose);
+      session.connectionState = SchoolConnectionState.connected;
+      await session.openExams(term: SchoolTerm(72), chooseTerm: true);
+      await session.openAuthentication();
+      expect(session.needsTermSelection, isFalse);
+      expect(session.selectedTerm, SchoolTerm(72));
+      const home = 'https://yjsjy.uestc.edu.cn/pyxx/home/index';
+      platform.web.url = home;
+      platform.web.javascript = (_) async =>
+          schoolPageEvidence(topUrl: home, authenticated: true);
+      platform.delegate.started(home);
+      platform.delegate.finished(home);
+      await flushSchoolEvents();
+      expect(session.needsTermSelection, isTrue);
+      await session.selectTerm(SchoolTerm(71));
+      await session.openAuthentication();
+      expect(session.selectedTerm, SchoolTerm(71));
+      expect(session.needsTermSelection, isFalse);
+      platform.web.url = home;
+      platform.delegate.started(home);
+      platform.delegate.finished(home);
+      await flushSchoolEvents();
+      expect(
+        platform.web.loads.last,
+        'https://yjsjy.uestc.edu.cn/pyxx/pygl/kskcxx/index?xq=71',
+      );
+    },
+  );
+
+  test('live dropdown choices are validated, deduplicated and sorted without private fields', () {
+    final uri = Uri.parse('https://yjsjy.uestc.edu.cn/pyxx/home/index');
+    final evidence = SchoolPageEvidence.decode(
+      jsonEncode({
+        'topUrl': uri.toString(),
+        'authenticated': true,
+        'pages': [],
+        'terms': [72, 73, 72, 0, -1, 10000, 'private-value'],
+      }),
+      uri,
+    );
+    expect(evidence.terms.map((term) => term.id), [73, 72]);
+  });
+}