[Feat/birthboard] 生日灯牌功能正式PR

[sparrowbot]

feat: 新增生日板（birthboard）模块——YQPoint 付费生日祝福投放系统

本 PR 新增生日板模块，打通"发起、凑份子付款、寿星确认、审核、定时投放"全流程，并与 YQPoint 积分、企业微信通知、定时任务深度集成。

核心功能：

1. 完整状态机：等待确认、等待寿星确认、等待审批、就绪、投放中、完成，及终止/驳回/撤销等终止态，每次变更都有审计日志（ChangeRecord）。
2. 发起与凑份子：支持匿名发起、邀请送出人、按人扣减 YQPoint、寿星确认后进入审核。
3. 两级审核：审核员一审、二审员二审；驳回需选择违规类型并填写原因；名单可通过 admin 配置。
4. 定时投放：每晚 23:45 调度任务切换就绪/到期记录，并用 Playwright 自动化操作外部投放屏（shihannet）完成实机投放。
5. 超时与退款：每日 12:00 对 D-3 未确认者提醒、D-1 未确认者自动拒绝并原子退款（悲观锁+事务），另有过期等待兜底任务。
6. 企业微信通知：覆盖邀请、付款成功、等待提醒、审核提醒、投放开始/结束/即将结束、自动退款、撤销、退款等十余种场景。
7. 审批定时提醒：为一审/二审分别调度提醒，审核完成后自动取消。
8. 制作名单：组织名单配置化、弹窗视觉重构、字体去重、累计点赞、今日提醒服务端去重（跨设备）。
9. 用户协议：投放前需签署；确认页各 tab 已读时间持久化到数据库，跨浏览器同步。

页面与路由（挂载于 /birthboard/）：主页面、协议页、确认页（参与/寿星/完成三 tab）、审核页、驳回页，以及余额查询、点赞、确认计数、提醒已读等 JSON API；左侧导航栏新增入口。

基础设施改动：

• generic.models.YQPointRecord.SourceType 新增 BIRTHBOARD=8，区分生日板消费/退款记录。
• generic.utils.to_search_indices 返回值新增 pk 字段，供前端作为关联 id。
• requirements.txt 新增 playwright、ddddocr。
• config_template.json 新增 birthboard.contact_email、birthboard.contributor_orgs、shihannet（外部投放屏账号，仅占位符）。
• 管理命令：backfill_birthboard_thumbnails、run_birthboard_waiting_checks、simulate_birthboard_nightly_update。
• 大量前端资源与模板；birthboard 各阶段迁移已 squashed 合并，含 YQPointRecord source_type 调整及 generic 迁移分支合并。

测试：

birthboard/tests.py（718 行）覆盖发起、付款、审核、投放、退款主流程及超时、驳回、并发等边界场景。

部署与配置注意：

1. 依赖：需安装 playwright 并执行 playwright install（Chromium）；ddddocr 用于图片识别。
2. 配置（config.json，不入库）：birthboard.contact_email、contributor_orgs；shihannet 为外部投放屏真实账号（模板仅占位）。
3. 迁移：python manage.py migrate（含 generic 迁移分支合并）。
4. 初始化：通过 admin 录入审核员/二审员名单；历史缩略图可运行 backfill 命令。
5. 定时任务：依赖 runscheduler 启动的调度器，三个定时任务自动注册。

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 660f39a0f5

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[Copilot]

Pull request overview

本 PR 为 YPPF 引入新的「生日灯牌（birthboard）」子系统：以 Django 模板页 + 后台任务为核心，打通生日祝福投放的用户流程，并与元气值（YQPoint）、通知、定时任务等模块对接，同时补充配置、依赖与迁移。

Changes:

• 新增 birthboard Django app：路由、模型、任务（scheduler jobs）、通知、管理命令与测试用例。
• 扩展通用能力：YQPointRecord SourceType 增加 BIRTHBOARD；用户搜索索引返回值增加 pk 字段。
• 增加前端模板与静态资源，并在左右侧导航栏加入入口；补充配置模板与依赖。

Reviewed changes

Copilot reviewed 40 out of 49 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
templates/user_left_navbar.html	用户侧导航栏增加 birthboard 入口链接
templates/org_left_navbar.html	组织侧导航栏增加 birthboard 入口链接
templates/birthboard/contract.html	新增 birthboard 用户协议页面
templates/birthboard/birthboard_approve.html	新增 birthboard 审核台页面与筛选/弹窗交互
templates/birthboard/birthboard_approve_denied.html	新增无审核权限提示页
static/birthboard/contract.css	新增协议页样式
static/birthboard/birthboard.css	新增 birthboard 主页面样式（含大量定位/弹窗样式）
static/birthboard/birthboard_fonts.css	新增 birthboard 共享字体声明样式
static/birthboard/birthboard_confirm.css	新增/调整确认页样式
static/birthboard/birthboard_approve.css	新增审核页样式
static/birthboard/birthboard_approve_denied.css	新增无权限页样式
requirements.txt	增加 birthboard 相关依赖（playwright、ddddocr）
generic/utils.py	to_search_indices 返回值增加 pk 字段以支持前端关联
generic/models.py	YQPointRecord.SourceType 增加 BIRTHBOARD=8
generic/migrations/0005_alter_yqpointrecord_source_type.py	迁移：更新 YQPointRecord.source_type choices
generic/migrations/0008_merge_20260831_0208.py	迁移：合并 generic 的迁移分支
config_template.json	增加 birthboard 配置段（contact_email、contributor_orgs）
boot/urls.py	注册 /birthboard/ 路由到 birthboard.urls
boot/settings.py	将 birthboard 加入应用配置列表
birthboard/utils.py	增加每人扣费计算与缩略图生成工具函数
birthboard/urls.py	新增 birthboard 页面与 JSON API 路由
birthboard/tests.py	新增较完整的单测覆盖（流程/任务/并发/提醒等）
birthboard/reminder.py	新增审核提醒定时任务的排期/撤回逻辑
birthboard/notify.py	新增站内信 + 企业微信通知封装函数
birthboard/models.py	新增 birthboard 核心模型（记录、参与者、审核员、协议、已读、点赞、提醒去重等）
birthboard/migrations/0001_initial.py	birthboard 初始迁移
birthboard/migrations/0002_alter_birthboardrecord_status_squashed_0011_add_thumbnail_field.py	squashed 迁移：扩展状态机/审核员/日志/协议/缩略图等
birthboard/migrations/0012_birthboardlike.py	增加点赞量模型迁移
birthboard/migrations/0013_birthboardreminderseen.py	增加提醒已读去重模型迁移
birthboard/migrations/init.py	迁移包初始化文件
birthboard/management/init.py	management 包初始化
birthboard/management/commands/init.py	commands 包初始化
birthboard/management/commands/backfill_birthboard_thumbnails.py	管理命令：历史记录缩略图回填
birthboard/management/commands/run_birthboard_waiting_checks.py	管理命令：手动触发等待提醒/超时处理
birthboard/management/commands/simulate_birthboard_nightly_update.py	管理命令：模拟 23:45 夜间更新任务
birthboard/jobs.py	定时任务：提醒/超时自动拒绝退款/夜间投放同步（Playwright）/过期兜底
birthboard/forms.py	新增表单：投放记录提交字段
birthboard/config.py	新增 birthboard + shihannet 配置封装
birthboard/apps.py	新增 Django AppConfig
birthboard/api_yqpoint.py	新增 YQPoint 校验 API（按 senders/record 计算是否足够）
birthboard/admin.py	新增审核员/二审员 admin 配置
birthboard/init.py	app 包初始化文件

Suppressed comments (2)

birthboard/jobs.py:83

• 同一函数中字符串分支也把年档 cost 写成了 1000；应与年档 10000 保持一致，否则 mode 以字符串形式存储时同样会被错误推断为 1 天。

        if isinstance(mode, str) and mode.isdigit():
            m = int(mode)
            cost_map = {35: 1, 60: 3, 1000: 365}
            return cost_map.get(m, 1)

static/birthboard/birthboard_fonts.css:43

• 同文件后续两个 @font-face 也使用了 display: swap;（无效）。应统一改为 font-display: swap;，避免只有部分字体族按预期加载。

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[sparrowbot]

完成修改，并按学院要求修改了部分措辞

[sparrowbot]

增加了手机版的审核视图

[sparrowbot]

增加了微信小程序的适配，应该是最后一次改动了

[Morgen-Kornblume]

已根据 AGENTS.md 对 PR #996 进行二次审阅和修改，重点检查了发布、付款、确认、审核、退款、违规处理及投屏同步中的权限与状态漏洞。

本次主要调整：

• 发布时在服务端校验发起人必须属于送出者并完成付款，同时限制人数和图片大小。
• 余额接口只返回当前用户信息；海报改为通过有权限校验的端点访问。
• 发布前允许发起人中止并按参与记录实际费用退款；审核通过后仅允许无退款撤销。
• 一审和二审必须由不同账号完成，且送出者、寿星等关联人员不得参与审核。
• 驳回原因使用服务端表单校验，避免绕过前端提交任意内容。
• 对投放中或已完成内容的违规处理不退款，并限制发起人 30 天内再次参与。
• 投屏下架失败时持久化 display_takedown_pending，定时重试；未完成下架前阻断新上传。
• 调整夜间同步顺序和数据库锁复查，增加 00:05 补偿任务及外部同步失败后的状态回退。
• 修复 Playwright 重试无界、默认非 headless、N+1 查询及本地配置缺少 birthboard 段时无法启动的问题。
• 补全 0014_harden_review_and_takedown 迁移，并升级开发容器至 Debian 12，以兼容 Playwright 1.62 Chromium。

Docker 开发容器验证结果：

• python manage.py check：通过
• python manage.py makemigrations --check --dry-run：No changes detected
• python manage.py migrate：通过
• 定向安全及工作流测试：44/44 通过
• birthboard 与 generic.tests：74/74 通过
• 项目全量测试：507/507 通过
• compileall、tabnanny、JSON 校验及 git diff --check：通过
• 容器内 Chromium 151.0.7922.34 headless 启动与关闭：通过

受现场条件限制，本次没有实际执行电子屏登录、素材上传、播单更新或下架。相关投屏流程通过 mock、失败回退、下架优先和定时重试测试验证，测试过程中未连接或操作真实投屏系统。

[sparrowbot]

根据修改完善了部分逻辑和视图