依星源码资源网,依星资源网

 找回密码
 立即注册

QQ登录

只需一步,快速开始

福运盘济宁依星网络八字排盘系统智慧物流
查看: 7|回复: 0

宠物纪念园 · 功能说明 一个「3D 园区 + 纪念馆 + 纪念服务」的线上平台

[复制链接] 主动推送

3万

主题

3万

帖子

3万

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
35018
发表于 昨天 19:02 | 显示全部楼层 |阅读模式
# 宠物纪念园 · 功能说明

> 线上体验:<http://47.92.27.171:38017/>

## 1. 产品定位

宠物纪念园是一个「3D 园区 + 纪念馆 + 纪念服务」的线上平台:

- **用户**:为离世宠物建立纪念馆,在 3D 园区中拥有一块墓碑,随时进入园区祭奠、献礼、与其他访客同屏互动。
- **访客**:无需注册即可进入园区,以随机昵称漫游、查看公开纪念馆并献礼。
- **运营方**:通过管理后台审核内容、管理用户与订单、调整园区与墓位价格、配置邮件/短信与支付。

需要明确:本平台提供的是**数字纪念服务**,不包含实体安葬、火化或任何线下殡葬服务。

## 2. 角色与权限

| 角色 | 获得方式 | 主要权限 |
| --- | --- | --- |
| 访客 | 打开站点自动获得访客身份 | 进入 3D 园区、查看公开纪念馆、献礼、免费换装;不能建馆 |
| 注册用户 | 邮箱注册并登录 | 管理宠物档案、创建纪念馆、充值、购买装扮/祭品/墓碑款式、管理个人资料 |
| 馆主 | 创建纪念馆的用户 | 编辑纪念馆信息、更换墓碑与照片、管理协作者、查看全部献礼记录、删除纪念馆 |
| 协作者 | 馆主邀请 | 按 `admin` / `editor` / `viewer` 角色编辑或查看纪念馆内容 |
| 平台管理员 | 后台账号(`users.role = admin`) | 审核、用户/商品/订单/退款管理、系统设置、实时监控、审计日志 |

## 3. 功能总览

| 模块 | 功能 |
| --- | --- |
| 账号 | 邮箱注册、邮箱验证码、登录、自动续期、找回密码、访客会话、注销冷静期 |
| 宠物档案 | 新增/编辑/删除宠物,头像、类别、品种、性别、生日、离开日期、故事 |
| 纪念馆 | 建馆选位、墓碑造型、墓志铭、可见性、访问口令、访客献礼开关、删除与撤销 |
| 墓碑款式 | 12 款可切换造型,6 款免费 + 6 款付费永久解锁 |
| 宠物照片 | 碑面居中展示真实照片,支持上传/更换/删除,10 款相框可选 |
| 3D 园区 | 第一/第三人称漫游、区域提示、墓碑碰撞、点击查看、多人同屏、表情与短语、换装 |
| 献礼祭品 | 免费/付费祭品、匿名献礼、30 天有效期、到期自动消失、献礼与到期记录 |
| 萤火币 | 签到奖励、充值、余额消费、账单 |
| 商城 | 商品浏览、下单、支付、订单超时关闭、退款申请;含墓碑款式与照片相框 |
| 家庭协作 | 邀请成员、角色权限、越权拦截 |
| 管理后台 | 数据看板、内容审核、举报、用户、商品、订单、退款、实时监控、系统设置 |
| 多端 | Web、管理后台、移动端 App / H5 / 微信小程序(小程序 3D 降级为 2D 地图) |

## 4. 账号与身份

### 4.1 注册与登录

- **邮箱注册**:填写邮箱 → 获取验证码 → 设置昵称与密码(至少 8 位,建议含字母与数字)→ 确认年满 18 周岁或已取得监护人同意 → 同意昵称公开展示。
- **验证码**:6 位数字,默认 5 分钟有效;同一邮箱 60 秒内不可重复发送,每小时最多 5 次。
- **开发模式**:未配置邮件服务时,接口会在响应中返回 `dev_code`,页面直接显示验证码;生产环境未配置邮件服务会返回明确错误。
- **登录状态**:访问令牌过期会自动使用刷新令牌续期;只有服务端明确返回 401/403 才会退出登录。
- **找回密码**:邮箱验证码校验通过后可重置密码,并吊销该账号所有已登录会话。

### 4.2 访客身份

- 未登录用户进入园区时,服务端从两字昵称池中分配一个**全局不重复**的随机昵称(每批 3000 个,用完自动生成下一批;两字组合耗尽后回收 90 天未使用的昵称)。
- 同一浏览器通过本机 `pg_client_id` 保持同一昵称,便于献礼记录署名;同时在线重名时自动追加序号。
- 访客可以献礼,献礼记录会保留其随机昵称。

### 4.3 账号注销

- 提交注销后进入 **7 天冷静期**(可在后台调整),期间可撤销;到期由后台任务清理。

## 5. 宠物档案

- 支持为多只宠物建立档案:昵称、类别、品种、性别、出生日期、离开日期、头像、小故事。
- 宠物档案集中在「个人资料」页管理,可新增、编辑、删除。
- 若宠物已绑定纪念馆,需先删除对应纪念馆才能删除宠物档案。

## 6. 纪念馆与墓位

### 6.1 建馆流程

1. 选择一只宠物(或先创建宠物档案)。
2. 在 3D 园区选择空墓位,或由系统自动分配。
3. 选择墓碑造型、填写墓志铭、设置可见性。
4. 确认费用并支付(有免费名额时费用为 0)。
5. 纪念馆进入待审核状态,审核通过后在园区与列表公开展示。
6. 创建成功后自动进入 3D 园区并站到自己的墓碑前,墓碑带橙色「审核中」标识,无需自己再寻找。

### 6.1.1 我的墓碑与一键到达

- 登录用户进入园区时,除公开纪念馆外还会拉取本人全部纪念馆(含待审核、私密、仅链接可见),合并去重后渲染。
- 本人墓碑上方有金色光柱、地面光环与「我的纪念碑」悬浮标签;审核中为橙色,并显示「审核中 · 我的纪念碑」。光柱与标签仅本机可见。
- 待审核的纪念馆,其他访客也能在园区看到墓碑占位,并在上方显示橙色「审核中」标识;不展示馆名、简介、宠物造型与照片,也不能点开详情,避免提前泄露未审核内容。
- 审核通过后,占位墓碑自动变为正常纪念馆;删除申请冷静期内的纪念馆不再显示。
- 园区右上角「我的墓碑」按钮:未登录不显示;无纪念馆时引导创建;1 座纪念馆直接传送;多座纪念馆展开列表供选择。
- 传送后角色站到墓碑前,镜头朝向墓碑;创建成功跳转 `/garden?mine=1` 时同样自动定位。
- 顶部横幅在有审核中的纪念馆时提示「你有 N 座纪念馆正在审核中,已用橙色光柱标出位置」,可关闭。
- 纪念馆卡片为本人显示「我的纪念馆」徽标,审核中显示「审核中」,并提供「前往墓碑」按钮。
- 移动端 App/H5 行为一致(HUD「我的墓碑」按钮);微信小程序 2D 地图用金色「我」标记并支持点击查看。

### 6.2 墓位与价格

园区包含三个区域:

| 区域 | 说明 | 默认价格 |
| --- | --- | --- |
| 入口区 | 大门与主步道,不设墓位 | — |
| 中央花园区(C 区) | 中央环路外圈,祭品范围更大 | 99 萤火币 |
| 宠物纪念区(含草坪区 G 区) | 成排草坪墓位,园区主力区域 | 首个普通墓位免费,再次创建 88 萤火币 |

- 以上价格与「首个普通墓位免费」开关均可在管理后台「设置 → 墓位价格」中调整,前台标价与说明实时读取后台配置。
- C 区墓位不参与首次免费名额,始终按标价收费。
- 墓位价格从萤火币余额扣除,余额不足时无法完成建馆。

### 6.3 纪念馆设置

- 名称、墓志铭、宠物照片、故事、相册。
- 可见性:公开 / 仅链接可见 / 私密。
- 访问口令:可设置 4–32 位口令,访问时需输入。
- 允许访客献礼:关闭后仅馆主与协作者可献礼。
- 删除纪念馆:进入 7 天冷静期,期间可撤销。

### 6.4 墓碑款式(12 款)

在「创建纪念馆」或「个人中心 → 我的纪念馆 → 编辑 → 墓碑款式」中选择。免费款默认可用,收费款购买后永久拥有,可反复切换且不再扣费。

| 款式 | Code | 类型 | 价格(萤火币) |
| --- | --- | --- | --- |
| 素石 | `stone-simple` | 免费 | 0 |
| 圆石 | `stone-round` | 免费 | 0 |
| 拱门 | `stone-arch` | 免费 | 0 |
| 心形 | `stone-heart` | 免费 | 0 |
| 星光 | `stone-star` | 免费 | 0 |
| 木牌 | `stone-wood` | 免费 | 0 |
| 天使之翼 | `stone-wing` | 付费 | 12 |
| 静思书卷 | `stone-book` | 付费 | 18 |
| 古典立柱 | `stone-column` | 付费 | 28 |
| 莲华宝座 | `stone-lotus` | 付费 | 38 |
| 云顶塔碑 | `stone-pagoda` | 付费 | 48 |
| 天阙殿堂 | `stone-hall` | 付费 | 58 |

- 12 款均为独立 3D 几何与配色,付费款含翅膀、立柱、莲花、塔檐、殿堂等装饰。
- 预订墓位时选择的款式会被纪念馆继承。
- 管理员可在「设置 → 墓碑与相框」关闭「开放收费墓碑与相框」,关闭后前台只展示 6 款免费墓碑与 4 款免费相框。

### 6.5 宠物照片与相框(10 款)

- 在「个人中心 → 我的纪念馆 → 编辑」上传宠物照片,照片显示在墓碑正中;不上传时保持姓名与生卒日期的姓名牌外观。
- 支持 JPG / PNG / WebP,单文件不超过 10 MB;前端会先压缩到长边 1024px 再上传。
- 照片按 cover 方式居中裁切,不会拉伸变形;支持删除后恢复姓名牌。
- 相框共 10 款:

| 相框 | Code | 类型 | 价格(萤火币) |
| --- | --- | --- | --- |
| 无框 | `frame-none` | 免费 | 0 |
| 素木框 | `frame-wood` | 免费 | 0 |
| 圆银环 | `frame-round` | 免费 | 0 |
| 心形软框 | `frame-heart` | 免费 | 0 |
| 鎏金椭圆 | `frame-gold` | 付费 | 6 |
| 浮雕石框 | `frame-carved` | 付费 | 9 |
| 青铜回纹 | `frame-bronze` | 付费 | 12 |
| 珍珠贝壳 | `frame-pearl` | 付费 | 18 |
| 月桂冠 | `frame-laurel` | 付费 | 28 |
| 星辉王冠 | `frame-crown` | 付费 | 38 |

- 收费款式复用商城订单与萤火币扣款链路;退款会回收权益,并自动把使用中的纪念馆回退为 `stone-simple` / `frame-none`;使用中的款式需先更换才能申请退款。

### 6.6 家庭协作

- 馆主可生成邀请链接,为亲友分配 `admin`(管理成员与内容)、`editor`(编辑内容)、`viewer`(只读)角色。
- 协作者可查看纪念馆后台与献礼记录,权限不足时接口返回 403。

## 7. 3D 纪念园区

- **漫游**:WASD / 方向键移动,鼠标或触屏拖动转向,点击地面自动行走,支持第一/第三人称。
- **区域提示**:左上角实时显示当前所在区域(入口区 / 中央花园区 / 宠物纪念区),随角色坐标变化。
- **墓碑交互**:点击墓碑打开纪念馆卡片,可查看详情、献礼或进入纪念馆;碑面按所选款式渲染,有照片时展示照片与相框。
- **碰撞**:角色不可穿过墓碑、围墙、树木与建筑;墓位占地按带旋转矩形计算。
- **多人同屏**:WebSocket 实时同步,分区与分线,单分区软上限 30 人、硬上限 50 人;支持表情、预设短语与隐身。
- **换装**:40 件部件(发型、上装、下装、鞋、配饰),可调体型与肤色;免费换装无需登录,造型保存在本机并在园区生效。
- **墓位范围提示**:点击墓碑或空墓位时在地面绘制祭品摆放范围(虚线标识),C 区范围默认大于 G 区,宽/深可在后台「墓园场景」中调整;Web 与手机端 App/H5 使用同一套范围绘制。
- **我的墓碑标识**:本人纪念馆上方显示金色光柱、地面光环与「我的纪念碑」悬浮标签,审核中为橙色;标识仅本人客户端可见,不遮挡墓碑点击。
- **一键到达**:园区「我的墓碑」按钮可直接传送到本人墓碑前并调整镜头朝向;多座纪念馆时可选择目标;`?mine=1` 与 `?memorial=<slug>` 均支持自动定位。
- **软广告位**:园区内「福运盘」摆件,点击新窗口打开 <http://www.fuyunpan.cn>。

## 8. 献礼与祭品 30 天规则

- 任何访客或用户都可以向公开纪念馆献礼,可选择实名或匿名。
- 每件祭品从放置时刻起独立计算 **30 天**有效期;到期后自动从墓碑前消失,但记录保留。
- 墓碑主人可以在「我的祭品记录」查看自己收到的全部祭品及其剩余天数。
- 献礼者可以在「献礼记录」查看自己送出的祭品。
- 馆主可查看该纪念馆的祭品统计:有效数量、已过期数量、累计有效天数。
- 到期清理由后台 worker 定时执行,同时查询接口会按 `expires_at` 过滤,保证到期即不再展示。

## 9. 萤火币与商城

- **萤火币**:站内虚拟币,1 萤火币 = 1 元人民币,名称可在后台修改。
- **获取**:每日签到(默认 1 萤火币,后台可调)、充值。
- **充值方式**(后台切换):
  - 二维码收款:展示支付宝/微信收款码,用户提交金额与付款凭证,管理员审核后到账。
  - 支付参数收款:配置支付宝/微信商户参数后在线支付,回调自动到账。
- **消费场景**:墓位、换装部件、祭品、商城商品、墓碑款式、照片相框。
- **商城**:商品列表/详情、下单、支付、订单超时自动关闭(默认 30 分钟)、7 天内可申请退款(后台可调)。
- 墓碑款式与照片相框在商城「墓碑款式与照片相框」区块展示,购买入口同时出现在纪念馆编辑页。

## 10. 管理后台

| 模块 | 功能 |
| --- | --- |
| 数据看板 | 用户、纪念馆、订单、收入等核心指标 |
| 内容审核 | 纪念馆、照片/媒体审核,通过或拒绝并填写原因 |
| 举报处理 | 查看举报、处理并记录结果 |
| 用户管理 | 搜索用户、查看详情、禁用/启用、角色调整 |
| 纪念馆管理 | 列表展示墓碑照片缩略图,支持预览 |
| 商品与订单 | 商品上下架、类型标签(装扮/墓碑款式/照片相框)、订单查询、退款审核 |
| 实时监控 | 在线人数、分区负载、连接状态 |
| 操作审计 | 管理员关键操作留痕 |
| 系统设置 | 见下表 |

系统设置分组(保存后前台即时生效):

| 分组 | 主要配置 |
| --- | --- |
| 基础信息 | 站点名称 |
| 墓园场景 | 园区宽/深、标准墓碑与 C 区墓碑的祭品范围宽/深 |
| 墓位价格 | C 区价格、纪念区价格、首个普通墓位免费开关 |
| 墓碑与相框 | 是否开放收费墓碑与付费相框 |
| 邮件服务 | SMTP 主机/端口/账号/密码/发件人、启用开关;也可用 `SMTP_*` 环境变量配置 |
| 短信服务 | 短信 Webhook 地址、令牌、内容模板 |
| 账号安全 | 注册是否必须验证邮箱、验证码有效期 |
| 数据策略 | 纪念馆删除冷静期、账号注销冷静期、导出文件有效期 |
| 3D 场景 | 外部 GLB 模型地址、环境贴图地址 |
| 萤火币与充值 | 币名、签到奖励、最低充值、收款方式、收款码或支付参数 |

## 11. 关键业务规则

| 规则 | 说明 |
| --- | --- |
| 祭品有效期 | 30 天,按单件放置时间独立计算,到期隐藏但保留记录 |
| 首个墓位免费 | 每个账号第一次在非 C 区建碑免费,可在后台关闭 |
| C 区收费 | 始终按后台设置的 C 区价格收费,不占免费名额 |
| 付费款式 | 一次购买永久拥有;未拥有时选择返回 409 `E-6402`;退款回收并回退纪念馆 |
| 访客昵称 | 服务端统一分配,两字、全局不重复、每批 3000 个 |
| 纪念馆删除 | 7 天冷静期,可撤销 |
| 账号注销 | 7 天冷静期,可撤销 |
| 订单超时 | 默认 30 分钟未支付自动关闭 |
| 退款窗口 | 支付后 7 天内可申请 |

## 12. 移动端(微信小程序 / Android / iOS / H5)

移动端位于 `apps/mobile`,使用 uni-app(Vue 3 + TypeScript + Vite),与 Web 共用同一套后端接口与业务规则。

| 功能 | 小程序 | App | 说明 |
| --- | --- | --- | --- |
| 邮箱注册/登录 | 支持 | 支持 | 与 Web 共用账号 |
| 微信小程序一键登录 | 支持 | — | 服务端 `jscode2session` 换取 openid,未配置 AppID 时隐藏入口 |
| Apple 登录 | — | iOS 支持 | 校验 Apple `identity_token` 与 JWKS;未配置 Bundle ID 时隐藏入口 |
| 首页 / 纪念馆列表 / 详情 / 献礼 | 支持 | 支持 | 献礼沿用 30 天有效期与审核规则 |
| 创建纪念馆 / 宠物档案 | 支持 | 支持 | 支持选位、款式选择(含购买)、显示后台墓位价格与首碑免费规则 |
| 个人中心 / 钱包签到 | 支持 | 支持 | 余额与充值记录只读 |
| 园区浏览 | 2D 俯视地图 | 完整 3D | App/H5 通过 renderjs 运行与 Web 相同的 three.js 场景(拖动旋转、双指缩放、点击地面移动、点击墓碑显示地面虚线范围与底部操作卡,墓碑进详情、空位直接建馆),并与 Web 共用 12 款墓碑 + 10 款相框渲染;小程序首版保持 2D |
| 虚拟币充值 | 默认关闭 | 待接入 | 小程序需虚拟支付资质;iOS 必须走 App Store 内购 |

平台合规约束:微信小程序 iOS 端不提供虚拟支付;iOS App 的虚拟币充值只能通过 IAP,服务端 `POST /payments/iap/verify` 已完成收据校验与幂等入账,客户端内购入口随 M3 上线。

## 13. 技术特性

- **前后端分离**:Go API、独立 WebSocket 网关、独立定时任务进程;管理后台与前台、H5 由同一 nginx 分发。
- **3D 全程序化**:`packages/garden-core` 使用 Three.js 几何体 + CanvasTexture 生成园区、12 款墓碑、10 款相框与照片贴图,无需外部模型文件;Web 与移动端 App/H5 共用同一份代码。
- **实时同步**:10Hz 状态广播,msgpack 编码,Redis Pub/Sub 支持多实例。
- **安全**:JWT 双令牌、接口限流、越权校验、上传类型与大小限制、管理员操作审计。
- **数据**:PostgreSQL 持久化,Redis 缓存与限流,MinIO/本地磁盘存储上传文件。
- **可配置**:园区尺寸、墓碑范围、墓位价格、墓碑/相框收费开关、邮件/短信、支付方式均无需改代码。
- **多端**:Web 与 uni-app 移动端共用 `packages/shared` 类型与 `packages/api-client` 请求层,一套代码编译到微信小程序、Android、iOS 与 H5。

---

相关文档:

- [源码编译与环境搭建](源码编译与环境搭建.md)
- [架设与环境搭建说明](架设与环境搭建说明.md)
- [使用说明与环境搭建](使用说明与环境搭建.md)
- [墓碑款式与照片相框改造计划](墓碑款式与照片相框改造计划.md)
- [微信公众号宣传文案](宣传文档-微信公众号.md)
- [项目 README](../README.md)
- [测试报告](测试报告.md)


扫码关注微信公众号,及时获取最新资源信息!【下载附件优惠:VIP会员6折;永久VIP4折】
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

免责声明:
1、本站提供的所有资源仅供参考学习使用,版权归原著所有,禁止下载本站资源参与商业和非法行为,请在24小时之内自行删除!
2、本站所有内容均由互联网收集整理、网友上传,并且以计算机技术研究交流为目的,仅供大家参考、学习,请勿任何商业目的与商业用途。
3、若您需要商业运营或用于其他商业活动,请您购买正版授权并合法使用。
4、论坛的所有内容都不保证其准确性,完整性,有效性,由于源码具有复制性,一经售出,概不退换。阅读本站内容因误导等因素而造成的损失本站不承担连带责任。
5、用户使用本网站必须遵守适用的法律法规,对于用户违法使用本站非法运营而引起的一切责任,由用户自行承担
6、本站所有资源来自互联网转载,版权归原著所有,用户访问和使用本站的条件是必须接受本站“免责声明”,如果不遵守,请勿访问或使用本网站
7、本站使用者因为违反本声明的规定而触犯中华人民共和国法律的,一切后果自己负责,本站不承担任何责任。
8、凡以任何方式登陆本网站或直接、间接使用本网站资料者,视为自愿接受本网站声明的约束。
9、本站以《2013 中华人民共和国计算机软件保护条例》第二章 “软件著作权” 第十七条为原则:为了学习和研究软件内含的设计思想和原理,通过安装、显示、传输或者存储软件等方式使用软件的,可以不经软件著作权人许可,不向其支付报酬。若有学员需要商用本站资源,请务必联系版权方购买正版授权!
10、本网站如无意中侵犯了某个企业或个人的知识产权,请来信【站长信箱312337667@qq.com】告之,本站将立即删除。
郑重声明:
本站所有资源仅供用户本地电脑学习源代码的内含设计思想和原理,禁止任何其他用途!
本站所有资源、教程来自互联网转载,仅供学习交流,不得商业运营资源,不确保资源完整性,图片和资源仅供参考,不提供任何技术服务。
本站资源仅供本地编辑研究学习参考,禁止未经资源商正版授权参与任何商业行为,违法行为!如需商业请购买各资源商正版授权
本站仅收集资源,提供用户自学研究使用,本站不存在私自接受协助用户架设游戏或资源,非法运营资源行为。
 
在线客服
点击这里给我发消息 点击这里给我发消息 点击这里给我发消息
售前咨询热线
312337667

微信扫一扫,私享最新原创实用干货

QQ|免责声明|小黑屋|依星资源网 ( 鲁ICP备2021043233号-3 )|网站地图网站统计

GMT+8, 2026-11-22 12:41

Powered by Net188.com X3.4

邮箱:312337667@qq.com 客服QQ:312337667(工作时间:9:00~21:00)

快速回复 返回顶部 返回列表