first commit

.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、多端适配、官方文档出处感兴趣，回答时应附**官方文档链接**。