Refactor observability and analytics documentation

- Updated the crash reporting section to clarify the integration of Bugly and sensors analytics.
- Revised the logging rules to ensure sensitive data is scrubbed before logging.
- Enhanced the session management guidelines to ensure user context is correctly set during login and logout processes.
- Consolidated the analytics event tracking strategy, emphasizing backend-driven event logging.
- Removed references to third-party SDKs for crash reporting and analytics, focusing on internal logging mechanisms.

flutter-app/08-build-flavors.md

@@ -16,11 +16,11 @@ App 侧维护 **3 个 flavor：`dev` / `uat` / `prod`**，环境划分与现有
 
 ## 使用规则
 
-- 每个 flavor 对应一个独立的 Dart 入口文件（`main_dev.dart`/`main_uat.dart`/`main_prod.dart`），三者都只是设置好环境标识后调用同一个共享的 `bootstrap()` 启动函数，不允许在入口文件里写业务逻辑分支。
-- 环境相关的可变配置（API base URL、是否开启日志等，见 [05-networking.md](./05-networking.md) 的 `appEnvProvider`）通过 `--dart-define-from-file=env/{flavor}.json` 注入，不写死在代码里、也不用 `if (flavor == 'dev')` 这种运行时字符串判断来分支配置。
+- 全项目只保留 `lib/main.dart` 一个 Dart 入口。Flutter 的 `appFlavor` 自动对应 `--flavor`，启动代码据此加载打包的 `env/{flavor}.json`；未传 flavor 时默认 dev，DevEco 不需要额外入口配置。
+- 环境配置只包含可公开随包发布的 API 地址、日志开关与 H5 host；不在 Dart 代码中写死，也不要求开发者为入口文件额外传 `-t` 或 `--dart-define-from-file`。
 - `env/*.json` 只包含非敏感配置（API 地址等）；密钥类配置（如第三方 SDK App Key）通过 CI 变量在构建时注入，不提交进仓库。
 - Android 侧用 Gradle `productFlavors` 区分 `applicationIdSuffix`/图标/`versionNameSuffix`；iOS 侧用对应的 xcconfig + Scheme 区分 `Bundle Identifier`/图标；两端 flavor 名称必须完全一致（`dev`/`uat`/`prod`），不允许两端用不同命名。
-- CI 流水线阶段固定为：`melos run analyze` → `melos run test` → 按 flavor `flutter build apk/ipa --flavor {flavor} --dart-define-from-file=env/{flavor}.json` → 上传对应分发渠道。`prod` flavor 的构建触发条件是打 tag，不是每次 push 都触发（避免误发生产包）。
+- CI 流水线阶段固定为：`melos run analyze` → `melos run test` → 按 flavor `flutter build apk/ipa --flavor {flavor}` → 上传对应分发渠道。`prod` flavor 的构建触发条件是打 tag，不是每次 push 都触发（避免误发生产包）。
 
 ## 用 `applicationIdSuffix` 而不是覆盖 `applicationId`
 
@@ -40,8 +40,7 @@ productFlavors {
 
 ```bash
 fvm flutter build appbundle \
-  --flavor prod --target lib/main_prod.dart \
-  --dart-define-from-file=env/prod.json \
+  --flavor prod \
   --split-debug-info=build/symbols/$CI_COMMIT_TAG
 ```
 
@@ -103,7 +102,7 @@ after_script:
 
 **当前阶段的两条纪律**，它们是"手工出包"唯一的真实风险来源：
 
-- **构建命令必须来自仓库里的脚本**，flavor、`--dart-define-from-file`、`--split-debug-info` 路径都在脚本里写死。手敲命令漏一个参数，出来的包看起来正常，实际连的是错的环境或者没有归档符号表。
+- **构建命令必须来自仓库里的脚本**，flavor 与 `--split-debug-info` 路径都在脚本里写死。手敲命令漏掉 flavor，可能构建出错误的原生包变体。
 - **符号表和 dSYM 要从 Mac 上带回来归档**（见上文 Release 构建）。这是手工出包最容易漏的一步——Linux 上有 CI artifact 自动兜着，Mac 上没有。
 
 证书和描述文件（Provisioning Profile）无论哪个阶段都用 [fastlane match](https://docs.fastlane.tools/actions/match/) 管理，存在一个私有 git 仓库里，**不靠人肉在钥匙串之间导来导去**。这一条在只有一台 Mac 的情况下更重要：机器坏了、人换了，签名能力不能跟着丢。
@@ -115,8 +114,7 @@ build_ios_uat:
   stage: build
   tags: [macos]        # 只有 mac runner 有这个 tag
   script:
-    - fvm flutter build ipa --flavor uat --target lib/main_uat.dart \
-        --dart-define-from-file=env/uat.json --export-options-plist=ios/ExportOptions-uat.plist
+    - fvm flutter build ipa --flavor uat --export-options-plist=ios/ExportOptions-uat.plist
 ```
 
 ## 内测分发：托管平台 + 后台发布管理
@@ -162,7 +160,6 @@ Android 的 flavor 源集目录（`src/{flavor}/`）会自动生效；iOS 没有
 ## 参考链接
 
 - [Flutter 官方 Flavors 文档](https://docs.flutter.dev/deployment/flavors)
-- [--dart-define-from-file 官方说明](https://docs.flutter.dev/deployment/flavors#configuration-approaches)
 - [Flutter: 混淆 Dart 代码](https://docs.flutter.dev/deployment/obfuscate)
 - [Android: 从命令行构建并签名](https://developer.android.com/build/building-cmdline)
 - [fastlane match（证书管理）](https://docs.fastlane.tools/actions/match/)
@@ -182,7 +179,7 @@ Android 的 flavor 源集目录（`src/{flavor}/`）会自动生效；iOS 没有
 1. **Android `productFlavors`**：在 `android/app/build.gradle` 里声明多套 `applicationId`/`versionNameSuffix`/资源目录，编译时用 `--flavor` 选择其中一套。
 2. **iOS Scheme + xcconfig**：iOS 没有 Gradle 那样的单文件配置，而是通过 Xcode 里多个 Build Configuration（对应不同的 `.xcconfig` 文件设置 Bundle ID 等）+ 多个 Scheme 组合实现同样的效果，`flutter build ipa --flavor xxx` 背后就是选中同名 Scheme。
 3. **Dart 入口文件（`main_xxx.dart`）**：flavor 决定的是"编译出什么样的原生外壳"，Dart 代码本身默认只有一个 `main.dart` 入口——项目约定用多个入口文件对应各 flavor，让每个 flavor 能设置不同的启动参数（比如传给 `bootstrap()` 一个环境枚举）。
-4. **`--dart-define-from-file`**：flavor 解决的是原生层面的差异（图标、包名），但 API 地址这类 Dart 侧读取的配置，用编译期注入的 JSON 文件解决，避免打包进一个写死 `http://dev-api...` 的字符串常量。
+4. **内置环境配置**：Dart 固定从 `main.dart` 启动，Flutter 将 `--flavor` 暴露为 `appFlavor`；启动代码按其加载随包发布的 JSON 配置。未提供 flavor 时使用 dev，适配 DevEco 的默认构建。
 
 ### 使用示例
 
@@ -240,8 +237,11 @@ Future<void> bootstrap(AppEnv env) async {
 ```
 
 ```dart
-// lib/main_dev.dart
-void main() => bootstrap(AppEnv.fromDartDefine(name: 'dev'));
+// lib/main.dart
+Future<void> main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  await bootstrap(await loadBundledAppEnv(flavor: appFlavor));
+}
 ```
 
 构建命令：
@@ -249,8 +249,6 @@ void main() => bootstrap(AppEnv.fromDartDefine(name: 'dev'));
 ```bash
 fvm flutter build apk \
   --flavor dev \
-  --target lib/main_dev.dart \
-  --dart-define-from-file=env/dev.json
 ```
 
 GitLab CI 片段（衔接现有 Runner；注意 Android 和 iOS 必须落到不同的 runner 上）：
@@ -268,7 +266,7 @@ build_android_dev:
   script:
     - melos run analyze
     - melos run test
-    - flutter build apk --flavor dev --target lib/main_dev.dart --dart-define-from-file=env/dev.json
+    - flutter build apk --flavor dev
   artifacts:
     paths: [build/app/outputs/flutter-apk/app-dev-release.apk]
   rules:
@@ -278,8 +276,7 @@ build_android_prod:
   <<: *flutter_base
   stage: build
   script:
-    - flutter build appbundle --flavor prod --target lib/main_prod.dart
-        --dart-define-from-file=env/prod.json
+    - flutter build appbundle --flavor prod
         --build-name=${CI_COMMIT_TAG#v} --build-number=$CI_PIPELINE_ID
         --split-debug-info=build/symbols/$CI_COMMIT_TAG
   artifacts:
@@ -294,8 +291,7 @@ build_ios_prod:
   stage: build
   tags: [macos]              # 必须是 mac runner，Linux runner 跑不了，见上文「iOS 构建：远程 Mac」
   script:
-    - fvm flutter build ipa --flavor prod --target lib/main_prod.dart
-        --dart-define-from-file=env/prod.json
+    - fvm flutter build ipa --flavor prod
         --build-name=${CI_COMMIT_TAG#v} --build-number=$CI_PIPELINE_ID
         --split-debug-info=build/symbols/$CI_COMMIT_TAG
   rules: