yuming
3965e542fc
部署到群晖 / deploy (push) Failing after 6m22s
- 新增 server/：Node + Express + SQLite + node-cron 实现登录、纪念日 CRUD 和定时订阅消息推送 - 新增 .gitea/workflows/deploy.yml：推送即触发群晖 Docker 部署，监听 15002 - utils/api.js：自动按 envVersion 切换本地/线上 BASE_URL - app.js 与 add-anniversary.js 移除 wx.cloud 调用，改走自建后端 - cloudfunctions/ 暂保留以便回滚 - 一并提交此前未入库的首页 / 设置页 / 日历 / 万年历等改造 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
193 lines
4.9 KiB
Markdown
193 lines
4.9 KiB
Markdown
# 快速开始指南
|
||
|
||
## 🎯 项目已完成！
|
||
|
||
你的生日提醒小程序项目已经完全搭建好了！下面是使用说明。
|
||
|
||
## 📦 项目文件结构
|
||
|
||
```
|
||
生日提醒小程序/
|
||
├── 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 已配置为 emoji 图标模式，无需添加图片文件：
|
||
- 🏠 首页
|
||
- 📅 日历
|
||
- ⚙️ 设置
|
||
|
||
如需添加自定义图标，可以在 `images/` 目录添加图片并修改 `app.json` 配置。
|
||
|
||
### 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. 根据需求进一步优化
|
||
|
||
祝你使用愉快！如有问题，欢迎反馈。
|
||
|