aa-shop 0.1.1__tar.gz

aa_shop-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Onisoru
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aa_shop-0.1.1/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: aa-shop
+Version: 0.1.1
+Summary: A public asset shop plugin for Alliance Auth.
+Keywords: allianceauth,eveonline,django
+Author-email: Daniel Onisoru <daniel.onisoru@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+License-File: LICENSE
+Requires-Dist: allianceauth>=5,<6
+Requires-Dist: aa-memberaudit>=5
+Requires-Dist: markdown
+Requires-Dist: coverage ; extra == "test"
+Requires-Dist: factory_boy ; extra == "test"
+Project-URL: Changelog, https://gitlab.com/daniel.onisoru/aa-shop/-/blob/master/CHANGELOG.md
+Project-URL: Homepage, https://gitlab.com/daniel.onisoru/aa-shop
+Project-URL: Issues, https://gitlab.com/daniel.onisoru/aa-shop/-/issues
+Project-URL: Source, https://gitlab.com/daniel.onisoru/aa-shop
+Provides-Extra: test
+
+# aa-shop
+
+An [Alliance Auth](https://gitlab.com/allianceauth/allianceauth) plugin that lets registered
+auth members run a publicly available shop stocked from their own (or their corporation's)
+assets.
+
+## Features
+
+- Members create and manage **personal** shops; authorized users manage **corporation** shops.
+- A member **back-office** at `/shop-backoffice/` (lists your shops, create/edit/delete).
+- Each published shop gets a **public storefront** at `/shop/<slug>/` — no login required.
+  Unpublished shops are visible only to their managers (preview).
+
+## Requirements
+
+- Alliance Auth >= 5
+- [aa-memberaudit](https://pypi.org/project/aa-memberaudit/) >= 5, installed and syncing
+
+## Installation
+
+1. Install into your Alliance Auth virtual environment:
+
+   ```bash
+   pip install aa-shop
+   ```
+
+2. Add `"shop"` to `INSTALLED_APPS` in your auth project's `local.py`:
+
+   ```python
+   INSTALLED_APPS += ["shop"]
+   ```
+
+3. Allow the storefront to expose its public (non-gated) views — **required**, or anonymous
+   visitors are redirected to login:
+
+   ```python
+   APPS_WITH_PUBLIC_VIEWS = ["storefront"]
+   ```
+
+4. Run migrations and collect static files, then restart your AA services:
+
+   ```bash
+   python manage.py migrate
+   python manage.py collectstatic
+   ```
+
+5. **EVE universe data:** the Hulls picker lists ship types from
+   [django-eveuniverse](https://gitlab.com/ErikKalkoken/django-eveuniverse), so make sure
+   your eveuniverse data is populated with ship types (load the full EVE universe, or at
+   least the Ship category, using eveuniverse's load tooling). Ships that aren't loaded
+   won't be selectable.
+
+6. Grant permissions (Django admin, or via groups/states):
+
+   | Permission | Grants |
+   |---|---|
+   | `shop.basic_access` | Access the back-office; create/manage your personal shops |
+   | `shop.manage_corporation_shops` | Create/manage your corporation's shops |
+
+### Periodic price refresh
+
+Hulls priced as **% Jita Buy** / **% Jita Sell** are refreshed by a Celery task
+every 6 hours. Add to your `local.py`:
+
+```python
+from celery.schedules import crontab
+
+CELERYBEAT_SCHEDULE["shop_refresh_pct_prices"] = {
+    "task": "shop.tasks.refresh_pct_prices",
+    "schedule": crontab(minute=0, hour="*/6"),
+}
+CELERYBEAT_SCHEDULE["shop_refresh_all_stock"] = {
+    "task": "shop.tasks.refresh_all_stock",
+    "schedule": crontab(minute=0),   # hourly
+}
+```
+
+Stock is recomputed from memberaudit assets (no ESI). Refresh on demand with
+`python manage.py shop_refresh_stock` (`--async` to enqueue the per-shop tasks).
+
+The task uses the public ESI market endpoint (no token) at low priority
+(override with `SHOP_TASKS_PRIORITY`, 1=urgent .. 9=idle; default 7). Prices are
+best-of-book at Jita 4-4 (highest buy / lowest sell), the same as Janice.
+
+To refresh on demand (e.g. after setting up %-pricing), run inline:
+
+```bash
+python manage.py shop_refresh_prices           # synchronous, prints results
+python manage.py shop_refresh_prices --async    # enqueue Celery tasks instead
+```
+
+## Usage
+
+- **Members:** open **Shop** in the auth sidebar (`/shop-backoffice/`) to create a shop —
+  set a slug, name, type (personal/corporation), and publish it.
+- **Public:** share `/shop/<slug>/`; published shops are browsable by anyone.
+
+## Contributing
+
+Design docs and implementation plans live in `docs/superpowers/`. The storefront stylesheet
+ships compiled (`shop/static/shop/storefront.css`); to rebuild it after changing storefront
+templates, use the standalone Tailwind v4 CLI + daisyUI (no Node required):
+
+```bash
+bash scripts/build-css.sh        # add --watch during development
+```
+
+## License
+
+MIT
+

aa_shop-0.1.1/README.md

@@ -0,0 +1,110 @@
+# aa-shop
+
+An [Alliance Auth](https://gitlab.com/allianceauth/allianceauth) plugin that lets registered
+auth members run a publicly available shop stocked from their own (or their corporation's)
+assets.
+
+## Features
+
+- Members create and manage **personal** shops; authorized users manage **corporation** shops.
+- A member **back-office** at `/shop-backoffice/` (lists your shops, create/edit/delete).
+- Each published shop gets a **public storefront** at `/shop/<slug>/` — no login required.
+  Unpublished shops are visible only to their managers (preview).
+
+## Requirements
+
+- Alliance Auth >= 5
+- [aa-memberaudit](https://pypi.org/project/aa-memberaudit/) >= 5, installed and syncing
+
+## Installation
+
+1. Install into your Alliance Auth virtual environment:
+
+   ```bash
+   pip install aa-shop
+   ```
+
+2. Add `"shop"` to `INSTALLED_APPS` in your auth project's `local.py`:
+
+   ```python
+   INSTALLED_APPS += ["shop"]
+   ```
+
+3. Allow the storefront to expose its public (non-gated) views — **required**, or anonymous
+   visitors are redirected to login:
+
+   ```python
+   APPS_WITH_PUBLIC_VIEWS = ["storefront"]
+   ```
+
+4. Run migrations and collect static files, then restart your AA services:
+
+   ```bash
+   python manage.py migrate
+   python manage.py collectstatic
+   ```
+
+5. **EVE universe data:** the Hulls picker lists ship types from
+   [django-eveuniverse](https://gitlab.com/ErikKalkoken/django-eveuniverse), so make sure
+   your eveuniverse data is populated with ship types (load the full EVE universe, or at
+   least the Ship category, using eveuniverse's load tooling). Ships that aren't loaded
+   won't be selectable.
+
+6. Grant permissions (Django admin, or via groups/states):
+
+   | Permission | Grants |
+   |---|---|
+   | `shop.basic_access` | Access the back-office; create/manage your personal shops |
+   | `shop.manage_corporation_shops` | Create/manage your corporation's shops |
+
+### Periodic price refresh
+
+Hulls priced as **% Jita Buy** / **% Jita Sell** are refreshed by a Celery task
+every 6 hours. Add to your `local.py`:
+
+```python
+from celery.schedules import crontab
+
+CELERYBEAT_SCHEDULE["shop_refresh_pct_prices"] = {
+    "task": "shop.tasks.refresh_pct_prices",
+    "schedule": crontab(minute=0, hour="*/6"),
+}
+CELERYBEAT_SCHEDULE["shop_refresh_all_stock"] = {
+    "task": "shop.tasks.refresh_all_stock",
+    "schedule": crontab(minute=0),   # hourly
+}
+```
+
+Stock is recomputed from memberaudit assets (no ESI). Refresh on demand with
+`python manage.py shop_refresh_stock` (`--async` to enqueue the per-shop tasks).
+
+The task uses the public ESI market endpoint (no token) at low priority
+(override with `SHOP_TASKS_PRIORITY`, 1=urgent .. 9=idle; default 7). Prices are
+best-of-book at Jita 4-4 (highest buy / lowest sell), the same as Janice.
+
+To refresh on demand (e.g. after setting up %-pricing), run inline:
+
+```bash
+python manage.py shop_refresh_prices           # synchronous, prints results
+python manage.py shop_refresh_prices --async    # enqueue Celery tasks instead
+```
+
+## Usage
+
+- **Members:** open **Shop** in the auth sidebar (`/shop-backoffice/`) to create a shop —
+  set a slug, name, type (personal/corporation), and publish it.
+- **Public:** share `/shop/<slug>/`; published shops are browsable by anyone.
+
+## Contributing
+
+Design docs and implementation plans live in `docs/superpowers/`. The storefront stylesheet
+ships compiled (`shop/static/shop/storefront.css`); to rebuild it after changing storefront
+templates, use the standalone Tailwind v4 CLI + daisyUI (no Node required):
+
+```bash
+bash scripts/build-css.sh        # add --watch during development
+```
+
+## License
+
+MIT

aa_shop-0.1.1/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["flit_core >=3.2,<4"]
+build-backend = "flit_core.buildapi"
+
+[project]
+name = "aa-shop"
+dynamic = ["version", "description"]
+readme = "README.md"
+license = {file = "LICENSE"}
+requires-python = ">=3.10"
+authors = [
+    { name = "Daniel Onisoru", email = "daniel.onisoru@gmail.com" },
+]
+keywords = ["allianceauth", "eveonline", "django"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Framework :: Django",
+    "Framework :: Django :: 4.2",
+    "Framework :: Django :: 5.2",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+]
+dependencies = [
+    "allianceauth>=5,<6",
+    "aa-memberaudit>=5",
+    "markdown",
+]
+
+[project.optional-dependencies]
+test = ["coverage", "factory_boy"]
+
+[project.urls]
+Homepage = "https://gitlab.com/daniel.onisoru/aa-shop"
+Source = "https://gitlab.com/daniel.onisoru/aa-shop"
+Issues = "https://gitlab.com/daniel.onisoru/aa-shop/-/issues"
+Changelog = "https://gitlab.com/daniel.onisoru/aa-shop/-/blob/master/CHANGELOG.md"
+
+[tool.flit.module]
+name = "shop"

aa_shop-0.1.1/shop/__init__.py

@@ -0,0 +1,3 @@
+"""A public asset shop plugin for Alliance Auth."""
+
+__version__ = "0.1.1"

aa_shop-0.1.1/shop/admin.py

@@ -0,0 +1,12 @@
+"""Admin registrations."""
+
+from django.contrib import admin
+
+from .models import Shop
+
+
+@admin.register(Shop)
+class ShopAdmin(admin.ModelAdmin):
+    list_display = ("name", "slug", "shop_type", "is_published", "corporation", "created_by")
+    list_filter = ("shop_type", "is_published")
+    search_fields = ("name", "slug")

aa_shop-0.1.1/shop/apps.py

@@ -0,0 +1,7 @@
+from django.apps import AppConfig
+
+
+class ShopConfig(AppConfig):
+    name = "shop"
+    label = "shop"
+    verbose_name = "Shop"

aa_shop-0.1.1/shop/auth_hooks.py

@@ -0,0 +1,48 @@
+from django.utils.translation import gettext_lazy as _
+
+from allianceauth import hooks
+from allianceauth.services.hooks import MenuItemHook, UrlHook
+
+from .urls import backoffice as backoffice_urls
+from .urls import storefront as storefront_urls
+
+
+class ShopMenuItem(MenuItemHook):
+    """Sidebar entry into the back-office for authorized users."""
+
+    def __init__(self):
+        MenuItemHook.__init__(
+            self,
+            _("Shop"),
+            "fas fa-store fa-fw",
+            "backoffice:index",
+            navactive=["backoffice:"],
+        )
+
+    def render(self, request):
+        if request.user.has_perm("shop.basic_access"):
+            return MenuItemHook.render(self, request)
+        return ""
+
+
+@hooks.register("menu_item_hook")
+def register_menu():
+    return ShopMenuItem()
+
+
+@hooks.register("url_hook")
+def register_backoffice_urls():
+    return UrlHook(backoffice_urls, "backoffice", r"^shop-backoffice/")
+
+
+@hooks.register("url_hook")
+def register_storefront_urls():
+    return UrlHook(
+        storefront_urls,
+        "storefront",
+        r"^shop/",
+        excluded_views=[
+            "shop.views.storefront.detail",
+            "shop.views.storefront.item_detail",
+        ],
+    )

aa_shop-0.1.1/shop/formatting.py

@@ -0,0 +1,23 @@
+"""Number formatting helpers."""
+
+
+def format_isk(amount) -> str:
+    """Abbreviate an ISK amount EVE-style: K / M / B / T.
+
+    Up to 2 decimals, trailing zeros stripped. Examples:
+        23_000_000      -> "23M ISK"
+        1_500_000_000   -> "1.5B ISK"
+        149_000_000_000 -> "149B ISK"
+        750             -> "750 ISK"
+    """
+    amount = int(amount)
+    for unit, suffix in (
+        (1_000_000_000_000, "T"),
+        (1_000_000_000, "B"),
+        (1_000_000, "M"),
+        (1_000, "K"),
+    ):
+        if amount >= unit:
+            value = f"{amount / unit:.2f}".rstrip("0").rstrip(".")
+            return f"{value}{suffix} ISK"
+    return f"{amount:,} ISK"

aa_shop-0.1.1/shop/forms.py

@@ -0,0 +1,156 @@
+"""Forms."""
+
+from django import forms
+
+from allianceauth.eveonline.models import EveCorporationInfo
+from eveuniverse.models import EveType
+
+from .models import (
+    FIXED_PRICE, FIXED_STOCK, PCT_MODES, PRICE_MODE_CHOICES, SECTION_CHOICES,
+    STOCK_MODE_CHOICES, Shop,
+)
+from .sources import owner_characters
+
+SHIP_CATEGORY_ID = 6
+
+
+def ship_type_queryset():
+    return EveType.objects.filter(
+        eve_group__eve_category_id=SHIP_CATEGORY_ID, published=True
+    ).order_by("name")
+
+
+def _resolve_corp(corporation_id):
+    try:
+        return EveCorporationInfo.objects.get(corporation_id=corporation_id)
+    except EveCorporationInfo.DoesNotExist:
+        return EveCorporationInfo.objects.create_corporation(corporation_id)
+
+
+class ShopForm(forms.ModelForm):
+    enabled_sections = forms.MultipleChoiceField(
+        choices=SECTION_CHOICES,
+        required=False,
+        widget=forms.CheckboxSelectMultiple,
+        label="Sections",
+    )
+
+    class Meta:
+        model = Shop
+        fields = ["name", "slug", "shop_type", "is_published", "enabled_sections", "description"]
+        widgets = {
+            "description": forms.Textarea(attrs={"rows": 6}),
+        }
+        help_texts = {
+            "description": "Markdown supported — bold, italic, headings, lists, links.",
+        }
+
+    def __init__(self, *args, user=None, **kwargs):
+        self.user = user
+        super().__init__(*args, **kwargs)
+        # shop_type is fixed after creation
+        if self.instance and self.instance.pk:
+            self.fields["shop_type"].disabled = True
+
+    def clean_shop_type(self):
+        shop_type = self.cleaned_data["shop_type"]
+        if shop_type == Shop.ShopType.CORPORATION:
+            if not (self.user and self.user.has_perm("shop.manage_corporation_shops")):
+                raise forms.ValidationError(
+                    "You do not have permission to create corporation shops."
+                )
+            main = getattr(getattr(self.user, "profile", None), "main_character", None)
+            if main is None or not main.corporation_id:
+                raise forms.ValidationError(
+                    "Your main character has no corporation set."
+                )
+        return shop_type
+
+    def save(self, commit=True):
+        creating = self.instance.pk is None
+        shop = super().save(commit=False)
+        if creating:
+            shop.created_by = self.user
+            if shop.shop_type == Shop.ShopType.CORPORATION:
+                corp_id = self.user.profile.main_character.corporation_id
+                shop.corporation = _resolve_corp(corp_id)
+        if commit:
+            shop.save()
+        return shop
+
+
+class AddStockroomForm(forms.Form):
+    character_id = forms.IntegerField()
+    location_id = forms.IntegerField()
+    container_item_id = forms.IntegerField(required=False)
+    price_mode = forms.ChoiceField(choices=PRICE_MODE_CHOICES)
+    price_pct = forms.DecimalField(
+        min_value=0, max_digits=5, decimal_places=2, required=False
+    )
+
+    def __init__(self, *args, owner=None, **kwargs):
+        self.owner = owner
+        super().__init__(*args, **kwargs)
+
+    def clean_character_id(self):
+        cid = self.cleaned_data["character_id"]
+        if not owner_characters(self.owner).filter(id=cid).exists():
+            raise forms.ValidationError("Not one of your characters.")
+        return cid
+
+    def clean(self):
+        cleaned = super().clean()
+        if cleaned.get("price_mode") in PCT_MODES and not cleaned.get("price_pct"):
+            self.add_error("price_pct", "Enter a percentage for %-based pricing.")
+        return cleaned
+
+
+class EditStockroomForm(forms.Form):
+    price_mode = forms.ChoiceField(choices=PRICE_MODE_CHOICES)
+    price_pct = forms.DecimalField(
+        min_value=0, max_digits=5, decimal_places=2, required=False
+    )
+
+    def clean(self):
+        cleaned = super().clean()
+        if cleaned.get("price_mode") in PCT_MODES and not cleaned.get("price_pct"):
+            self.add_error("price_pct", "Enter a percentage for %-based pricing.")
+        return cleaned
+
+
+class HullModeFieldsMixin(forms.Form):
+    stock_mode = forms.ChoiceField(choices=STOCK_MODE_CHOICES)
+    stock = forms.IntegerField(min_value=0, required=False)
+    price_mode = forms.ChoiceField(choices=PRICE_MODE_CHOICES)
+    price = forms.IntegerField(min_value=0, required=False)  # ISK, fixed mode
+    price_pct = forms.DecimalField(
+        min_value=0, max_digits=5, decimal_places=2, required=False
+    )
+    persist = forms.BooleanField(required=False)  # keep listing at 0 stock
+    description = forms.CharField(
+        required=False, widget=forms.Textarea(attrs={"rows": 4}),
+        help_text="Markdown supported.",
+    )
+
+    def clean(self):
+        cleaned = super().clean()
+        if cleaned.get("stock_mode") == FIXED_STOCK and cleaned.get("stock") is None:
+            self.add_error("stock", "Enter a stock quantity for fixed stock.")
+        if cleaned.get("price_mode") == FIXED_PRICE and cleaned.get("price") is None:
+            self.add_error("price", "Enter a price (0 = Ask) for fixed price.")
+        if cleaned.get("price_mode") in PCT_MODES and not cleaned.get("price_pct"):
+            self.add_error("price_pct", "Enter a percentage for %-based pricing.")
+        return cleaned
+
+
+class EditHullForm(HullModeFieldsMixin):
+    pass
+
+
+class AddHullForm(HullModeFieldsMixin):
+    eve_type = forms.ModelChoiceField(queryset=EveType.objects.none(), label="Ship")
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.fields["eve_type"].queryset = ship_type_queryset()
+        self.fields["eve_type"].widget.attrs["class"] = "form-select"

aa_shop-0.1.1/shop/management/commands/shop_refresh_prices.py

@@ -0,0 +1,45 @@
+"""Refresh %-based hull prices from Jita on demand.
+
+Runs inline (synchronous) by default so you see results immediately; pass
+--async to enqueue the Celery per-type tasks instead (needs a worker).
+"""
+
+from django.core.management.base import BaseCommand
+
+from shop.tasks import _apply_prices_for_type, _enqueue_pct_refreshes, pct_type_ids
+
+
+class Command(BaseCommand):
+    help = "Refresh %-priced hull listings from live Jita prices (Jita 4-4)."
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "--async",
+            action="store_true",
+            dest="use_async",
+            help="Enqueue Celery per-type tasks instead of running inline.",
+        )
+
+    def handle(self, *args, **options):
+        if options["use_async"]:
+            type_ids = _enqueue_pct_refreshes()
+            self.stdout.write(
+                self.style.SUCCESS(f"Enqueued {len(type_ids)} per-type refresh task(s).")
+            )
+            return
+
+        type_ids = pct_type_ids()
+        if not type_ids:
+            self.stdout.write("No %-priced hull listings to refresh.")
+            return
+
+        total = 0
+        for type_id in type_ids:
+            changed = _apply_prices_for_type(type_id)
+            total += changed
+            self.stdout.write(f"  type {type_id}: {changed} listing(s) updated")
+        self.stdout.write(
+            self.style.SUCCESS(
+                f"Done — {total} listing(s) updated across {len(type_ids)} type(s)."
+            )
+        )

aa_shop-0.1.1/shop/management/commands/shop_refresh_stock.py

@@ -0,0 +1,42 @@
+"""Recompute stored hull stock for shops with auto-stock listings.
+
+Runs inline (synchronous) by default; pass --async to enqueue the Celery
+per-shop tasks instead (needs a worker).
+"""
+
+from django.core.management.base import BaseCommand
+
+from shop.models import AUTO_STOCK, Shop
+from shop.stock import recompute_shop_stock
+from shop.tasks import _enqueue_stock_refreshes
+
+
+class Command(BaseCommand):
+    help = "Recompute stored hull stock for shops with auto-stock listings."
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "--async",
+            action="store_true",
+            dest="use_async",
+            help="Enqueue Celery per-shop tasks instead of running inline.",
+        )
+
+    def handle(self, *args, **options):
+        if options["use_async"]:
+            shop_ids = _enqueue_stock_refreshes()
+            self.stdout.write(
+                self.style.SUCCESS(f"Enqueued {len(shop_ids)} shop refresh task(s).")
+            )
+            return
+
+        shops = list(
+            Shop.objects.filter(hull_listings__stock_mode=AUTO_STOCK).distinct()
+        )
+        if not shops:
+            self.stdout.write("No shops with auto-stock listings.")
+            return
+        for shop in shops:
+            recompute_shop_stock(shop)
+            self.stdout.write(f"  {shop.slug}: recomputed")
+        self.stdout.write(self.style.SUCCESS(f"Done — {len(shops)} shop(s)."))