Secret Santa 是一个**全栈 Web 应用**（非纯前端），专为组织圣诞节交换礼物活动而设计。 ### 技术架构 - **后端**: Node.js + Express - **前端**: HTML + JavaScript + Tailwind CSS - **存储**: 文件系统 (JSON) - **部署**: Docker 容器化 --- ## 🎯 核心功能 ### 1. 派对创建 - 创建 Secret Santa 派对 - 设置派对名称 - 设置预算限制（可选） - 设置礼物要求（可选） - 添加参与者名单 ### 2. 自动分配 - 智能随机分配礼物对象 - 确保无人被分配到自己 - 每人只分配一个礼物对象 - 分配结果永久保存 ### 3. 隐私保护 - 每位参与者获得独立的加密链接 - 链接使用 UUID 生成，无法猜测 - 只能查看自己的分配结果 - 完全保密，无法偷看他人 ### 4. 数据持久化 - 派对数据自动保存 - 容器重启数据不丢失 - 自动备份机制 --- ## 📖 使用指南 ### 场景 1: 我是派对组织者 #### 步骤 1: 访问应用 打开浏览器，访问应用网址（懒猫微服上部署后的域名） #### 步骤 2: 创建派对 1. 在主页面填写派对信息： - **派对名称**: 例如 "公司圣诞派对 2025" - **预算限制**: 例如 "$50" 或 "200元"（可选） - **礼物要求**: 例如 "环保主题" 或 "实用物品"（可选） 2. 添加参与者： - 点击 "Add Guest" 按钮 - 输入每位参与者的姓名 - **重要**: 至少需要 2 位参与者 - **重要**: 如果你自己也参加，记得把自己的名字也加进去！ - 最多支持 50 位参与者 3. 点击 "Create Secret Santa Party" 按钮 #### 步骤 3: 分享链接 创建成功后，你会看到每位参与者的专属链接： ``` 🎁 Alice 的链接: https://secretsanta.xxx.lzcapp/guest/abc-123-def 🎁 Bob 的链接: https://secretsanta.xxx.lzcapp/guest/xyz-789-uvw 🎁 Charlie 的链接: https://secretsanta.xxx.lzcapp/guest/mno-456-pqr ``` **重要提示**: - ✅ 复制每个人的专属链接 - ✅ 通过私聊、邮件或短信单独发送给对应的人 - ❌ **千万不要在群里公开发送所有链接！** - ✅ 你自己也需要使用自己的专属链接查看分配结果 #### 步骤 4: 提醒参与者 向每位参与者发送消息模板： ``` 🎅 圣诞快乐！ 你被邀请参加【公司圣诞派对 2025】的 Secret Santa 活动！ 📱 点击你的专属链接查看你的礼物对象： https://secretsanta.xxx.lzcapp/guest/abc-123-def 🎁 礼物预算: $50 📝 礼物要求: 环保主题 ⚠️ 请不要分享你的链接或透露你的礼物对象！ 期待在派对上见到你！🎄 ``` --- ### 场景 2: 我是参与者 #### 步骤 1: 收到邀请 你会收到组织者发送的专属链接，例如： ``` https://secretsanta.xxx.lzcapp/guest/abc-123-def-456 ``` #### 步骤 2: 查看分配 1. 点击链接打开网页 2. 立即看到你需要送礼物的对象 3. 页面会显示： - 🎁 你要送礼物给谁 - 💰 预算限制（如果有） - 📝 礼物要求（如果有） #### 步骤 3: 准备礼物 根据页面显示的信息准备礼物： - 控制在预算范围内 - 符合礼物要求 - 保守秘密！ #### 步骤 4: 保密 - ❌ 不要告诉别人你的礼物对象 - ❌ 不要分享你的专属链接 - ❌ 不要偷看别人的链接 - ✅ 享受神秘感！