v5.12.5 — 2026年5月4日

🔧 已收款订单的返点付款通道保持开通

• 付款按钮覆盖到 09/10 状态：原先 07R/08 后付款按钮就消失，09待收款 / 10已收款 时无法发起付款；现在 07R/08/09/10 都保留付款通道，配合 11 升级守卫确保返点全付才完成
• 修正"已打款"误判：子返点 cell 原先 09/10/11 一律显示"已打款"是错的（已收款不等于已付返点）。现在仅 11已完成（由 v5.12.3 enforcement 保证）显示已打款，09/10 时按 PR 实际状态显示付款按钮
• 18 单回退订单能正常发起付款申请，财务付完返点后系统自动升回 11

v5.12.4 — 2026年5月4日

⚠️ 10已收款 但返点未付的订单加提示徽标 + 18 单脏数据回退

• 新增提示徽标：列表行 status=10 且返点>0 时，进度 badge 旁出现橙色 ⚠️，hover 显示"差 N 笔返点付款就完成了，所有返点 PR 完成后自动升级到 11"
• 后端 API 增强：GET /api/orders 响应新增 rebate_pending_count 和 rebate_paid_count 字段（基于 PaymentRequest 聚合）
• 18 单虚假 11已完成 回退：返点 > 0 但 PR 总数=0 的订单批量回退到 10已收款，note 加前缀"【系统校正·2026-05-04】..."，36 条审计日志
• 影响：收入总览"已完成"卡片数字下调；财务模块"待返点付款"列表出现这 18 单；财务完成 PR 后自动升回 11

v5.12.3 — 2026年5月4日

🔒 11已完成 强校验：必须收款 + 返点全打款

• 用户手动改进度到 11 时，后端检查若 rebate > 0，则该订单所有未撤销的返点付款申请必须 status=paid，否则返回错误
  "还有 N 笔返点付款未完成,无法升级到 11已完成"
• 自动晋升路径不变：账单匹配 / 付款回执触发完成 已校验过，不受影响
• 边界 case 顺畅："先收款后返点" 场景：账单匹配后停在 10已收款，待返点 PR 全 paid 时自动升 11
• 已知脏数据：生产库有 18 单为该校验缺失时的历史遗漏，本次修复只防新发不回退老数据

v5.12.2 — 2026年5月3日

🎯 月度统计严格按 published_at 归属 + 自动回填发布时间

• 前端去掉降级链 — _getCompleteDate 严格只取 published_at，不再 fallback 到 completed_at/updated_at/date。避免老数据用 updated_at（导入时间）误归月份
• 后端自动回填 — 订单进入 11已完成 时（含手动改进度、账单匹配、付款回执触发），若 published_at 为空，自动用 completed_at 或当前时间填上。新流转的数据从此都有发布时间
• 历史数据迁移脚本 — 服务器端跑 migrate_published_at.py 一次，回填存量 11订单的 published_at（来源优先级 completed_at → updated_at → date）
• 影响视图 — 月度收入明细、博主月度广告数量/月度收益/排行、月度商单趋势"已完成"、跨年度收入总览、总览页统计卡片，全部按严格发布时间归属月份

v5.12.1 — 2026年5月3日

🔧 修正"笔记发布时间戳"字段优先级

• 字段优先级翻转 — 完成时间获取改为 published_at(首次发布) 优先，其次 completed_at(账单匹配)、updated_at、date 兜底。修复"4月发布、5月账单匹配"的订单被归到 5月 而非 4月 的问题

v5.12 — 2026年5月3日

📅 月度"已完成"统计统一改按笔记发布时间戳归属

• 统计口径调整 — 所有"已完成"项目数和毛利润，月度归属一律按笔记发布时间戳（completed_at → published_at → updated_at → date）。提报数仍按订单提报日期，不变
• 受影响的视图 — 月度商单统计卡片、月度收入明细、博主月度广告数量、博主月度收益、博主排行、月度商单趋势（总览页）、月度收入趋势线、总览页"已完成 / 毛利润"卡片、跨年度收入总览、黄小分成结算
• 月份 tab — 月份选项卡列表 = 提报月份 ∪ 发布月份。"3月提报、4月发布"的订单现在能在 4 月 tab 看到
• 修复 — 筛选 4 月（或其它月份）时无笔记收入数据显示的问题；订单详情卡片点击展开会显示当月所有相关订单（提报或完成）

v5.11 — 2026年4月8日

🔐 权限隔离 + 付款保存 + 多联系人 + 返点双模式

• 权限隔离 — 普通用户只能编辑和删除自己提报的商单，无法修改他人的订单。管理员不受此限制
• 付款保存 — 付款申请新增"保存"按钮，填写一半可以先保存；关闭窗口时也会自动保存，下次打开继续填写
• 文件不丢失 — 上传的合同和发票文件在保存后不再丢失，重新打开时自动恢复，可继续补充其他信息
• 多联系人 — 添加或编辑合作公司时，可以添加多个联系人（姓名、电话/微信、职务），付款时可从中选择
• 返点双模式输入 — 添加项目时返点可输入百分比或金额（二选一）。输入百分比自动算出金额，输入金额自动算出百分比，两个数字始终同步。适用于品牌直返固定金额（如 HBN ¥2000）的场景。报价变化时金额按百分比自动重算
• 折扣双模式输入 — 折扣同样支持百分比/折后金额双向同步。可以直接输入折后金额（如 ¥35000），系统自动算出对应折扣百分比；反之亦然
• 预计反馈时间 — 添加项目时可以设置预计的品牌反馈日期；右键预警项也可随时设置/修改。到期当天系统自动在预警面板显示"📅 今日待反馈"提醒并置顶项目；逾期则显示红色"📅 反馈逾期X天"

v5.10 — 2026年4月1日

📂 账单拖拽上传 + 彩蛋

• 拖拽上传 — 博主管理页的账单上传区域现在支持直接拖拽 Excel 文件，无需点击选择
• 匹配范围扩大 — 账单匹配范围扩大到"已确认合作"及之后的所有订单，创作中的项目也能回填收入
• 愚人节彩蛋 — 4月1日登录时会触发一个小惊喜（仅触发一次，不影响正常使用）
• 修复 — 拖拽文件不再被浏览器直接打开；上传后文件列表不再丢失

v5.9 — 2026年4月1日

⏪ 撤销升级 + 账单匹配增强

• Ctrl+Z 撤销升级 — 现在可以撤销状态变更、删除和置顶操作，不再仅限于编辑撤销
• 批量账单上传 — 支持同时选择多个 Excel 文件一次性上传匹配
• 匹配更精准 — 需要博主+品牌+金额三项同时匹配才自动回填，其余进入人工审核
• 完成时间记录 — 账单匹配成功时自动记录订单完成时间
• 趋势图修正 — 已完成数改为按完成时间统计，年度订单数只统计已完成的
• 修复 — 蒲公英账单表头检测、撤销删除重复显示、合作方信息布局错乱

v5.8 — 2026年4月1日

📊 项目编号 + 周报 + 趋势图升级

• 项目编号 — 新建商单时自动生成编号（如 K260408xxxxx），方便追踪和沟通
• 下载回单 — 已打款项目可直接下载回单文件，未下载的项目会自动置顶提醒
• 趋势图升级 — 图表更大更清晰，支持周/月视图切换，全员模式下每个成员独立显示
• 周报功能 — 一键生成本周工作周报（提报数、确认合作数、完成数），支持复制文本和导出 PDF
• 收入总览重设计 — 统计卡片置顶、漏斗图改为扇形图、排行榜位置优化
• 管理员视图 — 管理员默认查看全部成员数据，可随时切换回只看自己的
• 权限控制 — 月份收入明细仅管理员可查看

v5.7 — 2026年4月1日

🔀 状态拆分 + 付款流程优化

• 创作/发布拆分 — 原"创作发布"状态拆分为"创作中"和"已发布"两个阶段，已发布需上传发布链接
• 付款撤销+草稿 — 付款申请支持撤销重新提交，编辑中的信息可暂存为草稿
• 对接人自动显示 — 付款弹窗选择收款方后，自动显示该公司的对接人信息
• 预警面板升级 — 新增搜索过滤、右键菜单、展开弹窗查看详情，预警项自动置顶
• 发票信息完善 — 新增开票日期和发票号码字段
• 待打款导航 — 每行显示"未打款"标识，点击可直接定位到待打款面板
• 合作公司校验 — 新增联系电话、微信等必填字段
• 修复 — 蒲公英账单匹配重写、月份选择器下拉、打款凭证拖拽上传

v5.6 — 2026年3月26日

🔒 安全加固 + 架构优化

• 访问控制 — 系统仅允许从 ceo.kingke.dev 域名访问，阻止外部未授权请求
• 密码安全 — 管理员密码改为服务器环境变量存储，不再写在代码中
• 登录保护 — 新增登录频率限制，防止暴力破解
• 数据备份 — 每日自动备份数据库并上传到 GitHub，防止数据丢失
• 系统监控 — 新增错误自动记录和健康检查，方便及时发现问题

v5.5 — 2026年3月26日

💳 待打款汇总 + 登录追踪

• 待打款汇总面板 — 财务看板新增统一待打款视图，一页查看 KOL 和设计两条线所有待打款项目
• 来源切换 — 可按来源（KOL/设计）筛选待打款项目
• 登录历史 — 记录每次登录的 IP 地址和地理位置，在团队管理页面可查看
• 自动登录记录 — 即使通过记住登录状态自动进入系统，也会记录登录信息

v5.4 — 2026年3月25日

🧾 发票系统 + 权限安全 + 驳回历史

• 发票预览 — 上传发票后永久保存，财务看板可内嵌预览PDF，自动核对金额/购方/销方
• 驳回历史 — 每次驳回记录保留，重新提交后仍可查看历史驳回原因
• 重新提交 — 被驳回的付款申请可直接修改后重新提交
• 折扣安全校验 — 启用折扣时必须指定改价抵扣方，防止多付款
• 权限分级 — 普通用户无法操作08及之后的状态，管理员可开启强制编辑模式
• 修复 — 发票识别销方为空、提报返点计算错误、驳回批量误伤

v5.3 — 2026年3月25日

💰 付款系统重构：独立申请 + 拆分弹窗

• 独立付款申请 — 每笔返点打款独立记录，下单/提报分别提交和撤销
• 拆分弹窗 — 多合作方项目每个合作方独立付款弹窗，不再共用大弹窗
• 展开行按钮 — 项目展开后直接显示每笔付款金额和状态（付款/已提交/被驳回/已打款）
• 精确驳回 — 财务可单独驳回某一笔付款，另一笔不受影响
• 修复 — 添加项目重复、驳回/打款状态不同步、已取消订单仍显示在财务看板

v5.2 — 2026年3月23日

💳 财务看板重构 + 账单匹配 + 编辑锁定

• 编辑锁定：已提交付款申请的订单（进度≥08）自动锁定，无法修改任何信息
• 账单匹配升级：新增订单号精确匹配（最高优先级），时间窗口缩短为前后3个月，未匹配项可人工选择
• 财务看板：已付款订单可双击查看/重新上传回单；新增单笔打款确认/驳回、批量打款
• 设计看板重构：子看板视图、右键复制项目、设计师忙碌状态、设计付款申请

v5.1 — 2026年3月23日

🔧 折扣系统 + 发票识别 + 订单ID

• 折扣开关：添加项目时可选是否启用折扣（默认关闭），折扣只影响打款拆分方式，不影响毛利润计算
• 订单ID：填写平台订单号后自动变更为"已下单"状态
• 发票识别升级：精确提取购方/销方/金额，5张测试发票100%准确率
• 付款独立提交：下单返点和提报返点可分别确认付款，各自独立上传合同和发票
• 毛利润修正：全站7处计算统一为 报价×(1-返点)，折扣不参与利润计算

v5.0 — 2026年3月23日

💰 财务重构：付款申请 + 博主管理

• 付款申请：商单明细中进度为"创作发布"及之后的项目，可直接点击"付款申请"按钮提交打款申请
• 自动计算打款金额：根据报价×返点×折扣自动计算应付金额，无需手动计算
• 合同+发票：上传合同文件或输入在线合同链接；上传发票自动识别金额并核对
• 博主管理：原"财务管理"改为博主管理页，每个博主一张卡片，清晰看到进行中/待收款/已完成数量
• 账单导入：管理员可上传博主月度收益Excel，系统自动匹配待收款订单并更新为已完成
• 逾期提醒：打款超过2个月未收到回款的项目会自动标红提醒

v4.8 — 2026年3月22日

📋 添加项目面板重构

• 三区域布局：弹窗分为基础信息、订单信息、合作方信息三个区域，更清晰
• 合作平台：新增平台选择（小红书/抖音/哔哩哔哩），也支持自定义输入
• 双合作方：支持下单方和提报方两个合作方，各自独立的机构、对接人和返点
• 历史合作查询：输入机构名后自动显示该公司的历史合作记录，帮助快速判断返点
• 智能补全：所有输入框都支持从历史数据自动补全

v4.7 — 2026年3月22日

📋 商单管理页6项优化

趋势图、双返点、面板合并、内联编辑

• 月度商单趋势图：替代原月度收入统计，显示您的提报数与已完成数的折线对比
• 双返点系统：新增"提报返点"和"下单返点"两个字段，系统自动计算总返点。表格中可展开查看返点组成
• 面板合并：⚠️待下单 和 🚧进行中 合并为单个"🚧进行中"面板
• 面板信息增强：每个项目额外显示报价、返点比例、合作渠道
• 无限滚动：预警面板不再限制8条，可滚动浏览全部项目
• 快速操作：点击状态标签可直接推进状态；点击项目可打开完整编辑弹窗

v4.6 — 2026年3月22日

📊 收入总览筛选 + 权限控制

收入总览页面新增年月筛选，仅超级管理员可查看

• 年月筛选器：页面顶部新增年份选择，悬停年份展开月份下拉选择
• 全面联动：选择月份后，页面上的统计卡片、图表、漏斗、排行榜、月度收入全部只显示对应月份的数据
• 权限控制：收入总览 Tab 仅超级管理员可见，其他用户进入 KOL 看板默认显示商单管理页
• 预计收入修正：累计汇总卡片的预计收入之前显示的是总报价，现已修正为扣除返点后的利润
• 跨年总览不受影响：页面最顶部的年度收入总览折线图始终显示所有年份数据

v4.5 — 2026年3月21日

🔧 稳定性与质量修复

对全项目进行了代码审计，修复了 9 个功能性问题

• 批量导入完善 — 通过 Excel 批量导入商单时，系统会自动记录导入人，并在操作日志中留下记录
• 设计师信息完整 — 设计师的银行账号、开户行、支付宝等收款信息现在能正常显示和保存
• 上传安全优化 — 物料文件上传现在会在读取前检查大小，防止超大文件导致系统卡顿
• 编辑即时生效 — 设计项目中编辑子任务后，列表立刻刷新显示最新内容
• 版本对比修复 — 恢复历史版本后再查看差异对比，结果更加准确
• 多人协同更稳定 — 修复了多人同时操作时可能出现的缓存积累问题

v4.0 ~ v4.4 — 2026年3月21日 重大更新

本次更新包含财务看板、版本历史、发票识别、设计看板优化等多项核心功能

💳 全新「财务看板」

• 统一打款总览 — 在一个页面查看 KOL 和设计两条业务线所有待打款项目，无需分别进入两个看板
• 按周查看 — 可切换上周/本周/下周，查看每周需处理的打款笔数和总额
• 批量上传回单 — 打款完成后将回单文件拖入上传区，系统根据文件名中的金额和公司名自动匹配对应订单
• 一键确认 — 匹配完成后点击确认，系统自动更新订单的打款状态
• 导出 Excel — 一键导出当前周打款明细表
• 独立权限 — 财务看板有独立的访问权限，可单独分配给财务人员

📜 版本历史（类似 Google 文档的历史记录）

• 在哪里看 — KOL 看板右上角「📜 版本历史」按钮，点击后右侧滑出时间线
• 能看到什么 — 按日期显示所有操作记录：谁在什么时间修改了哪个字段，旧值和新值分别是什么
• 差异对比 — 点击某个历史版本，可查看它与当前数据的差异（新增/删除/修改了哪些）
• 一键恢复 — 数据被改错时可直接恢复到之前的版本，恢复前系统会自动备份当前数据
• 撤销单个修改 — 也可以只撤销某一个字段的变更，不必恢复整个版本

🧾 发票智能识别

• 使用方式 — 在财务详情中上传发票 PDF 后，系统自动读取含税金额、收款公司、付款公司
• 自动填充 — 识别结果自动填入对应输入框，无需手动抄写
• 金额核对 — 发票金额与应付金额不一致时会显示红色警告
• 文件管理 — 上传后可点击蓝色链接预览，或点击垃圾桶图标删除重传
• 适用范围 — KOL 商单和设计项目均支持；仅限电子发票 PDF，扫描件暂不支持

📋 KOL 商单看板改进

• 提报人记录 — 新建商单时自动记录添加人，表格中可查看"提报人"列
• Ctrl+Z 撤销 — 编辑后按 Ctrl+Z 可撤销最近 30 步修改
• 操作追踪 — 每次修改自动记录（谁改的、改了什么、什么时间），便于团队追溯
• 月份筛选联动 — 选择某月后，收入统计自动展示该月明细
• 毛利润统计修正 — 财务管理页的毛利润区分"已打款确认"和"全部已完成"，与收入总览口径一致
• 修复商单重复 — 多人同时操作时偶发的重复商单问题已修复

💰 设计项目看板改进

• 表格直接编辑 — 项目列表每个单元格可直接点击修改，无需打开弹窗
• 子任务也能直接编辑 — 展开项目后可直接修改设计师、内容、金额、结算状态
• 物料上传 — 已完成项目可上传设计物料文件（单文件最大 10MB）
• 报价单权限 — 报价单功能仅超级管理员可见
• 财务结算重新设计 — 待结算任务按设计师分组为卡片，展开可查看明细、收款信息、上传发票、一键结算
• 设计师收款信息 — 可为每位设计师单独设置开户行、银行账号、账户名、支付宝，以及周结或月结
• 设置方式 — 进入「设计师库」→ 点击设计师 →「编辑」→ 在弹窗中填写收款信息和结算周期

v3.4.0 — 2026-03-20

UI全面打磨 + 数据显示优化

• 设计看板月份重复/总览数据不显示/dropdown对比度 — 全部修复
• 金额显示统一为中文"万"，hover显示完整金额
• 图表视觉升级：主题自适应网格、X轴月份单位、柔和色彩
• 设计师日历重设计：月历网格+今日高亮+忙碌标记
• URL路径规范：/kol、/design 独立路径

v3.3.0 — 2026-03-20

报价单自动生成系统

• 输入项目信息+选择参标公司+指定中标方，一键生成ZIP报价单包
• 参标公司库管理：每家公司独立模板(xlsx/docx)、独立撰写风格
• 中标方金额=预算，其他公司=预算×1.1~1.3
• 3家初始模板：蜿蜒泡影、洋芋伽、岱亦
• 生成历史记录自动保存

v3.2.0 — 2026-03-20

实时协同 + 在线用户 + UI全面优化

• 设计看板添加 WebSocket 实时同步（多人编辑即时同步）
• 团队管理显示在线用户状态（绿点=在线，灰点=离线）
• 全项目色彩系统重设计：降低饱和度、暗色模式更柔和
• Tooltip 修复：改为向下展开，不再被顶部裁剪
• superadmin 隐藏编辑/删除按钮，显示「系统保护」标签
• 密码输入添加确认框 + 👁 显示/隐藏切换

v3.1.0 — 2026-03-20

更新日志 + 管理工具弹窗 + 主题优化

• 新增更新日志弹窗（admin+ 可见）
• 团队管理/数据备份改为弹窗交互，不再跳转页面
• 主题色调首次优化（柔和暖灰/温暖炭色）
• 信息提示 ⓘ tooltip（同步状态、毛利润、返点）

v3.0.0 — 2026-03-20

域名迁移 + 设计项目管理看板

• 独立子域名 ceo.kingke.dev，Nginx + Certbot SSL
• 用户体系重构：superadmin（锁定）+ admin + editor/viewer 按模块分配
• 💰 设计项目管理看板：总览/项目列表(甘特图)/设计师库(档期)/财务
• 134 个项目 + 387 个任务 + 42 个设计师从 Excel 自动导入
• 🦖 品牌标识 + 点阵背景设计

v2.1.0 — 2026-03-20

企业级 RBAC + 主题 + 备份系统

• RBAC 权限系统：4 个角色 + 模块级权限控制
• 登录后进入工作台门户，无权限模块不可见
• Light/Dark 主题切换，持久化到用户表
• 企业级备份：SQLite .backup() + gzip，每日 03:00 自动备份
• 备份管理面板：浏览/下载/恢复/删除

v2.0.0 — 2026-03-19

全面重构版

• 10 阶段进度体系：01已拒绝 → 10已完成
• 跨年度收入总览折线图
• 三栏预警面板：🚨提报中 / ⚠️待下单 / 🚧进行中
• PDF 发票金额自动识别 + 返点核对
• 财务自动状态流转
• 合同链接/文件上传、发票/打款凭证上传
• 年份分组月份选择、渠道下拉选择、博主搜索下拉

v1.0.0 — 2026-03-17

线上协同版发布

• 本地 HTML 看板转化为线上 Web 应用
• FastAPI + SQLite 后端，完整 CRUD
• WebSocket 实时同步，多人协同编辑
• JWT 登录认证
• 167 条商单 + 11 条财务数据迁移
• Apple Liquid Glass UI 设计
• GitHub Webhook 自动部署