feat: make core pages local-first offline

docs/DEVELOPER.md

@@ -8,11 +8,11 @@
 
 ### 后端版本号
 - 文件：`backend/MiaoJiZhang.Api/Program.cs`
-- 变量：`apiVersion = "20260718-1600"`（修改此行即可）
+- 配置：`Build:Version`（未注入时默认为 `dev`）
 - 显示位置：
   - `GET /api/ping` 返回 JSON `{ "version": "...", "built": "..." }`
   - `GET /api/version` 同上
-- 更新方法：修改 `apiVersion` 字符串，重启后端
+- 更新方法：通过环境变量或部署配置注入 `Build__Version`，重启后端
 
 ### Flutter App 版本号
 - 文件：`frontend/lib/shared/version.dart`
@@ -22,9 +22,9 @@
   - 登录页底部
   - 「我的」页底部
 - 构建命令：
-  ```bash
+  ```powershell
   flutter clean
-  flutter build apk --release --dart-define=APP_VERSION=20260718-1600
+  flutter build apk --release --dart-define=APP_VERSION=20260821-135
   ```
   ⚠️ **必须加 `--dart-define`，否则 App 显示 `vdev`**
 
@@ -33,8 +33,7 @@
 - 更新方法：重新构建并完整替换后端静态资源目录。
   ```bash
   cd admin-web && npm run build
-  find ../backend/MiaoJiZhang.Api/wwwroot -mindepth 1 -delete
-  cp -a dist/. ../backend/MiaoJiZhang.Api/wwwroot/
+  Copy-Item -Recurse -Force dist\* ..\backend\MiaoJiZhang.Api\wwwroot\
   ```
 
 ---
@@ -58,11 +57,10 @@ dotnet run --project MiaoJiZhang.Api
 临时设置 `Admin__CookieSecure=false`。
 
 ### 2. Admin Web
-```bash
+```powershell
 cd admin-web
 npm run build
-find ../backend/MiaoJiZhang.Api/wwwroot -mindepth 1 -delete
-cp -a dist/. ../backend/MiaoJiZhang.Api/wwwroot/
+Copy-Item -Recurse -Force dist\* ..\backend\MiaoJiZhang.Api\wwwroot\
 ```
 浏览器打开 `http://localhost:5000/` 或 `http://{电脑IP}:5000/`。如界面未更新请 **Ctrl+Shift+R** 强制刷新。
 
@@ -71,7 +69,7 @@ cp -a dist/. ../backend/MiaoJiZhang.Api/wwwroot/
 cd frontend
 flutter clean
 flutter pub get
-flutter build apk --release --dart-define=APP_VERSION=20260718-1600
+flutter build apk --release --dart-define=APP_VERSION=20260821-135
 adb install -r build/app/outputs/flutter-apk/app-release.apk
 ```
 
@@ -111,10 +109,10 @@ jizhang/
 │       └── features/                     # 业务页面
 ├── admin-web/                            # Vue3 + Ant Design 后台
 │   └── src/
-│       ├── App.vue                       # ★ 侧边栏版本号
+│       ├── App.vue                       # Admin 壳与导航
 │       └── views/                        # 管理页面
-├── docs/                                  # 项目说明、设计规范、开发说明
-└── design/                                # UI 稿、UX 原型、配色探索
+├── design/                                # UI 稿、UX 原型、配色探索
+└── docs/                                  # 项目状态、设计、开发与客户端对接文档
 ```
 
 ---
@@ -136,5 +134,6 @@ jizhang/
 | 修改了代码但 App 不变 | 没有 clean 构建，或没加 dart-define | `flutter clean && flutter build apk --release --dart-define=APP_VERSION=...` |
 | 修改了代码但后台不变 | 后端还在跑旧进程 | 先 `Stop-Process -Name dotnet -Force` 再 `dotnet run` |
 | Admin Web 界面不变 | 浏览器缓存 | Ctrl+Shift+R 强制刷新，或用无痕模式打开 |
+| 数据库结构不一致 | 未执行最新 EF Migration | `dotnet ef database update` 后再启动服务 |
 | Windows 文件路径错误 | 中文路径编码 | 用 python3 读文件时加 `encoding='utf-8'` |
 | sed 破坏代码 | git-bash 的 sed 不兼容 | 禁止用 sed 改 dart/vue 源码，用 Write/Edit 工具 |