[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
+74
View File
@@ -0,0 +1,74 @@
# 星课表(starschedule)
面向高校师生的 Android 课程表。由拾光课程表精简而来:只保留课表核心能力,教务导入只适配正方,界面仅简体中文。
| 项 | 值 |
|---|---|
| 显示名 | 星课表 |
| 工程名 | `starschedule` |
| 安装包名 | `com.starschedule` |
| Kotlin 包名 | `com.xingheyuzhuan.shiguangschedule`(沿用原工程,未全量改名) |
| 当前版本 | `1.0.0`(versionCode `1`) |
| 最低系统 | Android 8.0(API 26) |
| 许可证 | Apache 2.0 |
完整文档在 [`docs/`](docs/README.md)。
## 能做什么
- 今日课表、周课表(多课表、自定义节次与学期)
- 课程增删改、按名称管理、调课、按周/日批量删除
- 正方教务导入(内置 `zhengfang.js`,不连外部适配仓库)
- JSON 导入导出、ICS 导出、本地 ZIP 与 WebDAV 备份
- 上课提醒、上课勿扰/静音、节假日跳过
- 课表样式与应用主题
- 四种桌面小组件
## 工程结构
```
starschedule/
├── app/ # Android 入口、闹钟、WorkManager、小组件
├── shared/ # Compose UI、业务、Room、正方脚本
├── gradle/ # 版本目录与 Wrapper
└── docs/ # 需求、使用、架构、开发说明
```
Gradle 模块:`:app`、`:shared`。
## 构建
需要 JDK 21。在 `starschedule/` 目录:
```bat
gradlew.bat :app:assembleDebug
```
```bash
./gradlew :app:assembleDebug
```
产物:`app/build/outputs/apk/debug/`,按 ABI 分包(`armeabi-v7a`、`arm64-v8a`、`x86_64`)。
依赖解析优先腾讯云 Maven,找不到时回落 Google Maven / Maven Central。详见 [构建与发布](docs/构建与发布.md)。
## 文档索引
| 文档 | 用途 |
|---|---|
| [需求文档](docs/需求文档.md) | 范围、功能与非功能需求、验收 |
| [用户使用说明](docs/用户使用说明.md) | 操作步骤 |
| [架构设计](docs/架构设计.md) | 模块、分层、关键数据流 |
| [开发文档](docs/开发文档.md) | 环境、约定、扩展入口 |
| [页面与导航](docs/页面与导航.md) | Destination 与界面对照 |
| [数据模型](docs/数据模型.md) | Room / DataStore / JSON / 备份 |
| [正方教务导入](docs/正方教务导入.md) | WebView、JS Bridge、脚本 |
| [构建与发布](docs/构建与发布.md) | Gradle、镜像、打包 |
| [隐私与数据](docs/隐私与数据.md) | 权限与本地数据 |
| [常见问题](docs/常见问题.md) | 导入、提醒、小组件排障 |
| [术语表](docs/术语表.md) | 领域名词 |
| [变更记录](docs/变更记录.md) | 版本说明 |
## 与拾光课程表的关系
本仓库是独立工程,工作区里的 `shiguangschedule`、`shiguang_warehouse` 仅作参考,运行时不依赖它们。正方脚本已内嵌在 `shared/src/commonMain/composeResources/files/zhengfang.js`。