cmintey/wishlist

Wishlist

概述

Wishlist是一款自托管的愿望清单应用，可与朋友和家人分享。你不再需要纠结节日给父母买什么礼物——只需查看他们的愿望清单，认领任何可用物品即可。简洁的用户界面让长辈也能轻松使用！

核心功能

• ✅ 认领愿望清单中的物品
• ✅ 将已认领物品标记为已购买
• ✅ 从URL自动获取产品数据
• ✅ 通过邮件邀请用户（需配置SMTP）
• ✅ 支持建议功能（多种模式）
• ✅ PWA支持（可添加到手机主屏幕）
• ✅ 群组支持
• ☐ 支持“秘密圣诞老人”抽签功能（待开发）

使用场景

• 家庭节日礼物清单：亲友间分享愿望，避免重复购买
• 朋友聚会礼物：提前收集大家的愿望，方便准备礼物
• 团队活动：如公司年会交换礼物，使用秘密圣诞老人模式

部署说明

使用Docker Compose快速部署：

创建docker-compose.yaml文件：

yaml
version: "3"

services:
  wishlist:
    container_name: wishlist
    image: ghcr.io/cmintey/wishlist:latest
    ports:
      - 3280:3280
    volumes:
      - ./uploads:/usr/src/app/uploads  # 存储用户上传的图片
      - ./data:/usr/src/app/data        # 存储SQLite数据库
    environment:
      ORIGIN: https://wishlist.example.com # 用户访问的URL
      TOKEN_TIME: 72 # 注册和密码重置令牌的有效期（小时）

执行命令启动：docker compose up -d，然后通过http://<主机IP>:3280访问应用。

注意
务必设置ORIGIN环境变量为用户实际访问的URL，否则可能出现功能异常。

群组功能

Wishlist支持多个愿望清单群组，例如“朋友”和“家人”群组，清单内容完全独立。点击头像可通过菜单切换群组。

任何人都可创建群组，创建者自动成为群组“管理员”。管理员可邀请用户加入群组、添加/移除成员、删除群组。系统管理员拥有与群组管理员相同的权限。

配置说明

管理员面板提供多种配置选项：

公开注册

默认允许任何人通过URL注册账号。可关闭此功能，改为邀请制。
若已配置SMTP，可输入用户***发送邀请链接；否则需手动生成链接并发送。

建议功能

默认启用建议功能，允许向他人的愿望清单添加物品，支持三种模式：

• 需审批：建议物品需被建议人批准后才显示在其清单中，批准后可编辑或删除。
• 自动审批：建议物品自动添加到清单，被建议人可编辑或删除。
• 惊喜模式：建议物品自动添加，但仅对除被建议人外的用户可见，被建议人无法查看、编辑或删除。

SMTP配置

SMTP非必需配置，但启用后可支持邮件邀请用户和密码重置功能。未配置时，仍可手动生成邀请和密码重置链接。