jizhi/docs/STATUS.md

记之 · 当前项目状态

更新时间：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. 用真实设备验证截图识别、推送、离线同步和更新检查。