# 生日提醒小程序

一款轻量级、易用的个人纪念日管理小程序，帮助用户记录和提醒重要的生日、节日和纪念日。

## 📋 功能特性

### 核心功能

1. **人员信息管理**
   - 添加、编辑、删除人员信息
   - 支持姓名、昵称、备注、头像
   - 快速搜索和筛选

2. **纪念日管理**
   - 支持公历和农历生日
   - 多种纪念日类型（生日、结婚纪念日、订婚纪念日等）
   - 自定义纪念日类型
   - 设置重要程度（非常重要/重要/一般）

3. **智能提醒**
   - 灵活设置提醒时间（提前3/7/14/30天或自定义）
   - 支持开启/关闭提醒
   - 近期纪念日一目了然

4. **日历视图**
   - 月历展示所有纪念日
   - 本月纪念日列表
   - 快速跳转到指定日期

5. **数据管理**
   - 导出数据备份（复制到剪贴板）
   - 导入数据恢复
   - 清空所有数据

## 🚀 快速开始

### 环境要求

- 微信开发者工具
- Node.js（如果需要）

### 安装步骤

1. **克隆或下载项目**
   ```bash
   git clone <项目地址>
   cd 生日提醒小程序
   ```

2. **打开微信开发者工具**
   - 打开微信开发者工具
   - 选择"导入项目"
   - 选择项目目录
   - AppID填写：`touristappid`（测试号）

3. **运行项目**
   - 点击"编译"按钮
   - 在模拟器中查看效果

### 配置说明

#### app.json 配置
- `pages`: 页面路径配置
- `tabBar`: 底部导航栏配置
- `window`: 窗口配置

#### project.config.json 配置
- 根据实际开发需求修改 `appid`

## 📁 项目结构

```
生日提醒小程序/
├── app.js                 # 小程序入口文件
├── app.json              # 全局配置
├── app.wxss              # 全局样式
├── project.config.json    # 项目配置
├── sitemap.json          # 站点地图
├── pages/                # 页面目录
│   ├── index/            # 首页（人员列表）
│   ├── person-detail/   # 人员详情
│   ├── add-person/      # 添加/编辑人员
│   ├── add-anniversary/ # 添加/编辑纪念日
│   ├── calendar/         # 日历视图
│   └── settings/         # 设置页面
└── utils/                # 工具类
    ├── storage.js        # 数据存储
    ├── lunar.js          # 农历转换
    └── date.js           # 日期工具
```

## 🎨 页面功能说明

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

### 2. 人员详情页
- 展示人员完整信息
- 显示该人员的所有纪念日
- 编辑和删除操作

### 3. 添加人员页
- 输入姓名、昵称、备注
- 上传头像
- 保存到本地存储

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

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

### 6. 设置页
- 导出/导入数据
- 清空数据
- 关于信息

## 💾 数据存储

项目使用微信小程序的本地存储功能：
- `wx.getStorageSync()` - 同步读取数据
- `wx.setStorageSync()` - 同步存储数据
- 最大存储容量：10MB

数据结构：
```javascript
// 人员数据
{
  id: String,
  name: String,
  nickname: String,
  avatar: String,
  remark: String,
  createTime: Number,
  updateTime: Number
}

// 纪念日数据
{
  id: String,
  personId: String,
  type: String,
  customTypeName: String,
  isLunar: Boolean,
  solarYear: Number,
  solarMonth: Number,
  solarDay: Number,
  importance: String,
  remindEnabled: Boolean,
  remindDays: Number,
  remark: String,
  createTime: Number,
  updateTime: Number
}
```

## ⚠️ 注意事项

1. **农历功能**
   - 当前使用简化版的农历转换算法
   - 建议使用成熟的农历库（如 `lunar-javascript`）替换

2. **提醒功能**
   - 小程序不支持后台定时任务
   - 需要在前台运行时才能触发提醒
   - 建议使用云开发或服务器来实现真正的推送通知

3. **数据备份**
   - 导出功能会将数据复制到剪贴板
   - 建议定期导出备份，防止数据丢失
   - 导入时会覆盖现有数据

4. **头像上传**
   - 当前使用本地临时路径
   - 如需持久化，需要上传到云存储或服务器

## 🔧 开发建议

### 功能扩展

1. **农历转换优化**
   - 使用 `lunar-javascript` 库
   - 实现准确的农历转公历计算

2. **提醒功能增强**
   - 使用云开发或后端服务
   - 实现真正的推送通知
   - 支持定时提醒

3. **数据同步**
   - 添加云存储支持
   - 多设备数据同步
   - 数据加密

4. **UI优化**
   - 添加更多的图标资源
   - 优化动画效果
   - 支持暗色模式

## 📄 许可证

MIT License

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📞 联系方式

如有问题或建议，请提交 Issue。

---

**最后更新**: 2024年
**版本**: v1.0.0