# 开发计划与任务拆分

## 1. 开发阶段概览

```
Phase 1: 基础框架搭建 (2天)
    ↓
Phase 2: 首页核心功能 (3天) ★ 优先保证首页体验
    ↓
Phase 3: 记录与历史 (2天)
    ↓
Phase 4: 统计与图表 (2天)
    ↓
Phase 5: AI助手与个人中心 (3天)
    ↓
Phase 6: 优化与测试 (2天)
```

---

## 2. Phase 1: 基础框架搭建 (2天)

### 2.1 项目初始化
- [ ] 创建 uni-app 项目 (Vue3 + JavaScript)
- [ ] 配置路径别名 (@/)
- [ ] 创建目录结构

### 2.2 基础配置
- [ ] 配置 pages.json (页面路由 + TabBar)
- [ ] 配置全局样式 (暗色主题变量)
- [ ] 配置环境变量 (开发/生产 API 地址)

### 2.3 核心模块
- [ ] 封装 request.js (请求拦截、Token管理、错误处理)
- [ ] 封装 storage.js (本地存储工具)
- [ ] 配置 Pinia stores 结构
- [ ] 实现登录流程 (wx.login + 后端认证)

### 2.4 公共组件
- [ ] 创建 Loading 组件
- [ ] 创建 Skeleton 骨架屏组件
- [ ] 创建 Button 组件 (主按钮/次按钮样式)
- [ ] 创建 Card 组件 (卡片容器)

**交付物**：可运行的空白项目，登录功能正常

---

## 3. Phase 2: 首页核心功能 (3天) ★

> ⚠️ 首页是用户最常访问的页面，必须保证 < 500ms 首屏渲染

### 3.1 Day 1: 页面结构 + 数据层

#### API 封装
- [ ] `api/smoke.js`: getDashboard()
- [ ] `api/smoke.js`: getNextSmokeTime()
- [ ] `api/profile.js`: getProfile()

#### Store 设计
- [ ] `stores/dashboard.js`: 看板数据 + 缓存逻辑
- [ ] `stores/user.js`: 用户信息 + 登录状态

#### 页面结构
- [ ] 首页骨架屏
- [ ] 页面布局 (header + timer + cards + buttons)

### 3.2 Day 2: 核心组件

#### 计时器组件 (TimerRing)
- [ ] Canvas 绘制进度环
- [ ] 时间格式化 (HH:MM:SS)
- [ ] requestAnimationFrame 优化
- [ ] 页面可见性处理 (切后台暂停)

#### 统计卡片
- [ ] 今日已抽卡片 (X/目标, 较昨日±N)
- [ ] 烟瘾发作已抵抗卡片

#### 快捷按钮
- [ ] 记录抽烟按钮 → 弹出记录表单
- [ ] 想抽忍住了按钮 → 快速提交

### 3.3 Day 3: 交互 + 优化

#### AI 提示卡片
- [ ] 延迟加载 (300ms后)
- [ ] 可关闭 (本地存储关闭状态)
- [ ] 下次建议时间显示

#### 性能优化
- [ ] 并行请求优化
- [ ] 骨架屏过渡动画
- [ ] 首屏性能埋点

#### 新用户引导
- [ ] 检测 profile.exists
- [ ] 跳转引导页逻辑

**交付物**：完整可用的首页，首屏 < 500ms

---

## 4. Phase 3: 记录与历史 (2天)

### 4.1 Day 1: 记录表单

#### 记录弹窗组件
- [ ] 时间选择 (默认当前时间)
- [ ] 原因标签选择 (压力大/无聊/社交/习惯等)
- [ ] 备注输入
- [ ] 支数选择 (默认1)

#### API 集成
- [ ] `POST /logs` 新增记录
- [ ] `POST /logs/resisted` 忍住记录
- [ ] 提交后刷新首页数据

### 4.2 Day 2: 历史记录页

#### 列表页面
- [ ] 筛选 Tabs (全部/已抽烟/已忍住)
- [ ] 时间线布局
- [ ] 按日期分组
- [ ] 下拉刷新 + 上拉加载

#### 记录卡片
- [ ] 类型图标 (抽烟/忍住)
- [ ] 时间 + 原因标签
- [ ] 间隔时间显示
- [ ] 左滑操作 (编辑/删除)

#### 编辑/删除
- [ ] 编辑弹窗
- [ ] 删除确认
- [ ] `PUT/DELETE /logs/:id`

**交付物**：完整的记录流程，历史记录页可用

---

## 5. Phase 4: 统计与图表 (2天)

### 5.1 Day 1: 统计页基础

#### 时间范围切换
- [ ] 周/月/年 Tabs
- [ ] 日期范围计算
- [ ] 数据请求 (`GET /dashboard?start=&end=`)

#### 吸烟趋势图
- [ ] 集成 uCharts / ECharts
- [ ] 柱状图组件封装
- [ ] 数据格式转换

#### 每周洞察卡片
- [ ] AI 分析展示 (异步加载)

### 5.2 Day 2: 详细指标

#### 健康与储蓄卡片
- [ ] 节省金额计算 + 环形进度
- [ ] 肺部功能恢复 + 环形进度

#### 成就卡片
- [ ] 连续记录天数
- [ ] 已拒绝次数

#### 趋势对比
- [ ] 周同比变化计算
- [ ] 日均吸烟量

**交付物**：完整的统计页，图表正常显示

---

## 6. Phase 5: AI助手与个人中心 (3天)

### 6.1 Day 1: AI 助手页

#### 阶段进度卡片
- [ ] 阶段计算逻辑
- [ ] 进度条展示
- [ ] 天数倒计时

#### 每日 AI 分析
- [ ] 对话式 UI
- [ ] `GET /ai/advice` 集成
- [ ] 会员/广告解锁判断

#### 今日目标
- [ ] 任务列表
- [ ] 完成状态切换 (本地存储)

### 6.2 Day 2: 个人中心页

#### 用户信息
- [ ] 头像 + 昵称展示
- [ ] 目标戒烟日期
- [ ] 连续天数

#### 设置项
- [ ] 目标设定入口
- [ ] AI 计划调整入口
- [ ] 通知设置
- [ ] 会员解锁

#### 基础设置
- [ ] 作息时间设置
- [ ] 每包价格设置

### 6.3 Day 3: 新用户引导

#### 引导页面
- [ ] 分步表单 (5步)
- [ ] 进度指示器
- [ ] 动画过渡

#### 数据收集
- [ ] 日均吸烟量
- [ ] 烟龄
- [ ] 抽烟/戒烟动机
- [ ] 作息时间

#### 提交流程
- [ ] `PUT /profile` 提交
- [ ] 完成后跳转首页

**交付物**：AI助手页、个人中心页、引导流程完整

---

## 7. Phase 6: 优化与测试 (2天)

### 7.1 Day 1: 性能优化

#### 首页优化
- [ ] 首屏时间 < 500ms 验证
- [ ] 图片懒加载
- [ ] 组件按需加载

#### 缓存优化
- [ ] 请求缓存策略检查
- [ ] 本地存储清理策略

#### 包体积
- [ ] 依赖分析
- [ ] 无用代码移除
- [ ] 分包加载配置

### 7.2 Day 2: 测试与修复

#### 功能测试
- [ ] 全流程测试 (新用户 → 日常使用)
- [ ] 边界情况测试
- [ ] 网络异常测试

#### UI 适配
- [ ] 不同机型测试
- [ ] 安全区域适配

#### Bug 修复
- [ ] 测试问题修复
- [ ] 体验优化

**交付物**：可发布的小程序版本

---

## 8. 开发优先级

按重要性和依赖关系排序：

```
P0 (必须完成):
├── 登录认证
├── 首页看板 (计时器 + 今日统计)
├── 记录抽烟/忍住
├── 历史记录查看
└── 新用户引导

P1 (核心功能):
├── 统计图表 (周视图)
├── 下次建议时间
├── 个人设置
└── 基础 AI 建议

P2 (增强功能):
├── 月/年统计
├── AI 时间节点
├── 会员/广告解锁
└── 通知提醒

P3 (未来迭代):
├── 成就系统
├── 社交分享
└── 数据导出
```

---

## 9. 技术风险与应对

| 风险 | 影响 | 应对措施 |
|------|------|----------|
| 首页加载慢 | 用户体验差 | 骨架屏 + 并行请求 + 缓存 |
| 图表库体积大 | 包体积超标 | 按需引入 + 分包 |
| AI 接口慢 | 等待时间长 | 异步加载 + Loading状态 |
| 网络不稳定 | 数据丢失 | 离线缓存 + 重试机制 |
| 微信审核不通过 | 延期上线 | 提前了解审核规范 |

---

## 10. 验收标准

### 首页
- [ ] 首屏渲染 < 500ms
- [ ] 计时器实时更新
- [ ] 记录操作 < 3步完成

### 记录
- [ ] 支持快速记录
- [ ] 支持编辑/删除
- [ ] 数据实时同步

### 统计
- [ ] 图表正常显示
- [ ] 数据计算准确
- [ ] 切换流畅

### 整体
- [ ] 无明显卡顿
- [ ] 无崩溃闪退
- [ ] 视觉符合设计稿
