使用手册

从浏览、互动到发布,按一条稳定流程使用和维护产品

这页面向三类人群:普通访客、已登录花友和生产维护者。前两类用于正确使用功能,后一类用于在每次生产部署前同步更新说明与历史页面。

🔎

访客使用路径

不登录也可以完成主要内容浏览与检索。

  • 从首页进入品种大全、场景方案、养护指南或搜索页。
  • 在品种大全中按品牌、花色和关键词筛选,进入详情页查看基础属性。
  • 在场景方案页按阳台、庭院、花墙、盆栽等场景找推荐品种。
👤

账号与个人资料

登录后可获得完整互动能力。

  • 支持邮箱、手机号或用户名登录。
  • 个人页可以编辑昵称、简介、经验标签、庭院类型和头像。
  • 重置密码流程已具备 token 验证能力,但生产邮箱发送仍待接入。
🖼️

日记与图片发布

日记是社区内容核心,支持多图上传与品种关联。

  • 创建日记时可选择一个主品种并附加多个关联品种。
  • 上传图片会在服务端压缩为 WebP,再写入持久化目录。
  • 编辑日记支持调整既有图片顺序、补充新图和删除单张图片。
💌

互动与通知

登录用户可进行社区互动,并在顶部通知中心查看状态。

  • 支持点赞、收藏、关注、评论与回复。
  • 重复点赞和重复关注通知已做去重,避免历史垃圾提醒累积。
  • 通知中心支持未读统计、单条已读和全部已读。
🚀

生产运维说明

生产环境上线前后,需要同步操作与内容更新。

  • 创建或轮换生产密钥时使用 scripts/create-production-secret.sh。
  • 危险迁移前必须先备份数据库与媒体,再执行带确认参数的生产迁移脚本。
  • 每次生产部署前,更新本文件中的产品说明、开发历史和部署历史条目。
发布前检查

每次生产部署前,都要同步更新页面内容

当前产品说明、手册和历史页共享一份内容源。只要在生产部署前更新它,就能保证站内说明和实际生产版本一致。

src/lib/content/productDocs.ts
1
补充本次新增功能、行为调整或限制说明。
2
追加功能开发历史条目,说明此次用户可见变化。
3
追加生产部署历史条目,记录部署目标、风险控制和结果。
4
若涉及数据库或媒体操作,先完成生产备份并确认回滚路径。