feat: changes for citation ad dynamic

2026-05-17 18:51:26 +03:30
parent f0a9d5832b
commit b8ab67049f
22 changed files with 1170 additions and 287 deletions
@@ -1,7 +1,7 @@
 from django.core.management.base import BaseCommand
 from django.db import transaction

-from apps.pages.models import DownloadItem, FAQEntry
+from apps.pages.models import DownloadItem, FAQEntry, HomepageSection, HomepageSectionItem
 from apps.products.models import Article, ArticleSection, MainProduct, SubProduct

 MAIN_PRODUCTS = [
@@ -33,6 +33,8 @@ MAIN_PRODUCTS = [
                    "for consistent, reproducible research outcomes."
                ),
                "order": 1,
+                "show_on_homepage": True,
+                "homepage_order": 1,
                "articles": [
                    {
                        "title": "Image Filtering Techniques",
@@ -252,7 +254,7 @@ FAQ_ENTRIES = [
    {
        "question": "Where can I get support or report issues?",
        "answer": (
-            "Support is available via email at support@visera.ca and through our "
+            "Support is available via email at support@radiuma.ca and through our "
            "community Discord server. For bug reports and feature requests, please "
            "use the Discord forum or contact us directly by email."
        ),
@@ -260,6 +262,86 @@ FAQ_ENTRIES = [
    },
 ]

+HOMEPAGE_SECTIONS = [
+    {
+        "section_type": HomepageSection.TYPE_FEATURES,
+        "badge": "Capabilities",
+        "title": "Important Features",
+        "description": "Comprehensive tools for medical imaging research, standardized and reproducible.",
+        "order": 1,
+        "items": [
+            {"icon": "⚗️", "title": "Image Filtering", "content": "Standardized image filtering techniques compliant with IBSI 2.0 guidelines.", "order": 1},
+            {"icon": "🖥️", "title": "Professional Viewer", "content": "Comfortable, professional medical image viewer with multi-modality support.", "order": 2},
+            {"icon": "📊", "title": "Radiomics Features", "content": "Handcrafted radiomics feature generation standardized by IBSI 1.0.", "order": 3},
+            {"icon": "🔄", "title": "Format Support", "content": "NIFTI, DICOM, NRRD, and more — comprehensive multi-format support.", "order": 4},
+            {"icon": "🗂️", "title": "Image Registration", "content": "Advanced image registration, fusion, and standardized SUV conversion.", "order": 5},
+            {"icon": "🔬", "title": "RT Struct Support", "content": "Full RT struct support for radiation oncology workflows and research.", "order": 6},
+        ],
+    },
+    {
+        "section_type": HomepageSection.TYPE_SCREENSHOTS,
+        "badge": "Gallery",
+        "title": "See Radiuma in Action",
+        "description": "Explore Radiuma's powerful interface, workflow builder, and multi-modal image viewer.",
+        "order": 2,
+        "items": [],
+    },
+    {
+        "section_type": HomepageSection.TYPE_PRODUCTS,
+        "badge": "Our Software",
+        "title": "Products",
+        "description": "Explore our suite of medical imaging and radiomics tools.",
+        "order": 3,
+        "items": [],
+    },
+    {
+        "section_type": HomepageSection.TYPE_PROBLEMS,
+        "badge": "Value Proposition",
+        "title": "What Problems Does Radiuma Solve?",
+        "description": "",
+        "order": 4,
+        "items": [
+            {"icon": "01", "title": "Accessibility", "content": "Radiuma provides a user-friendly interface and a wide range of tools, allowing researchers to perform complex data analysis without extensive technical knowledge or programming expertise.", "order": 1},
+            {"icon": "02", "title": "Integrated Tools", "content": "Radiuma integrates a vast collection of tools and resources from various domains of healthcare and medical imaging research in a common, unified environment.", "order": 2},
+            {"icon": "03", "title": "Flexibility", "content": "Radiuma offers flexibility in terms of tool optimization and workflow customization to match your specific research requirements.", "order": 3},
+            {"icon": "04", "title": "Reproducibility", "content": "Improve usability, reusability, and reproducibility (URR) through a workflow management system that allows researchers to easily create, share, and reuse analysis pipelines.", "order": 4},
+        ],
+    },
+    {
+        "section_type": HomepageSection.TYPE_ABOUT_STRIP,
+        "badge": "Our Story",
+        "title": "More to Know",
+        "description": (
+            "Radiuma has been developing since 2021 by the Quantitative Radiomolecular Imaging "
+            "and Therapy (Qurit) lab & program at the University of British Columbia & "
+            "BC Cancer Research Institute, Vancouver, BC, Canada."
+        ),
+        "link_text": "Learn More",
+        "link_url": "/about/",
+        "order": 5,
+        "items": [],
+    },
+    {
+        "section_type": HomepageSection.TYPE_SUPPORTERS,
+        "badge": "Acknowledgements",
+        "title": "Our Supporters",
+        "description": "Radiuma is made possible by the support of leading research institutions and organizations.",
+        "order": 6,
+        "items": [
+            {
+                "title": "University of British Columbia",
+                "content": "Faculty of Medicine and the Department of Integrative Oncology.",
+                "order": 1,
+            },
+            {
+                "title": "BC Cancer Research Institute",
+                "content": "Supporting cutting-edge radiomics and medical imaging research in Vancouver, BC.",
+                "order": 2,
+            },
+        ],
+    },
+]
+
 DOWNLOAD_ITEMS = [
    {
        "name": "Radiuma Desktop",
@@ -292,7 +374,7 @@ DOWNLOAD_ITEMS = [


 class Command(BaseCommand):
-    help = "Seed the database with initial Radiuma / Radiuma content from visera.ca"
+    help = "Seed the database with initial Radiuma / Radiuma content from radiuma.ca"

    def add_arguments(self, parser):
        parser.add_argument(
@@ -311,14 +393,21 @@ class Command(BaseCommand):
            MainProduct.objects.all().delete()
            FAQEntry.objects.all().delete()
            DownloadItem.objects.all().delete()
+            HomepageSectionItem.objects.all().delete()
+            HomepageSection.objects.all().delete()

        self._seed_products()
        self._seed_faq()
        self._seed_downloads()
+        self._seed_homepage_sections()

        self.stdout.write(self.style.SUCCESS("Content seeded successfully."))

    def _seed_products(self):
+        SubProduct.objects.filter(show_on_homepage=False, homepage_order=0).update(
+            show_on_homepage=True,
+        )
+
        for product_data in MAIN_PRODUCTS:
            sub_products_data = product_data.pop("sub_products")
            main_product, created = MainProduct.objects.get_or_create(
@@ -384,6 +473,28 @@ class Command(BaseCommand):
            action = "Created" if created else "Updated"
            self.stdout.write(f"  {action} FAQ: {faq.question[:60]}...")

+    def _seed_homepage_sections(self):
+        for section_data in HOMEPAGE_SECTIONS:
+            items_data = section_data.pop("items")
+            section, created = HomepageSection.objects.get_or_create(
+                section_type=section_data["section_type"],
+                defaults=section_data,
+            )
+            if not created:
+                for field, value in section_data.items():
+                    setattr(section, field, value)
+                section.save()
+
+            action = "Created" if created else "Updated"
+            self.stdout.write(f"  {action} homepage section: {section}")
+
+            for item_data in items_data:
+                item, _ = HomepageSectionItem.objects.get_or_create(
+                    section=section,
+                    title=item_data["title"],
+                    defaults=item_data,
+                )
+
    def _seed_downloads(self):
        for item_data in DOWNLOAD_ITEMS:
            item, created = DownloadItem.objects.get_or_create(
@@ -1,6 +1,54 @@
 from django.contrib import admin

-from .models import ContactSubmission, DownloadItem, FAQEntry
+from .models import (
+    AboutSection,
+    AboutSectionItem,
+    ContactSubmission,
+    DownloadItem,
+    FAQEntry,
+    HomepageSection,
+    HomepageSectionItem,
+)
+
+
+class HomepageSectionItemInline(admin.TabularInline):
+    model = HomepageSectionItem
+    extra = 1
+    fields = ("icon", "title", "content", "image", "order")
+    ordering = ("order",)
+
+
+@admin.register(HomepageSection)
+class HomepageSectionAdmin(admin.ModelAdmin):
+    list_display = ("section_type", "badge", "title", "order", "is_active")
+    list_filter = ("section_type", "is_active")
+    list_editable = ("order", "is_active")
+    inlines = [HomepageSectionItemInline]
+    fieldsets = (
+        (None, {"fields": ("section_type", "badge", "title", "description")}),
+        ("CTA Link (About Strip)", {"fields": ("link_text", "link_url"), "classes": ("collapse",)}),
+        ("Settings", {"fields": ("order", "is_active")}),
+    )
+
+
+class AboutSectionItemInline(admin.StackedInline):
+    model = AboutSectionItem
+    extra = 1
+    fields = ("badge", "title", "content", "url", "image", "image_alt", "is_featured", "order")
+    ordering = ("order",)
+
+
+@admin.register(AboutSection)
+class AboutSectionAdmin(admin.ModelAdmin):
+    list_display = ("section_type", "badge", "title", "order", "is_active")
+    list_filter = ("section_type", "is_active")
+    list_editable = ("order", "is_active")
+    inlines = [AboutSectionItemInline]
+    fieldsets = (
+        (None, {"fields": ("section_type", "badge", "title", "subtitle")}),
+        ("Content", {"fields": ("content_format", "content")}),
+        ("Settings", {"fields": ("order", "is_active")}),
+    )


@admin.register(ContactSubmission)
@@ -0,0 +1,103 @@
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("pages", "0003_faqentry_answer_format"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="AboutSection",
+            fields=[
+                ("id", models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name="ID")),
+                (
+                    "section_type",
+                    models.CharField(
+                        choices=[
+                            ("hero", "Hero"),
+                            ("intro", "Intro Card"),
+                            ("grid", "Grid Cards"),
+                            ("history", "History Block"),
+                            ("custom", "Custom Content"),
+                        ],
+                        default="custom",
+                        max_length=30,
+                    ),
+                ),
+                ("badge", models.CharField(blank=True, max_length=100)),
+                ("title", models.CharField(blank=True, max_length=300)),
+                (
+                    "subtitle",
+                    models.CharField(
+                        blank=True,
+                        help_text="Used as subtitle in Hero and year in History.",
+                        max_length=500,
+                    ),
+                ),
+                ("content", models.TextField(blank=True)),
+                (
+                    "content_format",
+                    models.CharField(
+                        choices=[
+                            ("plain", "Plain Text"),
+                            ("markdown", "Markdown"),
+                            ("html", "HTML"),
+                        ],
+                        default="markdown",
+                        max_length=20,
+                    ),
+                ),
+                ("order", models.PositiveIntegerField(default=0)),
+                ("is_active", models.BooleanField(default=True)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+            ],
+            options={
+                "verbose_name": "About Section",
+                "verbose_name_plural": "About Sections",
+                "ordering": ["order"],
+            },
+        ),
+        migrations.CreateModel(
+            name="AboutSectionItem",
+            fields=[
+                ("id", models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name="ID")),
+                (
+                    "section",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="items",
+                        to="pages.aboutsection",
+                    ),
+                ),
+                ("badge", models.CharField(blank=True, max_length=100)),
+                ("title", models.CharField(blank=True, max_length=300)),
+                (
+                    "content",
+                    models.TextField(
+                        blank=True,
+                        help_text="Description text or link label for History links.",
+                    ),
+                ),
+                ("url", models.URLField(blank=True, help_text="Used for History block links.")),
+                ("image", models.ImageField(blank=True, null=True, upload_to="about/")),
+                ("image_alt", models.CharField(blank=True, max_length=200)),
+                (
+                    "is_featured",
+                    models.BooleanField(
+                        default=False,
+                        help_text="Mark as featured item (e.g. large screenshot).",
+                    ),
+                ),
+                ("order", models.PositiveIntegerField(default=0)),
+            ],
+            options={
+                "verbose_name": "About Section Item",
+                "verbose_name_plural": "About Section Items",
+                "ordering": ["order"],
+            },
+        ),
+    ]
@@ -0,0 +1,49 @@
+# Generated by Django 5.0.2 on 2026-05-17 14:39
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('pages', '0004_aboutsection_aboutsectionitem'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='HomepageSection',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('section_type', models.CharField(choices=[('features', 'Features'), ('screenshots', 'Screenshots Gallery'), ('products', 'Products'), ('problems', 'Problems / Value Proposition'), ('about_strip', 'About Strip')], max_length=30, unique=True)),
+                ('badge', models.CharField(blank=True, max_length=100)),
+                ('title', models.CharField(blank=True, max_length=300)),
+                ('description', models.TextField(blank=True)),
+                ('link_text', models.CharField(blank=True, help_text='CTA button label (About Strip).', max_length=100)),
+                ('link_url', models.CharField(blank=True, help_text='CTA button URL (About Strip).', max_length=300)),
+                ('order', models.PositiveIntegerField(default=0)),
+                ('is_active', models.BooleanField(default=True)),
+            ],
+            options={
+                'verbose_name': 'Homepage Section',
+                'verbose_name_plural': 'Homepage Sections',
+                'ordering': ['order'],
+            },
+        ),
+        migrations.CreateModel(
+            name='HomepageSectionItem',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('icon', models.CharField(blank=True, help_text='Emoji or short symbol (e.g. ⚗️).', max_length=20)),
+                ('title', models.CharField(blank=True, max_length=300)),
+                ('content', models.TextField(blank=True)),
+                ('order', models.PositiveIntegerField(default=0)),
+                ('section', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='items', to='pages.homepagesection')),
+            ],
+            options={
+                'verbose_name': 'Homepage Section Item',
+                'verbose_name_plural': 'Homepage Section Items',
+                'ordering': ['order'],
+            },
+        ),
+    ]
@@ -0,0 +1,23 @@
+# Generated by Django 5.0.2 on 2026-05-17 14:59
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('pages', '0005_homepage_sections'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='homepagesectionitem',
+            name='image',
+            field=models.ImageField(blank=True, help_text='Logo or image (used for Supporters cards).', null=True, upload_to='homepage/items/'),
+        ),
+        migrations.AlterField(
+            model_name='homepagesection',
+            name='section_type',
+            field=models.CharField(choices=[('features', 'Features'), ('screenshots', 'Screenshots Gallery'), ('products', 'Products'), ('problems', 'Problems / Value Proposition'), ('about_strip', 'About Strip'), ('supporters', 'Supporters')], max_length=30, unique=True),
+        ),
+    ]
@@ -1,6 +1,118 @@
 from django.db import models

-from apps.core.utils import CONTENT_FORMAT_CHOICES, FORMAT_PLAIN, render_content
+from apps.core.utils import CONTENT_FORMAT_CHOICES, FORMAT_MARKDOWN, FORMAT_PLAIN, render_content
+
+
+class HomepageSection(models.Model):
+    TYPE_FEATURES = "features"
+    TYPE_SCREENSHOTS = "screenshots"
+    TYPE_PRODUCTS = "products"
+    TYPE_PROBLEMS = "problems"
+    TYPE_ABOUT_STRIP = "about_strip"
+    TYPE_SUPPORTERS = "supporters"
+
+    TYPE_CHOICES = [
+        (TYPE_FEATURES, "Features"),
+        (TYPE_SCREENSHOTS, "Screenshots Gallery"),
+        (TYPE_PRODUCTS, "Products"),
+        (TYPE_PROBLEMS, "Problems / Value Proposition"),
+        (TYPE_ABOUT_STRIP, "About Strip"),
+        (TYPE_SUPPORTERS, "Supporters"),
+    ]
+
+    section_type = models.CharField(max_length=30, choices=TYPE_CHOICES, unique=True)
+    badge = models.CharField(max_length=100, blank=True)
+    title = models.CharField(max_length=300, blank=True)
+    description = models.TextField(blank=True)
+    link_text = models.CharField(max_length=100, blank=True, help_text="CTA button label (About Strip).")
+    link_url = models.CharField(max_length=300, blank=True, help_text="CTA button URL (About Strip).")
+    order = models.PositiveIntegerField(default=0)
+    is_active = models.BooleanField(default=True)
+
+    class Meta:
+        ordering = ["order"]
+        verbose_name = "Homepage Section"
+        verbose_name_plural = "Homepage Sections"
+
+    def __str__(self):
+        return f"[{self.get_section_type_display()}] {self.title or self.badge}"
+
+
+class HomepageSectionItem(models.Model):
+    section = models.ForeignKey(HomepageSection, on_delete=models.CASCADE, related_name="items")
+    icon = models.CharField(max_length=20, blank=True, help_text="Emoji or short symbol (e.g. ⚗️).")
+    title = models.CharField(max_length=300, blank=True)
+    content = models.TextField(blank=True)
+    image = models.ImageField(upload_to="homepage/items/", blank=True, null=True, help_text="Logo or image (used for Supporters cards).")
+    order = models.PositiveIntegerField(default=0)
+
+    class Meta:
+        ordering = ["order"]
+        verbose_name = "Homepage Section Item"
+        verbose_name_plural = "Homepage Section Items"
+
+    def __str__(self):
+        return f"{self.section} › {self.title or self.icon or '(item)'}"
+
+
+class AboutSection(models.Model):
+    TYPE_HERO = "hero"
+    TYPE_INTRO = "intro"
+    TYPE_GRID = "grid"
+    TYPE_HISTORY = "history"
+    TYPE_CUSTOM = "custom"
+
+    TYPE_CHOICES = [
+        (TYPE_HERO, "Hero"),
+        (TYPE_INTRO, "Intro Card"),
+        (TYPE_GRID, "Grid Cards"),
+        (TYPE_HISTORY, "History Block"),
+        (TYPE_CUSTOM, "Custom Content"),
+    ]
+
+    section_type = models.CharField(max_length=30, choices=TYPE_CHOICES, default=TYPE_CUSTOM)
+    badge = models.CharField(max_length=100, blank=True)
+    title = models.CharField(max_length=300, blank=True)
+    subtitle = models.CharField(max_length=500, blank=True, help_text="Used as subtitle in Hero and year in History.")
+    content = models.TextField(blank=True)
+    content_format = models.CharField(max_length=20, choices=CONTENT_FORMAT_CHOICES, default=FORMAT_MARKDOWN)
+    order = models.PositiveIntegerField(default=0)
+    is_active = models.BooleanField(default=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        ordering = ["order"]
+        verbose_name = "About Section"
+        verbose_name_plural = "About Sections"
+
+    @property
+    def rendered_content(self):
+        return render_content(self.content, self.content_format)
+
+    def __str__(self):
+        label = self.title or self.badge or self.get_section_type_display()
+        return f"[{self.get_section_type_display()}] {label}"
+
+
+class AboutSectionItem(models.Model):
+    section = models.ForeignKey(AboutSection, on_delete=models.CASCADE, related_name="items")
+    badge = models.CharField(max_length=100, blank=True)
+    title = models.CharField(max_length=300, blank=True)
+    content = models.TextField(blank=True, help_text="Description text or link label for History links.")
+    url = models.URLField(blank=True, help_text="Used for History block links.")
+    image = models.ImageField(upload_to="about/", blank=True, null=True)
+    image_alt = models.CharField(max_length=200, blank=True)
+    is_featured = models.BooleanField(default=False, help_text="Mark as featured item (e.g. large screenshot).")
+    order = models.PositiveIntegerField(default=0)
+
+    class Meta:
+        ordering = ["order"]
+        verbose_name = "About Section Item"
+        verbose_name_plural = "About Section Items"
+
+    def __str__(self):
+        return f"{self.section} › {self.title or self.badge or '(item)'}"


 class ContactSubmission(models.Model):
@@ -5,17 +5,42 @@ from django.shortcuts import render
 from django.views import View
 from django.views.generic import ListView, TemplateView

+from apps.products.models import SubProduct
+
 from .forms import ContactForm
-from .models import ContactSubmission, FAQEntry
+from .models import AboutSection, ContactSubmission, FAQEntry, HomepageSection


 class HomeView(TemplateView):
    template_name = "pages/home.html"

+    def get_context_data(self, **kwargs):
+        ctx = super().get_context_data(**kwargs)
+        ctx["homepage_sections"] = (
+            HomepageSection.objects.filter(is_active=True)
+            .prefetch_related("items")
+            .order_by("order")
+        )
+        ctx["sub_products"] = (
+            SubProduct.objects.filter(is_active=True, show_on_homepage=True)
+            .select_related("main_product")
+            .order_by("homepage_order", "order")
+        )
+        return ctx
+

 class AboutView(TemplateView):
    template_name = "pages/about.html"

+    def get_context_data(self, **kwargs):
+        ctx = super().get_context_data(**kwargs)
+        ctx["about_sections"] = (
+            AboutSection.objects.filter(is_active=True)
+            .prefetch_related("items")
+            .order_by("order")
+        )
+        return ctx
+

 class FAQView(ListView):
    model = FAQEntry
@@ -1,6 +1,13 @@
 from django.contrib import admin

-from .models import Article, ArticleSection, MainProduct, SubProduct, SubProductVersion
+from .models import Article, ArticleCitation, ArticleSection, MainProduct, SubProduct, SubProductVersion
+
+
+class ArticleCitationInline(admin.TabularInline):
+    model = ArticleCitation
+    extra = 1
+    fields = ("text", "url", "order")
+    ordering = ("order",)


 class ArticleSectionInline(admin.TabularInline):
@@ -13,7 +20,7 @@ class ArticleSectionInline(admin.TabularInline):
 class ArticleInline(admin.StackedInline):
    model = Article
    extra = 0
-    fields = ("title", "description", "order")
+    fields = ("badge", "title", "description", "order")
    ordering = ("order",)
    show_change_link = True

@@ -39,7 +46,7 @@ class SubProductVersionInline(admin.TabularInline):
 class SubProductInline(admin.StackedInline):
    model = SubProduct
    extra = 0
-    fields = ("name", "slug", "distribution", "short_description", "image", "order", "is_active")
+    fields = ("name", "slug", "distribution", "short_description", "image", "logo", "show_on_homepage", "homepage_order", "order", "is_active")
    ordering = ("order",)
    show_change_link = True
    prepopulated_fields = {"slug": ("name",)}
@@ -67,20 +74,23 @@ class SubProductAdmin(admin.ModelAdmin):
        "name",
        "main_product",
        "distribution",
+        "show_on_homepage",
+        "homepage_order",
        "order",
        "is_active",
        "created_at",
    )
-    list_filter = ("is_active", "distribution", "main_product")
+    list_filter = ("is_active", "distribution", "main_product", "show_on_homepage")
    search_fields = ("name", "description", "main_product__name")
    prepopulated_fields = {"slug": ("name",)}
-    list_editable = ("order", "is_active")
+    list_editable = ("order", "is_active", "show_on_homepage", "homepage_order")
    raw_id_fields = ("main_product",)
    inlines = [ArticleInline, SubProductVersionInline]
    fieldsets = (
        (None, {"fields": ("main_product", "name", "slug", "distribution", "short_description")}),
        ("Description", {"fields": ("description_format", "description")}),
-        ("Media", {"fields": ("image",)}),
+        ("Media", {"fields": ("image", "logo")}),
+        ("Homepage", {"fields": ("show_on_homepage", "homepage_order")}),
        ("Settings", {"fields": ("order", "is_active")}),
    )

@@ -92,10 +102,11 @@ class ArticleAdmin(admin.ModelAdmin):
    search_fields = ("title", "description")
    list_editable = ("order",)
    raw_id_fields = ("sub_product",)
-    inlines = [ArticleSectionInline]
+    inlines = [ArticleSectionInline, ArticleCitationInline]
    fieldsets = (
-        (None, {"fields": ("sub_product", "title")}),
+        (None, {"fields": ("sub_product", "badge", "title")}),
        ("Description", {"fields": ("description_format", "description")}),
+        ("Citation Badge", {"fields": ("citation_count_display",), "description": "Set a number to show the dashed citation circle badge at the bottom-right of the article card. Leave blank to hide it."}),
        ("Settings", {"fields": ("order",)}),
    )

@@ -0,0 +1,22 @@
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("products", "0004_distribution_and_versions"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="article",
+            name="badge",
+            field=models.CharField(
+                blank=True,
+                default="",
+                help_text="Optional label shown above the article title (e.g. 'Overview', 'Note').",
+                max_length=100,
+            ),
+            preserve_default=False,
+        ),
+    ]
@@ -0,0 +1,49 @@
+# Generated by Django 5.0.2 on 2026-05-17 14:59
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('products', '0005_article_badge'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='subproduct',
+            name='homepage_order',
+            field=models.PositiveIntegerField(default=0, help_text='Order within the homepage Products section.'),
+        ),
+        migrations.AddField(
+            model_name='subproduct',
+            name='logo',
+            field=models.ImageField(blank=True, help_text='Small logo shown as a corner badge on homepage product cards.', null=True, upload_to='products/sub_logos/'),
+        ),
+        migrations.AddField(
+            model_name='subproduct',
+            name='show_on_homepage',
+            field=models.BooleanField(default=False, help_text='Display this sub-product in the homepage Products section.'),
+        ),
+        migrations.AlterField(
+            model_name='subproductversion',
+            name='package_resource_url',
+            field=models.URLField(blank=True, help_text='Shown on the site when set. For Resources it is the main Open link; for Installable it appears under the platform grid.'),
+        ),
+        migrations.CreateModel(
+            name='ArticleCitation',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('text', models.TextField(help_text='Full citation text.')),
+                ('url', models.URLField(blank=True, help_text='Optional link to the cited source.')),
+                ('order', models.PositiveIntegerField(default=0)),
+                ('article', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='citations', to='products.article')),
+            ],
+            options={
+                'verbose_name': 'Article Citation',
+                'verbose_name_plural': 'Article Citations',
+                'ordering': ['order', 'pk'],
+            },
+        ),
+    ]
@@ -0,0 +1,18 @@
+# Generated by Django 5.0.2 on 2026-05-17 15:16
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('products', '0006_subproduct_logo_homepage_citations'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='article',
+            name='citation_count_display',
+            field=models.PositiveSmallIntegerField(blank=True, help_text='Optional number shown in the dashed citation circle badge at the bottom of the article card. Leave blank to hide the badge.', null=True),
+        ),
+    ]
@@ -69,8 +69,11 @@ class SubProduct(models.Model):
        max_length=20, choices=CONTENT_FORMAT_CHOICES, default=FORMAT_PLAIN
    )
    image = models.ImageField(upload_to="products/sub/", blank=True, null=True)
+    logo = models.ImageField(upload_to="products/sub_logos/", blank=True, null=True, help_text="Small logo shown as a corner badge on homepage product cards.")
    order = models.PositiveIntegerField(default=0)
    is_active = models.BooleanField(default=True)
+    show_on_homepage = models.BooleanField(default=False, help_text="Display this sub-product in the homepage Products section.")
+    homepage_order = models.PositiveIntegerField(default=0, help_text="Order within the homepage Products section.")
    distribution = models.CharField(
        max_length=20,
        choices=DISTRIBUTION_CHOICES,
@@ -123,11 +126,21 @@ class Article(models.Model):
        on_delete=models.CASCADE,
        related_name="articles",
    )
+    badge = models.CharField(
+        max_length=100,
+        blank=True,
+        help_text="Optional label shown above the article title (e.g. 'Overview', 'Note').",
+    )
    title = models.CharField(max_length=300)
    description = models.TextField()
    description_format = models.CharField(
        max_length=20, choices=CONTENT_FORMAT_CHOICES, default=FORMAT_PLAIN
    )
+    citation_count_display = models.PositiveSmallIntegerField(
+        null=True,
+        blank=True,
+        help_text="Optional number shown in the dashed citation circle badge at the bottom of the article card. Leave blank to hide the badge.",
+    )
    order = models.PositiveIntegerField(default=0)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)
@@ -219,3 +232,22 @@ class ArticleSection(models.Model):

    def __str__(self):
        return f"{self.article.title} › {self.title}"
+
+
+class ArticleCitation(models.Model):
+    article = models.ForeignKey(
+        Article,
+        on_delete=models.CASCADE,
+        related_name="citations",
+    )
+    text = models.TextField(help_text="Full citation text.")
+    url = models.URLField(blank=True, help_text="Optional link to the cited source.")
+    order = models.PositiveIntegerField(default=0)
+
+    class Meta:
+        ordering = ["order", "pk"]
+        verbose_name = "Article Citation"
+        verbose_name_plural = "Article Citations"
+
+    def __str__(self):
+        return f"{self.article.title} — citation {self.order or self.pk}"