docs(selfop): record backend Excel export deployment and verification

平台客户层级与权限契约.md

@@ -17,7 +17,7 @@
 ### Admin 菜单结构与显示
 
 - 一级、二级菜单的名称、分组和顺序以当前确认原型及当前对话确认为准，唯一代码入口为 `apps/admin-web/src/core/navigation/adminNavigation.ts`。一级结构为首页数据看板、客户管理、国内头程、货柜管理、海外尾程、预约管理、车辆管理、海外业务、客户服务、财务管理、自营业务、通用、系统管理；二级菜单统一在该入口维护，实际显示继续由权限过滤。
-- 自营业务的经营总览、销量分析、库存分析、数据采集四个页面统一使用 `platform:self-operated-analytics:list`，包括任务详情只读和运行辅助查询；重试独立使用 `platform:self-operated-analytics:sync`。IAM 菜单管理资源不替代上述实际读写授权，不能仅凭采集写权限打开只读页面。
+- 自营业务的经营总览、销量分析、库存分析、数据采集四个页面统一使用 `platform:self-operated-analytics:list`，包括任务详情只读和运行辅助查询；重试独立使用 `platform:self-operated-analytics:sync`，库存周转后台导出使用独立 `platform:self-operated-analytics:export`，下载中心创建、下载及重试均校验该导出权限和非代登录平台身份。IAM 菜单管理资源不替代上述实际读写授权，不能仅凭采集写权限打开只读页面。
 - 已实现菜单继续使用正式路由及服务端权限，不因改名、移动或仅调整菜单结构改变接口、状态和操作资格。当前原型未展示的既有入口通过 `hidden` 退出侧栏，正式路由和权限仍按现行合同管理；角色权限设置仍保留这些正式页面及操作的可分配权限。
 - 尚无正式页面的菜单不显示，不保留禁用占位或空分组，不接入原型假数据、虚构权限码或新增业务接口。后续功能实现时再核对正式页面、权限与服务端合同。
 

测试环境单机部署与配置契约.md

@@ -2,6 +2,14 @@
 
 ## 自营库存周转 TEST 发布与验收（2026-10-15）
 
+15:15 后台导出已按本轮授权发布并完成真实HTTP／文件验收：Lastleg、File提交dbb93a06c26c001d572272e153084b22038cfc60，Jenkins baiyue-firstleg-lastleg-service #326、baiyue-firstleg-file #152 SUCCESS；Admin提交9a10fb66572c761026b47c3e282ca31d7dab1897，admin-web-test #614 SUCCESS，Job已恢复release/test及原lightweight设置。实际镜像digest为Lastleg sha256:1fa6b1a07c9828cd31ee63adbfc26ceb0f18a32da7e3be4c9145007e61301e5c、File sha256:b41a24ee062519d909a670a0c8f9ced82382a5812c29f42c655a70f065fc5ed0；Admin imageId为sha256:dc85864b3832c7b1529d30fe1b826867e6863a90222ff42cad7961dedf5515a5。三个容器健康、精确版本及前端实际HTTP资源已核对。已执行selfop-turnover-export-permission.sql，仅新增独立导出权限并授予平台管理员；Nacos file-service.yml仅CAS新增SELFOP_INVENTORY_TURNOVER定义，回读SHA256为7a739a7763dfd0c543a392ba922eac0c4fab5b68c70838d3258b5db05d2f8207。无业务建表、销量／库存回写或采集配置修改。
+
+库存周转改为下载中心SELFOP_INVENTORY_TURNOVER XLSX，Lastleg按固定版本、筛选、排序、有序列及预期总数分批供数，File后台生成文件，前端移除逐页拉取和CSV拼接；独立导出权限在创建、下载与重试时校验。真实SKU任务EXP2110629865531215873一次成功，下载2769行25列Excel（364615字节，SHA256 77869aeaecda31db2964b6feaac3152506fc816a39f9b3faabc2999fe4d00811）；货主任务EXP2110629945000693762一次成功，42行16列（7955字节，SHA256 d3a5cfe0d056ab68838a2591e54419e184df65d0fbed768a45900b5b74d0e7ff）。两文件总条数、列顺序、必需历史证据列及全量降序逐行检查通过，SKU前100行／货主42行百分比与实际接口逐格一致，公式核对考虑接口平均库存与周转值各自六位小数的舍入边界；未知保留11个SKU／5个货主的“—”，不变为0%。真实下载HTTP及XLSX解析通过，不代替人工视觉验收。
+
+Lastleg83项及File25项相关测试通过（含真实XLSX文件再读取、未知／零百分比、公式文本保护、权限撤销）；5项网关合同通过，前端49项定向测试及类型检查／构建通过。全前端3098项通过、1项模块边界失败，已改用下载中心公开入口，随后该门禁及相关48项全部通过。Lastleg依赖检查9过3失败，剩余为既有 `QuantityDiagnosticController→InternalServiceTokenGuard` 和 `RelabelPalletMeasurementService→PdaWarehouseIdentity` 未登记引用；本批仅明确登记导出装配器→周转导出投影的精确依赖，未扩大到自营Mapper或客户WMS业务。真实TEST后台任务／文件下载已验收，人工1920×1080、100%视觉仍待确认。证据位于后端target `selfop-backend-export-test.log`、`selfop-export-permission-test.log`、`selfop-export-contract.log`、`selfop-export-architecture.log`。
+
+15:15最终复核Integration／Lastleg健康、唯一领星出口、BUSINESS／continuousEnabled=true／1200ms保持，账号无暂停或在途请求；两仓仍各60个有效日头，140474条流水不变，发布验收期间领星请求计数27937不变。运行证据位于后端target的selfop-backend-export-release-*、selfop-backend-export-permission.json、selfop-backend-export-config.json、selfop-backend-export-file-runtime.json、selfop-backend-export-web-runtime.json、selfop-backend-export-http-*-xlsx-proof.json、selfop-backend-export-runtime-final.json。
+
 14:33 仅更新 Admin `68284ad2bfb5a2e65856ecccd2e763bb2e78f412`，Jenkins `admin-web-test` #613 SUCCESS，镜像 `68284ad2bfb5`、imageId `sha256:9f87d066a60651aaafd2f4b415acbf02fa9a8c237bb7d98a4c32fa138bfdd11f`，容器健康、库存路由和实际HTTP资源已核验。修复默认“期间周转率”百分比列漏接排序映射；表头支持服务端全量升降序、显示计算说明，与扩展次数列及下拉排序同步。前次真实接口排序通过未覆盖默认百分比表头点击，此次新增SKU／货主实际组件点击回归，两方向、翻页重置、筛选／固定版本保留和说明按钮不触发查询均通过，页面30项测试、类型检查及构建通过；全工作区3096项通过、3项失败及4个未处理错误均来自其他窗口未提交的预约表单 `CargoVerificationForm`，未纳入发布。真实接口9请求复核两仓400行公式、升降序和跨页顺序通过。Job配置已恢复；后端、SQL和采集配置未变。人工1920×1080、100%视觉验收仍待确认。证据：后端target内 `selfop-turnover-rate-web-release-admin-web-test.json`、`selfop-turnover-rate-web-runtime.json`、`selfop-history-http-turnover-rate-after.json`。
 
 历史库存还原本批已按用户授权推送并发布：Integration、Lastleg 初版 `99215bbb796248d4e3f6ad7897982678b363c072`，Admin `5e8c17c82fc6bef7340cb078ddc7660fc68dba10`。TEST 的三张历史库存表已创建，60 个字段与源DDL逐项核对一致，保留原有销量和原始库存。Integration 标准发布 #115、Lastleg #323、Admin #612 均 SUCCESS，实际镜像与HTTP资源已核验；Admin Job 已恢复原分支及 lightweight 配置。后端受影响257项测试通过（252项整组回归＋新增5项针对性回归），前端38项测试、类型检查与构建及5项路由检查通过；独立DDL、Lastleg源基线和海外统一基线的三表定义完全一致，所有新字段有中文注释。端到端H2验证覆盖真实Mapper、任务／分页暂存、修订归并、独立锚点对账及原子日版本切换；重启从新尝试第一页开始、分页异常拆片、失效旧版、负库存／未知类型／缺覆盖拒绝、货主整体资格和固定版本导出均纳入检查。未以H2通过替代MySQL8真实执行、全仓容量或浏览器人工验收。

自营业务/库存周转视图设计.md

@@ -356,4 +356,6 @@ SKU 数值表头支持实物件数、正品可售、7／15／30 日出库、所
 
 默认“期间周转率”表头支持全量升降序，与扩展周转次数列及筛选区的“期间周转率从高到低／从低到高”同步，未知值始终末尾。点击排序保留货主、日期、隐藏零库存及固定版本，回到第一页。表头独立信息按钮展示百分比公式、每日末均值、货主汇总与未知值口径；打开说明不触发排序或查询。
 
-顶部“导出”按当前已查询的筛选、排序及快照逐页读取全部匹配记录，导出CSV（Excel可打开），列顺序与当前显示列一致，扩展列打开时一并导出；保留未知与估算说明、周转率，提供进度及取消。查询变化或离开页面取消导出，版本失效或分页异常不下载部分文件。
+顶部“导出”接入统一下载中心，提交 SELFOP_INVENTORY_TURNOVER 后台任务生成 XLSX；浏览器不再分页拉明细或拼CSV。提交参数固定当前已查询的筛选、排序、版本、总条数及有序列键，扩展列打开时一并提交；列名、周转率、未知与估算说明由 Lastleg 生成，File 分批写文件并提供进度、下载和重试。离开页面不取消已提交任务。独立权限为 platform:self-operated-analytics:export，仅平台非代登录账号可创建／下载／重试。
+
+沿用库存周转查询的30分钟固定上下文，不在排队或重试时重新取最新版本。上下文过期、后端重启或日版本失效须刷新列表重新提交；条数变化、缺页等异常整任务失败，不提供部分文件。每批100条，最多200000条，沿用下载中心文件大小与存储有效期限制。必带统计期间、期间出库、平均日末库存、周转率及历史证据列，其他列保留当前表格顺序；新增 File 类型配置及IAM导出权限，无业务建表或销量／库存回写。