deploy: update docs

2026-04-19 14:26:25 +08:00 · 2026-04-19 14:26:25 +08:00 · 97f3aa35a9
commit 97f3aa35a9
parent 138a8d8995
11 changed files with 693 additions and 14 deletions
--- a/P0-研发落地清单.md
+++ b/P0-研发落地清单.md
@ -0,0 +1,108 @@
+# 宠小它 — P0 研发落地清单
+
+> 用途：发给研发拆任务与验收；**仅含 P0**（本期质量与主线闭环必需，不含 P1/P2 增强）。  
+> 依据：《产品全方位优化说明 v1》《本期主线》《宠主端预约体验优化》《产品设计文档》及当前仓库实现粗对齐。  
+> 更新：2026-04-19
+
+**关联**： [产品全方位优化说明-v1](./产品全方位优化说明-v1.md) · [本期主线-下一步产品优化点](./本期主线-下一步产品优化点.md) · [宠主端预约体验优化-产品说明](./宠主端预约体验优化-产品说明.md)
+
+---
+
+## 优先级说明
+
+- **P0**：本迭代必须交付；阻塞对外口碑、数据脏读、合规提示缺失、或主线（传播/成片/留资）不可用。  
+- 已部分实现的项：**仍保留**，以下方「验收标准」为准做 gap 关闭。
+
+---
+
+## A. 后端（Spring Boot）
+
+| ID | 需求 | 验收标准 | 备注 |
+|----|------|----------|------|
+| **A1** | **预约状态机校验**：`PUT /appointment/status`（及任意改状态入口）禁止非法迁移 | 仅允许：`new→doing`、`new→cancel`、`doing→done`（若报告提交会改 done 则接口侧与之一致）、`doing→cancel`（若产品允许，需与前端一致；**若产品规定仅 new 可取消**则 `doing→cancel` 返回 `CANCEL_NOT_ALLOWED`） | 当前 `AppointmentService.updateStatus` / `startService` 偏「直接赋值」，需按《产品设计文档》矩阵校验；非法迁移返回 **4xx + 明确业务码**（如 `INVALID_STATUS`） |
+| **A2** | **开始服务**仅当 `status=new` | `startService` 非 `new` 时拒绝，勿静默改库 | 与「谁点谁服务」一致 |
+| **A3** | **取消预约**（若独立接口）校验：仅允许目标状态为 `cancel` 且前置状态符合产品规则 | 与 A1 同一套状态机；前端取消按钮仅 `new` 时展示则后端仍要防篡改 | 防恶意请求 |
+| **A4** | （可选 P0，若本期上留资）**留资去重**：同一 `report_token` + 同一手机号 | 二次提交返回成功态或「已提交」语义，不重复插库 | 口径见《本期主线》C |
+
+---
+
+## B. 小程序 — 门店端（老板/员工）
+
+| ID | 需求 | 验收标准 | 备注 |
+|----|------|----------|------|
+| **B1** | **「已完成」Tab 列表默认不含已取消** | Tab「已完成」下默认仅展示 `status===done`；`cancel` 通过 **次级筛选**（如「包含已取消」开关）或 **单独子 Tab「已取消」** 二选一实现 | 当前 `Home.vue` 约 `currentStatus==='done'` 时含 `cancel`，需改 |
+| **B2** | **发送报告成功页**：同屏 **报告链接 + 二维码 + 两条可复制话术** | 话术支持变量：`{宠物名}{服务类型}{门店名}{链接}`；一键复制单条话术；二维码与链接不拆多页 | 对齐《本期主线》A「员工动作成本」 |
+| **B3** | **报告提交锁死提示** | 填写报告页底部或提交前弹窗固定文案：**「提交后不可修改，请确认照片与备注无误」**（与产品 v1 锁死策略一致） | 若已有则核对文案 |
+| **B4** | **「我的」老板端分组标题** | 至少两组：`店铺与经营` / `团队与账号`（或等价命名），高频在上；使用现有 `.module-title` | 降低入口迷失，见《产品全方位优化说明》§2.2 |
+
+---
+
+## C. 小程序 — 宠主端（customer）
+
+| ID | 需求 | 验收标准 | 备注 |
+|----|------|----------|------|
+| **C1** | **单一主预约路径** | 首屏仅保留 **一个**主级「预约服务」入口；**不再同屏强并存**「大按钮 + 空态大按钮 + FAB +」等效重复（保留 FAB 则须显著弱于主按钮或仅老用户） | 见《宠主端预约体验优化》§9；需对照当前 `Home.vue` 是否仍重复 |
+| **C2** | **扫码 / 分享落地 `storeId`** | `CustAppointmentCreate` 支持 `onLoad` 读 `storeId`（已有则做 **全入口** 回归：普通二维码、小程序码 scene、分享 path/query） | 预填门店且可「更换门店」 |
+| **C3** | **登录时机与草稿** | 业务规则二选一落地并写 README：**(1)** 未登录可填单，提交时再登录，返回后 **草稿恢复**；**(2)** 进入预约页即要求登录。推荐 (1) | `uni.storage` 或状态恢复；避免白填 |
+| **C4** | **异常可理解** | 无可用时段、网络失败、未登录：均有 **toast / 空态 / 重试**，禁止静默失败 | 专文 §7 |
+
+---
+
+## D. H5 报告页（`report-view` / 独立 H5）
+
+| ID | 需求 | 验收标准 | 备注 |
+|----|------|----------|------|
+| **D1** | **隐私提示（短期策略）** | 首屏或固定条：**「本页含宠物服务影像，请勿公开转发或发群」**（文案可微调，须合规友好） | 对齐《本期主线》A token 风险 |
+| **D2** | **短片三态与文案对齐小程序** | `processing / failed / success` 与 `ReportHighlightBlock` 一致；失败展示 **归类中文**，不暴露堆栈；成功展示可变时长说明 | H5 与小程序报告页行为一致 |
+| **D3** | **弱网 / 失败重试** | 报告主接口失败：**按钮「重新加载」**；超时阈值产品建议 **8～10s** 后出失败态 | 与《产品全方位优化说明》§3.3 |
+
+---
+
+## E. 传播与埋点（P0 最小集）
+
+| ID | 需求 | 验收标准 | 备注 |
+|----|------|----------|------|
+| **E1** | **分享卡片元信息规则** | 小程序 `onShareAppMessage`：标题 **宠物名 + 服务 + 门店**；封面优先级 **成片封面 > 服务后首图 > Logo**（与 `reportShare.js` 逻辑对齐） | 见 `frontend/src/utils/reportShare.js` |
+| **E2** | **埋点：报告打开** | 至少上报：`report_token` 或匿名 hash、**首次/再次**（可用本地 storage 记首次）、时间戳；落地页 H5 亦要能报（像素/接口二选一，研发定方案） | 不要求看板，要求 **可统计**《本期主线》 |
+
+---
+
+## F. 视觉与规范（工程债）
+
+| ID | 需求 | 验收标准 | 备注 |
+|----|------|----------|------|
+| **F1** | **禁止业务页硬编码主色** | 主色/品牌浅底统一 `var(--c-brand)`、`var(--c-brand-light)` 等；全局 grep `#16a34a`、`#2db96d`（除 `global.css` / 极少量渐变定义）**业务 vue 内为 0** | 《前端 UI 规范》已对齐 `--c-*` |
+| **F2** | **空态禁用 emoji 作主视觉**（若违反现有 UI 禁止项） | 宠主空态等用 `AppIcon` 或插图占位，不用 📋 等作为主视觉 | 见 `Home.vue` 空态 slot |
+
+---
+
+## G. 文案与对外承诺（配置级）
+
+| ID | 需求 | 验收标准 | 备注 |
+|----|------|----------|------|
+| **G1** | **无容量模型不写「排队」** | 全局检索「排队」「不排队」；宠主副标题等改为不承诺排队能力的表述（如「在线选时段」） | 与《产品全方位优化说明》D2 一致 |
+| **G2** | **对内录单表述（可选）** | 门店端新建预约入口文案是否改为「代客预约」由产品拍板；若改则全局统一 | 降低「预约」歧义 |
+
+---
+
+## 建议排期顺序（供研发参考）
+
+1. **A1～A3**（后端状态机）— 防脏数据，优先合。  
+2. **B1**（已完成 Tab）— 前端小改、用户感知强。  
+3. **B2、D1、D2、E1**（传播与报告体验）— 主线门面。  
+4. **C1～C4**（宠主）— 与登录/路由并行可排。  
+5. **E2、F1、F2、G1** — 可并行或插空。
+
+---
+
+## 不在 P0（勿与本清单混排）
+
+- 会员卡 / 储值 / 次卡  
+- 报告 token **作废重发**（中期，见 D3 决策）  
+- 多技师分成、排班深度联动  
+- 复杂数据看板、漏斗大屏  
+- 分包优化（可 P1）
+
+---
+
+*评审后可将本页 ID 勾进看板；与专文冲突以迭代评审为准。*
--- a/logo-concept-draft.png
+++ b/logo-concept-draft.png
--- a/产品全方位优化说明-v1.md
+++ b/产品全方位优化说明-v1.md
@ -0,0 +1,191 @@
+# 宠小它 — 产品全方位优化说明（v1）
+
+> 角色：资深产品 + UI/UX 方向说明，与当前仓库文档、页面结构对齐，供评审与拆迭代。  
+> 日期：2026-04-19  
+> 说明：本文件为 **v1 汇总落地版**；细节子域仍以专文为准，避免重复维护时以专文覆盖冲突段落。
+
+**关联文档**
+
+| 文档 | 用途 |
+|------|------|
+| [产品设计文档](./产品设计文档.md) | 功能、数据模型、状态机基线 |
+| [产品改进建议](./产品改进建议.md) | 中长期方向库 |
+| [本期主线-下一步产品优化点](./本期主线-下一步产品优化点.md) | 报告传播 + 成片 + 留资 + 绑定切片 |
+| [宠主端预约体验优化-产品说明](./宠主端预约体验优化-产品说明.md) | C 端预约入口与表单 |
+| [前端 UI 规范](./前端UI规范.md) | 视觉与组件基线（已与 `global.css` 对齐主色与 token） |
+| [洗美报告短视频成片方案](./洗美报告短视频成片方案.md) | 成片边界与工程契约 |
+| [**P0 研发落地清单**](./P0-研发落地清单.md) | **发给研发的 P0 任务与验收表** |
+
+---
+
+## 〇、待决策项（避免返工）
+
+| ID | 议题 | 选项 | 建议 |
+|----|------|------|------|
+| D1 | 主色唯一源 | A `#2db96d`（`--c-brand`，与 `pages.json`/全局样式一致） / B `#16a34a` | **已采纳 A**：以代码与品牌 VI 为准；见《前端 UI 规范》修订 |
+| D2 | 对外是否承诺「排队」 | 有容量模型再写 / 不写 | **无容量模型则不写**「排队」「不排队」类绝对话术 |
+| D3 | 报告 token | 仅页内提示 / + 作废重发 MVP / + 有效期 | 短期提示 + 埋点；中期 **作废重发** 优先于复杂有效期 |
+
+---
+
+## 一、定位、场景与核心流程
+
+### 1.1 问题与方向
+
+| 问题 | 方案 | 理由 |
+|------|------|------|
+| 价值偏「台账工具」，老板难感知增收留客 | **双叙事**：B 端强调「工单 + 可传播报告 + 线索」；C 端强调「少填一步 + 报告回看 + 提醒」 | 与 SaaS 北极星、主线文档一致 |
+| 预约多为店员录单，与「用户自助预约」心智混 | 短期文案统一为 **「代客预约」** 或 **「门店预约」**；中长期宠主自助 + 核销见宠主专文 | 降低期望落差 |
+| 状态迁移接口未完全收口 | 后端状态机校验 + 取消权限与按钮显隐一致；错误码：`INVALID_STATUS`、`CANCEL_NOT_ALLOWED` | 防脏数据、纠纷 |
+| 报告提交后是否可改 | **v1 锁死**则全链路提示「提交后不可修改」；补救能力单独立项 | 减少客诉与随意改档 |
+
+### 1.2 落地规范（研发验收）
+
+- 预约状态机以《产品设计文档》矩阵为准；列表筛选默认 **不含已取消**（见 §二）。
+- 对外宣传物料与小程序描述：**不写**未实现的排队/叫号能力。
+
+---
+
+## 二、信息架构、菜单与导航
+
+### 2.1 问题与方向
+
+| 问题 | 方案 | 理由 |
+|------|------|------|
+| 「我的」入口随功能增长臃肿 | **角色分流**：`Home`/`Mine` 内按 `role` 分支；宠主 **不展示** 门店 KPI 看板 | 专文已明确：C 端不进「后台感」 |
+| 「已完成」Tab 含取消单 | 列表默认 `status=done`；提供「含已取消」筛选或子 Tab | 财务与心智分离 |
+| 深链不足 | **Query 协议**（建议统一文档化）：`storeId`、`petId`、`from=report&reportToken=` 等；`CustAppointmentCreate` `onLoad` 解析并预填 | 扫码、报告再约、分享落地 |
+
+### 2.2 落地规范
+
+**「我的」分组（老板示例）**
+
+1. **经营与订单**：我的订单、预约相关入口（若未合并则保留高频项）  
+2. **店铺配置**：店铺设置、服务类型、排班（中频）  
+3. **团队与线索**：员工管理、线索（Leads）  
+4. **个人**：资料、退出  
+
+每组 ≤5 个一级入口；使用 `.module-title` 分组标题。
+
+**深链优先级**：扫码参数 > 报告带来的预填 > 用户上次默认（门店/宠物）。
+
+---
+
+## 三、交互、路径、文案、空态与异常
+
+### 3.1 问题与方向
+
+| 问题 | 方案 | 理由 |
+|------|------|------|
+| 宠主首屏「+」弱、空列表冷启动差 | 首屏 **主按钮「预约服务」**；空列表主 CTA 置顶 | 见宠主专文 P0 |
+| 发送报告步骤多 | **发送成功页同屏**：链接 + 二维码 + **2 条可复制话术**（变量模板） | 降店员切换成本 |
+| 成片/留资仅成功态精致 | **统一三态**：骨架/加载、失败（归类原因+重试）、成功 | 信任与主线文档一致 |
+| 登录打断填单 | **点击预约再登录**；返回保留草稿（Storage 或状态恢复） | 降首步流失 |
+
+### 3.2 按钮与文案常量（前端可抽 `copy` 模块）
+
+| 场景 | 主按钮 | 次要 | 危险操作 |
+|------|--------|------|----------|
+| 工单 | 开始服务 | 查看详情 | 取消预约（二次确认） |
+| 报告 | 提交报告 → 发送报告 | 稍后生成短片 | — |
+| 宠主 | 预约服务 | 更换门店 | 取消预约 |
+| 发送成功 | 复制链接 | 保存二维码到相册 | — |
+
+**失败原因对用户映射（示例）**
+
+- `NETWORK`：网络异常，请重试  
+- `ASSET`：素材不足或损坏，请补充后重试  
+- `BUSY`：生成排队中，请稍后查看报告  
+- `UNKNOWN`：服务暂时不可用，请联系门店  
+
+禁止直接展示堆栈或内部英文错误句。
+
+### 3.3 空态与网络
+
+- 统一 `.empty`；弱网：首屏请求超时内置阈值（如 10s）后展示「网络不佳，点击重试」。  
+- 列表首屏：**骨架屏** 3～5 行占位（与《前端 UI 规范》并行落地）。
+
+---
+
+## 四、UI、色彩、字体与卡片
+
+### 4.1 问题与方向
+
+| 问题 | 方案 | 理由 |
+|------|------|------|
+| 历史规范主色与代码不一致 | **以 `src/assets/global.css` 的 `--c-*` 为唯一源**；禁止业务页写死绿色 | 设计系统可维护 |
+| 工具感偏强 | 高亮区用 `--c-brand-light`；卡片白底 + `--c-border` + `--c-shadow` | 与品牌「温暖」一致 |
+
+### 4.2 落地规范
+
+- **主色**：`var(--c-brand)` `#2db96d`；深绿 `var(--c-brand-dark)`；浅底 `var(--c-brand-light)`。  
+- **字体层级**：标题 18/700，正文 14～15/400～500，辅助 12；禁止 ≤11px。  
+- **圆角**：组件 12～16px；页面左右边距 16px（`.page-section`）。  
+- **H5 报告页模块顺序**：店信息 → 服务摘要 → **短片区（若有）** → 前后对比 → 过程素材 → 备注 → 留资/绑定 CTA。
+
+---
+
+## 五、功能细节、边缘场景、会员与闭环
+
+| 问题 | 方案 | 备注 |
+|------|------|------|
+| `report_token` 长期有效 | 页内隐私提示；埋点异常频次；中期作废重发 | 见《产品改进建议》§六 |
+| 谁点谁服务、无协作记录 | 短期备注协作；长期多技师/分工表 | 不改表则产品不写「多技师提成」 |
+| 宠物历史 MVP | 列表/详情展示「第 N 次 / 距上次 X 天」**有数据才展示** | 与 `/api/pet/history` 等对齐 |
+| 会员储值 | 路线图 P0；本期仅预留客户域字段亦可 | 避免前端假功能 |
+| 时段已满 | 明确文案 + **快捷切次日** | 宠主专文 |
+
+**报告媒体类型**：前后端统一枚举；优先字段化 `media_type`，与成片任务对齐。
+
+---
+
+## 六、商业化、转化、留存
+
+| 方向 | 动作 | 指标建议（与主线一致，可二选一） |
+|------|------|----------------------------------|
+| 传播 | 分享标题规则：宠物名 + 服务 + 门店；封面：成片封面帧 > 后图首帧 > Logo | `report_open` / `report_reopen` |
+| 成片 | 成功页引导保存/转发；失败可重试 | `highlight_share`、生成成功率 |
+| 留资 | **单钩子** + 最少字段（手机必填）；隐私一句 | `lead_submit`、转化率 |
+| 绑定 | 留资后一句话价值 + 最短路径授权 | `wx_bind_success` |
+| 回访 | Leads 超时未跟进标红（阈值运营定） | 门店执行率 |
+
+计费模型（按店/月、成片加量包等）在《产品改进建议》§七层次定假设，指导裁剪。
+
+---
+
+## 七、微信小程序与性能
+
+| 方向 | 规范 |
+|------|------|
+| 能力差异 | H5 不承诺原生分享卡片；以长按保存、复制链接为主；小程序以 `onShareAppMessage` 为主 |
+| 成片 | 接口返回 `posterUrl`、`durationSec`；前端视频 `poster`、封面优先加载 |
+| 分包 | 低频管理页（服务类型、排班、线索等）评估 `subPackages` 减小主包 |
+| 安全区 | `navigationStyle: custom` 下统一底部 **≥120rpx** 与刘海适配自检 |
+| 图片 | 列表缩略图 lazy-load；报告页大图渐进 |
+
+---
+
+## 八、建议迭代切片（排期用）
+
+| 切片 | 内容 | 产出 |
+|------|------|------|
+| S0 | UI token 与规范文档一致；扫硬编码色 | MR + 自检表 |
+| S1 | 宠主 P0：首屏 CTA、空态、扫码 storeId、登录与草稿 | 专文验收项 |
+| S2 | 传播：发送成功页话术 + 分享元信息 + `report_open` 埋点 | 埋点表 |
+| S3 | 成片三态 + 对外文案「可变时长有上限」 | 报告页/H5 文案冻结 |
+| S4 | 留资 MVP + 绑定引导 + Leads 状态 | 接口与页面状态机 |
+| S5 | 列表筛选默认 done、可选取消 | 接口参数 + UI |
+
+实际顺序可按依赖调整（埋点可与 S1/S2 并行）。**P0 必做项已拆为独立表** → [P0-研发落地清单](./P0-研发落地清单.md)。
+
+---
+
+## 九、修订记录
+
+| 版本 | 日期 | 说明 |
+|------|------|------|
+| v1 | 2026-04-19 | 首版：汇总深度优化结论并落盘；主色与 `global.css` 对齐决策记入 §〇 |
+
+---
+
+*实施时以迭代看板为准；专文与主设计文档冲突处，以评审后更新专文为准。*
--- a/产品改进建议.md
+++ b/产品改进建议.md
@ -1,4 +1,6 @@
-# 宠伴生活馆（petstore）— 产品改进建议备忘
+# 宠小它（petstore）— 产品改进建议备忘
+
+> 品牌：宠小它 · 用心宠小它，温暖伴一生 · 智慧宠物门店服务系统

 > 来源：产品设计复盘（与当前代码/《产品设计文档》对齐）  
 > 用途：方向备忘，实施时以迭代计划与数据为准。
@ -126,7 +128,8 @@ v1 宠主多为「链接访客」，若不沉淀 openid/手机号，门店无法

 - 《产品设计文档.md》：v1 功能与数据模型以该文档为准。
 - 《洗美报告短视频成片方案.md》：成片能力与 §5.3 延伸对应；文内「约 15s 分镜」为**参考示例**，实际成片时长以素材与配置上限为准。
- 《前端UI规范.md》：实现层视觉基线。
+- 《前端UI规范.md》：实现层视觉基线（`--c-*` token 与 `global.css` 一致）。
+- 《产品全方位优化说明-v1.md》：定位、信息架构、交互/UI、商业化与小程序体验的**横向汇总**及排期切片；与本文互补，实施时以迭代目标裁剪。

 ---

@ -135,3 +138,5 @@ v1 宠主多为「链接访客」，若不沉淀 openid/手机号，门店无法
 ---

 **修订备忘（2026-04-18）**：全局措辞同步——成片由「固定 15s」统一为「竖屏、可变时长、配置上限、双编排」；与《洗美报告短视频成片方案》§0、《产品设计文档》v1.8 一致。
+
+**修订备忘（品牌）**：对外品牌统一为 **宠小它**；主/副 Slogan 见《产品设计文档》v1.9 与《品牌替换清单-宠小它.md》。
--- a/产品设计文档.md
+++ b/产品设计文档.md
@ -1,13 +1,18 @@
-# 宠伴生活馆 - 产品设计文档
+# 宠小它 - 产品设计文档

-> 版本：v1.8
-> 日期：2026-04-18（v1.8：成片「可变时长 + 双编排」措辞与 §5.3 对齐专文 §0）
+> 版本：v1.9  
+> 日期：2026-04-18（v1.9：对外品牌统一为「宠小它」及主/副 Slogan；v1.8：成片「可变时长 + 双编排」与 §5.3 对齐专文 §0）
+
+> **品牌**：宠小它 · **主 Slogan**：用心宠小它，温暖伴一生 · **副 Slogan**：智慧宠物门店服务系统  
+> **Logo / VI**：[《宠小它-Logo与品牌识别说明》](./宠小它-Logo与品牌识别说明.md)（含概念草案图）
 > 状态：产品设计确认中；**本期迭代重点：洗美过程短视频自动成片（竖屏、可变时长、双编排）**

 **相关子文档：**

 - [洗美报告短视频成片方案](./洗美报告短视频成片方案.md) — **本期迭代主方案**：过程短视频与自动成片（与 §5.3 服务报告延伸能力对应；时长与编排以专文「与工程实现同步」为准）
 - [产品改进建议](./产品改进建议.md) — 中长期方向库；**§〇** 为本期重点说明
+- [产品全方位优化说明 v1](./产品全方位优化说明-v1.md) — 定位/IA/交互/UI/商业化/小程序体验汇总与排期切片（**与专文互补**，冲突以评审更新为准）
+- [**P0 研发落地清单**](./P0-研发落地清单.md) — **本期必做**：后端状态机、Tab 筛选、发送报告话术、H5 隐私提示、宠主路径、埋点最小集等（**可直接拆 issue**）

 ---

@ -343,7 +348,7 @@ CREATE TABLE t_report_image (

 ## 九、后续事项（开放清单）

- [ ] 宠伴生活馆 Logo 素材
+- [ ] 宠小它 Logo 素材
 - [ ] 图片存储方案（本地 / OSS）
 - [ ] 短信验证码服务商接入
 - [ ] 微信授权登录 AppID/AppSecret
--- a/公众号协同与全链路触达-产品说明.md
+++ b/公众号协同与全链路触达-产品说明.md
@ -0,0 +1,161 @@
+# 公众号协同与全链路触达 — 产品说明
+
+> 范围：从 **预约 → 到店服务 → 洗美报告（海报/短视频）→ 分享朋友圈 → 提醒下次洗护** 的闭环中，**微信公众号**如何与小程序、门店运营配合。  
+> **账号类型（已确认）**：本项目以 **微信服务号** 为对外服务与触达主号（非订阅号）。下文能力与排期均按服务号理解。  
+> 说明：具体接口、类目、模板 ID 以微信后台与研发联调为准；本文以**产品规则与触点**为主。
+
+---
+
+## 1. 全链路一图（心智与资产）
+
+```
+宠主动机：想给宠物洗护/美容
+    ↓
+【小程序】选店、选时、下单（预约）
+    ↓
+到店服务（线下）
+    ↓
+【门店端小程序】填写报告、上传素材、生成海报/成片
+    ↓
+【宠主侧】打开报告页：对比图、过程素材、短片、海报
+    ↓
+情绪高点：保存海报 / 保存短片 → 【引导分享朋友圈】（小程序内能力 + 话术）
+    ↓
+沉淀与回访：关注公众号 / 已关注用户 → 【模板/订阅消息】提醒下次洗护、报告更新
+    ↓
+复购：从消息或菜单回到小程序 → 再次预约
+```
+
+**公众号在其中的角色**：不是替代小程序做业务，而是 **触达、提醒、品牌阵地、弱打扰的「拉回」**；**交易与重交互仍在小程序**。
+
+---
+
+## 2. 小程序 vs 公众号：分工原则
+
+| 维度 | 小程序 | 微信公众号 |
+|------|--------|-------------|
+| **预约、改约、查进度** | ✅ 主阵地 | 菜单跳转小程序页（路径带参） |
+| **报告详情、播放短片、存海报** | ✅ 主阵地 | 同上；不宜用长图文替代 H5/小程序页 |
+| **分享朋友圈** | 小程序卡片、页面引导；**注意**：朋友圈分享规则以微信为准 | 图文可放二维码/链接，转化路径更长 |
+| **定时提醒、服务通知** | 订阅消息（需用户触发订阅）、站内消息（若自建） | **模板消息/类目模板**（服务号能力更强）、订阅通知（视类目） |
+| **品牌内容、活动推文** | 可嵌入 web-view 或跳转 | ✅ 推文、自动回复、关键词 |
+
+**产品结论**：**预约与报告体验以小程序为准**；公众号负责 **关注后菜单导航、关键节点推送、内容运营**，与《本期主线》中的留资、绑定、复购提醒对齐。
+
+---
+
+## 3. 用户身份如何打通（产品必须先定口径）
+
+要让「推送」「菜单个人中心」不串号，需约定：
+
+- **小程序 openid**、**公众号 openid** 不同；若同一微信开放平台主体下绑定小程序与公众号，可有 **unionid** 做统一客户标识（技术实现由研发定）。  
+- **产品规则**：  
+  - 「下次洗护提醒」应对 **已绑定手机或已授权且可识别为同一用户** 的对象发送，避免骚扰陌生人。  
+  - 报告链接 **token** 与登录态关系已在《产品改进建议》§六讨论；公众号内跳转尽量 **带场景参数**，便于统计「从推送打开预约」的转化。
+
+*本节不涉及实现细节，但属于上线前必须评审项。*
+
+---
+
+## 4. 公众号菜单建议（可随阶段裁剪）
+
+以下为 **服务号/已认证订阅号** 常见结构的产品化版本；实际以微信后台可配置项为准。
+
+### 4.1 一级菜单（示例三栏）
+
+| 一级 | 指向 | 产品意图 |
+|------|------|----------|
+| **我要预约** | 跳转小程序指定页：`/pages/appointment/CustAppointmentCreate` 或首页（可带 `storeId`） | 最短路径复购 |
+| **我的服务** | 子菜单见下 | 查单、报告、宠物 |
+| **门店/帮助** | 子菜单：门店地址电话、客服消息、关于我们 | 信任与到店 |
+
+### 4.2 「我的服务」下二级菜单（示例）
+
+| 二级 | 跳转 | 说明 |
+|------|------|------|
+| **我的预约** | 小程序首页或 `MyOrders` | 与 Tab「服务预约」一致心智 |
+| **洗美报告** | 小程序 `MyReports` 或最近一单报告（需登录态） | 聚合历史报告入口 |
+| **我的宠物** | 小程序 `MyPets` | 档案与复购锚点 |
+
+未登录时：统一落地 **小程序登录页** 或 **报告 token 链接说明页**（产品需定义优先级）。
+
+### 4.3 菜单与「分享朋友圈」的关系
+
+- 朋友圈分享 **主要靠小程序页面右上角分享 + 海报保存**，公众号菜单**不承担「分享」动作**，只承担 **「再来一单」「看报告」入口**。  
+- 可在 **首次关注自动回复** 或 **菜单旁推文** 中教用户：「保存海报发圈」「报告页点右上角分享」——属于 **运营话术**，非菜单必选。
+
+---
+
+## 5. 推送：在什么时机、推什么（产品场景表）
+
+微信对营销类推送限制多，**服务通知类**需走模板；以下为 **产品侧可评审** 的场景，是否开通以账号类目与审核为准。
+
+### 5.1 建议的推送类型与触发
+
+| 场景 | 内容概要 | 落地动作 | 备注 |
+|------|----------|----------|------|
+| **报告已生成** | 宠物名 +「服务报告已就绪」 | 点击进小程序报告页 / H5 token 链接 | 高价值、用户强相关；注意频次 |
+| **成片已生成** | 「回顾短片已就绪，可观看保存」 | 同报告页锚点到短片模块 | 与主线「成片」一致 |
+| **预约成功 / 开始前提醒** | 时间、门店、项目 | 进预约详情 | 减少爽约 |
+| **下次洗护建议日**（与 Reminder/间隔产品一致） | 「根据上次服务，建议在 × 月 × 日前后安排洗护」 | 进预约页，可预填宠物 | **复购核心**；需与店内真实规则一致，避免虚假宣传 |
+| **留资/活动** | 优惠券、问卷 | H5 或小程序活动页 | 偏营销，注意防骚扰与退订 |
+
+### 5.2 通道选择（产品认知 · 服务号前提）
+
+- **模板消息 / 类目模板（服务号核心能力）**：适合「服务结果通知」类（报告就绪、预约成功、服务完成等）；需在公众平台选用与**账号类目**匹配的模板，**不可发纯营销/骚扰内容**（易违规封号）。服务号相较订阅号，在**主动服务类触达**上更可依赖模板能力做闭环。  
+- **订阅消息（小程序内）**：用户在小程序内**主动订阅**某次通知，适合「预约开始前」等；与公众号模板消息需 **去重**（见 §6），避免同一事件双推。  
+- **客服消息（48 小时）**：用户与公众号互动后 48 小时内可发一定类型消息，适合**人工跟进**，不适合大规模自动营销。
+
+**产品建议**：**报告/成片就绪** 用 **强相关、低频次** 通知；**洗护周期提醒** 用 **可预期的、可关闭的** 规则（与《Unsubscribe》类退订能力对齐）。
+
+---
+
+## 6. 从「分享朋友圈」到「下次洗护」的衔接
+
+1. **分享当下**：报告页突出 **海报保存 + 短片保存**（已实现方向见《报告短片下载功能》），配 **短文案**：「晒晒你家毛孩子」+ 合规提示。  
+2. **分享后无即时推送**：避免用户刚发圈就收到公众号推送（体验怪）；可在 **次日或 T+3** 做轻量内容（若做运营推文）。  
+3. **复购提醒**：依据 **服务间隔配置**（店内或总部统一），在 **建议日前 3～7 天** 发一条「该安排洗护啦」类模板/订阅消息，**一键进预约**。  
+4. **公众号配合**：同一策略在 **菜单「我要预约」** 保持入口；推文可周期性发「洗护小贴士」**软植入**预约入口。
+
+---
+
+## 7. 合规与体验底线
+
+- **关注与授权**：推送前用户需 **关注公众号** 且模板消息符合微信规范；小程序订阅消息需 **用户勾选**。  
+- **退订**：短信/公众号营销类需 **退订路径**（项目已有退订页方向的，需与公众号侧说明一致）。  
+- **频率**：同一用户 **报告类 + 提醒类** 建议设 **周上限**（产品定数字，研发实现），避免被投诉骚扰。
+
+---
+
+## 8. 分期落地建议
+
+| 阶段 | 公众号侧 | 小程序侧 |
+|------|----------|----------|
+| **P0** | 菜单三项打通小程序；自动回复/关注欢迎语含「预约」「报告」关键词说明 | 报告页分享/保存链路稳定 |
+| **P1** | 报告/成片就绪类 **模板消息**（能开则开） | 订阅消息与推送 **去重规则** |
+| **P2** | 洗护周期提醒 + 推文运营日历 | Reminder 与预约页深链、宠物档案联动 |
+
+---
+
+## 9. 附录：服务号相对订阅号（产品侧为何要定服务号）
+
+| 维度 | 对本期闭环的意义 |
+|------|------------------|
+| **模板消息 / 服务通知** | 报告就绪、预约提醒、洗护建议日等 **可产品化、可排期**；订阅号对「主动推送给未互动用户」限制更多，不适合作为「服务通知主通道」。 |
+| **菜单与小程序** | 服务号支持 **自定义菜单跳转小程序**（路径与参数），与 §4 菜单设计一致。 |
+| **品牌与服务心智** | 用户认知偏「官方服务窗口」，与预约、报告、提醒的 **服务属性** 一致。 |
+| **群发与推文** | 服务号群发频次低于订阅号，**不适合依赖日更推文拉活**；本期应以 **小程序 + 模板消息 + 菜单** 为主，推文作辅助。 |
+
+**产品排期含义**：P1「模板消息打通」在服务号上 **优先级高、可验收**；若误用订阅号，同一需求需改方案（偏小程序订阅消息 + 菜单）。
+
+---
+
+## 10. 相关文档
+
+- 《本期主线-下一步产品优化点.md》：传播、成片、留资、绑定。  
+- 《产品改进建议》§八合规、§二触达。  
+- 《产品设计文档》§5.4～5.5 报告与 H5。
+
+---
+
+*本文为产品与市场协同用说明；微信能力与模板文案以当时平台规则与审核结果为准，上线前需法务/运营复核。*
--- a/前端UI规范.md
+++ b/前端UI规范.md
@ -8,14 +8,21 @@

 ## 设计基线

- 主色：`#16a34a`
- 页面背景：`var(--pet-bg)`
- 主文案：`var(--pet-text)`
- 次级文案：`var(--pet-subtext)`
- 分割/边框：`var(--pet-border)`
- 卡片阴影：`var(--pet-card-shadow)`
+**唯一源**：`frontend/src/assets/global.css` 的 `:root` **CSS 变量（`--c-*`）**；`pages.json` 的 `navigationBarBackgroundColor` 与主色保持一致。

-以上变量统一在 `src/assets/global.css` 维护，页面中不要写死同类颜色。
+- 主色 / 品牌：`var(--c-brand)`（`#2db96d`）
+- 品牌深 / 渐变收边：`var(--c-brand-dark)`（`#1e9a55`）
+- 品牌浅底 / 选中弱背景：`var(--c-brand-light)`（`#eaf8f0`）
+- 页面背景：`var(--c-bg)`（`#fafaf8`）
+- 卡片表面：`var(--c-surface)` / `var(--c-surface-alt)`
+- 主文案：`var(--c-text)`；次级：`var(--c-text-2)`；辅助：`var(--c-text-3)` / `var(--c-text-4)`
+- 分割/边框：`var(--c-border)` / `var(--c-border-light)`
+- 阴影：`var(--c-shadow-sm)` / `var(--c-shadow)` / `var(--c-shadow-lg)`
+- 圆角：`var(--radius-sm)` / `var(--radius)` / `var(--radius-lg)`
+
+业务页面**禁止**写死同类十六进制色，统一使用上述变量。历史文档中出现的 `--pet-*` 已废弃，以 `--c-*` 为准。
+
+> 全站优化说明与决策记录见 [《产品全方位优化说明 v1》](./产品全方位优化说明-v1.md) §〇、§四。

 ## 字体与层级

--- a/品牌替换清单-宠小它.md
+++ b/品牌替换清单-宠小它.md
@ -0,0 +1,109 @@
+# 品牌替换清单：宠小它
+
+> **同步状态**：前端/后端/主文档已按下列定稿替换；微信短信签名、公众平台名称需线下配置。
+
+## 定稿品牌资产（产品）
+
+| 类型 | 内容 |
+|------|------|
+| **品牌名** | 宠小它 |
+| **主 Slogan** | 用心宠小它，温暖伴一生 |
+| **副 Slogan** | 智慧宠物门店服务系统 |
+
+**使用建议（供研发/设计落地）**
+
+- **主 Slogan**：偏 **宠主情感与品牌记忆**，适合：登录页主副文案、报告页/H5 页脚情感行、海报底部、运营朋友圈话术；字数较长时注意 **小屏换行** 与字号层级。  
+- **副 Slogan**：偏 **产品定位 / B 端心智**，适合：`manifest` / 应用商店式 **description**、商家后台页脚、对内文档、官网或公众号简介；**不宜**与主 Slogan 同屏并排抢视觉，通常 **二选一主展示**。  
+- **门店名称**：有 `store.name` 时仍以门店为准；无门店兜底时用品牌名 **宠小它**（见下文第二节）。
+
+---
+
+以下为 **历史梳理**（替换项多数已在代码中落实）。
+
+---
+
+## 一、建议保留不替换（技术标识）
+
+以下与 **代码包名、数据库、路径** 绑定，改名成本高且用户不可见，**可不随品牌改**（除非整体重构）：
+
+| 类型 | 示例 | 说明 |
+|------|------|------|
+| Maven / npm 工程名 | `petstore-backend`、`petstore-uniapp` | artifactId / package.json name |
+| Java 包名 | `com.petstore` | 全量重构级 |
+| 本地存储 Key | `petstore_user`、`petstore_store` 等 | 改则老用户本地态可能异常，需迁移方案 |
+| 数据库名 / 日志 logger | `petstore`、日志 `com.petstore` | 运维与历史日志 |
+| 服务器上传路径 | `application.yml` 中 `/www/petstore/uploads` | 与部署路径一致时可保留 |
+
+---
+
+## 二、必须替换：用户可见 / 审核相关
+
+### 1. 小程序与 H5（`frontend/`）
+
+| 位置 | 当前内容 | 建议 |
+|------|----------|------|
+| `src/manifest.json` | `name`、可选 `description` | **name：宠小它**；**description：建议含副 Slogan**（如「宠小它｜智慧宠物门店服务系统」或仅副 Slogan，保持简短） |
+| `src/pages.json` | `navigationBarTitleText` | **宠小它** |
+| `src/pages/login/Login.vue` | 品牌名、副标题 | **宠小它** + **主 Slogan**（原「让爱更专业」一行替换） |
+| `src/pages/home/Home.vue` | `storeInfo.name` 缺省兜底 | **宠小它**（两处） |
+| `src/pages/report-view/reportView.vue` | 店名兜底、页脚、分享默认 | 兜底 **宠小它**；页脚副线：**主 Slogan**（或店名+主 Slogan，按设计稿） |
+| `src/views/ReportView.vue`（H5） | logo 区、brand-sub | 兜底 **宠小它**；副文案 **主 Slogan** |
+| `src/utils/reportShare.js` | 默认店名 | **宠小它** |
+| `src/utils/reportPosterDraw.js` | 海报默认店名 | **宠小它**（海报是否印主 Slogan 由设计定） |
+| `src/pages/mine/Store.vue` | 页脚 | **宠小它 · 商家版** 或 **宠小它** + 下一行 **副 Slogan**（二选一，避免堆叠三行） |
+| `src/pages/mine/Profile.vue` | 页脚 | **宠小它 · {{ editionLabel }}**；若需系统定位可加 **副 Slogan** 于更弱字号 |
+| `src/assets/global.css` | 注释头 | **宠小它** — 设计系统 |
+| `index.html` | title、meta description | **宠小它**；description 建议 **主 Slogan** 或 **主+副** 择一，控制长度 |
+| `report.html` | `<title>` | **服务报告 - 宠小它** |
+| `login.html` / `register-boss.html` / `register-staff.html` | title、成功页 | 品牌 **宠小它**；副文可用 **主 Slogan** |
+| `login.html` | 演示店名 | **宠小它测试店** |
+
+### 2. 后端（`backend/`）
+
+| 位置 | 建议 |
+|------|------|
+| `pom.xml` `<description>` | **宠小它** 后端服务；可括号 **副 Slogan** |
+| 短信验证码文案 | **【宠小它】**…（与短信模板、签名同步） |
+
+### 3. 文档（`docs/`）
+
+全文「宠伴生活馆」→ **宠小它**；产品主文档可在扉页增加 **主/副 Slogan** 一句。`产品改进建议.md`、`产品设计文档.md`、`洗美报告短视频成片方案.md` 等交叉引用书名同步。
+
+### 4. README
+
+`frontend` / `backend` README 展示名改为 **宠小它**，可加一行 Slogan。
+
+---
+
+## 三、平台侧（非代码仓，需运营配置）
+
+| 项 | 说明 |
+|----|------|
+| **微信小程序名称 / 简介** | 与 **宠小它** 及 **副 Slogan** 或短描述一致 |
+| **短信签名** | **宠小它** |
+| **公众号名称、菜单、模板消息抬头** | 与品牌一致 |
+
+---
+
+## 四、替换后建议自检
+
+- [ ] 全局搜索：`宠伴`、`生活馆`、`让爱更专业`（旧 slogan）  
+- [ ] 主/副 Slogan 是否出现在 **约定场景**（见上文「使用建议」），无重复堆砌  
+- [ ] 小程序真机：标题、登录页、报告页  
+- [ ] H5：标题与 meta  
+- [ ] 短信、海报默认字
+
+---
+
+## 五、与「门店品牌」的边界
+
+- **连锁多店**：仍以 **`store.name`** 为主展示；平台兜底 **宠小它**。  
+- **单店模式**：若对外只露出店名，兜底规则另定并写入《产品设计文档》。
+
+---
+
+*实际字符串替换由研发在分支执行；本文档为产品与验收口径。*
+
+---
+
+**Logo 与 VI**：详见 [《宠小它-Logo与品牌识别说明》](./宠小它-Logo与品牌识别说明.md) 与仓库 `docs/logo-concept-draft.png`（概念草案）。
--- a/宠小它-Logo与品牌识别说明.md
+++ b/宠小它-Logo与品牌识别说明.md
@ -0,0 +1,92 @@
+# 宠小它 — Logo 与品牌识别说明（设计 Brief）
+
+> 角色：供 **设计师定稿** 与 **研发切图** 使用；本文为产品侧能交付的完整度。  
+> 关联：品牌名与 Slogan 见《产品设计文档》v1.9、《品牌替换清单-宠小它.md》。
+
+---
+
+## 1. 品牌一句话
+
+| 项 | 内容 |
+|----|------|
+| 名称 | 宠小它 |
+| 主 Slogan | 用心宠小它，温暖伴一生 |
+| 副 Slogan | 智慧宠物门店服务系统 |
+| 调性关键词 | **温暖、可靠、偏年轻、不低幼**；服务属性强于纯社交卖萌 |
+
+---
+
+## 2. Logo 形态建议（可并行出稿）
+
+| 形态 | 用途 | 说明 |
+|------|------|------|
+| **图形标（Icon / 符号）** | 小程序图标、推送小图、Tab 角标、水印 | 需 **16～24px 仍可辨认**，避免细线、过多细节 |
+| **字标（Wordmark）** | 报告页顶栏、海报、公众号头图 | 「宠小它」三字，字重与字距需单独调；可加英文副标 *ChongXiaoTa* 可选 |
+| **组合标** | 开屏、门店物料、官网 | 图形 + 字标左右或上下组合；规定 **安全区与最小宽度** |
+
+**方向 A（推荐优先试稿）**：**抽象小生灵轮廓**（猫/狗合一的极简形）+ **柔和负形或一笔曲线**（暗示「陪伴」），避免写实照片风。  
+**方向 B**：**字母/笔画几何化**——「小」字一点或「它」的偏旁做记忆点（需避免与现有字体库撞车，宜定制字标）。  
+**方向 C 慎用**：单独 **爪印/狗骨头**——易同质化，若采用需与图形强组合或定制变形。
+
+---
+
+## 3. 色彩（与现有产品对齐）
+
+当前前端主品牌色（见 `global.css`）：
+
+| 用途 | 色值 | 说明 |
+|------|------|------|
+| **主绿（首选）** | `#2db96d` | `--c-brand`，用于 Logo 主形、主按钮联想 |
+| **深绿（强调）** | `#1e9a55` | `--c-brand-dark`，描边、深色底反白时辅助 |
+| **浅绿（背景）** | `#eaf8f0` | `--c-brand-light`，卡片底、浅色水印 |
+
+**扩展（可选，设计师定）**：暖色点缀 **琥珀/橙** `#f5913e`（与现有 `--c-orange` 一致）仅用于 **活动/促销子品牌**，**主 Logo 默认不用橙色**，避免识别分裂。
+
+**反白稿**：需提供 **纯白 Logo + 透明底** 用于绿底/深色图；**单色黑** 用于传真/黑白印刷。
+
+---
+
+## 4. 安全区与最小尺寸（验收用）
+
+- **安全区**：Logo 完整外接矩形四周预留 **≥ 0.5× Logo 高度** 的留白（组合标以整块外轮廓计）。  
+- **数字端最小高度**：字标/组合标 **≥ 16px**（逻辑像素）；纯图形标 **≥ 24×24**（小程序 Tab 常见）。  
+- **禁止**：拉伸变形、改色为未定义色、加投影/描边破坏统一规范（营销特例需单独规范）。
+
+---
+
+## 5. 错误使用示例（给设计与市场对照）
+
+- 把 Logo 压在 **高杂讯照片** 上且未加底托；  
+- **同时**使用未定义的第三色与强渐变；  
+- 与竞品 **同构图** 的爪印/骨头 **无差异**；  
+- 在 **过小区域** 使用完整组合标导致字糊成一团——应改用 **纯图形标**。
+
+---
+
+## 6. 交付物清单（建议设计师输出）
+
+| 交付物 | 规格 | 用途 |
+|--------|------|------|
+| 矢量源文件 | AI / SVG | 研发与延展 |
+| 小程序 **AppIcon** | 1024×1024 PNG，圆角由平台裁切 | 微信提审 |
+| 多倍率 PNG | @2x @3x，透明底 | 小程序内嵌 |
+| 字标横排/竖排 | SVG + PNG | 报告、海报 |
+| 单色稿 | 黑 / 白 | 印刷、水印 |
+| 一页 **PDF 简版规范** | 色值、最小尺寸、错误示例 | 对外统一 |
+
+---
+
+## 7. 与工程衔接（研发）
+
+- 替换 `static` / `tab` 图标前，**先替换设计稿**，避免线上半新半旧。  
+- 小程序 **navigationBar** 与 **分享卡片封面** 若用 Logo，需各提供 **反白/深色** 两套或统一底色素材。
+
+---
+
+## 8. 概念草案图（AI 生成 · 非最终稿）
+
+与本文件同目录：**[`logo-concept-draft.png`](./logo-concept-draft.png)**（仅 **图形标方向** 之一），为视觉参考，**不替代**设计师矢量定稿；商标、版权与是否采用以法务/设计确认为准。
+
+---
+
+*修订：首版由产品侧起草；定稿后以设计团队输出为准并更新本文色值与路径。*
--- a/本期主线-下一步产品优化点.md
+++ b/本期主线-下一步产品优化点.md
@ -85,6 +85,7 @@
 - 《产品改进建议.md》：战略与中长期方向库。  
 - 《产品设计文档.md》§5.3–5.5：报告与发送流程基线。  
 - 《洗美报告短视频成片方案.md》：成片能力边界（需与当前「可变时长、双编排」实现同步修订）。  
+- 《产品全方位优化说明-v1.md》：与本主线配套的横向体验与排期切片（埋点、三态、深链、小程序差异等汇总）。  
 - 《产品协作约定.md》：产品说明默认落 `docs/`，代码由研发实现。

 ---
--- a/洗美报告短视频成片方案.md
+++ b/洗美报告短视频成片方案.md
@ -2,7 +2,7 @@

 > **本期产品迭代重点（2026-04）** — 与《产品改进建议》§〇、《产品设计文档》§5.3、§七 联动更新；**措辞与工程实现冲突时，以「§0 与工程实现同步」为准。**

-> **主文档：** [《宠伴生活馆 - 产品设计文档》](./产品设计文档.md)（预约与洗美报告主流程见 **第二章、§5.3～§5.5**）
+> **主文档：** [《宠小它 - 产品设计文档》](./产品设计文档.md)（预约与洗美报告主流程见 **第二章、§5.3～§5.5**）

 本文档沉淀「洗美报告增加过程短视频 + 自动生成成片」的产品与技术方向讨论结论，供设计与开发对齐。**第一版采用模板化剪辑为主、强生成式画面不做。**