feat(yedek): günlük MongoDB yedeği, geri yükleme ve bu bilgisayara kopya

- scripts/backup.sh: mongodump + bütünlük denetimi, son 14 yedek
- scripts/restore.sh: ayrı veritabanına geri yükleme ve sayım karşılaştırma
- scripts/backup-pull.sh + systemd zamanlayıcıları; kurulum docs/DEPLOY.md §6

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/DEPLOY.md

@@ -1,6 +1,6 @@
 # 🚀 Canlıya Alma (Atlas Homeserver + Dokploy)
 
-> Durum: ✅ Yayında — https://kakeibo.ta1sph.website (2026-11-12) · Yedekleme ⏳ (Faz 5 bitmeden)
+> Durum: ✅ Yayında — https://kakeibo.ta1sph.website (2026-11-12) · Yedekleme: betikler hazır, sunucuda kurulum bekliyor (§6)
 
 ## 1. Mimari
 
@@ -95,4 +95,78 @@ Notlar:
 
 ## 6. Yedekleme ve geri yükleme
 
-> Faz 3 – Adım 5'te doldurulacak (günlük `mongodump`, son 14 yedek).
+```
+Atlas  03:30  backup.sh ──▶ /var/backups/kakeibo/kakeibo-YYYY-MM-DD_HHMM.archive.gz  (son 14)
+                                     │  rsync (SSH)
+Bu bilgisayar  09:00 / açılışta ──▶ ~/Yedekler/kakeibo/  (son 60, 2 günden eskiyse masaüstü uyarısı)
+```
+
+| Dosya | Nerede çalışır | İş |
+|---|---|---|
+| `scripts/backup.sh` | Atlas → `/usr/local/lib/kakeibo/` | `mongodump --archive --gzip` → gzip + `mongorestore --dryRun` denetimi → son 14'ü tutar |
+| `scripts/restore.sh` | Atlas (ve yerelde `npm run db:restore`) | yedeği **başka adla** geri yükler, kayıt sayılarını gösterir/karşılaştırır |
+| `scripts/backup-pull.sh` | bu bilgisayar | yeni yedekleri çeker, eskiyse uyarır |
+| `deploy/systemd/*` | ikisi | zamanlayıcılar (`Persistent=true`: kapalıyken kaçan çalışma açılınca yapılır) |
+
+Yerel deneme: `npm run db:backup` (kakeibo_dev → `./backups`, git'e girmez) ·
+`COMPARE_DB=kakeibo_dev npm run db:restore -- latest kakeibo_restore_test`.
+
+### 6.1 Atlas'ta kurulum (bir kez)
+Bu bilgisayarda, proje klasöründe:
+```bash
+scp scripts/backup.sh scripts/restore.sh deploy/systemd/kakeibo-backup.service deploy/systemd/kakeibo-backup.timer atlas:/tmp/
+ssh atlas
+```
+Atlas'ta:
+```bash
+sudo install -Dm755 /tmp/backup.sh /usr/local/lib/kakeibo/backup.sh
+sudo install -Dm755 /tmp/restore.sh /usr/local/lib/kakeibo/restore.sh
+sudo install -m644 /tmp/kakeibo-backup.service /tmp/kakeibo-backup.timer /etc/systemd/system/
+```
+- SSH'ye **root olmayan** bir kullanıcıyla bağlanıyorsanız: `sudo systemctl edit --full kakeibo-backup.service` →
+  `#Environment=BACKUP_GROUP=…` satırının başındaki `#`'i kaldırıp kendi kullanıcı grubunuzu yazın (yoksa yedekleri çekemezsiniz).
+
+İlk yedek ve kontrol:
+```bash
+sudo systemctl daemon-reload
+sudo systemctl start kakeibo-backup.service
+journalctl -u kakeibo-backup -n 20 --no-pager     # "tamam: …" görülmeli
+```
+
+### 6.2 Geri yükleme denemesi (kurulumda bir kez, sonra ayda bir önerilir)
+Canlı veriye dokunmaz; ayrı `kakeibo_restore_test` veritabanına yükler ve sayıları karşılaştırır:
+```bash
+sudo COMPARE_DB=kakeibo /usr/local/lib/kakeibo/restore.sh latest kakeibo_restore_test
+# "✅ kakeibo ile aynı" görülmeli. Sonra deneme veritabanını silin:
+sudo docker exec $(sudo docker ps -q -f name=kakeibo-kakeibomongo-fibzhc) mongosh --quiet kakeibo_restore_test --eval 'db.dropDatabase()'
+```
+Sonra zamanlayıcıyı açın:
+```bash
+sudo systemctl enable --now kakeibo-backup.timer
+systemctl list-timers kakeibo-backup.timer        # bir sonraki çalışma saati
+```
+
+### 6.3 Bu bilgisayarda (sunucu dışı kopya)
+Önce şifresiz SSH çalışmalı: `ssh -o BatchMode=yes atlas ls /var/backups/kakeibo` yedek dosyasını listelemeli.
+```bash
+scripts/backup-pull.sh                               # elle bir kez: ~/Yedekler/kakeibo/
+mkdir -p ~/.config/systemd/user
+cp deploy/systemd/kakeibo-backup-pull.service deploy/systemd/kakeibo-backup-pull.timer ~/.config/systemd/user/
+systemctl --user daemon-reload
+systemctl --user enable --now kakeibo-backup-pull.timer
+```
+- SSH'de sunucunun adı `atlas` değilse: `systemctl --user edit --full kakeibo-backup-pull.service` → `KAKEIBO_BACKUP_HOST` satırı.
+- Günlük: `journalctl --user -u kakeibo-backup-pull -n 20`.
+
+### 6.4 Felaket sonrası geri yükleme (canlı veritabanının yerine)
+1. Dokploy → `kakeibo-app` → **Stop** (yükleme sırasında yazma olmasın).
+2. Gerekirse yedeği sunucuya kopyalayın: `scp ~/Yedekler/kakeibo/<dosya> atlas:/tmp/`.
+3. Atlas'ta: `sudo /usr/local/lib/kakeibo/restore.sh /tmp/<dosya> kakeibo --force` (önce mevcut `kakeibo` silinir).
+4. `kakeibo-app` → **Start**, `/api/health` ve giriş kontrolü.
+- MongoDB servisi tamamen yeniden kurulduysa önce §4'teki kullanıcıları (`kakeibo_app`) yeniden oluşturun.
+- Yedekte kullanıcı şifre özetleri (argon2) ve oturum bilgisi bulunur → yedek dosyalarını paylaşmayın.
+
+### Notlar
+- MongoDB'de kimlik doğrulaması zorunlu olmadığından (§4) `mongodump` konteynerin içinden şifresiz çalışır.
+  Auth açıldığında yedek için ayrı bir `backup` rolü kullanıcısı ve betiğe `--config` ile şifre dosyası eklenmeli.
+- Yedek boyutu şu an birkaç KB–MB; 14 + 60 dosya önemsiz yer tutar.