wxserver/快速开始.md

快速开始指南

🎯 项目已完成！

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

📦 项目文件结构

生日提醒小程序/
├── 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. 下载并安装 微信开发者工具
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. 替换农历库

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. 根据需求进一步优化

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