feat: 发票额度读取票聚销方可用额度 #1233

Merged
linchong merged 1 commits from feature/huilan-piaoju-invoice-quota into main 2026-11-18 15:35:11 +08:00
Collaborator

任务占用与边界

  • 任务名称:发票额度读取票聚销方最新可用额度
  • 实际开发者:huilan / Codex
  • 任务来源:负责人要求将发票额度页的可用额度改为票聚·销方管理中的最新可用发票额度
  • 目标结果:页面直接展示票聚返回的可用额度及额度更新时间,不再用“本地开票额度 - 销项金额”推算
  • 实际修改路径:发票额度页面数据与 Blade、票聚同步命令/Client/Importer/Repository、配置、共享镜像迁移、业务镜像登记、相关测试和上游镜像文档
  • 新增公共契约:共享镜像表 piaoju_seller_quota_snapshots;命令 piaoju:sync-invoice-quotas;页面按开票主体名称归一化匹配
  • 仅复用、不修改:InvoiceBasic、现有发票管理导航、共享业务镜像连接和现有部署入口
  • 数据源:https://api.erp321.com/fp/fms/company/seller/page,读取 sellerName、taxNumber、authStatus、invoiceLimit、invoiceLimitUpdated
  • 权限与菜单:不新增权限,不修改菜单
  • 明确不修改:票聚上游数据、本地发票基础信息口径、其他财务页面

碰撞与自审

  • 已基于最新 origin/main 重放提交,远程新增财务台账提交与本任务文件无重叠
  • 已逐文件复核 origin/main...feature/huilan-piaoju-invoice-quota,无敏感信息、构建产物或越界修改

实际改动

  • 发票额度页改为展示“票聚可用额度”和“额度更新时间”,覆盖未匹配、不可查看、授权过期、未获取额度和额度不足状态
  • 每 15 分钟同步票聚销方额度;未配置会话时不注册任务,同步失败时事务回滚并保留上一版镜像
  • 同名主体存在歧义时不猜测匹配;Cookie 仅从 Git 忽略的私有文件或私有环境变量读取

验证证据

  • 真实票聚接口:成功读取 99 条销方额度,dry-run 未写库
  • 自动测试:InvoiceQuotaPageTest、PiaojuSellerQuotaSyncTest 共 5 个测试、37 个断言通过
  • PHP 语法检查:12 个改动 PHP 文件全部通过
  • 定时任务:无 Cookie 时不注册,有 Cookie 时正确注册为每 15 分钟执行
  • 页面:已完成实际渲染检查,符合 VIP 黑金设计令牌;代表性 5,009 条记录数据层中位约 259ms、峰值约 60MB

风险与回滚

  • 涉及金额展示与新增数据库迁移。迁移仅新增共享镜像表,不修改既有业务表和金额口径
  • 同步失败保留旧镜像;如需回滚,可停止定时任务并回退应用版本,旧镜像表可保留
  • .env、Cookie、Token、真实业务数据和日志均未提交
## 任务占用与边界 - 任务名称:发票额度读取票聚销方最新可用额度 - 实际开发者:huilan / Codex - 任务来源:负责人要求将发票额度页的可用额度改为票聚·销方管理中的最新可用发票额度 - 目标结果:页面直接展示票聚返回的可用额度及额度更新时间,不再用“本地开票额度 - 销项金额”推算 - 实际修改路径:发票额度页面数据与 Blade、票聚同步命令/Client/Importer/Repository、配置、共享镜像迁移、业务镜像登记、相关测试和上游镜像文档 - 新增公共契约:共享镜像表 `piaoju_seller_quota_snapshots`;命令 `piaoju:sync-invoice-quotas`;页面按开票主体名称归一化匹配 - 仅复用、不修改:`InvoiceBasic`、现有发票管理导航、共享业务镜像连接和现有部署入口 - 数据源:`https://api.erp321.com/fp/fms/company/seller/page`,读取 `sellerName`、`taxNumber`、`authStatus`、`invoiceLimit`、`invoiceLimitUpdated` - 权限与菜单:不新增权限,不修改菜单 - 明确不修改:票聚上游数据、本地发票基础信息口径、其他财务页面 ## 碰撞与自审 - 已基于最新 `origin/main` 重放提交,远程新增财务台账提交与本任务文件无重叠 - 已逐文件复核 `origin/main...feature/huilan-piaoju-invoice-quota`,无敏感信息、构建产物或越界修改 ## 实际改动 - 发票额度页改为展示“票聚可用额度”和“额度更新时间”,覆盖未匹配、不可查看、授权过期、未获取额度和额度不足状态 - 每 15 分钟同步票聚销方额度;未配置会话时不注册任务,同步失败时事务回滚并保留上一版镜像 - 同名主体存在歧义时不猜测匹配;Cookie 仅从 Git 忽略的私有文件或私有环境变量读取 ## 验证证据 - 真实票聚接口:成功读取 99 条销方额度,dry-run 未写库 - 自动测试:`InvoiceQuotaPageTest`、`PiaojuSellerQuotaSyncTest` 共 5 个测试、37 个断言通过 - PHP 语法检查:12 个改动 PHP 文件全部通过 - 定时任务:无 Cookie 时不注册,有 Cookie 时正确注册为每 15 分钟执行 - 页面:已完成实际渲染检查,符合 VIP 黑金设计令牌;代表性 5,009 条记录数据层中位约 259ms、峰值约 60MB ## 风险与回滚 - 涉及金额展示与新增数据库迁移。迁移仅新增共享镜像表,不修改既有业务表和金额口径 - 同步失败保留旧镜像;如需回滚,可停止定时任务并回退应用版本,旧镜像表可保留 - `.env`、Cookie、Token、真实业务数据和日志均未提交
linchong added 1 commit 2026-11-18 15:33:23 +08:00
linchong merged commit 69ffa43d43 into main 2026-11-18 15:35:11 +08:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WuYongJie/CaiWuXiTong#1233
No description provided.