Initial Commit
This commit is contained in:
yuming
@@ -0,0 +1,193 @@
|
||||
# 快速开始指南
|
||||
|
||||
## 🎯 项目已完成！
|
||||
|
||||
你的生日提醒小程序项目已经完全搭建好了！下面是使用说明。
|
||||
|
||||
## 📦 项目文件结构
|
||||
|
||||
```
|
||||
生日提醒小程序/
|
||||
├── 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. 根据需求进一步优化
|
||||
|
||||
祝你使用愉快！如有问题，欢迎反馈。
|
||||
|
||||
Reference in New Issue
Block a user