unopim-data-transfer
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseUnoPim Data Transfer
UnoPim 数据传输
The import/export pipeline uses a queued job system with state tracking.
导入/导出流水线采用带状态跟踪的队列任务系统。
When to Use This Skill
何时使用该技能
Invoke this skill when:
- Configuring or running imports/exports
- Debugging failed import/export jobs
- Creating custom importer/exporter classes
- Understanding the job pipeline
在以下场景调用该技能：
- 配置或运行导入/导出任务
- 调试失败的导入/导出任务
- 创建自定义导入器/导出器类
- 了解任务流水线机制
Job Pipeline
任务流水线
Import States
导入状态
PENDING → VALIDATED → PROCESSING → PROCESSED → LINKING → LINKED → INDEXING → INDEXED → COMPLETED
↓
FAILEDPENDING → VALIDATED → PROCESSING → PROCESSED → LINKING → LINKED → INDEXING → INDEXED → COMPLETED
↓
FAILEDExport States
导出状态
PENDING → PROCESSING → COMPLETED
↓
FAILEDPENDING → PROCESSING → COMPLETED
↓
FAILEDImport Architecture
导入架构
| Class | Purpose |
|---|---|
| Import orchestrator — validates, batches, processes |
| Base importer with batch processing |
| Product-specific import logic |
| Category-specific import logic |
| CSV file reader |
| Excel file reader |
| 类 | 用途 |
|---|---|
| 导入协调器 — 负责验证、分批、处理 |
| 带批次处理能力的基础导入器 |
| 商品专属导入逻辑 |
| 分类专属导入逻辑 |
| CSV 文件读取器 |
| Excel 文件读取器 |
Export Architecture
导出架构
| Class | Purpose |
|---|---|
| Export orchestrator |
| Base exporter |
| Product export |
| Category export |
| 类 | 用途 |
|---|---|
| 导出协调器 |
| 基础导出器 |
| 商品导出 |
| 分类导出 |
Queued Jobs
队列任务
| Stage | Job Class |
|---|---|
| Import track | |
| Import batch | |
| Link batch | |
| Linking | |
| Index batch | |
| Indexing | |
| Completed | |
| Export track | |
| Export batch | |
| Upload | |
| 阶段 | 任务类 |
|---|---|
| 导入追踪 | |
| 导入批次 | |
| 关联批次 | |
| 关联处理 | |
| 索引批次 | |
| 索引处理 | |
| 完成 | |
| 导出追踪 | |
| 导出批次 | |
| 上传 | |
CLI Commands
CLI 命令
bash
undefinedbash
undefinedStart queue worker (required for import/export)
Start queue worker (required for import/export)
php artisan queue:work --queue="default,system"
php artisan queue:work --queue="default,system"
Run a specific job
Run a specific job
php artisan unopim:queue:work {jobId} {userEmail}
php artisan unopim:queue:work {jobId} {userEmail}
Restart workers after code changes
Restart workers after code changes
php artisan queue:restart
undefinedphp artisan queue:restart
undefinedModels
模型
| Model | Purpose |
|---|---|
| Job definition (type, entity, file path, settings) |
| Single job run (state, stats, errors) |
| Individual batch within a job |
| 模型 | 用途 |
|---|---|
| 任务定义（类型、实体、文件路径、设置） |
| 单次任务运行记录（状态、统计数据、错误） |
| 任务内的单个批次记录 |
Troubleshooting
问题排查
Import stuck in PENDING
导入卡在 PENDING 状态
Queue worker not running:
bash
php artisan queue:work --queue="default,system"队列工作进程未运行：
bash
php artisan queue:work --queue="default,system"Import fails with validation errors
导入因验证错误失败
Check for detailed row-level errors.
JobTrack.errors查看 获取详细的行级错误信息。
JobTrack.errorsExport produces empty file
导出生成空文件
Verify data exists and filters match records.
验证数据是否存在，且筛选条件匹配对应记录。
Creating Custom Importers/Exporters
创建自定义导入器/导出器
See the skill → custom-data-transfer.md.
unopim-plugin-dev查看 技能 → custom-data-transfer.md。
unopim-plugin-dev