# Live: Add Feed - URL preview/sync + CSV upload (Local Demo Co)

**When:** 2026-08-04  
**Tenant:** Local Demo Co (`ee246275-dec0-4446-9e83-58d0c16c258a`)  
**API:** http://127.0.0.1:8080  
**Web:** http://127.0.0.1:5174  
**Auth:** `Authorization: Bearer dk_demo_local_descrybe_test_key_v1`

## Verdict

**PASS** (real HTTP against Local Demo Co; worker running). No fake passes.

| Flow | Result |
|------|--------|
| URL create -> extract-schema (preview) -> map -> sync -> sample process | PASS |
| CSV multipart create -> extract-schema -> map -> sync -> sample process | PASS |
| Sync before mappings | **400** `no field mappings defined for feed` (expected) |

## Correct order

```
Add Feed (URL or CSV file)
  -> status = unmapped
  -> POST .../extract-schema   (preview fields)
  -> PUT  .../mappings         (status -> mapped; sets options.item_path for XML)
  -> POST .../sync             (raw_products)
  -> POST .../sync-process-sample  (or POST /api/v1/process)
```

Do **not** sync before mappings. FTP/FTPS supplier URLs still return 400 (`ftp/ftps feed sync is not supported yet`).

## Fixes applied during this live run

1. **New feeds start as `unmapped`** (`Create` INSERT in `internal/feeds/service.go`) so Sync stays gated until mapping; PUT mappings flips `unmapped` -> `mapped`.
2. **Feeds UI** (`apps/web/src/routes/feeds/+page.svelte`): after create, navigate to `/feeds/{id}/mapping`; block Sync when status is `unmapped`; sync toast no longer says "Next: map fields" after a successful sync.

## Evidence - URL (HTTPS Enim sample)

| Step | HTTP | Notes |
|------|------|-------|
| `POST /api/v1/feeds` JSON | 201 | Feed `453f6efa-...` (Live URL Test); Enim XML URL |
| `POST .../extract-schema` | 200 | 17 fields, `item_path=Export/Item`, preview present |
| Sync without map | 400 | `no field mappings defined for feed` |
| `PUT .../mappings` | 200 | name/brand/gtin/... |
| `POST .../sync` | 202 | **34** products synced, job `completed` |
| `POST .../sync-process-sample` (`limit:3`, `skip_sync:true`, `normalize`) | 202 | job `ae90ffc4-...` -> **completed** |

## Evidence - CSV upload

| Step | HTTP | Notes |
|------|------|-------|
| `POST /api/v1/feeds` multipart (`name`, `feed_type=csv`, `file`) | 201 | Feed `8d1d9e53-...`; `options.source_path` + `source_kind=csv` |
| `POST .../extract-schema` | 200 | 7 fields (EAN, Title, ...); preview = CSV head |
| `PUT .../mappings` | 200 | gtin/name/description/brand/price/stock/main_image |
| `POST .../sync` | 202 | **3** products synced |
| Sample process | 202 -> completed | job `53fede44-...`; all 3 raw -> `processed`; 3 processed products (quality grade C) |

## Retest after fix (CSV)

| Step | Result |
|------|--------|
| Create | 201, **status=`unmapped`** (`474f5343-...`) |
| Sync early | 400 mappings required |
| Map | status -> **`mapped`** |
| Sync | 202, 1 product |
| Sample process | job completed |

## Copy/paste

```powershell
$H = @{ Authorization = "Bearer dk_demo_local_descrybe_test_key_v1"; "Content-Type" = "application/json" }
$base = "http://127.0.0.1:8080/api/v1"

# URL create
Invoke-RestMethod -Method POST -Uri "$base/feeds" -Headers $H -Body (@{
  name = "My URL feed"; url = "https://www.enim.si/xml/A11109019400_nov/A1nov.xml"
  feed_type = "xml"; sync_interval_minutes = 1440
} | ConvertTo-Json)

# CSV create (curl multipart preferred on Windows)
# curl -H "Authorization: Bearer dk_demo_local_descrybe_test_key_v1" `
#   -F "name=My CSV feed" -F "feed_type=csv" -F "file=@sample.csv;type=text/csv" `
#   http://127.0.0.1:8080/api/v1/feeds

# Preview / map / sync / sample (replace FEED_ID)
Invoke-RestMethod -Method POST -Uri "$base/feeds/FEED_ID/extract-schema" -Headers $H -Body "{}"
# PUT mappings via --data-binary @file.json to avoid PowerShell quote mangling, then:
Invoke-RestMethod -Method POST -Uri "$base/feeds/FEED_ID/sync" -Headers $H -Body "{}"
Invoke-RestMethod -Method POST -Uri "$base/feeds/FEED_ID/sync-process-sample" -Headers $H -Body (@{
  limit = 3; skip_sync = $true; processing_type = "normalize"
} | ConvertTo-Json)
```

Worker required: `scripts/run-api.ps1 worker` (or `bin/worker.exe`).

## Related

- [e2e-feeds-process-export.md](e2e-feeds-process-export.md) - map -> process -> export on existing demo feeds
- [qa-local-demo.md](qa-local-demo.md) - Local Demo Co checklist
- [demo-user.md](demo-user.md) - credentials