修茈科技 LogoXCAGI企业业务自动化平台
ERP 与业务文件 / 单据与打印

Excel 导入导出

已验证Web · 已验证代码更新于 2026-10-25

客户、产品等主数据的 Excel 批量导入与业务报表导出。

返回 ERP 与业务文件

功能价值

客户、产品等主数据的 Excel 批量导入与业务报表导出。

使用方式

在数据页上传 Excel 批量导入；导出按钮生成业务报表。

所属模块

ERP 与业务文件 / 单据与打印

适用平台

Web · 已验证

已知限制

  • 模板格式有校验要求，首次导入建议小批量试跑

平台验证状态

本项适用于 1 个平台，逐平台独立判定：平台状态只由该平台的实机验收记录产生，总体状态由平台状态自动汇总，目录与页面都不存放可手写的状态。验收结论仅覆盖记录所列版本、Git SHA 与产物；当前源码或新安装包仍需独立验收。

Web

已验证

验收结果：PASS；通过 4 / 失败 0；产品版本 1.0.0.5；Git SHA 086a98f1fbad9f9b357692a85e656d8972cb6bc3；验证时间 2026-09-29。Acceptance JSON SHA-256 c9d98a6e2db3462a234cf2e51cedfa9b30714e3d7d1279c6e1d083185db3c1ba

实机录像 / 操作流程

媒体内容已复核，记录结论：验收结果：通过；画面内容：本轮真实浏览器会话录像（webm）：管理端登录 → 模板清单 → 生成 Excel → 导出二进制 → 负例。；SHA-256：f634449951747bbab44f36ce3fde6192cad79cdc69d1ece2da1d1f29e2e26449（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-excel-io/video/erp-excel-io-web-20260929-152158.webm） 下载原始录像

实机截图

Excel 导入导出 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：管理端登录页「XCMAX 服务器后台 · 管理员登录」，账号框已填 admin、密码框为掩码。；SHA-256：2f8189c42d477234b9f54f1fe9e4eae68f10f125897ea7a42ea453e9a6dcdc43（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-excel-io/shot/00-login-form.png） 查看原图
Excel 导入导出 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染 Excel 模板清单真实 JSON（id/name/category）。；SHA-256：ec57ae5905ee3b8a78250f64383acfc2f10b21b8fd2e00fc2712adb27b98108c（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-excel-io/shot/EX1-excel-templates.png） 查看原图
Excel 导入导出 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染真实生成 Excel 的响应：200、file_path、filename、sheet、rows。；SHA-256：56ecd4a194085d7c39aa65c69f9182c54c6b169a34cc0dfc79663e82d6a95a84（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-excel-io/shot/EX2-excel-generate.png） 查看原图
Excel 导入导出 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器上下文校验产品导出 xlsx 的真实二进制字节数与 content-type。；SHA-256：e82a87896e463142509e3b78d6a294b3eac79d06069a4d629e7e5fa15b54465b（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-excel-io/shot/EX3-excel-export.png） 查看原图
Excel 导入导出 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染缺 data 参数的 400「请提供数据 data 参数」与旧导入接口 403 fail-closed。；SHA-256：8520b40f0373fce3ee6eb5f7f0b6981fbbde6f8e9d355f83b7f0ef51305d61e5（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-excel-io/shot/EX4-excel-negative.png） 查看原图

运行日志

下载原件：erp-excel-io-web-20260929-152158.log；SHA-256：2a0e8775c2fb74f59d180ee7e270f83852313449db9fd0589fb832d4c6a8f5e0（仓库路径：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-excel-io/log/erp-excel-io-web-20260929-152158.log）

安装包 / 部署产物 SHA-256：cfa52148ab19fd69e6bea715cc2b9ad046f9607dbdee31033cb9d5357d3c7368 · 交付身份 JSON

实现与测试（平台无关）

图片内容复核（2026-09-30，Mac 1.0.0.5）：业务对象页是饰品包装品管理表，可见导入导出和产品行。

源码实现

  • FHD/app/fastapi_routes/excel_templates.py
  • FHD/app/application/excel_imports.py
  • FHD/app/infrastructure/repositories/product_repository_export_mixin.py
  • FHD/mods/xcagi-erp-domain-bridge/backend/blueprints.py

API 端点

  • /api/excel/*

自动化测试

  • FHD/tests/test_erp_products_facade.py
  • FHD/tests/test_infrastructure/test_product_repository_export_mixin.py

CI 门禁：待补本项 CI 证据

CI 工作流定义

暂无

未标注平台的补充资料

下列资料未绑定到具体平台，仅作实现与历史资料参考，不计入任何平台状态，也不构成实机验收。

实机截图

Excel 导入导出 已复核截图
记录结论：资料收录（未绑定平台验收）；SHA-256：8a5c162df67bb4d4571c54aeb2546ea9b363b7e8b47fe9b6a6bdbaa47ba23274（原始文件：FHD/docs/evidence/capabilities/erp-excel-io-01-etl-center.png） 查看原图

关联文档

  • FHD/docs/excel_import_api.md

证据原件存放于私有对象存储，页面通过短时效签名地址读取原图与原始录像； 「核验哈希」会对照本页登记的 SHA-256 与存储对象元数据。对象存储不可用时自动改用站内副本， 也可下载原件后用 sha256sum 自行核对。