feat(birthboard): 通知发件人配置化、审核提醒开关与后台管理增强

- 通知发件人改由 config.birthboard.sender_username/sender_name 控制，
  notify.py 统一改用 record.log logger，避免发件人缺失时静默失败；
  新增 ensure_birthboard_sender 幂等创建官方组织账号的命令。
- 一审/二审员新增 reminder_enabled 开关：关闭后仍可审核，但不再接收
  自动重复审核提醒（notify_approval_reminder 只发给开启者）。
- 投放记录接入 admin：只读流程字段 + 参与者/变更记录只读内联，可改 date；
  审核员/二审员管理页提供内联开关。
- 四个模型补充中文 verbose_name 并用序号前缀控制 admin 显示顺序。
- config_template.json：birthboard 段新增 sender_username/sender_name；
  scheduler.use_scheduler 默认改为 true（新部署默认启用调度集成）。

Files changed:
- birthboard/config.py: 新增 sender_username/sender_name 配置项。
- birthboard/notify.py: 发件人读取 config（_sender_user），logger 换统一 logger；审核提醒按 reminder_enabled 过滤。
- birthboard/management/commands/ensure_birthboard_sender.py: 新增幂等创建发件人命令。
- birthboard/models.py: approver/second approver 新增 reminder_enabled；四个模型加中文 verbose_name。
- birthboard/admin.py: 审核员内联开关；投放记录只读 admin 与参与者/变更记录只读内联。
- birthboard/migrations/0015_*: 新增 reminder_enabled 字段。
- birthboard/migrations/0016_*: 模型 Meta 选项（verbose_name）变更。
- birthboard/tests.py: 通知发件人与提醒开关回归测试。
- config_template.json: birthboard 段新增发件人配置；scheduler.use_scheduler 默认 true。

Author: sparrowbot

birthboard/admin.py

@@ -1,25 +1,119 @@
 from django.contrib import admin
+from django.utils.html import format_html
 from birthboard.models import (
     BirthboardApprover,
     BirthboardContract,
+    BirthboardParticipant,
+    BirthboardRecord,
     BirthboardSecondApprover,
+    ChangeRecord,
 )
 
 @admin.register(BirthboardApprover)
 class BirthboardApproverAdmin(admin.ModelAdmin):
-    list_display = ("user", "is_active", "created_at", "note")
+    # is_active：是否允许该审核员参与审核；reminder_enabled：是否接收自动重复审核提醒
+    # 两者独立，均可在列表内直接勾选/取消，保存即生效。
+    list_display = ("user", "is_active", "reminder_enabled", "created_at", "note")
+    list_editable = ("is_active", "reminder_enabled")
     search_fields = ("user__username", "user__first_name", "user__last_name")
-    list_filter = ("is_active",)
+    list_filter = ("is_active", "reminder_enabled")
     autocomplete_fields = ["user"]
 
 @admin.register(BirthboardSecondApprover)
 class BirthboardSecondApproverAdmin(admin.ModelAdmin):
-    list_display = ("user", "is_active", "created_at", "note")
+    list_display = ("user", "is_active", "reminder_enabled", "created_at", "note")
+    list_editable = ("is_active", "reminder_enabled")
     search_fields = ("user__username", "user__first_name", "user__last_name")
-    list_filter = ("is_active",)
+    list_filter = ("is_active", "reminder_enabled")
     autocomplete_fields = ["user"]
 
 
+class _ReadOnlyInline(admin.TabularInline):
+    """只读内联基类：子记录仅用于查看，禁止新增/删除/编辑。"""
+    extra = 0
+    can_delete = False
+
+    def has_add_permission(self, request, obj=None):
+        return False
+
+    def has_change_permission(self, request, obj=None):
+        return False
+
+    def has_delete_permission(self, request, obj=None):
+        return False
+
+
+class BirthboardParticipantInline(_ReadOnlyInline):
+    """投放参与者明细（送出人/寿星、角色、扣款状态等）。"""
+    model = BirthboardParticipant
+    fields = (
+        "user", "role", "is_initiator", "cost", "status", "action_time",
+    )
+
+
+class ChangeRecordInline(_ReadOnlyInline):
+    """投放变更审计记录（操作、前后状态、详情等）。"""
+    model = ChangeRecord
+    # created_at 为 auto_now_add（不可编辑），只能经 readonly_fields 展示
+    fields = (
+        "actor", "action", "before_status", "after_status", "detail",
+    )
+    readonly_fields = ("created_at",)
+
+
+@admin.register(BirthboardRecord)
+class BirthboardRecordAdmin(admin.ModelAdmin):
+    """投放记录后台：以查看/检索为主，流程字段只读。
+
+    状态、金额、审批与投放同步等字段的变更涉及退款、通知与屏幕同步，必须走
+    业务入口（页面/任务），禁止在 admin 直接修改，避免绕过事务与审计。
+    记录由业务流程创建，admin 不提供新增。
+    """
+    list_display = (
+        "id",
+        "receiver_name",
+        "receiver_username",
+        "date",
+        "status",
+        "per_cost",
+        "is_anonymous",
+        "thumbnail_preview",
+        "created_at",
+    )
+    list_display_links = ("id", "receiver_name")
+    list_filter = ("status", "date", "is_anonymous")
+    search_fields = ("receiver_name", "receiver_username", "id")
+    date_hierarchy = "date"
+    # 详情页同时内联展示参与者明细与变更审计记录（只读）
+    inlines = (BirthboardParticipantInline, ChangeRecordInline)
+    readonly_fields = (
+        "receiver_username",
+        "mode",
+        "per_cost",
+        "status",
+        "created_at",
+        "first_approved",
+        "first_approver",
+        "first_approved_at",
+        "second_approver",
+        "second_approved_at",
+        "display_takedown_pending",
+    )
+
+    @admin.display(description="缩略图")
+    def thumbnail_preview(self, obj):
+        """列表里直接预览海报缩略图，便于核对内容。"""
+        if not obj.thumbnail:
+            return "—"
+        return format_html(
+            '<img src="{}" height="40" style="border-radius:4px" />',
+            obj.thumbnail.url,
+        )
+
+    def has_add_permission(self, request):
+        return False
+
+
 @admin.register(BirthboardContract)
 class BirthboardContractAdmin(admin.ModelAdmin):
     list_display = ("user", "signed", "signed_at", "restricted_until")

birthboard/config.py

@@ -21,6 +21,20 @@ class BirthboardConfig(Config):
         type=int,
     )
     max_senders = LazySetting('max_senders', default=20, type=int)
+    # 站内信/企业微信通知的发件人官方组织账号（Organization 类型）。
+    # 用管理命令 `python manage.py ensure_birthboard_sender` 幂等创建；
+    # 切换发件人只需改这里的 username（指向真实存在的组织账号）。
+    sender_username = LazySetting(
+        'sender_username',
+        default='yppf_birthboard',
+        type=str,
+    )
+    # 该发件人组织的显示名（Organization.oname / User.name），供创建命令使用。
+    sender_name = LazySetting(
+        'sender_name',
+        default='生日灯牌',
+        type=str,
+    )
 
 
 CONFIG = BirthboardConfig(ROOT_CONFIG.get('birthboard', {}))

birthboard/management/commands/ensure_birthboard_sender.py

@@ -0,0 +1,86 @@
+"""幂等创建 birthboard 官方发送组织账号（站内信/企业微信通知的发件人）。
+
+发件人账号与组织名由 birthboard config 决定：
+    config.birthboard.sender_username（默认 yppf_birthboard）
+    config.birthboard.sender_name（默认 生日灯牌）
+改 config.json 后重新运行本命令即可切换/补齐账号。
+
+用法：
+    python manage.py ensure_birthboard_sender
+"""
+from django.core.management.base import BaseCommand
+
+from generic.models import User
+from app.models import Organization, OrganizationType
+
+from birthboard.config import CONFIG
+
+
+class Command(BaseCommand):
+    help = 'Ensure the birthboard official sender org account exists (config-driven).'
+
+    def handle(self, *args, **options):
+        username = CONFIG.sender_username
+        name = CONFIG.sender_name
+        if not username or not name:
+            self.stderr.write(self.style.ERROR(
+                'birthboard.sender_username / sender_name 未配置，无法创建发送账号。'))
+            return
+
+        # 1) 确保账号（User，Organization 类型）存在
+        user = User.objects.filter(username=username).first()
+        if user is None:
+            user = User.objects.create_user(
+                username=username,
+                name=name,
+                usertype=User.Type.ORG,
+                active=True,
+                is_active=True,
+                is_newuser=False,
+            )
+            self.stdout.write(self.style.SUCCESS(
+                f'创建发送账号：{username}（{name}）'))
+        else:
+            updates = {}
+            if user.name != name:
+                updates['name'] = name
+            if user.utype != User.Type.ORG:
+                updates['utype'] = User.Type.ORG
+            if not user.active:
+                updates['active'] = True
+            if not user.is_active:
+                updates['is_active'] = True
+            if user.is_newuser:
+                updates['is_newuser'] = False
+            if updates:
+                User.objects.filter(pk=user.pk).update(**updates)
+                self.stdout.write(self.style.WARNING(
+                    f'更新发送账号字段：{", ".join(sorted(updates))}'))
+
+        # 2) 确保账号对应的组织资料（Organization 一对一）存在
+        org = Organization.objects.filter(organization_id=user).first()
+        if org is not None:
+            if org.oname != name:
+                self.stdout.write(self.style.WARNING(
+                    f'组织资料已存在（oname={org.oname}），与 sender_name={name!r} 不一致，'
+                    '未自动改名，请按需在 admin 调整。'))
+            return
+        # 组织名唯一，先检查是否被其它账号占用
+        org_by_name = Organization.objects.filter(oname=name).first()
+        if org_by_name is not None:
+            self.stderr.write(self.style.ERROR(
+                f'组织名 {name!r} 已被其他账号（{org_by_name.organization_id.username}）'
+                '占用，请调整 birthboard.sender_name。'))
+            return
+        otype = OrganizationType.objects.order_by('otype_id').first()
+        if otype is None:
+            self.stderr.write(self.style.ERROR(
+                '数据库中不存在 OrganizationType，无法为发送账号创建组织资料。'))
+            return
+        Organization.objects.create(
+            organization_id=user,
+            oname=name,
+            otype=otype,
+        )
+        self.stdout.write(self.style.SUCCESS(
+            f'创建组织资料：{name}（账号 {username}）'))

birthboard/migrations/0015_birthboardapprover_reminder_enabled_and_more.py

@@ -0,0 +1,23 @@
+# Generated by Django 5.2.13 on 2026-09-04 23:31
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('birthboard', '0014_harden_review_and_takedown'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='birthboardapprover',
+            name='reminder_enabled',
+            field=models.BooleanField(default=True, verbose_name='接收重复提醒'),
+        ),
+        migrations.AddField(
+            model_name='birthboardsecondapprover',
+            name='reminder_enabled',
+            field=models.BooleanField(default=True, verbose_name='接收重复提醒'),
+        ),
+    ]

birthboard/migrations/0016_alter_birthboardapprover_options_and_more.py

@@ -0,0 +1,29 @@
+# Generated by Django 5.2.13 on 2026-09-04 23:49
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('birthboard', '0015_birthboardapprover_reminder_enabled_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='birthboardapprover',
+            options={'verbose_name': '初审人员', 'verbose_name_plural': '1.初审人员'},
+        ),
+        migrations.AlterModelOptions(
+            name='birthboardcontract',
+            options={'verbose_name': '协议记录', 'verbose_name_plural': '3.协议记录与小黑屋'},
+        ),
+        migrations.AlterModelOptions(
+            name='birthboardrecord',
+            options={'verbose_name': '灯牌记录', 'verbose_name_plural': '4.灯牌记录'},
+        ),
+        migrations.AlterModelOptions(
+            name='birthboardsecondapprover',
+            options={'verbose_name': '终审人员', 'verbose_name_plural': '2.终审人员'},
+        ),
+    ]

birthboard/models.py

@@ -17,6 +17,10 @@
 # Create your models here.
 # 生日祝福投放记录模型，顶格定义
 class BirthboardRecord(models.Model):
+    class Meta:
+        verbose_name = '灯牌记录'
+        verbose_name_plural = '4.灯牌记录'
+
     receiver_username = models.CharField(max_length=64)
     receiver_name = models.CharField(max_length=64)
     date = models.DateField()
@@ -95,8 +99,14 @@ def log(cls, record, actor=None, action='', before_status='', after_status='', d
         )
 # 二审员名单表
 class BirthboardSecondApprover(models.Model):
+    class Meta:
+        verbose_name = '终审人员'
+        verbose_name_plural = '2.终审人员'
+
     user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='birthboard_second_approver')
     is_active = models.BooleanField(default=True)
+    # 是否接收自动重复审核提醒；关闭后仍可正常审核，只是不再被提醒打扰
+    reminder_enabled = models.BooleanField('接收重复提醒', default=True)
     created_at = models.DateTimeField(auto_now_add=True)
     note = models.CharField(max_length=64, blank=True, default='', help_text='备注')
 
@@ -153,8 +163,14 @@ def __str__(self):
 
 # 审核员名单表
 class BirthboardApprover(models.Model):
+    class Meta:
+        verbose_name = '初审人员'
+        verbose_name_plural = '1.初审人员'
+
     user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='birthboard_approver')
     is_active = models.BooleanField(default=True)
+    # 是否接收自动重复审核提醒；关闭后仍可正常审核，只是不再被提醒打扰
+    reminder_enabled = models.BooleanField('接收重复提醒', default=True)
     created_at = models.DateTimeField(auto_now_add=True)
     note = models.CharField(max_length=64, blank=True, default='', help_text='备注')
 
@@ -163,6 +179,10 @@ def __str__(self):
 
 # 用户协议签署记录
 class BirthboardContract(models.Model):
+    class Meta:
+        verbose_name = '协议记录'
+        verbose_name_plural = '3.协议记录与小黑屋'
+
     user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='birthboard_contract')
     signed = models.BooleanField('已签署', default=False)
     signed_at = models.DateTimeField('签署时间', null=True, blank=True)