aa-buybackprogram 3.0.0b3__tar.gz → 3.1.0__tar.gz

{aa_buybackprogram-3.0.0b3 → aa_buybackprogram-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aa-buybackprogram
-Version: 3.0.0b3
+Version: 3.1.0
 Summary: Buyback program plugin app for Alliance Auth.
 Author-email: Ikarus Cesaille <contact@eve-linknet.com>
 Requires-Python: >=3.10
@@ -39,6 +39,7 @@ An Alliance Auth app for creating buyback programs and to allow users calculate
 - [Features](#features)
 - [Installation](#installation)
 - [Program Settings](#program-settings)
+- [Troubleshooting](#troubleshooting)
 - [Change Log](CHANGELOG.md)
 
 ## Images
@@ -165,7 +166,7 @@ Buyback program requires a few periodic tasks to operate and update its data.
 
 Buybackprogram is designed to use locally stored prices to speed up the price calculations. It is important that you have the price update task in your periodic tasks so that your prices will update.
 
-By adding the following lines in your `local.py` setting file the program will update the stored item prices at midnight. This same task is also responsible for maintenance tasks such as removing unlinked tracking objects. It will also check for any new contracts and update the statistics page with them every 30 minutes:
+By adding the following lines in your `local.py` setting file the program will update the stored item prices at midnight. This same task is also responsible for maintenance tasks such as removing unlinked tracking objects, including reverse buyback requests that were never followed through with an actual contract (which releases the stock they had reserved). It will also check for any new contracts and update the statistics page with them every 30 minutes:
 
 ```python
 # Buybackprogram price updates, updates prices at midnight
@@ -207,14 +208,14 @@ Name | Description | Default | Options
 BUYBACKPROGRAM_ENABLE_REVERSE_BUYBACK | Enable or disable the reverse buyback feature entirely. When disabled the menu item will not appear. | True | `True`, `False`
 BUYBACKPROGRAM_DISALLOW_CONTRACTS_WITH_ANY_DISALLOWED_ITEMS | Prevents price calculations if there are any disallowed items in the parsed list | False | `True`, `False`
 BUYBACKPROGRAM_SHOW_LOCATION_COUNT | How many locations we will show on buyback index page before we change it to a pop-up show all locations button | 4 | Integer
-BUYBACKPROGRAM_TRACKING_PREFILL | This is the prefill tag you will have on the tracking description for your contracts | aa-bbp. | Free text input
+BUYBACKPROGRAM_TRACKING_PREFILL | Default prefill tag used at the start of tracking numbers for your contracts. Individual buyback and reverse buyback programs can override this from their program settings (Tracking prefill tag), e.g. to separate ore and manufacturing buybacks in reports. | aa-bbp. | Free text input
 BUYBACKPROGRAM_PRICE_SOURCE_ID | Station ID for fetching base prices. Supports IDs listed on [Fuzzwork API](https://market.fuzzwork.co.uk/api/). Does not work with Janice API!| 60003760 | See ID list
 BUYBACKPROGRAM_PRICE_SOURCE_NAME | Display name of your price source. Has no effect on the actual price fetch which uses the ID. | Jita | Free text input
 BUYBACKPROGRAM_PRICE_AGE_WARNING_LIMIT | Limit in hours when an item price is considered as outdated | 48
 BUYBACKPROGRAM_PRICE_METHOD | By default Fuzzwork API will be used for pricing, if this is set to "Janice" then the Janice API will be used. | Fuzzwork | `Fuzzwork`, `Janice`
 BUYBACKPROGRAM_PRICE_INSTANT_PRICES | On default we use top 5% average prices. Set to `true` to change to instant prices | False | `False`, `True`
 BUYBACKPROGRAM_PRICE_JANICE_API_KEY | The API key to access Janice API. | `null` | `G9KwKq3465588VPd6747t95Zh94q3W2E`
-BUYBACKPROGRAM_UNUSED_TRACKING_PURGE_LIMIT | Time limit to remove unlinked tracking objects from the database. Set to 0 to never purge any tracking objects. | 48 | Any number in hours
+BUYBACKPROGRAM_UNUSED_TRACKING_PURGE_LIMIT | Time limit to remove unlinked tracking objects (both normal and reverse buyback requests) from the database. Purging an unlinked reverse buyback request also releases the hangar stock it had reserved. Set to 0 to never purge any tracking objects. | 48 | Any number in hours
 BUYBACKPROGRAM_TRACK_PREFILL_CONTRACTS | Determines if we will track and store contracts that starts with the prefill phrase but do not have any actual tracking hits in database | True | `True`, `False`
 BUYBACKPROGRAM_RESTRICT_TRACKING_DETAILS | When True, only the contract issuer and managers can view tracking detail pages via direct URL. Set to False to allow any authenticated basic_access user to view any tracking detail. | False | `True`, `False`
 
@@ -513,6 +514,20 @@ If ticked, contracts will be issued from the manager's corporation.
 ##### Location
 The structure where stock is held and contracts will be created. The structure ID must be set on the location for hangar sync to work.
 
+##### Stock Source
+Choose where the program's stock comes from:
+
+- **Whole hangar division** — everything in the selected Hangar Division at the program locations is for sale.
+- **Selected containers only** — only the contents of the chosen containers are for sale. Use this when you cannot dedicate an entire division to buyback. Containers must be assembled and sitting directly in a hangar division at one of the program locations; nested containers are not supported. Give containers a name ingame so they are easy to pick from the list.
+
+Containers are discovered during the hangar sync, so on a new manager the container list is empty until the first sync has run. Click **Refresh Stock** and reload the page if the list is empty. If a selected container is repackaged or moved away from the program locations it disappears from the program's stock and a warning is written to the log.
+
+##### Hangar Division
+The corporation hangar division to sell from. Only used when the stock source is a whole hangar division.
+
+##### Containers
+The containers to sell from. Only used when the stock source is selected containers.
+
 ##### Price Type
 The base price type used to value items. Default: Sell.
 
@@ -535,3 +550,17 @@ Once your program is created, click **Refresh Stock** in the management menu to
 
 Players navigate to **Reverse Buyback**, click **Buy** on a program, paste a list of items they want, and submit. The calculator checks availability against current stock and generates a price and tracking number. The player then waits for the owner to create a contract to them using the tracking number as the contract title.
 
+
+## Troubleshooting
+
+### Contract updates stop running after a worker restart
+
+Symptom: the log shows `Starting all contract updates` and `Updating contracts for <owner>` for each owner, but no `Fetching all contracts for ...` line follows and no contracts are linked.
+
+Cause: each owner's contract update runs as a run-once task. If a worker is restarted while the task is running (for example right after applying migrations), the lock is never released and every following run is silently skipped until the lock expires. The lock is stored in the Django cache and expires after `BUYBACKPROGRAM_TASKS_TIME_LIMIT` seconds (2 hours by default).
+
+To clear the locks immediately:
+
+```bash
+redis-cli -n 1 --scan --pattern "*qo_buybackprogram*" | xargs -r redis-cli -n 1 del
+

{aa_buybackprogram-3.0.0b3 → aa_buybackprogram-3.1.0}/README.md

@@ -13,6 +13,7 @@ An Alliance Auth app for creating buyback programs and to allow users calculate
 - [Features](#features)
 - [Installation](#installation)
 - [Program Settings](#program-settings)
+- [Troubleshooting](#troubleshooting)
 - [Change Log](CHANGELOG.md)
 
 ## Images
@@ -139,7 +140,7 @@ Buyback program requires a few periodic tasks to operate and update its data.
 
 Buybackprogram is designed to use locally stored prices to speed up the price calculations. It is important that you have the price update task in your periodic tasks so that your prices will update.
 
-By adding the following lines in your `local.py` setting file the program will update the stored item prices at midnight. This same task is also responsible for maintenance tasks such as removing unlinked tracking objects. It will also check for any new contracts and update the statistics page with them every 30 minutes:
+By adding the following lines in your `local.py` setting file the program will update the stored item prices at midnight. This same task is also responsible for maintenance tasks such as removing unlinked tracking objects, including reverse buyback requests that were never followed through with an actual contract (which releases the stock they had reserved). It will also check for any new contracts and update the statistics page with them every 30 minutes:
 
 ```python
 # Buybackprogram price updates, updates prices at midnight
@@ -181,14 +182,14 @@ Name | Description | Default | Options
 BUYBACKPROGRAM_ENABLE_REVERSE_BUYBACK | Enable or disable the reverse buyback feature entirely. When disabled the menu item will not appear. | True | `True`, `False`
 BUYBACKPROGRAM_DISALLOW_CONTRACTS_WITH_ANY_DISALLOWED_ITEMS | Prevents price calculations if there are any disallowed items in the parsed list | False | `True`, `False`
 BUYBACKPROGRAM_SHOW_LOCATION_COUNT | How many locations we will show on buyback index page before we change it to a pop-up show all locations button | 4 | Integer
-BUYBACKPROGRAM_TRACKING_PREFILL | This is the prefill tag you will have on the tracking description for your contracts | aa-bbp. | Free text input
+BUYBACKPROGRAM_TRACKING_PREFILL | Default prefill tag used at the start of tracking numbers for your contracts. Individual buyback and reverse buyback programs can override this from their program settings (Tracking prefill tag), e.g. to separate ore and manufacturing buybacks in reports. | aa-bbp. | Free text input
 BUYBACKPROGRAM_PRICE_SOURCE_ID | Station ID for fetching base prices. Supports IDs listed on [Fuzzwork API](https://market.fuzzwork.co.uk/api/). Does not work with Janice API!| 60003760 | See ID list
 BUYBACKPROGRAM_PRICE_SOURCE_NAME | Display name of your price source. Has no effect on the actual price fetch which uses the ID. | Jita | Free text input
 BUYBACKPROGRAM_PRICE_AGE_WARNING_LIMIT | Limit in hours when an item price is considered as outdated | 48
 BUYBACKPROGRAM_PRICE_METHOD | By default Fuzzwork API will be used for pricing, if this is set to "Janice" then the Janice API will be used. | Fuzzwork | `Fuzzwork`, `Janice`
 BUYBACKPROGRAM_PRICE_INSTANT_PRICES | On default we use top 5% average prices. Set to `true` to change to instant prices | False | `False`, `True`
 BUYBACKPROGRAM_PRICE_JANICE_API_KEY | The API key to access Janice API. | `null` | `G9KwKq3465588VPd6747t95Zh94q3W2E`
-BUYBACKPROGRAM_UNUSED_TRACKING_PURGE_LIMIT | Time limit to remove unlinked tracking objects from the database. Set to 0 to never purge any tracking objects. | 48 | Any number in hours
+BUYBACKPROGRAM_UNUSED_TRACKING_PURGE_LIMIT | Time limit to remove unlinked tracking objects (both normal and reverse buyback requests) from the database. Purging an unlinked reverse buyback request also releases the hangar stock it had reserved. Set to 0 to never purge any tracking objects. | 48 | Any number in hours
 BUYBACKPROGRAM_TRACK_PREFILL_CONTRACTS | Determines if we will track and store contracts that starts with the prefill phrase but do not have any actual tracking hits in database | True | `True`, `False`
 BUYBACKPROGRAM_RESTRICT_TRACKING_DETAILS | When True, only the contract issuer and managers can view tracking detail pages via direct URL. Set to False to allow any authenticated basic_access user to view any tracking detail. | False | `True`, `False`
 
@@ -487,6 +488,20 @@ If ticked, contracts will be issued from the manager's corporation.
 ##### Location
 The structure where stock is held and contracts will be created. The structure ID must be set on the location for hangar sync to work.
 
+##### Stock Source
+Choose where the program's stock comes from:
+
+- **Whole hangar division** — everything in the selected Hangar Division at the program locations is for sale.
+- **Selected containers only** — only the contents of the chosen containers are for sale. Use this when you cannot dedicate an entire division to buyback. Containers must be assembled and sitting directly in a hangar division at one of the program locations; nested containers are not supported. Give containers a name ingame so they are easy to pick from the list.
+
+Containers are discovered during the hangar sync, so on a new manager the container list is empty until the first sync has run. Click **Refresh Stock** and reload the page if the list is empty. If a selected container is repackaged or moved away from the program locations it disappears from the program's stock and a warning is written to the log.
+
+##### Hangar Division
+The corporation hangar division to sell from. Only used when the stock source is a whole hangar division.
+
+##### Containers
+The containers to sell from. Only used when the stock source is selected containers.
+
 ##### Price Type
 The base price type used to value items. Default: Sell.
 
@@ -508,3 +523,17 @@ Once your program is created, click **Refresh Stock** in the management menu to
 #### How it works for players
 
 Players navigate to **Reverse Buyback**, click **Buy** on a program, paste a list of items they want, and submit. The calculator checks availability against current stock and generates a price and tracking number. The player then waits for the owner to create a contract to them using the tracking number as the contract title.
+
+
+## Troubleshooting
+
+### Contract updates stop running after a worker restart
+
+Symptom: the log shows `Starting all contract updates` and `Updating contracts for <owner>` for each owner, but no `Fetching all contracts for ...` line follows and no contracts are linked.
+
+Cause: each owner's contract update runs as a run-once task. If a worker is restarted while the task is running (for example right after applying migrations), the lock is never released and every following run is silently skipped until the lock expires. The lock is stored in the Django cache and expires after `BUYBACKPROGRAM_TASKS_TIME_LIMIT` seconds (2 hours by default).
+
+To clear the locks immediately:
+
+```bash
+redis-cli -n 1 --scan --pattern "*qo_buybackprogram*" | xargs -r redis-cli -n 1 del

{aa_buybackprogram-3.0.0b3 → aa_buybackprogram-3.1.0}/buybackprogram/__init__.py

@@ -2,5 +2,5 @@
 
 default_app_config = "buybackprogram.apps.BuybackProgramConfig"
 
-__version__ = "3.0.0b3"
+__version__ = "3.1.0"
 __title__ = "Buyback Program"

aa_buybackprogram-3.1.0/buybackprogram/admin.py

@@ -0,0 +1,194 @@
+from django.contrib import admin
+from django.db.models import Exists, OuterRef
+
+from .models import (
+    Contract,
+    Faq,
+    HangarContainer,
+    HangarDivision,
+    HangarStock,
+    Location,
+    Owner,
+    Program,
+    ReverseProgram,
+    ReverseTracking,
+    ReverseTrackingItem,
+    StaticItemPrice,
+)
+
+# Register your models here.
+
+
+class ProgramAdmin(admin.ModelAdmin):
+    model = Program
+
+    list_display = (
+        "owner",
+        "_location",
+        "is_corporation",
+        "hauling_fuel_cost",
+        "tax",
+        "refining_rate",
+        "price_dencity_modifier",
+        "allow_all_items",
+        "use_refined_value",
+        "use_compressed_value",
+        "use_raw_ore_value",
+        "allow_unpacked_items",
+    )
+
+    @classmethod
+    def _location(cls, obj):
+        names = [x.name for x in obj.location.all().order_by("name")]
+
+        if names:
+            return ", ".join(names)
+        else:
+            return None
+
+    _location.short_description = "Location"
+    _location.admin_order_field = "location__name"
+
+
+class FaqAdmin(admin.ModelAdmin):
+    model = Program
+
+    list_display = (
+        "header",
+        "body",
+    )
+
+
+class ContractTypeFilter(admin.SimpleListFilter):
+    title = "contract type"
+    parameter_name = "contract_type"
+
+    def lookups(self, request, model_admin):
+        return (
+            ("reverse", "Reverse buyback"),
+            ("normal", "Normal buyback"),
+        )
+
+    def queryset(self, request, queryset):
+        if self.value() == "reverse":
+            return queryset.filter(reversetracking__isnull=False).distinct()
+        if self.value() == "normal":
+            return queryset.filter(reversetracking__isnull=True)
+        return None
+
+
+@admin.register(Contract)
+class ContractAdmin(admin.ModelAdmin):
+    list_display = (
+        "contract_id",
+        "status",
+        "price",
+        "date_issued",
+        "location_name",
+        "_is_reverse",
+        "no_tracking",
+    )
+    list_filter = (ContractTypeFilter, "status")
+    search_fields = ("contract_id", "title", "location_name")
+
+    def get_queryset(self, request):
+        return (
+            super()
+            .get_queryset(request)
+            .annotate(
+                is_reverse=Exists(
+                    ReverseTracking.objects.filter(contract=OuterRef("pk"))
+                )
+            )
+        )
+
+    @admin.display(description="Reverse", boolean=True, ordering="is_reverse")
+    def _is_reverse(self, obj):
+        return obj.is_reverse
+
+
+@admin.register(StaticItemPrice)
+class StaticItemPriceAdmin(admin.ModelAdmin):
+    list_display = ("program", "eve_type", "price")
+    search_fields = ("program__name", "eve_type__name")
+
+
+@admin.register(ReverseProgram)
+class ReverseProgramAdmin(admin.ModelAdmin):
+    list_display = (
+        "name",
+        "owner",
+        "is_corporation",
+        "stock_source",
+        "price_type",
+        "markup",
+        "is_public",
+    )
+    list_filter = ("stock_source",)
+    search_fields = ("name",)
+    filter_horizontal = ("containers",)
+
+
+class ReverseTrackingItemInline(admin.TabularInline):
+    model = ReverseTrackingItem
+    extra = 0
+    raw_id_fields = ("eve_type",)
+
+
+@admin.register(ReverseTracking)
+class ReverseTrackingAdmin(admin.ModelAdmin):
+    list_display = (
+        "tracking_number",
+        "program",
+        "issuer_user",
+        "net_price",
+        "created_at",
+        "_contract_status",
+    )
+    list_filter = (("contract", admin.EmptyFieldListFilter), "program")
+    search_fields = ("tracking_number",)
+    inlines = [ReverseTrackingItemInline]
+
+    @admin.display(description="Contract status")
+    def _contract_status(self, obj):
+        if obj.contract is None:
+            return "unlinked"
+        return obj.contract.status
+
+
+@admin.register(HangarStock)
+class HangarStockAdmin(admin.ModelAdmin):
+    list_display = ("program", "eve_type", "quantity", "updated_at")
+    search_fields = ("program__name", "eve_type__name")
+    raw_id_fields = ("eve_type",)
+
+
+@admin.register(HangarDivision)
+class HangarDivisionAdmin(admin.ModelAdmin):
+    list_display = ("name", "owner", "division_id", "location_flag", "updated_at")
+    search_fields = ("name",)
+    list_filter = ("owner",)
+
+
+@admin.register(HangarContainer)
+class HangarContainerAdmin(admin.ModelAdmin):
+    list_display = (
+        "name",
+        "type_name",
+        "owner",
+        "item_id",
+        "structure_id",
+        "location_flag",
+        "updated_at",
+    )
+    search_fields = ("name", "item_id")
+    list_filter = ("owner", "location_flag")
+
+
+admin.site.register(Program, ProgramAdmin)
+
+admin.site.register(Owner)
+
+admin.site.register(Location)
+
+admin.site.register(Faq, FaqAdmin)

{aa_buybackprogram-3.0.0b3 → aa_buybackprogram-3.1.0}/buybackprogram/forms.py

@@ -3,7 +3,9 @@ from django.core.validators import MaxValueValidator, MinValueValidator
 from django.utils.translation import gettext as _
 from eveuniverse.models import EveGroup, EveMarketGroup, EveSolarSystem, EveType
 
+from buybackprogram.app_settings import BUYBACKPROGRAM_TRACKING_PREFILL
 from buybackprogram.models import (
+    HangarContainer,
     HangarDivision,
     Location,
     Owner,
@@ -30,6 +32,9 @@ class ProgramForm(forms.ModelForm):
         self.user = kwargs.pop("user", None)
 
         super(ProgramForm, self).__init__(*args, **kwargs)
+        self.fields["tracking_prefill"].widget.attrs["placeholder"] = (
+            "%s (global default)" % BUYBACKPROGRAM_TRACKING_PREFILL
+        )
         self.fields["owner"].queryset = Owner.objects.filter(user=self.user)
         self.fields["location"].queryset = Location.objects.filter(
             owner__user=self.user
@@ -257,6 +262,9 @@ class ReverseProgramForm(forms.ModelForm):
             "is_public": "Public program",
             "is_corporation": "Use corporation as contract issuer",
         }
+        widgets = {
+            "stock_source": forms.RadioSelect,
+        }
 
     def __init__(self, *args, **kwargs):
         self.user = kwargs.pop("user", None)
@@ -267,17 +275,73 @@ class ReverseProgramForm(forms.ModelForm):
         )
 
         if is_admin:
-            self.fields["owner"].queryset = Owner.objects.all()
+            owners = Owner.objects.all()
             self.fields["location"].queryset = Location.objects.all()
-            self.fields["hangar_division"].queryset = HangarDivision.objects.all()
         else:
-            self.fields["owner"].queryset = Owner.objects.filter(user=self.user)
+            owners = Owner.objects.filter(user=self.user)
             self.fields["location"].queryset = Location.objects.filter(
                 owner__user=self.user
             )
+        self.fields["owner"].queryset = owners
+
+        # Hangar divisions and containers are only ever offered for the
+        # selected manager, so one manager's hangar layout is never rendered
+        # for another. Before a manager is picked the lists are empty and the
+        # page fills them via the autocomplete endpoints.
+        owner_id = self.data.get("owner") if self.is_bound else None
+        if not owner_id and self.instance.pk:
+            owner_id = self.instance.owner_id
+
+        if self.is_bound:
+            location_ids = self.data.getlist("location")
+        elif self.instance.pk:
+            location_ids = list(self.instance.location.values_list("pk", flat=True))
+        else:
+            location_ids = []
+
+        if owner_id and owners.filter(pk=owner_id).exists():
             self.fields["hangar_division"].queryset = HangarDivision.objects.filter(
-                owner__user=self.user
+                owner_id=owner_id
+            )
+            # Only containers sitting at one of the program's locations can
+            # ever supply stock, so nothing else is offered or accepted
+            structure_ids = Location.objects.filter(
+                pk__in=location_ids, structure_id__isnull=False
+            ).values_list("structure_id", flat=True)
+            self.fields["containers"].queryset = HangarContainer.objects.filter(
+                owner_id=owner_id, structure_id__in=structure_ids
             )
+        else:
+            self.fields["hangar_division"].queryset = HangarDivision.objects.none()
+            self.fields["containers"].queryset = HangarContainer.objects.none()
+
+    def clean(self):
+        cleaned_data = super().clean()
+        stock_source = cleaned_data.get("stock_source")
+        owner = cleaned_data.get("owner")
+        containers = cleaned_data.get("containers")
+
+        if stock_source == ReverseProgram.StockSource.CONTAINERS:
+            locations = cleaned_data.get("location")
+            if (
+                locations is not None
+                and not locations.filter(structure_id__isnull=False).exists()
+            ):
+                self.add_error(
+                    "location",
+                    "Selected containers only needs at least one location with a structure ID set; containers are matched by structure.",
+                )
+            if not containers:
+                self.add_error(
+                    "containers",
+                    "Select at least one container, or change the stock source to a whole hangar division.",
+                )
+            elif owner and containers.exclude(owner=owner).exists():
+                self.add_error(
+                    "containers", "All containers must belong to the selected manager."
+                )
+
+        return cleaned_data
 
 
 class ReverseCalculatorForm(forms.Form):

{aa_buybackprogram-3.0.0b3 → aa_buybackprogram-3.1.0}/buybackprogram/helpers.py

@@ -16,7 +16,6 @@ from buybackprogram.app_settings import (
     BUYBACKPROGRAM_PRICE_JANICE_API_KEY,
     BUYBACKPROGRAM_PRICE_METHOD,
     BUYBACKPROGRAM_PRICE_SOURCE_ID,
-    BUYBACKPROGRAM_TRACKING_PREFILL,
 )
 from buybackprogram.constants import (
     BLUE_LOOT_TYPE_IDS,
@@ -1257,7 +1256,7 @@ def get_tracking_number(
         last_id = 0
 
     tracking_number = (
-        BUYBACKPROGRAM_TRACKING_PREFILL
+        program.get_tracking_prefill()
         + "-"
         + str(last_id)
         + "-"

aa_buybackprogram-3.1.0/buybackprogram/migrations/0019_program_tracking_prefill_reverseprogram_stock_source_and_more.py

@@ -0,0 +1,123 @@
+# Generated by Django 5.2.15 on 2026-09-14 04:26
+
+import django.core.validators
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("buybackprogram", "0018_structurenamecache_alter_general_options_and_more"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="program",
+            name="tracking_prefill",
+            field=models.CharField(
+                blank=True,
+                default="",
+                help_text="Optional tag used as the start of tracking numbers for this program, for example aa-bbp-ore. Leave empty to use the global BUYBACKPROGRAM_TRACKING_PREFILL setting. Only letters, numbers, dots, dashes and underscores.",
+                max_length=16,
+                validators=[
+                    django.core.validators.RegexValidator(
+                        "^[A-Za-z0-9._-]*$",
+                        "Only letters, numbers, dots, dashes and underscores are allowed.",
+                    )
+                ],
+                verbose_name="Tracking prefill tag",
+            ),
+        ),
+        migrations.AddField(
+            model_name="reverseprogram",
+            name="stock_source",
+            field=models.CharField(
+                choices=[
+                    ("division", "Whole hangar division"),
+                    ("containers", "Selected containers only"),
+                ],
+                default="division",
+                help_text="Sell everything in a hangar division, or only the contents of specific containers at the program locations.",
+                max_length=10,
+                verbose_name="Stock source",
+            ),
+        ),
+        migrations.AddField(
+            model_name="reverseprogram",
+            name="tracking_prefill",
+            field=models.CharField(
+                blank=True,
+                default="",
+                help_text="Optional tag used as the start of tracking numbers for this program. Leave empty to use the global BUYBACKPROGRAM_TRACKING_PREFILL setting. Only letters, numbers, dots, dashes and underscores.",
+                max_length=16,
+                validators=[
+                    django.core.validators.RegexValidator(
+                        "^[A-Za-z0-9._-]*$",
+                        "Only letters, numbers, dots, dashes and underscores are allowed.",
+                    )
+                ],
+                verbose_name="Tracking prefill tag",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="reverseprogram",
+            name="hangar_division",
+            field=models.ForeignKey(
+                blank=True,
+                help_text="The corporation hangar division where stock is stored. Used when stock source is a whole hangar division.",
+                null=True,
+                on_delete=django.db.models.deletion.SET_NULL,
+                to="buybackprogram.hangardivision",
+            ),
+        ),
+        migrations.CreateModel(
+            name="HangarContainer",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "item_id",
+                    models.BigIntegerField(
+                        help_text="ESI asset item id of the container"
+                    ),
+                ),
+                ("name", models.CharField(max_length=128)),
+                ("type_name", models.CharField(blank=True, default="", max_length=128)),
+                ("structure_id", models.BigIntegerField(blank=True, null=True)),
+                (
+                    "location_flag",
+                    models.CharField(blank=True, default="", max_length=32),
+                ),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "owner",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="containers",
+                        to="buybackprogram.owner",
+                    ),
+                ),
+            ],
+            options={
+                "default_permissions": (),
+                "unique_together": {("owner", "item_id")},
+            },
+        ),
+        migrations.AddField(
+            model_name="reverseprogram",
+            name="containers",
+            field=models.ManyToManyField(
+                blank=True,
+                help_text="Containers whose contents are sold. Used when stock source is selected containers. Containers appear here after the first hangar sync; name them ingame to make them easy to identify.",
+                related_name="+",
+                to="buybackprogram.hangarcontainer",
+            ),
+        ),
+    ]