VIE Gallery
V1 已验收 · 持续迭代把私人影像整理成可长期保存、自然浏览、受控分享的个人空间。
个人相册产品：admin + viewer 双端。原图保存、相册整理、2D/3D 空间展示、受控链接分享。
项目概览
- 问题
- 私人照片散落在聊天记录和网盘里，长期保存、整理和分享都受制于人。
- 对象
- 管理相册的内容创作者，以及通过受控链接访问的受邀访客。
- 范围
- admin 管理端 + viewer 浏览端，双端产品。
产品体验
管理流程
- 上传照片，原图直接入库保存
- 在展厅工作台配置氛围、封面与排序
- 发布展厅，进入访客可见状态
- 生成带访问模式与有效期的受控分享链接
浏览流程
- 打开受控链接进入展厅
- 在经典网格与 3D 空间之间自由切换
- 通过系统分享或复制链接转发给朋友
核心能力
原图留存
上传即保存原图，照片长期留存不受展示压缩影响。
相册整理
上传、封面、排序与标题修改在展厅工作台一次完成。
2D / 3D 浏览
经典网格与 3D 空间两种浏览方式，访客可自由切换。
受控分享
分享链接支持访问模式与有效期配置，默认禁止访客下载。
系统实现
前端使用 Vue 3 与 Three.js 构建 admin 工作台与 viewer 的 3D 空间浏览；后端由 Spring Boot 与 MyBatis-Plus 提供服务；Docker 承担本机部署与自动化门禁。
验证与结果
- 2026-09-12：双端达到 V1 Ready，验收通过。
- M7.5 综合回归在本机 Docker + 自动化门禁下通过。
开发日志
推荐场景开箱即用与首次发布引导
新增推荐场景预设：未配置的画廊由 admin 自动种入、viewer 免服务端配置兜底渲染，开箱即用；发布链路新增草稿/发布状态标识与一键发布，并以就绪横幅引导新用户完成首次发布，氛围选项卡改为场景卡优先、细调收进高级区；8 张场景背景图替换为写实风格素材，修复预览重载与启动状态稳定性。
Vue 3Three.js场景背景分层加载、启动提速与投影修复
viewer 场景背景支持半分辨率变体与缩略图分层加载，素材带版本参数防旧缓存，舞台画廊与实时预览启动提速；修复全景投影与旋转恢复、旧版背景 schema 兼容、背景请求竞态与纹理释放、admin 配置侧板还原，并补背景旋转 e2e 验收；移除品牌站特性（admin 视图与后端配置一并下线）。
Three.jsVue 3viewer 内置 8 套场景背景，配置面板支持预览选用
viewer 预置极简空间、森林之梦、星空夜曲等 8 套全景场景背景图与配套预设，配置栏与 3D 球幕渲染共用；admin 配置中心场景面板支持背景预览与选用，并补充场景面板 e2e 验证。
Three.jsVue 3查看器新增照片墙视图，照片标题搜索与筛选安全优化
viewer 新增照片墙浏览视图，灯箱弹窗与查看器引擎、布局插件同步重构；admin 图库工作台支持照片标题搜索与状态筛选并做安全优化；两端补充 e2e 验证。
Vue 3Three.js品牌站模板体系全链路落地
5 套品牌站模板在渲染端、后端与 admin 工作区全链路打通；修复 demo 图片在 /site/ 部署路径下的 404（补齐 base 前缀）与暗房区块标题样式。
Vue 3Spring Bootviewer 氛围渲染升级与 admin 图库工作区增强
viewer 新增萤火虫/流星粒子、星迹拖尾与开场电影运镜及光照时段配置，配置中心支持下发相机自转与主题点缀色并实时预览，移除冗余的空间背景主题配置；admin 图库工作台支持拖拽排序、上传进度与原图查看；修复生产形态下预览 iframe 端口丢失导致握手失败。
Three.jsVue 3分享支持微信 / QQ 传播
分享链接支持微信扫码与 QQ 一键分享，修复微信/QQ 分享卡片与访客端转发引导；清理赛博朋克残留外壳样式与未引用遗留组件；compose 传入本地安全密钥环境变量修复 API 启动。
Vue 3Docker短链生成与 token 轮换，部署迁移冲突修复
分享链接支持短链生成与历史链接 token 轮换，短链公开路由放行与配置容错；定位并解决 V14/V15 Flyway 迁移冲突，API 健康检查失败可诊断。
Spring BootDocker短链接功能实现与 admin 动效打磨
API 实现分享短链接，修复海报预签名 URL 超出 OSS 7 天上限与 CJK 字体缺失；admin 批量卡片倾斜逻辑简化、界面视觉与交互动效增强；部署链路补齐 raw_token 迁移与 API 健康诊断。
Spring BootVue 3Docker分享海报生成全链路完成（WP-12.1）
admin 新增海报生成入口，API 完成海报生成：取真实照片 URL、跨平台字体与详细错误处理；OSS 预签名 URL 设置 Content-Type / Content-Disposition 支持浏览器直览，上传超时放宽至 120s，部署切换 SSL nginx 并消除周期性 502。
Spring BootVue 3Docker生产存储切换阿里云 OSS 并加密 API 数据
生产环境接入阿里云 OSS 对象存储与安全环境变量，API 实现数据加密，预签名 URL 修复双重签名并显式指定 GET；沉淀部署排障指南与一键 502 修复脚本；回退未完成的 URL 存储特性。
Spring Boot阿里云 OSSDocker生产部署链路落地：Docker 化与 CI/CD
新增部署配置、CI/CD workflow 与生产环境模板；修复 Maven 多模块镜像构建、MinIO 镜像源、容器卷路径与 admin/viewer 静态资源代理规则。
DockerSpring BootWeek 1 交付：viewer 渲染增强（WP-10）
动态光照、照片过渡动画、粒子性能优化与 Bloom / Fog 艺术调校（WP-10.1~10.4）完成，Week 1 以 demo 模式实测验收收尾；配置面板按反馈重构并加入点击涟漪，修复全屏预览 iframe 未铺满与无效纹理配置。
Three.jsVue 3修复分享链接主机栏与用户菜单点击失效
viewer 分享链接主机栏与用户菜单恢复可点击。
Vue 3admin 请求超时与创建弹窗交互加固
gallery-admin 加固请求超时处理与创建弹窗交互。
Vue 3V1 签收：个人相册 V1 Ready 验收通过
双端（admin 工作台 / viewer）达到 V1 Ready：原图保存、相册管理、2D/3D 展示、受控链接分享、上传任务中心、配置版本化与资源变体通过真实环境验收；M7.5 综合回归在本机 Docker + 自动化门禁下通过。
Vue 3Three.jsSpring BootMyBatis-PlusDocker