🎲 GPS Tombola - Because Regular Bingo Wasn't Italian Enough! 🎄

🎯 What's This All About?

Welcome to GPS Tombola - the digital version of the traditional Italian Christmas game that's more fun than trying to convince your nonna that pineapple doesn't belong on pizza!

This isn't just any Tombola - it's a modern, cloud-native Tombola that runs on OpenShift. Because nothing says "Buon Natale" like containerized gaming! 🎅

🚧 Todos

• User Profile page (pass change, etc...)
• Enhance responsiveness
• Add translations with i18next
• Optimize CI/CD pipeline on frontend, building the ReactAPP only 1 time both for amd64 and arm64

✨ Features

• 🎮 Real-time multiplayer - Watch grandpa try to figure out how to unmute himself!
• 🎁 Multiple game variants - Because one way to play isn't Italian enough
• 🏆 Customizable prizes - From panettone to prosecco (digital ones, sorry!)
• 👮‍♂️ Admin controls - Someone has to be the boss (just like mamma)
• 📱 Responsive design - Play on any device, even on that ancient tablet from 2010

🛠 Tech Stack

• Frontend: React + TypeScript + PatternFly 6 (because we're fancy)
• Backend: NestJS + TypeScript + Typeorm (Just Love it)
• State Management: Zustand (because Redux is too 2020)
• Deployment: OpenShift + Helm (because we're enterprise-y)

🚀 Quick Start

Want to deploy faster than your uncle devours Christmas dinner? Here you go:

# Add our super-fancy Helm repo
helm repo add bingo https://github.com/gpillon/bingo-helm
helm repo update
# Deploy it like it's hot!
helm install bingo-chart bingo/bingo

🏗 Architecture

+---------------+ +---------------+ +---------------+
|               | |               | |               |
|   Frontend    -->   Backend     -->   Database    |
|  (React.js)   | |  (Node.js)    | |   (SQLite)    |
|               | |               | |               |
+---------------+ +---------------+ +---------------+
^                                                   ^
|                                                   |
+--------------- "Where's my number?" ------------->+

👥 The Dream Team

Created with ❤️ (and lots of caffè) by Me. We're the folks who thought: "Hey, let's modernize a centuries-old game because... why not?"

🧑‍💻 Developer Guide

TL;DR: To start the project, run npm run start:dev in both packages/bingo-be and packages/bingo-fe folders.

when running the backend yu can use the seed script to populate the database with some data with the following commands:

npm run seed

To run the frontend, use the following command:

npm run start:dev

To run the backend without needing to copy the admin password from the terminal at every start, use the following command:

export ADMIN_PASS=<admin password> && export JWT_SECRET=<jwt secret> && npm run start:dev

with the following environment variables:

• ADMIN_PASS: the password for the admin user (you can choose any string)
• JWT_SECRET: the secret for the JWT token (you can choose any string or generate one with openssl rand -base64 32)

🤝 Contributing

Found a bug? Want to add a feature? Know how to make the animations more pizzazz-y? We're all ears! Just:

1. Fork it
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request
6. Wait for our code review (while enjoying a cannoli)

📜 License

This project is licensed under the GNU GPL3 License - because sharing is caring, just like nonna's recipes!

🙏 Special Thanks

• To whoever invented coffee
• To our families for understanding our "just one more commit" moments
• To Stack Overflow (our true MVP)
• To that one developer who fixed that crucial bug at 3 AM (Me)

---

Made with 🍕 in Italy

Remember: In case of emergency, try turning it off and on again, or call your Italian grandmother.