《珅玉定制》APP 功能开发历程（课程大作业版）

这篇内容是我的《中国玉石与玉文化鉴赏》课程大作业说明文档。老师要求我不仅展示结果，还要说明选题背景、功能设计思路、实现路径与最终落地效果。

所以我采用“模块化功能说明”的方式来写：每个模块都讲清楚我做了什么、怎么实现、解决了什么问题。

更加详细的版本可以看这篇文章：https://pub-fae7c18af59f40679cbe76ee23a170c8.r2.dev/%E5%90%8C%E6%B5%8E/%E7%8E%89%E7%9F%B3%E5%A4%A7%E4%BD%9C%E4%B8%9A/2352396-%E7%A6%B9%E5%B0%A7%E7%8F%85-%E7%8F%85%E7%8E%89%E5%AE%9A%E5%88%B6APP.pdf

课程背景与作业要求

课程背景

《中国玉石与玉文化鉴赏》这门课关注的不只是玉器本身，也包括玉文化在审美、礼仪、寓意与现代传播中的延展。

我做《珅玉定制》APP 的出发点，是把课程里的文化理解转成一个可交互、可体验、可展示的数字化产品。

本次大作业要求（我在文档中逐项对应）

• 选题要与玉文化主题相关；
• 要有清晰的功能设计，不只是概念展示；
• 要体现实现过程与功能落地方式；
• 要能展示最终效果与应用价值。

下面我会按“用户端四大模块 + 管理后台模块”展开，重点放在功能实现。

---

一、用户端四大模块（珅玉定制）

模块 1：灵感首页模块

功能目标

这个模块要解决两个问题：

• 新用户进入后，不知道从哪里开始；
• 老用户需要快速回到常用风格。

核心功能

• 首页轮播内容运营化（后台可配置）；
• 「猜你想做」推荐卡片；
• 从首页一键跳转到定制流程。

我怎么实现

• 首页轮播数据改为后台配置读取，不再硬编码在前端。
• 对轮播资源做 URL 合法性校验，只接受 http/https。
• 当后台清空轮播时，前台保持空态展示，不再回退旧图，保证“后台即线上”。
• 推荐模块基于模板预设与历史线索进行轻量排序，提升命中率。

用户价值

用户打开 APP 后可以立即得到“可点击、可生成”的入口，不会卡在第一步。

---

模块 2：定制表单模块

功能目标

把用户模糊需求转成结构化输入，让 AI 生成更稳定。

核心功能

• 材质、纹样、形制、预算、送礼对象等参数输入；
• 模板中心一键填参；
• 推荐卡片点击后自动带入参数并进入定制页。

我怎么实现

• 用统一状态对象管理全部输入字段，提交时单次打包，避免参数遗漏或错位。
• 建立 TEMPLATE_PRESETS 预设集合，作为推荐与模板中心的共同数据源。
• 应用模板时同时更新表单与页面跳转状态，减少用户手动操作。

用户价值

用户从“有想法”到“可提交”的路径更短，输入成本大幅下降。

---

模块 3：AI 生成与评级模块

功能目标

把一次定制请求做成完整链路：文本设计 -> 图片生成 -> AI 评级。

核心功能

• 生成设计说明与方案文案；
• 生成玉雕效果图；
• 输出 AI 评级结果与解释。

我怎么实现

• 后端按阶段串联生成逻辑，前端统一调度请求流程。
• 进度反馈采用三阶段：plan -> image -> rating。
• 进度条做了阶段动画与节奏调优，避免“卡住感”和“瞬间跳满”。
• 根据用户反馈延长图像阶段感知时长，使等待体验更自然。

用户价值

用户可以清楚知道系统当前在做哪一步，结果不仅有图，还有可解释的评级。

---

模块 4：玉苑模块

功能目标

这个模块下存放了课程中提到的多种自然玉石的真实照片，以及多个玉雕大师的真实玉雕作品，旨在让用户能够更好地领略到玉石之美！

核心功能

• 分为两个大的模块：自然玉石，玉雕作品
• 点击之后可以查看具体地大图和介绍
• 用户可以在搜索框搜索想要的玉石或者玉雕作品，就可以快速筛选

模块 5：作品管理模块（查看、收藏、历史）

功能目标

让用户对生成结果可复看、可比较、可沉淀，而不是“一次性产物”。

核心功能

• 当前作品详情查看；
• 历史作品列表与详情；
• 收藏列表与详情；
• 图片点击放大预览与保存。

我怎么实现

• 用统一预览弹层覆盖当前作品、历史详情、收藏详情三类入口。
• 图片支持点击放大，移动端可长按保存，并保留下载入口。
• 预览态独立管理，切换页面后自动清理，避免旧图残留。
• 生成过程中的页面交互做约束：只在必要阶段锁定滚动，不影响非生成场景。

用户价值

用户可以持续回看和复用成果，提升作品资产沉淀能力。

---

二、管理后台模块

后台模块 1：事项审批模块

核心功能

• 对用户的申请进行审批

---

后台模块 2：用户管理模块

核心功能

• 用户存在性校验；
• 用户额度调整

我怎么实现

• check-user-exists 改为循环分页查询，避免用户量变大后漏查。
• 增加分页上限和超时保护，防止异常循环。
• 对关键管理接口做身份与角色校验，限制非管理员访问。

价值

后台数据和操作权限更可靠，降低误操作与越权风险。

---

后台模块 3：公告发布与活动发布

核心功能

• 配置变更后前后端联动生效；
• 发布后快速校验核心功能。
• 可以选择对单个或者所有用户发布。
• 可以选择发布公告或者活动的优先级。

我怎么实现

• 把前台需要的动态参数集中到配置层管理。
• 每次变更后执行“功能验证 -> 构建验证 -> 线上核对”的固定流程。
• 前端与函数服务分别部署，但通过统一数据契约保持一致。

价值

配置可持续迭代，且不会因为联动失配影响线上稳定性。

---

后台模块 4：评级概率调整

核心功能

• 支持直接调整卡片的评级概率。

---

后台模块 5：玉苑管理模块

核心功能

• 可以通过这里粘贴图片链接来直接发布到用户的玉苑界面。
• 可以添加最多6张轮播图到首页。
• 方便后续有更多的图片的时候可以正常添加使用。

---

三、总结：珅玉定制当前能力版图

我把《珅玉定制》做成了“前台四模块 + 后台五模块”的完整功能体系：

• 前台负责获客、输入、生成、沉淀；
• 后台负责运营、校验、配置、演进；
• 两端通过统一数据与发布流程保持一致。

接下来我会继续围绕“功能可用性 + 体验精细化 + 后台可运营性”推进，让每个模块都更稳定、更顺滑。