# 记之 · 当前项目状态

> 更新时间：2026-08-21

## 总览

项目已经从 UI/接口骨架进入「客户端、后台和服务端能力联调」阶段。当前主干包含 Flutter 客户端、.NET 9 API、Vue 3 管理后台、数据库迁移和自动化测试；`main` 与 `origin/main` 当前指向同一提交 `8828851`。

## 已完成模块

### 后端 API

- 用户注册、登录、JWT、用户资料、引导和双模式切换。
- 账本、系统/自定义分类、手动记账、月账单、统计、搜索和软删除回收站。
- AI 聊天、意图识别、AI 直接入账、来源追溯、预算、月报、表情包和 AI 伙伴设置。
- 文本解析入口、截图识别相关接口、识别幂等和 AI 权限/额度控制。
- 管理后台 API：品牌配置、系统分类、AI 形象/性格、表情包、用户、推送、管理员账号、审计和密码变更。
- 账户注销清理、数据导出/恢复、同步冲突和访客数据合并相关服务。
- EF Core/MySQL 迁移已存在，覆盖初始模型、账户注销、分类颜色、AI 权限、额度、推送基础设施和转账/后台安全等变更。

### Flutter 客户端

- 启动、登录/注册、引导选模式和 AI 伙伴。
- 普通模式首页、账本切换、手动记账、账单详情/编辑、聊天和全 AI 模式。
- 统计、AI 月报、预算、搜索、分类管理、伙伴设置、回收站、数据管理和推送设置。
- 语音/OCR 确认页、截图识别设置/批量导入、识别诊断、离线提示、同步冲突和本地数据导出。
- 客户端更新检查、推送注册和本地数据库/会话恢复。

当前 `frontend/pubspec.yaml` 版本为 `1.2.5+135`；发布时仍需使用正式构建参数和发布说明。

### Admin Web

已具备登录、强制改密、仪表盘、系统设置、品牌配置、系统分类、AI 性格、AI 形象、表情包、用户、推送、管理员账号和审计页面。管理员角色权限由路由和后端共同控制。

### 测试

- 后端：API 集成测试、推送集成测试、推送供应商测试。
- Flutter：模型、主题/时间、本地导出、本地转移数据库、更新流程、视觉契约和 Widget 测试。

## 当前待办

### P0：联调与发布阻塞项

- 在真实环境验证 LLM、OCR/ASR、截图识别和推送供应商配置。
- 验证最新 EF Migration 在全新库、升级库和回滚/重试场景下的行为。
- 将数据库连接串、JWT Secret、管理员引导变量、API Base URL 和更新下载地址全部改为部署环境注入。
- 完成 Android 内部构建的截图权限、后台识别、证书和网络安全回归。

### P1：质量与体验

- 对核心流程做端到端回归：注册 → 引导 → 记账 → AI 解析 → 撤销 → 月报/预算。
- 完善错误提示、离线待同步、同步冲突和外部服务失败时的降级行为。
- 检查 Admin Web 发布资源生成策略，避免把本地 hashed 静态文件和构建目录带入工作区。

### P2：后续演进

- 完成正式 SVG/插画资源和更多运营内容配置。
- 补充后台数据看板、脱敏意图失败样本和内容版本回滚。
- 完成各平台正式签名、应用商店元数据和更新渠道配置。

## 工作区清理记录

2026-08-21 已清理未跟踪的完整备份、历史部署、`.codex-tools` 缓存、Codex 临时构建/补丁目录，以及后端 `wwwroot/assets` 的未跟踪生成资源。源码、`docs/`、设计原型、APK、Android 新代码和测试文件未删除。

## 建议验证顺序

1. 启动 MySQL，执行 `dotnet ef database update`。
2. 配置后端外部服务和管理员引导变量，运行 API 集成测试。
3. 构建 Admin Web，验证登录、权限、配置和发布资源。
4. 运行 Flutter 测试，再构建 `1.2.5+135` 内部包。
5. 用真实设备验证截图识别、推送、离线同步和更新检查。