fortunaisk 0.2.33

fortunaisk Plugin for Alliance Auth

FortunaISK (Beta)

A lottery module for Alliance Auth to organize, manage, and track community lotteries effortlessly. This module integrates seamlessly with Alliance Auth and its ecosystem, automating lottery creation, management, and winner selection.

---

Feedback Welcome

This module is currently in beta testing. Your feedback, ideas for improvements, and suggestions are highly valued. Feel free to reach out with any insights or recommendations!

---

Features

• Ticket Handling: Accepts and validates ticket purchases.
• Payment Processing: Automates payment verification and tracks anomalies.
• Winner Selection: Randomly selects winners using pre-defined criteria.
• Lottery History: Provides a detailed history of past lotteries and winners.
• Recurring Lotteries: Supports automated creation of recurring lotteries.
• Administrative Tools:
  • Anomaly resolution for mismatched transactions.
  • Prize distribution tracking.
  • Comprehensive admin dashboard for statistics and management.
• Notifications:
  • Discord notifications for major events like lottery completion or anomalies.
  • Alliance Auth notifications for users about ticket status and winnings.

---

Prerequisites

• Alliance Auth
• Alliance Auth Corp Tools
• Django Celery and Django Celery Beat for task scheduling.

---

Installation

Step 1 - Install app

pip install fortunaisk

Step 2 - Configure Auth settings

Add 'fortunaisk' to your INSTALLED_APPS in local.py:

Step 3 - Maintain Alliance Auth

• Run migrations:

  python manage.py makemigrations
  python manage.py migrate
  

• Restart Auth:

  supervisorctl restart all
  

Step 4 - Configure tasks

Run the following management command to set up periodic tasks:

python manage.py setup_fortuna_tasks

Step 5 - Configure Webhooks

Visit the following URL to configure Discord webhooks:

AUTH_ADDRESS/admin/fortunaisk/webhookconfiguration/

---

Permissions

Permission	Description
fortunaisk.can_access_this_app	Allows access to the user's personal dashboard and viewing their winnings.
fortunaisk.can_admin_this_app	Grants full administrative rights to manage lotteries, resolve anomalies, etc.

---

Usage

User Features

• Active Lotteries: Users can view and participate in ongoing lotteries.
• Personal Dashboard: View purchased tickets and winnings.
• Lottery History: Access records of past lotteries and their outcomes.

Admin Features

• Create Lotteries: Set ticket prices, duration, winner count, and prize distribution.
• Manage Recurring Lotteries: Activate or deactivate automated lotteries.
• Monitor Participants: View ticket purchases and participant details.
• Resolve Anomalies: Identify and correct mismatches in ticket purchases or payments.

---

Contributing

Contributions are welcome! To report an issue or propose a feature:

1. Fork this repository.

2. Create a branch for your feature or fix:

   git checkout -b feature/your-feature-name
   

3. Submit a pull request.

---

Update

Step 1 - Update app

pip install -U fortunaisk

Step 2 - Maintain Alliance Auth

• Run migrations:

  python manage.py makemigrations
  python manage.py migrate
  

• Restart Auth:

  supervisorctl restart all
  

---

License

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

---

Thank you for using FortunaISK! For questions or feedback, feel free to open an issue or contact the maintainer.