persionalBrand/docs/PRD.md

个人品牌小程序试点版 PRD

1. 文档信息

• 版本：v0.1
• 产品阶段：单品牌试点版
• 目标用户：朋友作为首个品牌经营者；其客户作为小程序访客
• 产品形态：微信小程序 + Web 内容管理后台
• 当前目标：让品牌经营者能在微信中展示自己、接收预约/咨询，并自行维护内容

需求基线补充：首轮访谈后的订单、微信身份、配送、标签与状态规则见 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 客户浏览并预约

打开小程序 -> 首页了解品牌 -> 查看服务/作品 -> 点击预约
-> 填写称呼、联系方式、服务、期望日期和备注
-> 提交成功 -> 品牌方在后台处理

5.2 管理员更新内容

登录后台 -> 编辑品牌资料/服务/作品 -> 保存
-> 预览 -> 内容在小程序端展示

5.3 管理员处理预约

后台查看待处理预约 -> 查看详情 -> 联系客户
-> 更新为已联系/已完成/已取消 -> 添加内部备注

5.4 反馈发布

客户提交反馈 -> 后台审核 -> 通过后显示在小程序

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，也不是电商系统。支付作为远期能力被保留在产品边界和数据设计中，但当前不实现、不测试、不展示入口。任何新增需求都必须说明它是否直接帮助“展示品牌、承接预约、维护内容”这三个目标；否则进入后续需求池。