Secret Santa

Secret Santa is a ** full-stack Web application **(non-pure front-end) designed specifically for organizing Christmas gift exchange events. ###Technical Architecture - ** Backend **: Node.js + Express - ** Front-end **: HTML + JavaScript + Tailwind CSS - ** Storage **: File System (JSON) - ** Deployment **: Docker containerization --- ##Core functions ### 1. Party creation - Create a Secret Santa Party - Set party name - Set budget limits (optional) - Set gift requirements (optional) - Add a list of participants ### 2. automatically assigned - Intelligent random allocation of gift objects - Make sure no one is assigned to you - Each person is assigned only one gift object - Allocation results are saved permanently ### 3. Privacy Protection - Each participant gets an independent encrypted link - Links are generated using UUID and cannot be guessed - You can only view your own allocation results - Completely confidential, no peeping at others ### 4. data persistence - Party data is automatically saved - Container restart data is not lost - Automatic backup mechanism --- ##User Guide ###Scenario 1: I am the party organizer ####Step 1: Access the application Open the browser and visit the application URL (the deployed domain name on Lazy Cat Micro Service) ####Step 2: Create a party 1. Fill in the party information on the main page: - ** Party name **: For example,"Company Christmas Party 2025" - ** Budget limit **: For example,"$50" or "$200"(optional) - ** Gift requirements **: For example,"environmental theme" or "practical items"(optional) 2. Add participants: - Click on the "Add Guest" button - Enter the name of each participant - ** Important **: At least 2 participants are required - ** Important **: If you participate yourself, remember to add your name! - Support up to 50 participants 3. Click the "Create Secret Santa Party" button ####Step 3: Share links After successful creation, you will see a unique link for each participant: ``` 🎁Alice's link: https://secretsanta.xxx.lzcapp/guest/abc-123-def 🎁Bob's link: https://secretsanta.xxx.lzcapp/guest/xyz-789-uvw 🎁Charlie's link: https://secretsanta.xxx.lzcapp/guest/mno-456-pqr ``` ** Important Tips **: - Copy everyone's exclusive link - Send it individually to the corresponding person via private chat, email or text message - * * Don't publicly send all links in the group!** - You also need to use your own exclusive link to view the allocation results ####Step 4: Remind participants Send message templates to each participant: ``` Merry Christmas! You are invited to participate in the Secret Santa event of [Company Christmas Party 2025]! Click on your exclusive link to view your gift recipients: https://secretsanta.xxx.lzcapp/guest/abc-123-def Gift budget: $50 Gift requirements: Environmental theme ˇPlease do not share your links or reveal your gift recipients! Looking forward to seeing you at the party!🎄 ``` --- ###Scenario 2: I am a participant ####Step 1: Receive an invitation You will receive exclusive links from the organizer, such as: ``` https://secretsanta.xxx.lzcapp/guest/abc-123-def-456 ``` ####Step 2: View allocations 1. Click on the link to open the web page 2. Immediately see who you need to send a gift to 3. The page will display: - 🎁Who are you giving gifts to? - 💰Budget constraints (if any) - Gift requirements (if any) ####Step 3: Prepare the gift Prepare gifts according to the information displayed on the page: - Stay within budget - Meets gift requirements - Keep it secret! ####Step 4: Keep it confidential - Don't tell anyone about your gift recipients - Don't share your exclusive links - Don't peek at other people's links - Enjoy the mystery!