# 快速开始指南

## 🎯 项目已完成！

你的生日提醒小程序项目已经完全搭建好了！下面是使用说明。

## 📦 项目文件结构

```
生日提醒小程序/
├── app.js                    # 小程序入口
├── app.json                  # 全局配置
├── app.wxss                  # 全局样式
├── project.config.json        # 项目配置
├── sitemap.json              # 站点地图
├── README.md                 # 完整文档
├── PRD.md                    # 产品需求文档
├── 快速开始.md                # 本文件
│
├── pages/                    # 所有页面
│   ├── index/               # 首页（人员列表）
│   ├── person-detail/       # 人员详情
│   ├── add-person/          # 添加/编辑人员
│   ├── add-anniversary/     # 添加/编辑纪念日
│   ├── calendar/            # 日历视图
│   └── settings/            # 设置页面
│
├── utils/                    # 工具类
│   ├── storage.js          # 数据存储管理
│   ├── lunar.js            # 农历转换
│   └── date.js             # 日期工具
│
└── images/                   # 图片资源
    └── .gitkeep
```

## 🚀 如何使用

### 1. 打开微信开发者工具

1. 下载并安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
2. 打开工具，选择"导入项目"
3. 选择本项目目录
4. **AppID填写**：`touristappid`（使用测试号）

### 2. 添加图标（可选）

tabBar需要图标，可以在 `images/` 目录添加：
- `home.png` / `home-active.png`
- `calendar.png` / `calendar-active.png`
- `settings.png` / `settings-active.png`
- `default-avatar.png`

如果不添加图标，tabBar可能显示异常，但功能不受影响。

### 3. 运行项目

1. 点击"编译"按钮
2. 在模拟器中查看效果
3. 可以开始测试各项功能

## ✅ 核心功能已实现

### ✅ 1. 人员管理
- 添加人员（姓名、昵称、头像、备注）
- 编辑人员信息
- 删除人员
- 搜索功能

### ✅ 2. 纪念日管理
- 支持多种类型（公历生日、农历生日、纪念日等）
- 自定义纪念日类型
- 设置重要程度
- 支持公历/农历切换

### ✅ 3. 提醒设置
- 开启/关闭提醒
- 设置提前天数（3/7/14/30天或自定义）
- 近期纪念日显示

### ✅ 4. 日历视图
- 月历展示
- 标记纪念日
- 本月纪念日列表
- 快速浏览

### ✅ 5. 数据管理
- 导出数据（复制到剪贴板）
- 导入数据
- 清空数据

## 📱 页面说明

### 首页（人员列表）
- 查看所有添加的人员
- 显示最近的纪念日和倒计时
- 搜索和筛选
- 浮动按钮快速添加

### 人员详情页
- 查看完整信息
- 管理该人员的所有纪念日
- 编辑、删除操作

### 添加人员页
- 输入完整信息
- 上传头像（可选）
- 保存到本地

### 添加纪念日页
- 选择关联人员
- 选择类型
- 设置日期（公历/农历）
- 配置提醒和重要程度

### 日历页
- 月历视图
- 标记有纪念日的日期
- 本月纪念日列表

### 设置页
- 导入/导出数据
- 清空数据
- 查看版本信息

## 💡 使用建议

### 首次使用
1. 先添加几个人员
2. 为每个人添加1-2个纪念日
3. 设置重要程度和提醒
4. 查看日历和列表效果

### 数据备份
- **定期导出**：设置 → 导出数据
- **导入恢复**：设置 → 导入数据
- **注意**：导入会覆盖现有数据

### 农历生日
- 选择"农历"类型
- 输入农历日期
- 系统会自动计算

## ⚠️ 已知限制

1. **tabBar图标**：需要手动添加图标文件，否则tabBar可能显示异常
2. **农历计算**：当前使用简化算法，准确性有限
3. **提醒功能**：小程序限制，无法真正的后台推送
4. **头像上传**：使用本地临时路径，刷新后会丢失

## 🔧 可选优化

### 1. 替换农历库
```bash
npm install lunar-javascript
```
然后在 `utils/lunar.js` 中使用。

### 2. 添加云开发
- 使用微信云开发实现数据同步
- 支持多设备
- 真正的推送通知

### 3. 添加更多图标
- 使用 iconfont 或 iconify
- 统一设计风格

## 📞 遇到问题？

### 常见问题

**Q: tabBar显示异常？**
A: 需要添加图标文件到 `images/` 目录，或者删除 `app.json` 中的 `tabBar` 配置。

**Q: 数据丢失？**
A: 建议定期导出数据备份。在设置页可以导出当前所有数据。

**Q: 提醒不工作？**
A: 小程序限制，无法真正的后台推送。需要在小程序前台运行时才能触发。

**Q: 农历日期不准确？**
A: 当前使用简化算法。建议使用成熟的农历库如 `lunar-javascript`。

## 🎉 完成！

现在你可以：
1. 打开微信开发者工具
2. 导入项目
3. 开始使用和测试
4. 根据需求进一步优化

祝你使用愉快！如有问题，欢迎反馈。