FortunaISK

A comprehensive lottery system for Alliance Auth that brings excitement and community engagement to your corporation or alliance. Run fair, transparent lotteries with automated management and real-time tracking.

<hr />

✨ Features

🎲 Easy Lottery Participation

• Simple ISK Transfer System - Just send money with the lottery reference in the reason
• Real-time Ticket Tracking - Monitor your purchases and remaining allowances
• Personal Dashboard - Complete history of tickets, winnings, and payments
• Automatic Notifications - Get notified instantly when you win

🏆 Flexible Prize Distribution

• Multi-winner Support - Configure multiple winners per lottery
• Custom Prize Percentages - Set exact prize distribution for each winner
• Automated Calculations - System handles all prize calculations automatically
• Transparent Results - Public winner announcements with full details

⚡ Automated Management

• Recurring Lotteries - Set up lotteries that run automatically on schedule
• Smart Payment Processing - Automated validation and anomaly detection
• Lifecycle Management - Automatic transitions from active to completed
• 24-hour Reminders - Automated closure notifications

📊 Administrative Excellence

• Rich Admin Dashboard - Real-time statistics and system monitoring
• Anomaly Resolution - Advanced tools to handle payment discrepancies
• Prize Distribution Tracking - Monitor and confirm prize deliveries
• Comprehensive Audit Trails - Complete logging of all actions
• CSV Export - Export participant and winner data

🔔 Discord Integration

• Rich Notifications - Beautiful embeds for all lottery events
• Winner Announcements - Automatic celebration of lottery results
• Admin Alerts - Immediate notification of anomalies or issues
• Customizable Webhooks - Configure notifications for your community

<hr />

📋 Requirements

• Alliance Auth v4.0+
• Alliance Auth Corp Tools - For wallet integration
• AA Discord Notify (Optional) - For Discord notifications

<hr />

🚀 Installation

Step 1 - Install the Package

pip install fortunaisk

Step 2 - Configure Settings

Add the following to your Alliance Auth's local.py:

# Add to INSTALLED_APPS
INSTALLED_APPS += [
    "fortunaisk",
]

Step 3 - Finalize Installation

python manage.py migrate
python manage.py collectstatic

Restart your Alliance Auth instance:

supervisorctl restart all

Step 4 - Setup Permissions

Visit your admin interface and assign permissions to appropriate groups:

Permission	Purpose
fortunaisk \| Can access FortunaISK	Basic lottery participation
fortunaisk \| Can admin FortunaISK	Full administrative access

Step 5 - Configure Discord (Optional)

Visit /admin/fortunaisk/webhookconfiguration/ to set up Discord notifications.

<hr />

🎮 How to Use

For Players

1. 🔍 Find Active Lotteries - Check the lottery page to see what's currently running
2. 🎫 Buy Tickets - Send ISK to the specified corporation with the lottery reference in the reason
3. 📊 Track Progress - Monitor your tickets and see real-time lottery statistics
4. 🏆 Check Results - Winners are announced automatically via Discord and notifications

For Administrators

1. ➕ Create Lotteries - Set ticket prices, duration, winners, and prize distribution
2. 🔄 Setup Recurring Lotteries - Configure automated lotteries that repeat on schedule
3. 📈 Monitor Activity - Watch real-time participant counts and revenue tracking
4. 🔧 Resolve Issues - Use advanced tools to handle payment anomalies
5. 💰 Distribute Prizes - Track and confirm prize distributions to winners

<hr />

📸 Screenshots

🎲 User Experience

FortunaISK in Action	Personal Dashboard
Complete lottery system overview	Track tickets, winnings, and payments

Lottery History Browse past lotteries with detailed results and statistics

🛠️ Admin Interface

Admin Dashboard	Lottery Details
Real-time statistics and monitoring	Participant tracking and anomaly resolution

🏆 Results & 🔔 Discord Integration

Winner Announcements	Discord Notifications
Transparent prize distribution	Rich embeds for community engagement

24-Hour Closure Reminders
Automated reminders to boost participation before lottery closure

<hr />

🆕 Latest Updates

Version 1.0.0 - Stable Release! 🎉

• ✅ Multi-winner lottery support with custom prize distribution
• ✅ Automated recurring lotteries with flexible scheduling
• ✅ Enhanced admin dashboard with real-time statistics
• ✅ Advanced anomaly detection and resolution
• ✅ Comprehensive Discord integration
• ✅ CSV export functionality
• ✅ Complete audit trails and security improvements

What's Coming Next

• 🎁 Physical prize lottery support

<hr />

🔄 Updating

Step 1 - Update Package

pip install -U fortunaisk

Step 2 - Apply Changes

python manage.py migrate
python manage.py collectstatic
supervisorctl restart all

⚠️ Important for v0.6.6+ users: Discord webhook configuration has changed. Please reconfigure your webhooks at /admin/fortunaisk/webhookconfiguration/ after updating.

<hr />

🤝 Contributing

We welcome contributions! Whether it's bug fixes, new features, or documentation improvements:

1. 🍴 Fork the repository
2. 🌿 Create your feature branch: git checkout -b feature/amazing-feature
3. 📝 Commit your changes: git commit -m 'Add amazing feature'
4. 🚀 Push to the branch: git push origin feature/amazing-feature
5. 📬 Submit a pull request

For major changes, please open an issue first to discuss your ideas.

<hr />

🆘 Support

• 📚 Documentation: View the full documentation
• 🐛 Bug Reports: Report issues
• 💬 Community: Join the Alliance Auth Discord for support
• ✉️ Contact: Reach out to the maintainer for direct support

<hr />

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

<hr />

FortunaISK - Bringing fair and exciting lotteries to your Alliance Auth community! 🎲✨

Made with ❤️ for the EVE Online community

No reviews yet...

Python Requirements

• aa-discordnotify>=2
• allianceauth<5,>=4
• allianceauth-corptools>=2.5.5

Required Python packages to be installed and other Python requirement.

App Dependencies

Required apps:

• allianceauth-corptools
• Discord Notify

Used by apps:

-

Dependencies to other apps registered in this app directory.

Classifiers

• Environment :: Web Environment
• Framework :: Celery
• Framework :: Django
• Framework :: Django :: 4.0
• Framework :: Django :: 4.2
• Intended Audience :: Developers
• License :: OSI Approved :: MIT License
• Operating System :: OS Independent
• Programming Language :: Python
• Programming Language :: Python :: 3 :: Only
• Programming Language :: Python :: 3.10
• Programming Language :: Python :: 3.11
• Programming Language :: Python :: 3.12
• Programming Language :: Python :: 3.13
• Programming Language :: Python :: 3.8
• Programming Language :: Python :: 3.9
• Programming Language :: Python :: Implementation :: CPython
• Topic :: Internet :: WWW/HTTP
• Topic :: Internet :: WWW/HTTP :: Dynamic Content