telvero_whatson_talpa/docs/TRANSMISSION_SYNC_TESTING.md

Transmission Synchronisatie Testing Guide

Overzicht

Dit document beschrijft hoe je de nieuwe transmission synchronisatie functionaliteit kunt testen. De implementatie zorgt ervoor dat wanneer transmissions in de planning worden verplaatst, deze automatisch worden bijgewerkt in Talpa.

Vereisten

1. Database migratie uitvoeren: migrations/002_add_talpa_transmission_id.sql
2. Talpa API configuratie in .env (of MOCK_MODE enabled)
3. Bestaande infomercials in de database

Test Scenario's

Scenario 1: Nieuwe Transmission Aanmaken en Synchroniseren

Doel: Verifieer dat nieuwe transmissions correct worden aangemaakt en gesynchroniseerd naar Talpa.

Stappen:

1. Maak een nieuwe transmission aan via de planning interface
2. Klik op "Sync Block" voor het betreffende blok
3. Controleer de database:

   SELECT id, talpa_transmission_id, api_status 
   FROM transmissions 
   WHERE id = [transmission_id];
   

Verwacht Resultaat:

• talpa_transmission_id is gevuld met een waarde (bijv. "MOCK_TX_1234567890")
• api_status = 'synced'
• api_response bevat de Talpa response

Verificatie:

• Check api_log.txt voor de POST request naar /linearSchedule/v1/transmissions
• Response moet een id bevatten

---

Scenario 2: Bestaande Transmission Verplaatsen

Doel: Verifieer dat verplaatsen van een transmission deze en alle volgende transmissions in het blok update.

Setup:

1. Maak 3 transmissions in een blok (bijv. 07:00, 07:30, 08:00)
2. Sync het blok zodat alle transmissions een talpa_transmission_id hebben

Stappen:

1. Verplaats de tweede transmission naar een latere tijd (bijv. 07:45)
2. Gebruik de drag-and-drop functionaliteit of update API

Verwacht Resultaat:

• Transmission 2 heeft nieuwe start_time (07:45)
• Transmission 3 is automatisch verschoven (08:15)
• Beide transmissions zijn geüpdatet in Talpa (PUT requests)
• api_status blijft 'synced' voor beide

Verificatie:

SELECT id, start_time, talpa_transmission_id, api_status 
FROM transmissions 
WHERE start_date = '[date]' AND channel = '[channel]'
ORDER BY start_time;

Check api_log.txt voor:

• PUT request naar /linearSchedule/v1/transmissions/[id] voor transmission 2
• PUT request voor transmission 3

---

Scenario 3: Insert at Position

Doel: Verifieer dat inserting een transmission op een specifieke positie alle volgende transmissions update.

Setup:

1. Maak een blok met 3 transmissions (07:00, 07:30, 08:00)
2. Sync het blok

Stappen:

1. Insert een nieuwe transmission op positie 1 (tussen eerste en tweede)
2. Gebruik de insert API endpoint

Verwacht Resultaat:

• Nieuwe transmission is aangemaakt op positie 1
• Transmissions 2 en 3 zijn verschoven
• Nieuwe transmission heeft talpa_transmission_id = NULL (nog niet gesynchroniseerd)
• Bestaande transmissions zijn geüpdatet in Talpa

Verificatie:

SELECT id, start_time, talpa_transmission_id, api_status 
FROM transmissions 
WHERE start_date = '[date]' AND channel = '[channel]'
ORDER BY start_time;

Expected times:

• TX1: 07:00 (unchanged)
• NEW: 07:30 (new, no talpa_transmission_id yet)
• TX2: 08:00 (updated from 07:30)
• TX3: 08:30 (updated from 08:00)

---

Scenario 4: Re-sync na Wijzigingen

Doel: Verifieer dat re-sync correct omgaat met bestaande transmissions.

Setup:

1. Maak en sync een blok met transmissions
2. Verplaats enkele transmissions (zonder direct te syncen)

Stappen:

1. Klik op "Sync Block" opnieuw
2. Observeer het gedrag

Verwacht Resultaat:

• Transmissions met talpa_transmission_id: PUT update naar Talpa
• Transmissions zonder talpa_transmission_id: POST create naar Talpa
• Alle transmissions krijgen status 'synced'

Verificatie: Check response van sync_block.php:

{
  "success": true,
  "synced": 3,
  "failed": 0,
  "api_calls": [
    {
      "transmission_id": 1,
      "action": "update",
      "determined_status": "synced"
    },
    {
      "transmission_id": 2,
      "action": "create",
      "determined_status": "synced"
    }
  ]
}

---

Scenario 5: Error Handling - Talpa Transmission Niet Gevonden

Doel: Verifieer dat het systeem correct omgaat met een transmission die lokaal bestaat maar niet in Talpa.

Setup:

1. Maak een transmission met een fake talpa_transmission_id (bijv. "FAKE_ID_123")
2. Zet api_status op 'synced'

Stappen:

1. Probeer de transmission te verplaatsen
2. Of: sync het blok opnieuw

Verwacht Resultaat:

• PUT request faalt (404 of error response)
• talpa_transmission_id wordt NULL
• api_status wordt 'pending' of 'error'
• Bij volgende sync: POST create nieuwe transmission

Verificatie:

SELECT id, talpa_transmission_id, api_status, api_response 
FROM transmissions 
WHERE id = [transmission_id];

---

Scenario 6: Overnight Block

Doel: Verifieer dat transmissions in overnight blocks (bijv. 23:30 - 02:00) correct worden behandeld.

Setup:

1. Maak een overnight block (SBS9 Nachtblok: 23:30 - 02:00)
2. Voeg transmissions toe die over middernacht lopen

Stappen:

1. Maak transmission om 23:30
2. Maak transmission om 00:30
3. Sync het blok
4. Verplaats een transmission

Verwacht Resultaat:

• Beide transmissions worden correct gesynchroniseerd
• Tijd berekeningen werken correct over middernacht
• Updates worden correct naar Talpa gestuurd

---

Scenario 7: Cascade Update bij Meerdere Transmissions

Doel: Verifieer dat een wijziging aan één transmission alle volgende transmissions in het blok update.

Setup:

1. Maak een blok met 5 transmissions (elk 30 minuten)
2. Sync het blok

Stappen:

1. Verplaats transmission 2 naar 15 minuten later
2. Observeer de cascade

Verwacht Resultaat:

• Transmission 2: nieuwe tijd
• Transmissions 3, 4, 5: elk 15 minuten later
• Alle 4 transmissions zijn geüpdatet in Talpa (PUT requests)

Verificatie: Check api_log.txt voor 4 PUT requests:

PUT /linearSchedule/v1/transmissions/[id2]
PUT /linearSchedule/v1/transmissions/[id3]
PUT /linearSchedule/v1/transmissions/[id4]
PUT /linearSchedule/v1/transmissions/[id5]

---

Mock Mode Testing

Voor testen zonder echte Talpa API verbinding, zet in .env:

TALPA_MOCK_MODE=true

Mock responses:

• POST create: {"statusCode": "201", "id": "MOCK_TX_[timestamp]"}
• PUT update: {"statusCode": "200", "message": "Transmission updated"}

---

Database Queries voor Verificatie

Check Sync Status van Blok

SELECT 
    t.id,
    t.start_time,
    t.talpa_transmission_id,
    t.api_status,
    c.title
FROM transmissions t
JOIN infomercials c ON t.infomercial_id = c.id
WHERE t.start_date = '2026-01-20'
AND t.channel = 'SBS9'
ORDER BY t.start_time;

Check Transmissions Zonder Talpa ID

SELECT id, start_time, api_status
FROM transmissions
WHERE talpa_transmission_id IS NULL
AND api_status = 'synced';

Dit zou leeg moeten zijn - alle synced transmissions moeten een talpa_transmission_id hebben.

Check Failed Syncs

SELECT 
    t.id,
    t.start_time,
    t.api_status,
    t.api_response,
    c.title
FROM transmissions t
JOIN infomercials c ON t.infomercial_id = c.id
WHERE t.api_status = 'error'
ORDER BY t.start_date DESC, t.start_time DESC
LIMIT 10;

---

API Endpoints voor Testing

Sync Block

curl -X POST http://localhost/api/sync_block.php \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-01-20",
    "channel": "SBS9"
  }'

Update Transmission

curl -X POST http://localhost/api/update_transmission.php \
  -H "Content-Type: application/json" \
  -d '{
    "id": 123,
    "start_time": "08:15:00"
  }'

Insert at Position

curl -X POST http://localhost/api/insert_transmission_at_position.php \
  -H "Content-Type: application/json" \
  -d '{
    "infomercial_id": 5,
    "channel": "SBS9",
    "date": "2026-01-20",
    "block_id": 10,
    "position": 2
  }'

---

Troubleshooting

Transmission blijft op 'pending'

Oorzaak: Sync is niet uitgevoerd of gefaald Oplossing:

1. Check api_log.txt voor errors
2. Voer sync_block.php opnieuw uit
3. Check api_response kolom voor error details

Talpa Transmission ID is NULL na sync

Oorzaak: Talpa response bevat geen id veld Oplossing:

1. Check api_response in database
2. Verify Talpa API response format
3. Check mock response in TalpaAPI.php line 130

Cascade update werkt niet

Oorzaak: Block ID niet correct bepaald Oplossing:

1. Verify daily_blocks tabel heeft correcte data
2. Check block time ranges
3. Verify transmission valt binnen block

PUT request faalt met 404

Oorzaak: Transmission bestaat niet (meer) in Talpa Oplossing:

1. Systeem zou automatisch talpa_transmission_id op NULL moeten zetten
2. Re-sync maakt nieuwe transmission aan (POST)
3. Verify error handling in helpers.php syncTransmissionToTalpa()

---

Performance Overwegingen

Bij grote blokken (>10 transmissions):

• Elke update triggert meerdere PUT requests naar Talpa
• Overweeg batch updates of rate limiting
• Monitor api_log.txt voor response times

---

Volgende Stappen

Na succesvolle testing:

1. ✅ Migratie uitvoeren op productie database
2. ✅ Backup maken voor rollback
3. ✅ Monitor eerste sync operaties
4. ✅ Check Talpa API logs voor errors
5. ✅ Verify data consistency tussen lokaal en Talpa

---

Support

Bij problemen:

• Check api_log.txt voor API calls
• Check PHP error logs
• Review plans/transmission-sync-update-plan.md voor architectuur details