first commit

.codebuddy/.gitignore

@@ -0,0 +1 @@
+db/

.codebuddy/memory/2026-09-21.md

@@ -0,0 +1,25 @@
+# 2026-09-21
+
+## 代码讲解（Flutter 入门答疑，未改动业务代码）
+围绕项目已有文件做概念讲解，帮助用户理解 Flutter/Riverpod 基础：
+
+- `lib/app.dart`：讲解根组件职责 = 全局 `navigatorKey` + M3 主题 + 登录态路由分发（`auth.isLoggedIn ? MainShell : LoginPage`）。
+- `GlobalKey`：讲解其"全局可寻址"特性；本项目 `navigatorKey` 属于第①类用法（获取 `NavigatorState` 以在无 `BuildContext` 的网络层执行跳转）。
+- `ConsumerWidget`：讲解它是「带 `ref` 的 StatelessWidget」；对照本项目的三种用法分布——`ConsumerWidget`（`app.dart`、`ocr_tab.dart`、`ocr_result_card.dart`）、`ConsumerStatefulWidget`（`main_shell.dart`、`login_page.dart`、`manual_entry_tab.dart`）、`Consumer` 局部订阅（`manual_entry_tab.dart` 的 `categoriesProvider`）。
+- `main_shell.dart` 全文件：`ConsumerStatefulWidget` 选型理由、`_index` 本地状态、`initState` 兜底跳转（`addPostFrameCallback` + `pushAndRemoveUntil` 的用意）、`IndexedStack` 保留 Tab 状态、M3 `NavigationBar` 参数（`indicatorColor: 0x33C8956E` 的 `33` 是透明度）。
+- `main_shell.dart` 中 `ref` 的来源：`ConsumerState` 的继承成员（非普通变量），`initState` 内只能用 `ref.read` 不能 `watch`。
+- `login_page.dart` 的 `Stack`（L132-152）：层叠布局——先画 4 个 `Positioned` 装饰圆球，再画 `SafeArea → Center → SingleChildScrollView → Column` 内容层；`..._buildBackgroundBalls()` 是 Dart 展开运算符。
+
+## 环境确认
+- 执行 `flutter --version` 确认：**Flutter 3.47.4 stable / Dart 3.13.3**。这正好是 Material & Cupertino 从 SDK 解耦（拆为 `material_ui` / `cupertino_ui` 独立包）的版本，现有 `package:flutter/material.dart` 导入仍兼容。
+
+## 学习资料指引（已提供给用户）
+- 设计规范：`m3.material.io`（尤其 `/components`）、`/develop/flutter`、Theme Builder。
+- Flutter 文档：`docs.flutter.dev/ui/design/material`、Widget Catalog、`api.flutter.dev` 的 `material-library` / `ThemeData` / `ColorScheme`。
+- 中文：`docs.flutter.cn`。示例：`flutter.github.io/samples`。在线试验：`dartpad.dev`。
+- 多端与自适应：`docs.flutter.cn/ui/adaptive-responsive/`、`.adaptive` 构造（`Switch.adaptive` 等）、窗口尺寸类别（Compact <600 / Medium 600-839 / Expanded ≥840）、`flutter_adaptive_scaffold`。
+
+## 结论性判断
+- 项目已是 Material 3，无需开启 `useMaterial3`。
+- 项目"多端"现状：仅 Android/iOS/Web，纯 M3、未做平台自适应与响应式布局。
+- 向用户提出了三个可选后续任务：① `MainShell` 响应式改造（小屏 `NavigationBar` / 宽屏 `NavigationRail`）② 关键组件加 `.adaptive` ③ 补桌面端平台目录。用户尚未选择。

.codebuddy/memory/MEMORY.md

@@ -0,0 +1,37 @@
+# 项目长期记忆：强宝爱记账
+
+## 项目概况
+- 名称：`qiangbao_accounting`（强宝爱记账），一个 Flutter 记账类 App。
+- 定位：由 uniApp 项目 `pages/login/login.vue` 复刻迁移而来（见 `login_page.dart` 顶部注释）。
+- 环境：Flutter **3.47.4** stable / Dart **3.13.3**（Windows 开发）。
+- 目标平台：仅 `android/`、`ios/`、`web/`，未配置桌面端。
+
+## 技术栈与约定
+- 状态管理：**flutter_riverpod ^3.0.0**（`Notifier` / `NotifierProvider`，非旧版 StateNotifier）。
+- 网络：**dio ^5.8.0**，API 层按模块拆分在 `lib/api/`，每个模块导出 `xxxApiProvider = Provider<XxxApi>(...)`。
+- 本地存储：`shared_preferences`，统一封装在 `lib/core/storage/local_storage.dart`。
+- 其他依赖：`image_picker`（OCR 选图）、`intl`、`cupertino_icons`。
+- UI：Material 3（Flutter 3.16+ 默认启用），未显式设置 `useMaterial3`。
+
+## 架构与关键文件
+- `lib/app.dart`：根组件 `QiangbaoApp extends ConsumerWidget`。定义全局 `navigatorKey`（供网络层 401 跳转登录页），配置主题，用 `auth.isLoggedIn` 在 `MainShell` / `LoginPage` 之间分发。
+- `lib/pages/shell/main_shell.dart`：主框架，4 个 Tab（首页/记账/统计/我的），用 `IndexedStack` 保留各页状态，`NavigationBar`（M3）承载导航，默认 `_index = 1`（记账）。`initState` 里有登录态兜底跳转。
+- `lib/pages/login/login_page.dart`：登录/注册页，含毛玻璃卡片（`BackdropFilter`）、动画背景圆球（`AnimationController` + `Stack` + `Positioned` + `Transform.translate`）、记住密码（`utils/crypto.dart` 加解密）。
+- 目前只有「记账」页（`AddPage`，含 `manual_entry_tab.dart`、`ocr_tab.dart`、`ocr_result_card.dart`）是真实实现，首页/统计/我的仍是 `_PlaceholderPage`。
+
+## 设计规范（配色）
+- 品牌主色：`#C8956E`（驼色/焦糖色），在 `app.dart` 中作为 `ColorScheme.fromSeed` 的 seedColor。
+- 深棕文字色：`#5D4037`；辅助文字：`#8D6E63`；页面底色：`#F8F8F8`。
+- 登录页另用暖橙渐变 `#FFE5CC → #FFD4A8 → #FFC08A`，点缀金色 `#FFD700`、粉色 `#FFB6C1`。
+- 注意：项目中颜色多为**硬编码字面量**，尚未统一走 `Theme.of(context).colorScheme`（有优化空间）。
+
+## 待办 / 可优化点
+- 硬编码颜色可迁移为 M3 角色色（`colorScheme.primary` 等），并补暗色模式。
+- `MainShell` 未做响应式：宽屏（≥600dp/840dp）应切换 `NavigationRail` / `NavigationDrawer`。
+- `MainShell.initState` 的 `addPostFrameCallback` 回调里可加 `if (!mounted) return;`。
+- Flutter 3.47 起 Material/Cupertino 已解耦为 `material_ui` / `cupertino_ui` 包，`package:flutter/material.dart` 仍可用，暂无需迁移。
+
+## 用户画像与偏好
+- 用户正在**系统学习 Flutter 基础概念**，常就单个文件/代码片段提问（如 `GlobalKey`、`ConsumerWidget`、`ref`、`Stack`）。
+- 沟通偏好：希望用**中文**解释，讲清「是什么 + 为什么这么写 + 在本项目中的上下文」，并配合结构化的表格/分层说明。
+- 用户对 Material 3、多端适配、官方文档出处感兴趣，回答时应附**官方文档链接**。