SchoNavi 是一个 Flutter 应用。应用入口位于 lib/main.dart，应用壳位于 lib/app.dart。
lib/core：应用配置、路由、主题、依赖注入、API 鉴权、本地状态和外链能力。lib/domain：业务实体与 repository 接口。lib/data：真实后端 HTTP repository、本地备赛状态和 DTO。lib/features：首页、推荐、教授详情、聊天、邮件、对比、收藏和历史页面。lib/shared：跨页面复用组件。test：对应模块的测试。
项目采用 Flutter UI + Riverpod 状态管理/依赖注入 + GoRouter 路由。业务层通过 domain 中的 repository 接口隔离，所有业务数据和 AI 能力统一通过 API_BASE_URL 指向真实后端；本地仅保存匿名凭证、主题设置、备赛计划和提醒状态。
正式包名为 top.schonavi.app。Release APK 必须使用本地 release keystore 签名；
android/key.properties 和 android/app/*.jks 已被 .gitignore 忽略，不要提交。
首次正式打包前，先生成 keystore：
keytool -genkeypair -v `
-keystore android/app/schonavi-release.jks `
-alias schonavi `
-keyalg RSA `
-keysize 2048 `
-validity 10000然后复制签名配置模板，并在本机填写密码：
Copy-Item android/key.properties.example android/key.properties先复制构建配置示例到本地配置文件：
Copy-Item config/android_apk_build.example.json config/android_apk_build.local.json然后编辑 config/android_apk_build.local.json，填写后端地址并选择 APK 类型：
{
"backend": {
"scheme": "http",
"host": "YOUR_HOST",
"port": 8000
},
"apk": {
"target": "armv8"
}
}target 只支持两个值：
universal：生成通用 APK，产物为build/app/outputs/flutter-apk/app-release.apk。armv8：生成 arm64-v8a APK，产物为build/app/outputs/flutter-apk/app-arm64-v8a-release.apk。
运行构建：
dart run scripts/build_android_apk.dart检查将执行的 Flutter 命令但不真正构建：
dart run scripts/build_android_apk.dart --dry-run使用其他配置文件：
dart run scripts/build_android_apk.dart --config config/android_apk_build.example.json --dry-run脚本会把配置拼成 API_BASE_URL=<scheme>://<host>:<port> 并传给 Flutter。API_BASE_URL 是后端 origin，不要包含 /api/v1；客户端会自行拼接 /api/v1/... 路径。
Android 模拟器访问本机后端时，host 使用 10.0.2.2。当前 Android 明文 HTTP 只放行 10.0.2.2 和 localhost；真机访问普通 http://局域网IP:端口 需要 HTTPS，或另行调整 Android 网络安全配置。
可在 .vscode/launch.json 中使用 HTTP 后端配置。未配置 API_BASE_URL 时 App 仍可启动，但业务请求会显示后端配置错误，不会回退到本地目录或直连 LLM。
{
"version": "0.2.0",
"configurations": [
{
"name": "SchoNavi Flutter (backend)",
"request": "launch",
"type": "dart",
"program": "lib/main.dart",
"toolArgs": [
"--dart-define=API_BASE_URL=https://api.example.com"
]
}
]
}通过 --dart-define=API_BASE_URL=https://api.example.com 配置真实后端。
API_BASE_URL 填后端 origin，不要包含 /api/v1；客户端会自行拼接
/api/v1/... 路径。