产品需求文档Version 1.0 · 2026-10-02

用途：作为 YUYU手作集 V1 的统一产品依据，供产品设计、Codex 开发、CloudBase 数据建模、后台实现与验收使用。

版本状态：核心产品范围、信息架构、主要页面、作品字段、图片安全策略已冻结。Data Model v1.0 正在工程落地；后台管理系统结构已确定方向，但尚未开始开发。

变更原则：后续若无真实使用问题，不再反复改产品结构；优先完成数据链路、前台实现、后台、真机测试与发布。

YUYU手作集是一个以真实手作作品为核心的个人创作者品牌小程序，用于展示作品、长期手作服务、创作者故事与联系方式。

作品 / Works

展示 YUYU 做过什么，强调图片浏览与作品详情。

手作服务 / Services

展示 YUYU 能长期提供什么体验、定制与合作。

YUYU

呈现主理人故事、合作创作者、品牌表达和联系入口。

首页 / Home

作为品牌入口，聚合作品、服务与品牌预览。

支付、购物车、订单、用户登录 / 账号体系、收藏、点赞、评论、用户上传内容、销量 / 浏览量 / 排行榜、分享奖励、即时预约排期、库存 / 名额、复杂团队权限、通用商城或 CMS 模板。

对 YUYU 手作作品感兴趣、希望了解作品故事、咨询类似定制、参加手作体验或寻求团体 / 品牌合作的人。

• 让用户快速、沉浸地浏览真实作品，并能自然进入作品详情。
• 让用户理解 YUYU 的创作方式、作品价值和可提供的长期服务。
• 提供透明但不电商化的价格参考与定制说明。
• 建立可持续维护的数据与后台结构，使后续新增作品无需改代码。
• 保护发布母图，前台仅接触 display / thumb，不暴露 source。

底部原生 TabBar 固定为：首页 ｜ 作品 ｜ YUYU。

「手作服务」不占底部 Tab，通过首页或 YUYU 页进入。作品详情、服务列表、服务详情均为二级页面。

首页

品牌总入口。Hero、分类入口、精选作品、手作服务预览、About YUYU。设计冻结

作品

沉浸式浏览。顶部轻量标签筛选 + 两列自然比例瀑布流。设计冻结

作品详情

完整看作品，再理解作品。连续图片流、作品信息、故事、价格、定制说明、联系 / 分享。设计冻结

手作服务

介绍长期服务。3 类服务卡片 + 详情入口 + 联系 YUYU。V1 冻结

YUYU

建立创作者关系。主理人故事、合作创作者、联系入口。V1 冻结

定位：YUYU 的品牌入口，视觉上约 80% 聚焦作品，20% 承担服务与品牌介绍。

• 保留品牌名称 YUYU手作集 / HANDMADE COLLECTION。
• Hero 以作品或创作氛围为主，不引入商城促销感。
• 提供作品分类入口与精选作品。
• 提供「一起做手作」服务入口。
• 提供 About YUYU 预览，导向 YUYU 页面。
• 不展示销量、浏览量、价格瀑布、搜索、购物车、账号入口。

定位：纯图片作品墙，优先视觉浏览，不把卡片做成电商信息卡。

• 顶部：作品 ALL WORKS + 横向轻量筛选。
• 当前标签：全部 / 奶油胶 / 串珠 / 其他。
• 选中态为浅裸粉胶囊 + 小圆点；未选中为普通文字。
• 主体为两列自然比例 Masonry；一件作品 = 一张封面图。
• 卡片不展示标题、作者、分类、材料、标签、编号、点赞、价格。
• 图片宽高由数据驱动，前端按列高分配；数据库不存列位置。
• 点击封面进入作品详情。

核心体验原则：先完整看作品，再了解它叫什么，以及为什么这样做。

• 极简导航 / 返回
• 作品全部图片按自然比例纵向连续排列；无圆角、无图片间距
• 点击图片进入原生全屏预览，可缩放 / 平移 / 切图，返回保持滚动位置
• 作品名称 → 创作者（创作 · YUYU，或联合创作 · YUYU × XXX）→ 它是什么品类 → 标签归类 → 所属系列（可选）
• 主要材料 → 创作灵感和故事 → 价格参考 → 参考价包含 → 价格说明
• 按标签解析后的手作定制说明 → 咨询类似定制 → 分享
• 返回作品列表 / BACK TO ALL WORKS

奶油胶手作体验

把喜欢的小世界与手作灵感，一点一点亲手做出来。
个人体验 / 好友同游 / 亲子手作

串珠手作体验

从喜欢的颜色与配珠开始，慢慢组合成属于自己的随身小物。
随身挂饰 / 闺蜜手作 / 个性定制

团体与品牌合作

为企业团队建设、节日沙龙、品牌跨界提供量身定制的手作体验工坊方案。
企业团建 / 节日专场 / 品牌沙龙

服务页不设计日期、场次、价格库存、报名人数、预约状态或订单；V1 本质是长期服务介绍。

• Hero：HANDMADE CREATOR / YUYU / 把喜欢的东西，慢慢做出来。
• About YUYU：主理人故事、创作动机与品牌表达。
• 一起做手作的人 / YUYU & FRIENDS：YUYU + 合作创作者小王子。
• 联系区：定制手作、手作体验或合作想法都可以联系 YUYU。
• 保留轻量品牌 Footer；不做团队门户、成员详情页或统计数据。

作品名称

文本 · 前台表现为标题 · 必填

作者

选择创作者，可多选 · 前台表现「创作 / 联合创作」· 支持 YUYU × 合作创作者

它是什么品类

自由文本 · 如：背包、纸巾盒 · 不建品类集合

标签归类

多选 · 奶油胶 / 串珠 / 其他 · 固定枚举

所属系列

单选，可空 · 服饰 / 家居 / 饰品 / 礼品等 · 后台可管理

主要材料

字符串数组 · 以自然文本或分隔展示 · 后台分项录入

创作灵感和故事

长文本 · 正文 · 作品叙事核心

价格参考

整数分 · 前台表现「¥178起」· 避免浮点金额

参考价包含

字符串数组 · 轻量 chips · 如载体 / 手工费 / 包邮

价格说明

长文本 · 正文 · 解释娃、载体、自备等差异

手作定制说明

按标签自动解析 · 固定说明块 · 不逐作品重复录入

目标：给用户足够透明的参考，而不把产品做成电商报价器。

价格组成可能涉及载体、娃 / 盲盒、材料、特殊配件、手工、邮费等；V1 不拆成复杂明细数据库。使用一个参考基础价 + 统一后缀 + 包含项 + 自由价格说明即可。

V1 正式集合仅保留 6 个，避免提前过度建模：

works

作品核心数据。creatorIds 数组；itemType 自由文本；tags 枚举；软删除；schemaVersion

creators

YUYU 与合作创作者。creator ≠ admin；被引用后归档而非硬删除

series

作品系列。后台可维护；允许归档

services

长期手作服务。无排期 / 库存 / 订单

settings

全局与页面配置。customization / pricing / yuyu / home

media_sources_private

私有发布母图记录。sourceFileId 只存在于此，普通用户不可读写

categories、crafts、materials、tags、prices、users、orders、appointments、favorites、comments、通用关系表、通用素材中心。

listWorks

只返回：workId、cover.thumbFileId、width / height、tags 等瀑布流必要字段
不返回：详情正文、sourceFileId、后台字段

getWorkDetail

只返回：公开作品字段、解析后的 creator / series / customizationNote、display 图片
不返回：sourceFileId、管理员数据、临时 URL

真正摄影原片永不上传 CloudBase。创作者在本地完成裁剪、调色、水印、压缩后，上传「发布母图 source」。

• source 与前台公共数据结构分离，sourceFileId 仅存在 media_sources_private。
• 普通小程序用户永远不应接触 sourceFileId。
• 数据库保存稳定 CloudBase fileID / path，不保存临时下载 URL。
• 图片记录宽高，保持自然比例；前端不强制裁成正方形。
• 原生图片预览不等于 DRM；只能降低直接获取母图的风险，无法阻止截图。
• 图片替换采用「新图生成成功 → 切换指针 → 再清理旧图」的顺序，避免更新失败造成断图。

• V1 支持作品详情分享给微信好友；朋友圈能力以开发时官方当前能力为准。
• 分享链接必须能定位到 workId。
• 从分享直接进入详情时，页面栈可能没有上一页；此时不得仅依赖 navigateBack。
• 需提供「进入作品集 / 回到首页」的 switchTab 兜底。
• 不存在、已归档、未发布作品显示友好失效状态。
• 不做分享次数、奖励、裂变机制。

后台是内部维护工具，不追求复杂 SaaS 能力。V1 仅需单管理员。

作品管理

新建 / 编辑作品、图片、作者、标签、系列、材料、故事、价格、保存草稿、发布 / 归档

手作服务

维护服务卡片、详情正文与图片

创作者

维护 YUYU 与合作创作者资料

系列管理

新增、排序、归档系列

页面设置

首页、YUYU 页、统一价格提示、奶油胶 / 串珠定制说明

图片后台流程：管理员上传已人工处理的 source，系统后续生成 display + thumb；不要求人工制作三套尺寸。

视觉方向：轻奢可爱画廊。高级约 60%，可爱约 40%。

• 原生微信小程序 + CloudBase。
• Stitch 仅作为视觉 / 布局参考，不直接复制 HTML / Tailwind 到原生小程序。
• CloudBase 环境配置集中管理，开发 / 生产环境在发布前分离。
• 数据库默认拒绝客户端写入；写操作通过受控后台 / 云端能力完成。
• V1 单管理员 allowlist，不引入复杂 RBAC。
• 列表查询避免 N+1；按真实查询设计最小索引。
• 不提前引入微服务、GraphQL、通用 CMS、复杂资源中心、DRM 等。

工程

QuickStart 与演示云函数已清理；三 Tab 可正常编译与切换；无项目代码报错

作品列表

真实 CloudBase 数据驱动；自然比例两列瀑布流；标签筛选正确；未发布 / 已删除不出现

作品详情

图片连续展示；全屏预览；字段与价格规则正确；source 不暴露

服务 / YUYU

与冻结文案和结构一致；无虚构预约、地址、微信号等

后台

可完成作品新增 → 草稿 → 发布 → 归档；可维护服务、创作者、系列、页面设置

安全

普通用户不能写正式数据；已知 source 路径 / fileID 也不能由普通身份读取

真机

主流手机下首屏、瀑布流、长图、预览、分享直达、返回路径均正常

产品定位与范围

完成 · 冻结，不再扩范围

Design System + 核心页面

基本完成 · 按冻结稿开发

QuickStart 清理 + 项目骨架

完成 · 正式基线 fe50536

Data Model + 安全边界

进行中 · 完成工程落地并验收

CloudBase + 真实作品链路

待开始 · 先用 2–3 个差异化真实作品跑通

正式前台 UI

待开始 · 优先 Works → Detail → Home

Services + YUYU

待开始 · 数据化实现

Web Admin + 图片链路

待开始 · 实现内部内容维护

真机测试 / 发布

待开始 · 性能、权限、异常、分享、审核准备

• 联系 YUYU 的最终能力：客服能力、合规二维码或其他方式，在接近发布时依据微信当时官方规则确认。
• 图片自动处理实现细节：display / thumb 的具体尺寸、格式和质量参数，在接入真实图片后通过真机性能测试确定。
• 开发 / 生产 CloudBase 环境拆分的具体时点：在正式数据与发布流程进入前完成。

YUYU手作集 V1 已具备足够清晰的产品边界、页面结构、数据模型与工程方向。

后续工作重点从「继续设计」转向「实现、验证、上线」。