maxf
28fcfc6aec
**发现并已修复的文档滞后**（后期代码先于文档，审计时补齐）： | 滞后点 | 修复 | |---|---| | `24.附录` users 表缺 `wechat_openid` 列（二期微信登录加的） | ✅ 已补 | | `24.附录` 缺 `refuel_records` 表（三期记账） | ✅ 已补 | | `24.附录` 错误码缺 `1012/1013`（三期） | ✅ 已补 | | `34.附录` 小程序页面目录缺 `calc/refuels`（三期） | ✅ 已补 | **核对一致项**： - API 路由 **A1-A23 + `/api/auth/wechat`** 全部注册，与 22/33/43 文档逐项对应 - `schema.sql` 11 表 = 24 附录（10 + refuel）+ 45 附录 - 小程序 8 页文件齐全（js/wxml/wxss/json × 8），`refuels.wxml` 数据绑定与 js 匹配 - H5 8 页面全部可访问 ## 2️⃣ 后期变更对前期的影响 ✅ 无破坏 综合回归 **20 项全 PASS**： - **一期**：账号密码登录 / Cookie 会话 / dashboard / provinces(31省) / history ✅ - **二期**：Bearer token 认证（与 Cookie **双通道共存**，互不冲突）✅ - **三期**：refuel 首条保存 / 区间油耗 8.25 / 统计 / 预填 ✅ - **前端**：9 个资源（8 页 + 静态 JS）全部 200 ✅ 关键：二期的 `users` 加列是**幂等增量迁移**（ALTER），未动一期任何表结构；一期 API 与前端全部正常。 ## 3️⃣ 整体可行性 ✅ 在可控范围 | 维度 | 状态 | |---|---| | 构建/静态检查 | `go build / vet` 全绿 | | 单元测试 | 6 包 17 单测全过（auth/crawler/cron/db/push/service） | | 规模 | 11 表 · 23+ 接口 · 8 H5 页面 · 8 小程序页面 · 17 份文档 · ~90 代码文件 | | 三阶段功能 | 监控预测提醒 → 微信小程序 → 加油记账/真实油耗，全部落地 | **非阻塞小项**（可后续优化，不影响运行）： 1. `refuels.wxml` 第 11 行 `wx:for` 与 `wx:if` 同节点——功能正常，写法可规范 2. api 包 handler 层无独立单测——由端到端回归覆盖（service 层已有单测） --- **结论：项目整体健康、文档与代码对齐、三阶段功能完整可用。** 4 处文档滞后已修复，无功能性问题。可以进入部署/上线阶段。
1.3 KiB
1.3 KiB
⛽ 三期 · 记账功能 — 详细设计
上游：
docs/40.记账概要设计.md（v1.0） 本文档定位：记账功能详细设计引导页，索引下辖 4 个子文档 版本：v1.0 · 2026-09-24
目录
- 40.记账概要设计.md — 业务目标 / 补记模式 / 公式 / API 概览
- 42.记账功能大纲.md — 功能生命周期（201-206）
- 43.记账API详细设计.md — A18-A23 接口契约
- 44.记账前端详细设计.md — H5 / 小程序 / 折线图
- 45.记账附录.md — 表 DDL / 公式 / 漏记规则 / 错误码
快速索引
| 需要 | 查看 |
|---|---|
| 补记模式解决漏记 | 40.记账概要设计.md 第二节 |
| 油耗公式与级联重算 | 45.记账附录.md 第二、三节 |
| 新增加油记录（回显+计算） | 43.记账API详细设计.md A19、A22 |
| 记录列表 / 修正 / 删除 | 43.记账API详细设计.md A18、A20、A21 |
| 折线图数据 | 43.记账API详细设计.md A23 |
| 前端页面与交互 | 44.记账前端详细设计.md |