0 Fork 0

Files

T

maxf 28fcfc6aec ## 1️⃣ 文档与代码一致性 ✅（修复 4 处滞后）

**发现并已修复的文档滞后**（后期代码先于文档，审计时补齐）：

| 滞后点 | 修复 |
|---|---|
| `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 处文档滞后已修复，无功能性问题。可以进入部署/上线阶段。

2026-09-25 16:56:07 +08:00

1.2 KiB

Raw Permalink Blame History

📱 二期 · 微信小程序 — 详细设计

上游：docs/30.小程序概要设计.md（v1.0） 本文档定位：小程序详细设计引导页，索引下辖 3 个子文档版本：v1.0 · 2026-09-24

快速索引

需要	查看
小程序怎么做登录	33.小程序与后端接口对接.md 第二节
各页面完整生命周期	32.小程序功能大纲.md
复用哪些后端 API	33.小程序与后端接口对接.md 第三节
部署到线上	34.小程序附录.md 第四节
一期后端接口细节	`docs/22.API详细设计.md`（A1-A17）

1.2 KiB Raw Permalink Blame History Unescape Escape

📱 二期 · 微信小程序 — 详细设计

目录

快速索引

1.2 KiB

Raw Permalink Blame History