docs: define initial product requirements
This commit is contained in:
391
docs/PRD.md
Normal file
391
docs/PRD.md
Normal file
@@ -0,0 +1,391 @@
|
||||
# 个人品牌小程序试点版 PRD
|
||||
|
||||
## 1. 文档信息
|
||||
|
||||
- **版本**：v0.1
|
||||
- **产品阶段**：单品牌试点版
|
||||
- **目标用户**：朋友作为首个品牌经营者；其客户作为小程序访客
|
||||
- **产品形态**：微信小程序 + Web 内容管理后台
|
||||
- **当前目标**：让品牌经营者能在微信中展示自己、接收预约/咨询，并自行维护内容
|
||||
|
||||
> 需求基线补充：首轮访谈后的订单、微信身份、配送、标签与状态规则见 [07-requirements-interview-decisions.md](./07-requirements-interview-decisions.md)。与本文早期表述冲突时，以该决策文档为准。
|
||||
|
||||
## 2. 背景与问题
|
||||
|
||||
个体户和手艺人通常依赖朋友圈、聊天记录和零散图片介绍业务。客户难以快速了解其身份、服务、作品和合作方式，经营者也缺少一个可持续维护的品牌入口。
|
||||
|
||||
本项目先为一个真实经营者交付可用的小程序，验证“品牌展示 + 预约承接 + 内容自维护”的完整闭环。第一版不做支付、不做多商户平台、不做自动发布流程。
|
||||
|
||||
## 3. 产品目标
|
||||
|
||||
### 3.1 目标
|
||||
|
||||
1. 客户在 1 分钟内了解品牌、服务和代表作品。
|
||||
2. 客户无需注册即可提交咨询或预约。
|
||||
3. 经营者可以在后台独立更新品牌、服务和作品内容。
|
||||
4. 经营者可以查看并处理预约，审核客户反馈。
|
||||
5. 形成一个可复用的首个品牌案例，为后续自己的品牌和其他客户项目提供基础。
|
||||
|
||||
### 3.2 非目标
|
||||
|
||||
- 当前不提供支付、退款、发票、分账或财务对账。
|
||||
- 当前不提供多商户注册、套餐、计费和租户自助开通。
|
||||
- 当前不提供多员工、多门店、复杂排班和库存管理。
|
||||
- 当前不提供自动注册、自动审核、自动发布微信小程序。
|
||||
- 当前不将小程序做成内容社区或平台流量市场。
|
||||
|
||||
## 4. 用户与角色
|
||||
|
||||
### 4.1 访客/客户
|
||||
|
||||
无需登录即可浏览公开内容和提交预约。提交预约时填写必要联系信息。
|
||||
|
||||
### 4.2 品牌管理员
|
||||
|
||||
朋友本人。可登录后台管理品牌资料、服务、作品、预约和反馈。
|
||||
|
||||
### 4.3 平台维护者
|
||||
|
||||
开发者本人。负责系统维护、问题排查、内容协助和版本发布。第一版可与品牌管理员共用后台，但权限模型应保留角色字段。
|
||||
|
||||
## 5. 核心用户流程
|
||||
|
||||
### 5.1 客户浏览并预约
|
||||
|
||||
```text
|
||||
打开小程序 -> 首页了解品牌 -> 查看服务/作品 -> 点击预约
|
||||
-> 填写称呼、联系方式、服务、期望日期和备注
|
||||
-> 提交成功 -> 品牌方在后台处理
|
||||
```
|
||||
|
||||
### 5.2 管理员更新内容
|
||||
|
||||
```text
|
||||
登录后台 -> 编辑品牌资料/服务/作品 -> 保存
|
||||
-> 预览 -> 内容在小程序端展示
|
||||
```
|
||||
|
||||
### 5.3 管理员处理预约
|
||||
|
||||
```text
|
||||
后台查看待处理预约 -> 查看详情 -> 联系客户
|
||||
-> 更新为已联系/已完成/已取消 -> 添加内部备注
|
||||
```
|
||||
|
||||
### 5.4 反馈发布
|
||||
|
||||
```text
|
||||
客户提交反馈 -> 后台审核 -> 通过后显示在小程序
|
||||
```
|
||||
|
||||
## 6. 功能需求
|
||||
|
||||
优先级定义：P0 为第一版必须交付，P1 为第一版可选增强，P2 为后续规划。
|
||||
|
||||
### 6.1 小程序：首页（P0）
|
||||
|
||||
展示品牌头像、名称、一句话介绍、代表服务、代表作品和主要行动按钮。
|
||||
|
||||
**要求**
|
||||
|
||||
- 公开访问，无需登录。
|
||||
- 内容来自后台配置，不得写死在前端。
|
||||
- 服务和作品无内容时，模块自动隐藏或显示空状态，不出现破损布局。
|
||||
- 至少提供“查看服务”和“联系/预约”两个主要入口。
|
||||
|
||||
### 6.2 小程序：品牌介绍（P0）
|
||||
|
||||
- 品牌名称、头像/Logo、封面图
|
||||
- 个人简介
|
||||
- 从业经历
|
||||
- 擅长领域
|
||||
- 服务理念
|
||||
- 联系方式、所在地区、地址（可选）
|
||||
|
||||
**要求**
|
||||
|
||||
- 支持富文本或结构化文本编辑。
|
||||
- 联系电话、微信号等敏感信息由管理员控制是否展示。
|
||||
- 地址展示与地图能力解耦，第一版可先展示文字地址。
|
||||
|
||||
### 6.3 小程序：服务项目（P0）
|
||||
|
||||
每项服务包含：名称、封面图、描述、价格文本、预计时长、预约状态、排序。
|
||||
|
||||
**价格规则**
|
||||
|
||||
- 第一版只展示价格文本，例如“￥xxx”“面议”“起价 xxx”。
|
||||
- 价格不参与支付、不计算订单金额。
|
||||
- 数据模型保留可扩展的数值价格字段，但第一版不展示支付按钮。
|
||||
|
||||
**要求**
|
||||
|
||||
- 仅展示已启用服务。
|
||||
- 支持服务详情页。
|
||||
- 服务可配置“可预约/仅咨询”。
|
||||
|
||||
### 6.4 小程序：作品集（P0）
|
||||
|
||||
每项作品包含：图片、标题、描述、分类、排序、是否展示。
|
||||
|
||||
- 支持多图浏览。
|
||||
- 支持作品详情页。
|
||||
- 图片加载失败时显示占位状态。
|
||||
- 作品数量较多时支持分类筛选或分页加载（P1）。
|
||||
|
||||
### 6.5 小程序：预约/咨询表单（P0）
|
||||
|
||||
字段：
|
||||
|
||||
- 称呼：必填，2-30 字
|
||||
- 手机号或微信号：至少填写一项
|
||||
- 服务项目：可选，来自已启用服务
|
||||
- 期望日期：可选，不能选择过去日期
|
||||
- 备注：可选，0-500 字
|
||||
- 用户同意联系/信息使用提示：必选确认
|
||||
|
||||
**提交规则**
|
||||
|
||||
- 提交前校验字段格式。
|
||||
- 防止重复提交，提交按钮在请求期间禁用。
|
||||
- 成功后生成预约编号，并显示提交成功页。
|
||||
- 失败时保留用户已填内容并给出可理解的错误提示。
|
||||
- 第一版不承诺具体预约时间，不做自动排班和冲突检测。
|
||||
|
||||
### 6.6 小程序：反馈（P0）
|
||||
|
||||
- 查看已审核反馈。
|
||||
- 提交称呼、内容和可选联系方式。
|
||||
- 内容长度 10-500 字。
|
||||
- 新反馈默认待审核，不直接公开。
|
||||
- 后台审核通过后才展示。
|
||||
|
||||
### 6.7 小程序：管理员入口（P1）
|
||||
|
||||
- 后端返回当前微信身份是否为管理员。
|
||||
- 仅管理员显示入口。
|
||||
- 入口可跳转管理后台网页或后续管理页面。
|
||||
- 隐藏入口不能替代后端鉴权，所有管理 API 必须重新校验权限。
|
||||
|
||||
第一版可暂时使用后台独立登录，不要求小程序内完成管理操作。
|
||||
|
||||
### 6.8 后台：登录与权限（P0）
|
||||
|
||||
- 管理员登录、退出登录。
|
||||
- 密码不得明文存储，应使用安全哈希。
|
||||
- 登录态有过期时间，支持主动退出。
|
||||
- 每个管理 API 校验登录态和角色。
|
||||
- 角色字段至少保留 `admin`、`operator` 两种值；第一版可只启用 `admin`。
|
||||
|
||||
### 6.9 后台：品牌资料管理（P0）
|
||||
|
||||
- 编辑品牌名称、头像、封面、简介、经历、擅长领域、服务理念、联系方式和地址。
|
||||
- 控制首页模块是否显示。
|
||||
- 保存草稿和发布内容可先合并为“保存即生效”。
|
||||
- 保存成功后显示明确反馈。
|
||||
- 提供预览入口。
|
||||
|
||||
### 6.10 后台：服务管理（P0）
|
||||
|
||||
- 新增、编辑、删除服务。
|
||||
- 启用/停用服务。
|
||||
- 修改排序。
|
||||
- 配置服务描述、价格文本、时长和预约方式。
|
||||
- 删除前二次确认；已产生预约的服务建议采用停用而非物理删除。
|
||||
|
||||
### 6.11 后台：作品管理（P0）
|
||||
|
||||
- 上传图片、编辑标题/描述/分类。
|
||||
- 调整排序。
|
||||
- 隐藏/显示作品。
|
||||
- 删除前确认。
|
||||
- 限制文件类型、大小和图片数量，并展示上传进度/失败原因。
|
||||
|
||||
### 6.12 后台：预约管理（P0）
|
||||
|
||||
- 列表展示预约编号、客户称呼、联系方式、服务、期望日期、状态、提交时间。
|
||||
- 支持按状态和日期筛选。
|
||||
- 查看详情。
|
||||
- 状态：待处理、已联系、已完成、已取消。
|
||||
- 添加内部备注。
|
||||
- 联系方式仅授权管理员可见。
|
||||
- 第一版不发送自动通知，管理员通过现有联系方式联系客户。
|
||||
|
||||
### 6.13 后台：反馈管理（P0）
|
||||
|
||||
- 查看待审核、已通过、已隐藏反馈。
|
||||
- 通过、隐藏、删除。
|
||||
- 查看提交时间和关联预约（如有）。
|
||||
- 审核操作记录操作人和时间。
|
||||
|
||||
### 6.14 后台：预览（P0）
|
||||
|
||||
- 从后台进入小程序预览页。
|
||||
- 预览内容与当前保存数据一致。
|
||||
- 第一版不做复杂草稿版本和多人协作。
|
||||
|
||||
## 7. 页面清单
|
||||
|
||||
### 小程序
|
||||
|
||||
1. 首页
|
||||
2. 品牌介绍页
|
||||
3. 服务列表页
|
||||
4. 服务详情页
|
||||
5. 作品集列表页
|
||||
6. 作品详情页
|
||||
7. 预约/咨询表单页
|
||||
8. 提交成功页
|
||||
9. 反馈列表页
|
||||
10. 反馈提交页
|
||||
|
||||
### 管理后台
|
||||
|
||||
1. 登录页
|
||||
2. 首页/概览页
|
||||
3. 品牌资料页
|
||||
4. 服务列表/编辑页
|
||||
5. 作品列表/编辑页
|
||||
6. 预约列表/详情页
|
||||
7. 反馈列表/审核页
|
||||
8. 预览入口
|
||||
|
||||
## 8. 数据模型
|
||||
|
||||
### BrandProfile
|
||||
|
||||
`id`, `name`, `avatar_url`, `cover_url`, `intro`, `experience`, `expertise`, `philosophy`, `contact_phone`, `contact_wechat`, `address`, `is_published`, `created_at`, `updated_at`
|
||||
|
||||
### Service
|
||||
|
||||
`id`, `name`, `description`, `cover_url`, `price_text`, `price_amount`（预留，第一版不用于支付）, `duration_minutes`, `booking_enabled`, `is_enabled`, `sort_order`, `created_at`, `updated_at`
|
||||
|
||||
### PortfolioItem
|
||||
|
||||
`id`, `title`, `description`, `category`, `image_urls`, `is_visible`, `sort_order`, `created_at`, `updated_at`
|
||||
|
||||
### Booking
|
||||
|
||||
`id`, `booking_no`, `customer_name`, `phone`, `wechat_id`, `service_id`, `requested_date`, `note`, `status`, `admin_note`, `created_at`, `updated_at`
|
||||
|
||||
### Feedback
|
||||
|
||||
`id`, `booking_id`（可选）, `customer_name`, `content`, `contact`, `status`, `reviewed_by`, `reviewed_at`, `created_at`, `updated_at`
|
||||
|
||||
### AdminUser
|
||||
|
||||
`id`, `username`, `password_hash`, `display_name`, `role`, `wechat_openid`（预留）, `is_enabled`, `last_login_at`, `created_at`, `updated_at`
|
||||
|
||||
### 远期支付相关预留
|
||||
|
||||
第一版不创建可用支付流程，但应避免把预约和支付强绑定。远期可新增：
|
||||
|
||||
- `Order`：业务订单，与 `Booking` 一对一或一对多关联
|
||||
- `Payment`：支付单、微信交易号、金额、状态、支付时间
|
||||
- `Refund`：退款记录
|
||||
- `price_amount` 使用整数分，避免浮点金额
|
||||
- 订单状态与预约状态分离
|
||||
|
||||
第一版的 `Booking` 不应包含 `paid`、`payment_status` 等容易造成误解的字段。若必须预留，使用独立扩展表或明确标记为未启用字段。
|
||||
|
||||
## 9. 权限与安全要求
|
||||
|
||||
- 公开内容接口只返回已发布、已启用、已审核数据。
|
||||
- 管理接口必须验证登录态和角色。
|
||||
- 联系方式、预约备注等个人信息不得出现在公开接口和日志中。
|
||||
- 所有输入进行长度、格式和内容校验。
|
||||
- 图片上传限制 MIME 类型、文件大小和存储路径。
|
||||
- 删除采用软删除或保留审计记录，避免误删预约数据。
|
||||
- 生产环境必须使用 HTTPS。
|
||||
- 管理操作记录操作人、动作和时间。
|
||||
- 小程序端隐藏管理员入口仅为体验优化，不是安全边界。
|
||||
|
||||
## 10. 非功能要求
|
||||
|
||||
- 移动端首屏在正常网络下可用，图片按需加载并压缩。
|
||||
- 后台适配桌面浏览器，窄屏下不出现不可操作的横向溢出。
|
||||
- 关键操作有加载、成功、失败和空状态。
|
||||
- 表单提交具备幂等或重复提交保护。
|
||||
- 数据库每日备份，至少保留最近 7 天备份（部署条件允许时）。
|
||||
- 关键错误写入可检索日志，但不得记录明文密码和完整联系方式。
|
||||
|
||||
## 11. 验收标准
|
||||
|
||||
### 内容闭环
|
||||
|
||||
- 管理员登录后可以修改品牌介绍，重新打开小程序可看到更新。
|
||||
- 管理员可以新增、停用和排序服务。
|
||||
- 管理员可以上传、隐藏和排序作品。
|
||||
- 未启用服务和未展示作品不会出现在小程序公开页面。
|
||||
|
||||
### 预约闭环
|
||||
|
||||
- 客户无需注册即可提交有效预约。
|
||||
- 缺少称呼和联系方式时不能提交。
|
||||
- 重复点击不会生成重复预约。
|
||||
- 管理员可以查看预约详情并更新状态。
|
||||
- 预约联系方式不出现在公开页面。
|
||||
|
||||
### 反馈闭环
|
||||
|
||||
- 客户提交的反馈默认不可见。
|
||||
- 管理员审核通过后才展示。
|
||||
- 管理员可以隐藏已展示反馈。
|
||||
|
||||
### 权限闭环
|
||||
|
||||
- 未登录用户无法访问管理页面和管理 API。
|
||||
- 普通用户即使直接调用管理接口也无法修改数据。
|
||||
- 管理员退出后旧登录态失效或在有效期内被拒绝。
|
||||
|
||||
### 远期支付兼容性
|
||||
|
||||
- 第一版没有支付按钮、支付接口和支付状态。
|
||||
- 服务价格仅作为展示文本，不产生支付金额。
|
||||
- 预约状态不承担订单和支付状态职责。
|
||||
- 后续新增支付不会要求重写品牌、服务和预约基础数据。
|
||||
|
||||
## 12. 开发阶段与交付顺序
|
||||
|
||||
### 阶段一：需求和内容准备
|
||||
|
||||
- 确认朋友的品牌资料、服务、作品和预约流程。
|
||||
- 确认视觉基调和首页结构。
|
||||
- 收集真实图片和联系方式。
|
||||
|
||||
### 阶段二：基础系统
|
||||
|
||||
- 数据库和 API。
|
||||
- 管理员登录。
|
||||
- 品牌、服务、作品管理。
|
||||
- 小程序公开展示。
|
||||
|
||||
### 阶段三：业务闭环
|
||||
|
||||
- 预约表单和预约后台。
|
||||
- 反馈提交、审核和展示。
|
||||
- 权限校验、错误处理和日志。
|
||||
|
||||
### 阶段四：真实试用
|
||||
|
||||
- 用朋友的真实内容上线测试环境。
|
||||
- 至少完成 3 次内容更新和 3 次预约流程演练。
|
||||
- 修复影响真实使用的问题。
|
||||
- 冻结第一版范围，记录后续需求，不在上线前无限扩张。
|
||||
|
||||
## 13. 后续评估指标
|
||||
|
||||
第一版上线后两周观察：
|
||||
|
||||
- 朋友是否能独立完成内容更新。
|
||||
- 客户是否能在不解释的情况下找到服务和联系方式。
|
||||
- 是否产生真实咨询或预约。
|
||||
- 预约处理是否比原有聊天记录更清晰。
|
||||
- 哪些后台操作被频繁使用或频繁出错。
|
||||
- 哪些需求是其他品牌也可能复用的。
|
||||
|
||||
只有在真实使用出现稳定需求后，再评估支付、微信通知、多品牌和自动发布能力。
|
||||
|
||||
## 14. 版本边界结论
|
||||
|
||||
本版本的交付结果是一个可用的单品牌展示和预约系统，而不是完整 SaaS，也不是电商系统。支付作为远期能力被保留在产品边界和数据设计中，但当前不实现、不测试、不展示入口。任何新增需求都必须说明它是否直接帮助“展示品牌、承接预约、维护内容”这三个目标；否则进入后续需求池。
|
||||
Reference in New Issue
Block a user