# Behavior Update Berulang di Hourly Summary

## Jawaban Singkat

**YA, ketika cron hourly jalan lagi, data akan di-UPDATE lagi.**

Ini adalah **behavior yang benar dan diinginkan** untuk memastikan data selalu akurat.

## Timeline Update Berulang

### Skenario: Manual Execute + Cron Otomatis

**Jam 14:00 - Manual execute:**
```bash
php bin/hourly_summary.php today 13
```
- ✅ Update data jam 13:00
- ✅ Data jam 13:00 sekarang sesuai dengan entry_events

**Jam 15:00 - Cron otomatis jalan:**
```bash
# Cron command:
php bin/hourly_summary.php today 14
```
- ✅ Update data jam 14:00 (jam yang baru selesai)
- ✅ Data jam 13:00 **TIDAK diubah** (karena tidak di-rekap)

**Jam 16:00 - Cron otomatis jalan lagi:**
```bash
# Cron command:
php bin/hourly_summary.php today 15
```
- ✅ Update data jam 15:00 (jam yang baru selesai)
- ✅ Data jam 13:00 dan 14:00 **TIDAK diubah**

### Skenario: Cron Update Jam yang Sama Berulang

**Jam 15:00 - Cron pertama kali:**
```bash
php bin/hourly_summary.php today 14
```
- ✅ Update data jam 14:00
- ✅ total_count: 10, total_amount: 20000

**Jam 15:30 - Ada event baru masuk (terlambat):**
- Event jam 14:00 masuk di jam 15:30 (terlambat)
- entry_events sekarang punya 11 events untuk jam 14:00

**Jam 16:00 - Cron jalan lagi (jika rekap ulang jam 14):**
```bash
# Jika manual execute lagi:
php bin/hourly_summary.php today 14
```
- ✅ **UPDATE LAGI** data jam 14:00
- ✅ total_count: 10 → 11 (DIGANTI dengan nilai baru)
- ✅ total_amount: 20000 → 22000 (DIGANTI dengan nilai baru)
- ✅ Event terlambat sekarang terhitung

## Mengapa Update Berulang Itu Baik?

### 1. **Akurasi Data**
- Data summary selalu mencerminkan data aktual di `entry_events`
- Jika ada event terlambat, akan otomatis terhitung saat rekap ulang

### 2. **Idempotent**
- Bisa dijalankan berulang tanpa merusak data
- Hasil selalu sama, tidak peduli berapa kali dijalankan
- Tidak akan double count karena menggunakan `ON DUPLICATE KEY UPDATE`

### 3. **Self-Healing**
- Jika ada masalah di cron sebelumnya, bisa di-rekap ulang
- Tidak perlu manual correction

## Contoh Timeline Lengkap

### Hari: 2025-12-17

**Jam 14:00 - Manual execute:**
```bash
php bin/hourly_summary.php today 13
```
- ✅ Update jam 13:00
- ✅ total_count: 5, total_amount: 10000

**Jam 15:00 - Cron otomatis:**
```bash
# Cron command otomatis:
php bin/hourly_summary.php today 14
```
- ✅ Update jam 14:00 (jam yang baru selesai)
- ✅ Jam 13:00 **TIDAK diubah** (karena tidak di-rekap)

**Jam 15:30 - Event terlambat masuk:**
- Event jam 13:00 masuk di jam 15:30 (terlambat)
- entry_events sekarang punya 6 events untuk jam 13:00

**Jam 16:00 - Cron otomatis:**
```bash
# Cron command otomatis:
php bin/hourly_summary.php today 15
```
- ✅ Update jam 15:00 (jam yang baru selesai)
- ✅ Jam 13:00 **MASIH** total_count: 5 (belum ter-update)

**Jam 16:30 - Manual execute lagi untuk jam 13:**
```bash
php bin/hourly_summary.php today 13
```
- ✅ **UPDATE LAGI** jam 13:00
- ✅ total_count: 5 → 6 (DIGANTI dengan nilai baru)
- ✅ total_amount: 10000 → 12000 (DIGANTI dengan nilai baru)
- ✅ Event terlambat sekarang terhitung

## Apakah Data Akan Hilang?

**TIDAK**, data tidak akan hilang karena:

1. **ON DUPLICATE KEY UPDATE** hanya mengganti nilai, bukan menghapus row
2. **Primary key** tetap sama, row tetap ada
3. **Hanya nilai** (total_count, total_amount) yang diganti

### Contoh:

**Sebelum update:**
```
summary_date: 2025-12-17
summary_hour: 13
location_code: kerkof_01
gate_code: gate01
category: motor
total_count: 5
total_amount: 10000
```

**Setelah update:**
```
summary_date: 2025-12-17  ← SAMA
summary_hour: 13           ← SAMA
location_code: kerkof_01  ← SAMA
gate_code: gate01          ← SAMA
category: motor            ← SAMA
total_count: 6             ← DIGANTI (5 → 6)
total_amount: 12000        ← DIGANTI (10000 → 12000)
```

**Row tetap ada**, hanya nilainya yang berubah.

## Apakah Akan Double Count?

**TIDAK**, tidak akan double count karena:

1. **ON DUPLICATE KEY UPDATE** mengganti nilai, bukan menambah
2. Query selalu hitung ulang dari `entry_events`, bukan menambah ke nilai lama
3. Setiap kali rekap, hasilnya selalu sama (idempotent)

### Contoh:

**Skenario salah (jika ditambah):**
```
total_count lama: 5
total_count baru: 6
total_count hasil: 5 + 6 = 11 ❌ SALAH
```

**Skenario benar (diganti):**
```
total_count lama: 5
total_count baru: 6
total_count hasil: 6 ✅ BENAR (diganti, bukan ditambah)
```

## Kapan Data Akan Di-Update Lagi?

### 1. **Cron Otomatis Setiap Jam**
- Update jam yang baru saja selesai
- Contoh: jam 15:00 update jam 14:00
- Jam sebelumnya **TIDAK diubah**

### 2. **Manual Execute**
- Update jam yang ditentukan
- Bisa update jam berapa saja, kapan saja
- Berguna untuk rekap ulang atau fix data

### 3. **Rekap Final Kemarin**
- Setiap hari jam 1 pagi
- Rekap semua jam kemarin
- Memastikan data kemarin lengkap

## Best Practice

### ✅ **Yang Benar:**

1. **Biarkan cron otomatis jalan setiap jam**
   - Update jam yang baru selesai
   - Tidak perlu manual intervention

2. **Manual execute hanya jika perlu:**
   - Ada event terlambat yang perlu di-rekap
   - Ada masalah di cron sebelumnya
   - Testing atau debugging

3. **Rekap final kemarin (opsional):**
   - Setiap hari jam 1 pagi
   - Memastikan data kemarin lengkap

### ❌ **Yang Salah:**

1. **Jangan khawatir data hilang**
   - Data tidak akan hilang, hanya nilai yang diganti
   - Row tetap ada dengan primary key yang sama

2. **Jangan takut double count**
   - Tidak akan double count karena menggunakan UPDATE, bukan ADD
   - Query selalu hitung ulang dari source data

3. **Jangan manual execute terlalu sering**
   - Biarkan cron otomatis bekerja
   - Manual execute hanya jika benar-benar perlu

## Kesimpulan

| Aspek | Behavior |
|-------|----------|
| **Apakah akan di-update lagi?** | ✅ YA, setiap kali cron jalan atau manual execute |
| **Apakah data akan hilang?** | ❌ TIDAK, row tetap ada, hanya nilai yang diganti |
| **Apakah akan double count?** | ❌ TIDAK, menggunakan UPDATE bukan ADD |
| **Apakah ini normal?** | ✅ YA, ini behavior yang benar dan diinginkan |
| **Kapan akan di-update?** | Setiap jam (cron otomatis) atau manual execute |

**Intinya:** Update berulang adalah **normal dan benar**. Ini memastikan data summary selalu akurat dan sesuai dengan `entry_events`.