feat(V0.2): OTA 版本与判新口径 + Tab 结构调整
1) 版本对齐分支 - package.json / tauri.conf.json / Cargo.toml / Cargo.lock: 0.1.0 -> 0.2.0, OTA 包版本变为 0.2.0-ota - 新增 scripts/ci/check-version.mjs: 分支 dev-x.y 与 package.json 版本不一致时 CI 直接失败 - docker-build.yml / ota-build.yml: min_binary_version 与前端版本解耦, 固定 0.1.0 (现有 APK 原生层仍是 0.1.0, 抬高会导致旧 APK 收不到更新) 2) 我的页 OTA「开发版本」开关 (默认关, 持久化 localStorage.iboard_ota_dev_mode) - 关: 按版本号逐字段比较 (src/utils/version.js), 服务端 version 更高才算新 - 开: 按 build sequence 判新 (hotswap checkUpdate), 每次构建都能推到设备 - Web 端: 开发口径退化为版本不同即算新; 生产口径严格比较大小 3) 打卡 Tab 移到最左并默认选中, 移除特效开关 - BottomNav: 打卡/宏观/监控/我; 删除 home 图标 - App: / 与 404 均重定向到 /checkin - RingProgress/Celebrate: 删除 effectsEnabled/setEffectsEnabled, 特效恒开 - HabitView: 去掉头部「特效开/关」按钮 4) 取消首页 Tab, 报警/新闻并入宏观 - 新增 pages/macro/AlertsView.jsx、NewsView.jsx; 删除 HomePage.jsx - MacroPage: 6 个子 Tab (油价/经济数据/策略研究/经济文章/报警/新闻), 报警角标保留 - 新闻详情 /news/:id -> /macro/news/:id (宏观 Tab 保持高亮) 5) 文档: 需求文档补 F-OT 需求点与已决策项; 设计文档新增 §10 变更记录与判新设计; 界面设计.html 11 屏 (Tab 4 项/去掉特效开关/宏观合并/我的 OTA 开关 关+开 两态)
This commit is contained in:
cheney
+22
-9
@@ -117,7 +117,7 @@
|
||||
|
||||
| 编号 | 需求描述 | 验收要点 | 优先级 |
|
||||
| --- | --- | --- | --- |
|
||||
| F-SY-01 | 底部 TabBar 新增**「打卡」页** 和 **「清单」页** | 图标风格与现有 TabIcon 一致 | P0 |
|
||||
| F-SY-01 | 底部 TabBar 新增**「打卡」页**，并作为**默认首页放在最左**；「清单」不单独占 Tab，作为打卡页内的第三个子视图 | 图标风格与现有 TabIcon 一致；启动即进入 `/checkin` | P0 |
|
||||
| F-SY-02 | 「打卡」页内集成 打卡/日历 两个功能，日历放在上半截，默认显示一行为周视图，下拉显示为月视图。 | 日历中选择时间与下部打卡任务联动 | P0 |
|
||||
| F-SY-03 | 所有接口复用现有鉴权（`authRequired`，JWT），数据按 `userId` 隔离 | 未登录跳转 `/login` | P0 |
|
||||
| F-SY-04 | 后端新增 REST 路由（建议 `/api/checkin/*`、`/api/checklist/*`），挂载到 `server/index.js` | 与现有路由风格一致 | P0 |
|
||||
@@ -132,11 +132,11 @@
|
||||
| --- | --- | --- | --- |
|
||||
| U-01 | **环形进度组件**：SVG 圆环，背景环 + 进度环，进度变化带 400ms ease-out 动画 | 组件可复用（打卡卡片、清单进度共用） | P0 |
|
||||
| U-02 | **完成特效**：达标瞬间环形闭合 + 光晕/粒子扩散，约 600ms；可重复观看不烦扰 | 不阻塞操作，动画结束自动清理 | P0 |
|
||||
| U-03 | **触感反馈**：完成打卡时轻量震动（Web Vibration API / Tauri），可在设置中关闭 | 默认开启，关闭后仅视觉反馈 | P1 |
|
||||
| U-03 | **触感反馈**：完成打卡时轻量震动（Web Vibration API / Tauri） | 固定开启，与特效一同触发 | P1 |
|
||||
| U-04 | 移动端适配：375~430px 视口，复用 `globals.css` 的 `.card` 体系，安全区与底部 TabBar 不遮挡内容 | 真机无横向滚动、无遮挡 | P0 |
|
||||
| U-05 | 空态 / 加载态 / 错误态三态齐全（首次使用引导"创建第一个打卡项"） | 空态有明确 CTA | P0 |
|
||||
| U-06 | 打卡按钮足够大（点击热区 ≥ 44×44），符合移动端触控规范 | 误触率低 | P1 |
|
||||
| U-07 | 动效**性能降级**：低端设备或 `prefers-reduced-motion` 时关闭粒子特效，仅保留进度动画 | 不卡顿 | P1 |
|
||||
| U-07 | 动效**性能降级**：特效保持轻量（单次 ≤900ms、`pointer-events:none`），不给低端机造成卡顿 | 不卡顿、不阻塞操作 | P1 |
|
||||
| U-08 | 深浅色：跟随现有浅色主题，卡片/分割线风格与首页、监控页一致 | 视觉统一 | P1 |
|
||||
| U-09 | 清单勾选有明确的勾选动画（勾形描边动画） | 反馈即时 | P2 |
|
||||
|
||||
@@ -174,12 +174,23 @@
|
||||
| E-07 | 清单项全部删除后清单进度为 0/0 | 显示空清单，不显示 100% | P1 |
|
||||
| E-08 | 跨零点打卡（23:59 → 00:00） | 以**提交时刻的本地日历日**归属 | P0 |
|
||||
|
||||
### 3.9 功能需求 — 版本与升级（F-OT，2026-10-22 追加）
|
||||
|
||||
| 编号 | 需求描述 | 验收要点 | 优先级 |
|
||||
| --- | --- | --- | --- |
|
||||
| F-OT-01 | **OTA 包版本必须与分支对应**：`dev-0.2` 分支上 OTA 包版本应为 `0.2.0-ota` | `GET /api/ota/check/0` 返回 `version = 0.2.0-ota` | P0 |
|
||||
| F-OT-02 | 版本号错位在 CI 阶段就拦住：分支名 `dev-x.y` 与 `package.json` 版本主次号不一致时构建失败 | CI 输出明确报错并中断 | P0 |
|
||||
| F-OT-03 | 「我」页 OTA 组内新增**「开发版本」开关**，默认**关闭** | 关闭=按版本号比较；打开=按 build sequence 比较 | P0 |
|
||||
| F-OT-04 | 开关值**持久化在设备端**，重启 App 后保持上次选择 | 杀进程重进仍为上次状态 | P0 |
|
||||
| F-OT-05 | 版本号比较规则：按非数字字符切成数字字段，逐段比较大小（`0.2.0 > 0.1.0`，`0.10 > 0.9`） | 单测覆盖后缀/前缀/缺位/多位段 | P0 |
|
||||
| F-OT-06 | 切换开关后清空上一次的检查结果，避免误判 | 切换即回到「未检查」状态 | P1 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 优先级汇总（本期交付范围）
|
||||
|
||||
- **P0（必须）**：F-CK-01~08、F-CK-11；F-CL-01~08；F-LS-01~04；F-SY-01~05；U-01、U-02、U-04、U-05；D-01~05；N-01、N-02、N-04、N-05；E-01、E-02、E-04、E-05、E-08。
|
||||
- **P1（应该）**：F-CK-09、10、12~14；F-CL-09；F-LS-05~09；F-SY-06~08；U-03、U-06~08；D-06；N-03；E-03、E-06、E-07。
|
||||
- **P0（必须）**：F-CK-01~08、F-CK-11；F-CL-01~08；F-LS-01~04；F-SY-01~05；F-OT-01~05；U-01、U-02、U-04、U-05；D-01~05；N-01、N-02、N-04、N-05；E-01、E-02、E-04、E-05、E-08。
|
||||
- **P1（应该）**：F-CK-09、10、12~14；F-CL-09；F-LS-05~09；F-SY-06~08；F-OT-06；U-03、U-06~08；D-06；N-03；E-03、E-06、E-07。
|
||||
- **P2（可选/延后）**：F-CK-15~17；F-CL-10、11；F-LS-10、11；U-09。
|
||||
|
||||
---
|
||||
@@ -200,12 +211,12 @@
|
||||
|
||||
| # | 问题 | 建议 |
|
||||
| --- | --- | --- |
|
||||
| 1 | 是否新增第 5 个底部 Tab「打卡」，还是放在首页入口？ | 建议新增 Tab，入口最清晰 |
|
||||
| 1 | 是否新增第 5 个底部 Tab「打卡」，还是放在首页入口？ | ✅ **已决策（2026-10-22）**：「打卡」作为**默认首页放在最左**；原来的「首页」取消，报警/新闻并入宏观 |
|
||||
| 2 | 周起始日是周一还是周日？ | 建议周一（国内习惯） |
|
||||
| 3 | 是否允许"明天提前打卡"？ | 建议**不允许**（F-CK-11），保持统计口径干净 |
|
||||
| 4 | 删除打卡项时历史是否保留？ | 建议默认归档保留，硬删除才清历史 |
|
||||
| 5 | 预置模板具体包含哪些项？ | 评审时列出"出差/回老家"各 8~12 条初始项 |
|
||||
| 6 | 完成特效是否可全局关闭？ | 建议在"我"页提供开关（默认开） |
|
||||
| 6 | 完成特效是否可全局关闭？ | ✅ **已决策（2026-10-22）**：不提供关闭入口，**特效永远打开**；页面内不再有特效开关 |
|
||||
|
||||
---
|
||||
|
||||
@@ -308,8 +319,10 @@ model CheckListTemplate {
|
||||
| B-6 | **撤销语义** | 撤销删除本周期内"最近一次"打卡（按 date desc、seq desc 取第一条） |
|
||||
| B-7 | **删除打卡项** | 默认归档（`archived=true`，历史保留）；`?hard=1` 才物理删除并清记录 |
|
||||
| B-8 | **接口前缀** | 打卡 `/api/checkin/*`、清单 `/api/checklists/*`，全部 `authRequired`，数据按 `userId` 隔离 |
|
||||
| B-9 | **前端入口** | 底部新增第 5 个 Tab「打卡」→ `/checkin`，页内三视图：打卡 / 日历 / 清单 |
|
||||
| B-10 | **特效开关** | 完成特效 + 触感反馈受 `localStorage iboard_celebrate` 控制（默认开），系统开启"减弱动效"时自动降级 |
|
||||
| B-9 | **前端入口** | 底部 Tab 4 个：**打卡（最左，默认选中）** / 宏观 / 监控 / 我；`/` 重定向到 `/checkin`，页内三视图：打卡 / 日历 / 清单。原「首页」取消，报警/新闻并入宏观 |
|
||||
| B-10 | **特效** | 完成特效 + 触感反馈**恒开**，页面内不提供开关（2026-10-22 变更，原 `localStorage iboard_celebrate` 机制已移除） |
|
||||
| B-11 | **OTA 版本** | OTA 包 `version = package.json.version + '-ota'`，必须与分支一致（`dev-0.2` → `0.2.0-ota`），CI 有强校验 |
|
||||
| B-12 | **OTA 判新** | 我的页「开发版本」开关（默认关，持久化 `localStorage.iboard_ota_dev_mode`）：关=版本号字段比较，开=build sequence 比较 |
|
||||
|
||||
### 接口清单
|
||||
|
||||
|
||||
Reference in New Issue
Block a user