生日提醒小程序

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

📋 功能特性

核心功能

1. 人员信息管理

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

2. 纪念日管理

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

3. 智能提醒

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

4. 日历视图

   • 月历展示所有纪念日
   • 本月纪念日列表
   • 快速跳转到指定日期

5. 数据管理

   • 导出数据备份（复制到剪贴板）
   • 导入数据恢复
   • 清空所有数据

🚀 快速开始

环境要求

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

安装步骤

1. 克隆或下载项目

   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

数据结构：

// 人员数据
{
  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