unopim-data-transfer（联海监察局数据传输）

UnoPim Data Transfer

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
                                                                                          ↓
                                                                                        FAILED

Export States

PENDING → PROCESSING → COMPLETED
                         ↓
                       FAILED

Import Architecture

Export Architecture

Queued Jobs

CLI Commands

# Start queue worker (required for import/export)
php artisan queue:work --queue="default,system"

# Run a specific job
php artisan unopim:queue:work {jobId} {userEmail}

# Restart workers after code changes
php artisan queue:restart

Models

Troubleshooting

Import stuck in PENDING

Queue worker not running:

php artisan queue:work --queue="default,system"

Import fails with validation errors

Check JobTrack.errors for detailed row-level errors.

Export produces empty file

Verify data exists and filters match records.

Creating Custom Importers/Exporters

See the unopim-plugin-dev skill → custom-data-transfer.md.