[new] new project

This commit is contained in:
2026-09-20 13:33:09 +08:00
commit ca6a52fb2d
997 changed files with 140250 additions and 0 deletions
+68
View File
@@ -0,0 +1,68 @@
# 页面与导航
导航使用 Navigation3 的 `NavBackStack`。目的地定义在 `Navigation.kt` 的 `Destination`,分发在 `App.kt` 的 `ScreenContent`。所有 Destination 必须在 `navSerializersModule` 注册,否则进程被杀后无法还原返回栈。
三个 `MainDestination`(今日课表、周课表、我的)切换时会 `backStack.clear()` 再压入,底部栏无横向滑动动画。其余页面压栈,横向滑入/滑出。
## 1. 目的地一览
| Destination | 类型 | 界面 | 用户入口 |
|---|---|---|---|
| `TodaySchedule` | 主 Tab | `TodayScheduleScreen` | 底部「今日课表」;启动页可设为它 |
| `CourseSchedule` | 主 Tab | `WeeklyScheduleScreen` | 底部「课表」;默认启动页 |
| `Settings` | 主 Tab | `SettingsScreen` | 底部「我的」 |
| `TimeSlotSettings` | 子页 | `TimeSlotManagementScreen` | 我的 → 自定义时间段 |
| `ManageCourseTables` | 子页 | `ManageCourseTablesScreen` | 我的 → 管理课表 |
| `CourseTableConversion` | 子页 | `CourseTableConversionScreen` | 我的 → 课表导入/导出 |
| `NotificationSettings` | 子页 | `NotificationSettingsScreen` | 我的 → 课程提醒设置 |
| `MoreOptions` | 子页 | `MoreOptionsScreen` | 我的 → 更多 |
| `QuickActions` | 子页 | `QuickActionsScreen` | 我的 → 快捷操作 |
| `TweakSchedule` | 子页 | `TweakScheduleScreen` | 快捷操作 → 调课 |
| `QuickDelete` | 子页 | `QuickDeleteScreen` | 快捷操作 → 快速删除课程 |
| `CourseManagementList` | 子页 | `CourseNameListScreen` | 我的 → 课程管理 |
| `CourseManagementDetail(courseName)` | 子页 | `CourseInstanceListScreen` | 课程管理 → 点某一门 |
| `StyleSettings` | 子页 | `StyleSettingsScreen` | 我的 → 个性化配置 |
| `ThemeSettings` | 子页 | `ThemeSettingsScreen` | 更多 → 主题设置 |
| `BackupAndRestore` | 子页 | `BackupScreen` | 课表导入/导出 → 备份与恢复 |
| `WebView(initialUrl)` | 子页 | `WebViewScreen` | 课表导入/导出 → 正方教务导入;默认 `about:blank` |
| `AddEditCourse(courseId)` | 子页 | `AddEditCourseScreen` | 周课表点空白格/课程;课程管理添加。`courseId == null` 为新建 |
## 2. 「我的」页结构
**常规设置**
- 显示非本周课程(开关,写入全局 DataStore)
- 是否显示周末(写入当前课表 `CourseTableConfig`)
- 设置开学日期
- 本学期总周数(默认 20)
- 当前周数(手动改会反推开学日期;可选「假期中」)
- 每周起始日(周一或周日)
- 快捷操作
**高级功能**
- 课表导入/导出
- 课程提醒设置
- 管理课表
- 课程管理
- 自定义时间段
- 个性化配置
- 更多(关于、启动页面、主题)
## 3. 导入导出页结构
- 正方教务导入 → `Destination.WebView()`
- 课程文件导入(JSON,覆盖指定课表)
- 课程文件导出(`starschedule_<时间戳>.json`)
- 日历文件导出(`starschedule_<时间戳>.ics`,可选 1–60 分钟提醒)
- 备份与恢复 → `BackupAndRestore`
## 4. 新增页面步骤
1. 在 `Destination` 增加 `@Serializable` 类型(带参数用 `data class`)。
2. 在 `navSerializersModule` 的 `polymorphic` 里 `subclass(...)`。
3. 在 `App.kt` 的 `ScreenContent` 增加 `when` 分支。
4. 从已有 Screen 用 `onNavigate(Destination.Xxx)` 跳转。
5. 用户可见标题、说明写进 `composeResources/values/strings.xml`。
主 Tab 必须实现 `MainDestination`,并在 `AdaptiveNavigationScaffold` 的 Tab 列表里出现,否则底部栏对不上。