tillerhand 3.43.0 → 3.47.1

package/docs/operations/accounts.md

@@ -1,39 +1,39 @@
-# Hesaplar ve Son Tarihler
+# Accounts and Deadlines
 
-> Projenin bağlı olduğu her dış hesap burada. Tek kişilik projelerde en sık yaşanan felaketler kod değil:
-> alan adının süresinin dolması, kartın geçersiz olup servisin durması, 2FA'sız hesabın ele geçirilmesi,
-> kimde olduğu unutulan bir anahtar. `/dashboard` panosu **30 gün içinde dolan tarihleri** "Dikkat" alanında gösterir.
+> Every external account the project depends on is listed here. In one-person projects the most common disasters are not code:
+> an expired domain, an invalid card that stops a service, a hijacked account without 2FA,
+> a key nobody remembers owning. The `/dashboard` dashboard shows **dates expiring within 30 days** in the "Needs attention" area.
 >
-> **Buraya asla şifre, anahtar veya token yazma.** Sadece hangi hesap, kimde, ne zaman bitiyor.
-> Tarihler `YYYY-AA-GG` biçiminde olmalı (pano okur).
+> **Never write a password, key or token here.** Write only which account, who holds it, when it ends.
+> Dates must use the `YYYY-AA-GG` format (the dashboard reads them).
 
 ## Hesaplar
 
-| Servis | Amaç | Hesap sahibi | 2FA | Plan / aylık maliyet | Bitiş / yenileme | Anahtar yenileme | Not |
+| Service | Purpose | Account owner | 2FA | Plan / monthly cost | Expiry / renewal | Key rotation | Note |
 |---|---|---|---|---|---|---|---|
-| [GitHub] | Kod deposu | [e-posta] | [evet/hayır] | [Ücretsiz] | - | - | |
-| [Alan adı kayıt firması] | Alan adı | | | | [YYYY-AA-GG] | - | Otomatik yenileme açık mı? |
+| [GitHub] | Code repository | [email] | [yes/no] | [Free] | - | - | |
+| [Domain registrar] | Domain name | | | | [YYYY-AA-GG] | - | Is auto-renewal on? |
 | [Hosting] | | | | | | | |
-| [Veritabanı] | | | | | | [YYYY-AA-GG] | |
-| [E-posta servisi] | | | | | | | |
-| [Ödeme sağlayıcı] | | | | | | | |
-| [Hata takibi] | | | | | | | |
-| [AI sağlayıcı] | | | | | | [YYYY-AA-GG] | Harcama limiti: |
-| [Apple / Google geliştirici] | Mağaza | | | | [YYYY-AA-GG] | | Yıllık üyelik |
+| [Database] | | | | | | [YYYY-AA-GG] | |
+| [Email service] | | | | | | | |
+| [Payment provider] | | | | | | | |
+| [Error tracking] | | | | | | | |
+| [AI provider] | | | | | | [YYYY-AA-GG] | Spend limit: |
+| [Apple / Google developer] | Store | | | | [YYYY-AA-GG] | | Annual membership |
 
 ## Ortamlar (dev / prod)
 
-> Proje ref'i ve URL sır değildir; anahtarlar yine buraya yazılmaz. `/release` bu tabloyu okur: prod ref'i
-> `.mcp.json`'da, `.claude/`'da veya kodda geçerse yayını engeller.
+> A project ref and a URL are not secrets; keys are still not written here. `/release` reads this table: it blocks the release
+> if the prod ref appears in `.mcp.json`, in `.claude/` or in code.
 
-| Ortam | Servis | Proje ref / URL | Kim bağlanır |
+| Environment | Service | Project ref / URL | Who connects |
 |---|---|---|---|
-| dev | [Supabase] | [dev ref] | Yerel ortam, AI (MCP salt-okunur ve `supabase-dev`), CI dışındaki denemeler |
-| prod | [Supabase] | [prod ref] | Sadece barındırma (Vercel / EAS ortam değişkenleri). AI ve yerel ortam bağlanmaz |
+| dev | [Supabase] | [dev ref] | Local environment, AI (MCP read-only and `supabase-dev`), trials outside CI |
+| prod | [Supabase] | [prod ref] | Hosting only (Vercel / EAS environment variables). AI and the local environment do not connect |
 
-## Kurallar
+## Rules
 
-- Her yeni dış servis eklendiğinde (`/start` Adım 5, yeni entegrasyon) bu tabloya satır eklenir.
-- Kritik hesaplarda 2FA zorunlu: kod deposu, hosting, veritabanı, alan adı, ödeme, e-posta.
-- Ödeme kartının son kullanma tarihini de "Bitiş" sütununa yaz (kart bitince servisler durur).
-- `/maintain quarterly` bu tabloyu gözden geçirir; `/release ilk` boş satır bırakmaz.
+- Add a row to this table whenever a new external service is added (`/start` Step 5, a new integration).
+- 2FA is mandatory on critical accounts: code repository, hosting, database, domain, payment, email.
+- Also write the payment card's expiry date in the "Expiry" column (services stop when the card expires).
+- `/maintain quarterly` reviews this table; `/release first` leaves no empty row.

package/docs/operations/deploy-setup.md

@@ -1,105 +1,105 @@
-# Dağıtım Kurulumu
+# Deploy Setup
 
-> `/release first` → "Dağıtım kurulumu" bu dosyayı kullanır. Sadece `docs/architecture/stack.md`'deki sağlayıcıların bölümü okunur.
-> Adımlar sağlayıcıların resmî dokümanından alındı; her bölümde kaynak ve kontrol tarihi var. Paneller değişir:
-> kullanmadan önce kaynak sayfayı `source-research` ile yeniden aç. Bir şey değiştiyse güncel kaynağa göre ilerle ve farkı raporda yaz.
-> Bir yıldan eski kaynak tarihi ⚠️ ile işaretlidir.
+> `/release first` → "Deploy setup" uses this file. Only the section for the providers in `docs/architecture/stack.md` is read.
+> The steps come from the providers' official docs; each section has the source and the check date. Panels change:
+> before using, reopen the source page with `source-research`. If something changed, follow the current source and write the difference in the report.
+> A source date older than a year is marked with ⚠️.
 
-## Kurallar
+## Rules
 
-- **Sır değeri sohbete ve dosyaya yazılmaz.** Bu dosyaya, `accounts.md`'ye ve koda da. AI sadece değişken adını söyler (`.env.example`'daki gibi); değeri kullanıcı sağlayıcının panelinde kendisi girer.
-- `mattpocock-skills:wizard` betiği prod sırrı istemez ve `.env`'e prod değeri yazmaz. Prod değeri panelde girilir. Betik sadece CI sırlarını (ör. `LIVE_TEST_*`) kullanıcının terminalinde gizli girişle `gh secret set`'e verir. Betik `sandbox/` altında durur, iş bitince silinir.
-- Prod deploy, geri alma provası ve yedekten geri yükleme onaysız başlamaz.
-- AI ve yerel ortam prod veritabanına bağlanmaz (`accounts.md` → Ortamlar). Tek istisna: kullanıcının kendi terminalinde aldığı yedek (Supabase → Yedek).
-- Her adımın sonucu `accounts.md`'ye (servis, sahip, 2FA, plan, bitiş; Ortamlar'da prod ref ve URL) ve `/release` raporuna işlenir.
-- Bu dosya kitle güncellenir; projede düzenleme. Kaynakla çelişen adımı raporda yaz.
+- **A secret value is never written in chat or in a file.** Not in this file, not in `accounts.md`, not in code. The AI says only the variable name (as in `.env.example`); the user enters the value in the provider's panel themselves.
+- The `mattpocock-skills:wizard` script does not ask for a prod secret and does not write a prod value to `.env`. The prod value is entered in the panel. The script passes only CI secrets (e.g. `LIVE_TEST_*`) to `gh secret set` with hidden input in the user's terminal. The script stays under `sandbox/` and is deleted when the work is done.
+- A prod deploy, a rollback drill and a restore from backup do not start without approval.
+- The AI and the local environment do not connect to the prod database (`accounts.md` → Ortamlar). The only exception: the backup the user takes in their own terminal (Supabase → Backup).
+- The result of each step goes into `accounts.md` (service, owner, 2FA, plan, expiry; the prod ref and URL under Ortamlar) and into the `/release` report.
+- The kit updates this file; do not edit it in the project. Write a step that conflicts with the source in the report.
 
-## Sıra
+## Order
 
-1. Hosting projesi (prod, dev'den ayrı)
-2. Ortam değişkenleri (Production ve Preview ayrı değer)
-3. Alan adı ve DNS
-4. Yedek ve zamana geri dönüş (PITR)
-5. Geri alma provası (en sonda, onaylı)
+1. Hosting project (prod, separate from dev)
+2. Environment variables (separate values for Production and Preview)
+3. Domain and DNS
+4. Backup and point-in-time recovery (PITR)
+5. Rollback drill (last, with approval)
 
 ## Vercel (web)
 
-Kontrol: 2026-10-25. Kaynaklar: [Environment variables](https://vercel.com/docs/environment-variables) (2026-09-17) · [Add a domain](https://vercel.com/docs/domains/working-with-domains/add-a-domain) (2026-09-16) · [A record](https://vercel.com/kb/guide/a-record-and-caa-with-vercel) (2026-10-16) · [Instant Rollback](https://vercel.com/docs/instant-rollback) (2026-07-07)
+Checked: 2026-10-25. Sources: [Environment variables](https://vercel.com/docs/environment-variables) (2026-09-17) · [Add a domain](https://vercel.com/docs/domains/working-with-domains/add-a-domain) (2026-09-16) · [A record](https://vercel.com/kb/guide/a-record-and-caa-with-vercel) (2026-10-16) · [Instant Rollback](https://vercel.com/docs/instant-rollback) (2026-07-07)
 
-**Proje.** GitHub deposunu Vercel projesine bağla. Prod dalına (genelde `main`) push prod deploy'u, diğer dallar önizlemeyi üretir.
+**Project.** Connect the GitHub repository to a Vercel project. A push to the prod branch (usually `main`) produces the prod deploy; other branches produce previews.
 
-**Ortam değişkenleri.** Settings → Environment Variables. Her değişken için ortam seç: Production, Preview, Development. Anahtar ve token **Secret** türünde girilir (kaydedildikten sonra okunamaz); URL gibi açık değerler **Config**. Değişiklik eski deploy'lara uygulanmaz, yeni deploy gerekir. Sınır: deploy başına toplam 64 KB (edge'de değişken başı 5 KB).
+**Environment variables.** Settings → Environment Variables. For each variable pick the environment: Production, Preview, Development. Keys and tokens are entered as **Secret** (unreadable after saving); open values such as URLs as **Config**. A change does not apply to old deploys; a new deploy is needed. Limit: 64 KB total per deploy (5 KB per variable at the edge).
 
-**Alan adı.** Settings → Domains → Add Domain (CLI: `vercel domains add example.com <proje>`). Apex eklenince `www` önerilir: ikisini de ekle, birini diğerine yönlendir.
-- Apex (`example.com`): **A** kaydı. Değeri proje alan adı kartından al. Çoğu projede `76.76.21.21`, yeni projelerde farklı olabilir (ör. `216.198.79.1`); doğrulama karttaki değeri arar.
-- Alt alan (`www`, `app`): **CNAME**, hedef projeye özel (kartta, ör. `…vercel-dns-017.com`).
-- Alan başka bir Vercel hesabındaysa `_vercel` adında **TXT** doğrulaması istenir.
-- Nameserver'ı Vercel'e taşıyacaksan önce MX ve doğrulama TXT kayıtlarını kopyala; yoksa e-posta durur. SSL otomatik.
+**Domain.** Settings → Domains → Add Domain (CLI: `vercel domains add example.com <proje>`). When you add the apex, `www` is recommended: add both and redirect one to the other.
+- Apex (`example.com`): **A** record. Take the value from the project's domain card. In most projects it is `76.76.21.21`; new projects may differ (e.g. `216.198.79.1`); verification looks for the value on the card.
+- Subdomain (`www`, `app`): **CNAME**, the target is project-specific (on the card, e.g. `…vercel-dns-017.com`).
+- If the domain is in another Vercel account, a **TXT** verification named `_vercel` is requested.
+- If you will move the nameserver to Vercel, first copy the MX and verification TXT records; otherwise email stops. SSL is automatic.
 
-**Yedek.** Vercel'de veri yok; veritabanının bölümüne bak.
+**Backup.** There is no data in Vercel; see the database's section.
 
-**Geri alma.** Proje → Production Deployment kutusu → Instant Rollback (ya da Deployments → ⋮ → Instant Rollback).
-- Hobby sadece bir önceki prod deploy'a döner; Pro ve Enterprise prod'a çıkmış her deploy'a.
-- Ortam değişkenleri geri alınmaz, eski build'in değerleriyle çalışır.
-- Geri almadan sonra prod alan adı otomatik atanmaz: yeni push canlıya çıkmaz. Düzeltme hazır olunca "Undo Rollback" ya da `vercel promote <deploy-url>`.
+**Rollback.** Project → Production Deployment box → Instant Rollback (or Deployments → ⋮ → Instant Rollback).
+- Hobby returns only to the previous prod deploy; Pro and Enterprise to any deploy that went to prod.
+- Environment variables are not rolled back; the old build runs with its own values.
+- After a rollback the prod domain is not assigned automatically: a new push does not go live. When the fix is ready, "Undo Rollback" or `vercel promote <deploy-url>`.
 
-## Supabase (veritabanı + kimlik)
+## Supabase (database + auth)
 
-Kontrol: 2026-10-25. Kaynaklar: [Backups](https://supabase.com/docs/guides/platform/backups) · [Backup and restore using the CLI](https://supabase.com/docs/guides/platform/migrating-within-supabase/backup-restore) · [API keys](https://supabase.com/docs/guides/api/api-keys) (sayfalarda tarih yok)
+Checked: 2026-10-25. Sources: [Backups](https://supabase.com/docs/guides/platform/backups) · [Backup and restore using the CLI](https://supabase.com/docs/guides/platform/migrating-within-supabase/backup-restore) · [API keys](https://supabase.com/docs/guides/api/api-keys) (no dates on the pages)
 
-**Proje.** Prod için ayrı proje aç. Ref'ini `accounts.md` → Ortamlar → prod satırına yaz. Auth ve e-posta ayarları: `docs/architecture/stack.md` → "Canlıya alma (ek)".
+**Project.** Open a separate project for prod. Write its ref in `accounts.md` → Ortamlar → prod row. Auth and email settings: `docs/architecture/stack.md` → "Go live (extra)".
 
-**Anahtarlar.** Yeni anahtarlar `sb_publishable_…` (istemciye gidebilir) ve `sb_secret_…` (sadece sunucuda; hosting panelinde Secret türünde). `eyJ` ile başlayan uzun anahtar eski türdür. Supabase eski `anon` ve `service_role` anahtarlarını 2026 sonuna kadar kullanımdan kaldırıyor: yeni projede yeni anahtarları kullan. `.env.example`'da eski adlar (`NEXT_PUBLIC_SUPABASE_ANON_KEY`, `SUPABASE_SERVICE_ROLE_KEY`) duruyorsa yeni anahtarı aynı adla gir.
+**Keys.** The new keys are `sb_publishable_…` (can go to the client) and `sb_secret_…` (server only; as Secret in the hosting panel). A long key starting with `eyJ` is the old type. Supabase is deprecating the old `anon` and `service_role` keys by the end of 2026: use the new keys in a new project. If `.env.example` still has the old names (`NEXT_PUBLIC_SUPABASE_ANON_KEY`, `SUPABASE_SERVICE_ROLE_KEY`), enter the new key under the same name.
 
-**Yedek.**
-- Free: otomatik yedek listelenmiyor. Düzenli dış yedek al. Varsayılan `db dump` sadece şemayı alır; tam yedek üç dosyadır. Bu komutları **kullanıcı kendi terminalinde** çalıştırır: bağlantı adresinde prod veritabanı parolası var, AI komutu çalıştırmaz ve parolayı istemez. Dosyalar depoya girmez.
+**Backup.**
+- Free: automatic backups are not listed. Take a regular external backup. The default `db dump` takes only the schema; a full backup is three files. **The user runs** these commands **in their own terminal**: the connection address holds the prod database password, the AI does not run the command and does not ask for the password. The files do not enter the repository.
   ```bash
   npx -y supabase@2.120.0 db dump --db-url "$PROD_DB_URL" -f roles.sql --role-only
   npx -y supabase@2.120.0 db dump --db-url "$PROD_DB_URL" -f schema.sql
   npx -y supabase@2.120.0 db dump --db-url "$PROD_DB_URL" -f data.sql --use-copy --data-only -x "storage.buckets_vectors" -x "storage.vector_indexes"
   ```
-  `PROD_DB_URL`: panelin Connect ekranındaki Session pooler adresi; kalıcı dosyaya yazılmaz. Gerekenler: Supabase CLI ve Docker.
-- Pro 7 gün, Team 14 gün, Enterprise 30 güne kadar günlük yedek.
-- PITR: Pro ve üstünde eklenti, en az Small compute. 7/14/28 gün saklama, aylık yaklaşık $100/$200/$400. En kötü durumda 2 dakikalık veri kaybı. PITR açılınca günlük yedek durur.
-- Geri yükleme: Database → Backups. Bu sırada proje erişilemez, süre veritabanı boyutuyla uzar. Storage dosyaları yedekte yok.
-- Prova: prod'u geri yükleme. Kullanıcı üç dosyayı kendi makinesinde geçici bir yerel veritabanına (`supabase start`) `psql --single-transaction` ile yükler (sıra ve bayraklar kaynak sayfada), birkaç tabloyu kontrol eder, sonra yerel veritabanını ve dosyaları siler. Dev projesine yükleme: prod'daki kişisel veri AI'nın okuduğu ortama geçer.
+  `PROD_DB_URL`: the Session pooler address on the panel's Connect screen; it is not written to a permanent file. Requirements: Supabase CLI and Docker.
+- Pro keeps daily backups up to 7 days, Team 14 days, Enterprise 30 days.
+- PITR: an add-on on Pro and above, at least Small compute. 7/14/28 days retention, about $100/$200/$400 a month. At worst 2 minutes of data loss. When PITR is turned on, daily backups stop.
+- Restore: Database → Backups. The project is unreachable during this; the time grows with the database size. Storage files are not in the backup.
+- Drill: do not restore prod. The user loads the three files into a temporary local database on their own machine (`supabase start`) with `psql --single-transaction` (order and flags are on the source page), checks a few tables, then deletes the local database and the files. Loading into the dev project: personal data from prod would move to the environment the AI reads.
 
-**Geri alma.** Migration'ı geri almak için ters migration yaz; yedekten dönüş son çaredir (kesinti ve veri kaybı).
+**Rollback.** To undo a migration, write a reverse migration; restoring from backup is the last resort (downtime and data loss).
 
 ## Railway (backend)
 
-Kontrol: 2026-10-25. Kaynaklar: [Working with domains](https://docs.railway.com/networking/domains/working-with-domains) · [Variables](https://docs.railway.com/variables) · [Deployment actions](https://docs.railway.com/deployments/deployment-actions) · [Backups](https://docs.railway.com/volumes/backups) · [Plans](https://docs.railway.com/pricing/plans) (sayfalarda tarih yok)
+Checked: 2026-10-25. Sources: [Working with domains](https://docs.railway.com/networking/domains/working-with-domains) · [Variables](https://docs.railway.com/variables) · [Deployment actions](https://docs.railway.com/deployments/deployment-actions) · [Backups](https://docs.railway.com/volumes/backups) · [Plans](https://docs.railway.com/pricing/plans) (no dates on the pages)
 
-**Proje.** GitHub deposundan servis oluştur. Railway adresi: servis Settings → Networking → Public Networking → Generate Domain.
+**Project.** Create a service from the GitHub repository. Railway address: service Settings → Networking → Public Networking → Generate Domain.
 
-**Ortam değişkenleri.** Servisin Variables sekmesi. Birden çok serviste aynı olan değer: Project Settings → Shared Variables, serviste `${{shared.AD}}`. Veritabanı adresi referansla: `${{Postgres.DATABASE_URL}}` (servis adı Postgres ise). Sırları **sealed** yap: değer arayüzde ve API'de görünmez, geri açılamaz, PR ortamına kopyalanmaz. Değişiklikler önce "staged" olur; Deploy ile uygulanır.
+**Environment variables.** The service's Variables tab. A value shared by several services: Project Settings → Shared Variables, in the service `${{shared.AD}}`. Database address by reference: `${{Postgres.DATABASE_URL}}` (if the service name is Postgres). Make secrets **sealed**: the value is not visible in the interface or the API, cannot be unsealed, and is not copied to a PR environment. Changes are first "staged"; Deploy applies them.
 
-**Alan adı.** Servis Settings → Public Networking → + Custom Domain. Panel bir **CNAME** (ör. `…up.railway.app`) ve bir **TXT** kaydı gösterir; ikisini de aynen gir. TXT yoksa alan doğrulanmaz ve 404 döner. Yayılma 72 saate kadar sürebilir.
-- Apex için DNS sağlayıcısı CNAME flattening veya ALIAS desteklemeli (Cloudflare, Namecheap: CNAME; DNSimple: ALIAS). Route 53, Azure DNS, GoDaddy, Hostinger, NameSilo, Squarespace desteklemez: nameserver'ı Cloudflare'e taşı.
-- Cloudflare proxy açıksa SSL/TLS ayarı **Full** olmalı; Full (Strict) çalışmaz.
-- SSL (Let's Encrypt) DNS'ten sonra 1 saat içinde. Sınır: Trial 1 alan, Hobby servis başı 2, Pro 20.
+**Domain.** Service Settings → Public Networking → + Custom Domain. The panel shows a **CNAME** (e.g. `…up.railway.app`) and a **TXT** record; enter both exactly. Without the TXT the domain is not verified and returns 404. Propagation can take up to 72 hours.
+- For the apex, the DNS provider must support CNAME flattening or ALIAS (Cloudflare, Namecheap: CNAME; DNSimple: ALIAS). Route 53, Azure DNS, GoDaddy, Hostinger, NameSilo, Squarespace do not support it: move the nameserver to Cloudflare.
+- If the Cloudflare proxy is on, the SSL/TLS setting must be **Full**; Full (Strict) does not work.
+- SSL (Let's Encrypt) within 1 hour after DNS. Limit: Trial 1 domain, Hobby 2 per service, Pro 20.
 
-**Yedek.** Veritabanı servisi → Backups sekmesi. Elle yedek ve zamanlama: günlük (6 gün saklanır), haftalık (27 gün), aylık (89 gün). Elle yedek volume boyutunun %50'siyle sınırlı. Geri yükleme yeni bir volume açar, eskisi bağlantısız kalır; Deploy ile uygulanır ve sadece aynı proje ve ortama yapılır. Volume silinirse yedekleri de gider: ayrıca `pg_dump` ile dış yedek al.
+**Backup.** Database service → Backups tab. Manual backup and schedule: daily (kept 6 days), weekly (27 days), monthly (89 days). A manual backup is limited to 50% of the volume size. A restore opens a new volume, the old one stays detached; Deploy applies it and it works only within the same project and environment. If the volume is deleted, its backups go too: also take an external backup with `pg_dump`.
 
-**Geri alma.** Servis → Deployments → önceki deploy → ⋮ → Rollback. İmajı ve değişkenleri geri getirir, veritabanı şemasını getirmez. Pencere imaj saklama süresi kadar: Free/Trial 24 saat, Hobby 72 saat, Pro 120 saat. Daha eskisine yeniden deploy gerekir.
+**Rollback.** Service → Deployments → previous deploy → ⋮ → Rollback. It restores the image and the variables, not the database schema. The window equals the image retention time: Free/Trial 24 hours, Hobby 72 hours, Pro 120 hours. For anything older, redeploy.
 
-## EAS (mobil)
+## EAS (mobile)
 
-Kontrol: 2026-10-25. Kaynaklar: [Environment variables](https://docs.expo.dev/eas/environment-variables/) (2026-07-21) · [Manage variables](https://docs.expo.dev/eas/environment-variables/manage/) (2026-07-21) · [Submit](https://docs.expo.dev/submit/introduction/) (2026-10-12) · [Rollbacks](https://docs.expo.dev/eas-update/rollbacks/) (2025-03-03 ⚠️)
+Checked: 2026-10-25. Sources: [Environment variables](https://docs.expo.dev/eas/environment-variables/) (2026-07-21) · [Manage variables](https://docs.expo.dev/eas/environment-variables/manage/) (2026-07-21) · [Submit](https://docs.expo.dev/submit/introduction/) (2026-10-12) · [Rollbacks](https://docs.expo.dev/eas-update/rollbacks/) (2025-03-03 ⚠️)
 
-**Proje ve hesaplar.** Apple Developer Program ve Google Play Console hesapları `accounts.md`'ye (yıllık yenileme tarihiyle). Mağaza listesini Play Console'da gönderimden önce hazırla. `eas submit` ilk Android sürümünü internal testing kanalına yükler. CI'da gönderim için Google servis hesabı anahtarı ve App Store Connect API anahtarı gerekir; bu dosyalar depoya girmez.
+**Project and accounts.** Apple Developer Program and Google Play Console accounts go into `accounts.md` (with the yearly renewal date). Prepare the store listing in Play Console before submission. `eas submit` uploads the first Android release to the internal testing track. Submission in CI needs a Google service account key and an App Store Connect API key; these files do not enter the repository.
 
-**Ortam değişkenleri.** Ortamlar: development, preview, production. Görünürlük:
-- plain text: sitede, CLI'da ve logda görünür;
-- sensitive: logda gizlenir, sitede ve CLI'da okunur;
-- secret: sadece EAS sunucularında okunur. Derleme sırasında gereken anahtarlar içindir (ör. özel paket token'ı).
+**Environment variables.** Environments: development, preview, production. Visibility:
+- plain text: visible on the site, in the CLI and in the log;
+- sensitive: hidden in the log, readable on the site and in the CLI;
+- secret: readable only on EAS servers. For keys needed during the build (e.g. a private package token).
 
-Uygulamaya giren her değer (`EXPO_PUBLIC_…`) herkese açıktır: oraya sır koyma. Build profili ortamı `eas.json` → `environment` alanından seçer; güncelleme `eas update --environment production`. Değeri sitede gir: `eas env:set --value …` değeri kabuk geçmişine yazar.
+Every value that goes into the app (`EXPO_PUBLIC_…`) is public: do not put a secret there. The build profile picks the environment from `eas.json` → `environment`; update with `eas update --environment production`. Enter the value on the site: `eas env:set --value …` writes the value to the shell history.
 
-**Yedek.** EAS'ta veri yok; backend'in bölümüne bak (Supabase veya Railway).
+**Backup.** There is no data in EAS; see the backend's section (Supabase or Railway).
 
-**Geri alma.** `eas update:rollback`: önceki güncellemeyi yeniden yayımlar ya da build'e gömülü güncellemeye döner. Native kod değişikliği güncellemeyle geri alınmaz: yeni build ve mağaza incelemesi gerekir.
+**Rollback.** `eas update:rollback`: republishes the previous update or returns to the update embedded in the build. A native code change is not rolled back with an update: a new build and store review are needed.
 
-## Geri alma provası (hepsi)
+## Rollback drill (all)
 
-Lansmandan önce bir kez, kullanıcı onayıyla: zararsız bir değişiklik yayımla, geri al, duman testiyle eski sürümün canlıda olduğunu gör, sonra normale dön (Vercel'de "Undo Rollback"). Sonucu `/release` raporunda "Geri alma yolu" satırına yaz.
+Once before launch, with user approval: publish a harmless change, roll it back, see with a smoke test that the old version is live, then return to normal (in Vercel "Undo Rollback"). Write the result in the `/release` report on the "Rollback path" line.

package/docs/operations/feature-flags.md

@@ -1,27 +1,27 @@
-# Özellik Bayrakları
+# Feature Flags
 
-> Riskli özellikler bir bayrağın arkasında yayınlanır. Sorun çıkarsa **yeniden deploy etmeden** kapatılır (acil kapatma).
-> Unutulan bayrak teknik borçtur: her bayrağın bir kaldırma tarihi olur. `/dashboard` panosu süresi geçenleri gösterir.
-> Uygulama yöntemi `docs/architecture/stack.md` → "Özellik bayrakları" bölümünde.
+> Risky features ship behind a flag. If something goes wrong, the flag is turned off **without a redeploy** (kill switch).
+> A forgotten flag is technical debt: every flag gets a removal date. The `/dashboard` dashboard shows the overdue ones.
+> The implementation method is in `docs/architecture/stack.md` → "Acceptance tests and feature flags".
 
-## Ne zaman bayrak zorunlu?
+## When is a flag mandatory?
 
-- Ödeme, abonelik veya para hareketi
-- AI/LLM çağrısı yapan özellik (maliyet patlaması riski)
-- Toplu e-posta / bildirim gönderen özellik
-- Veri silen, taşıyan veya dışa aktaran özellik
-- Büyük arayüz değişikliği (kademeli açmak için)
+- Payment, subscription or money movement
+- A feature that calls an AI/LLM (risk of a cost explosion)
+- A feature that sends bulk email / notifications
+- A feature that deletes, moves or exports data
+- A large interface change (to roll it out gradually)
 
 ## Bayraklar
 
-`/dashboard` panosu bu tabloyu okur. Tarih biçimi `YYYY-AA-GG`, durum `açık` / `kapalı` / `kademeli %N`.
+The `/dashboard` dashboard reads this table. Date format `YYYY-AA-GG`, status `on` / `off` / `gradual %N`.
 
-| Bayrak | Amaç | Durum | Sahibi | Eklendi | Kaldırma tarihi | Acil kapatma test edildi |
+| Flag | Purpose | Status | Owner | Added | Removal date | Kill switch tested |
 |---|---|---|---|---|---|---|
 
-## Kurallar
+## Rules
 
-- Bayrak adı `ozellik_adi` biçiminde ve `docs/product/glossary.md` ile uyumlu.
-- Bayrak kapalıyken kod yolu da test edilir (iki durum için en az bir test).
-- Özellik herkese açıldıktan ve 2 hafta sorunsuz çalıştıktan sonra bayrak ve eski kod yolu kaldırılır.
-- Acil kapatma: Panelden veya ortam değişkeninden kapatma adımı bu dosyada yazılı ve en az bir kez denenmiş olmalı.
+- The flag name uses the `ozellik_adi` form and matches `docs/product/glossary.md`.
+- The code path is also tested while the flag is off (at least one test for each of the two states).
+- After the feature is open to everyone and has run without problems for 2 weeks, the flag and the old code path are removed.
+- Kill switch: the step to turn it off from the panel or an environment variable is written in this file and has been tried at least once.

package/docs/operations/maintenance.md

@@ -1,52 +1,52 @@
-# Bakım ve Düzenli Kontroller
-
-> Canlıdaki proje kendi kendine bozulur: bağımlılıklar eskir, sertifikalar ve kartlar süresi dolar,
-> faturalar şişer, yedekler sessizce durur. Bu dosya bunları yakalar.
-> `/maintain weekly` · `/maintain monthly` · `/maintain quarterly` komutları ilgili listeyi çalıştırır ve kayda ekler.
-> Tipe özel ek maddeler: `docs/architecture/stack.md` → "Bakım".
-
-## Haftalık (~15 dk)
-
-- [ ] Hata takibi: yeni veya artan hata var mı? Varsa `docs/product/roadmap.md`'ye görev olarak ekle.
-- [ ] Uptime: kesinti oldu mu?
-- [ ] Maliyet: hosting, DB, AI API harcaması beklenen aralıkta mı? Harcama alarmı tetiklendi mi (`docs/operations/spend-alarms.md`)?
-- [ ] Kullanıcı geri bildirimi / destek kutusu tarandı.
-- [ ] Yedekler son 7 günde başarıyla alındı mı?
-
-## Aylık (~1 saat)
-
-- [ ] Bağımlılık güncellemesi (yama ve küçük sürümler) + testler.
-- [ ] Bağımlılık güvenlik taraması (`npm audit` / `uv run --with pip-audit pip-audit`).
-- [ ] Performans ölçümü (tipe özel hedefler, `docs/architecture/stack.md`).
-- [ ] Maliyet trendi: geçen aya göre artış neden?
-- [ ] Kullanılmayan servis, ortam değişkeni, özellik bayrağı, ölü kod temizliği.
-- [ ] `docs/workflow/progress.md`, `docs/architecture/overview.md` güncel mi?
-- [ ] Analitik: başarı kriterlerine (`docs/product/prd.md` §4) göre durum.
-- [ ] Kopya kod oranı (`npx jscpd --silent .`) ve `docs/quality/metrics.md`'ye aylık satır.
-- [ ] `docs/product/unit-economics.md` gerçek faturalarla güncel mi?
-- [ ] `docs/operations/feature-flags.md`: kaldırma tarihi geçen bayraklar temizlendi mi?
-- [ ] `docs/product/feedback.md`: yeni geri bildirimler işlendi mi (`/user-feedback`)?
-
-## Çeyreklik (3 ayda bir, ~yarım gün)
-
-- [ ] **Yedekten tam geri yükleme tatbikatı** (ayrı bir ortama).
-- [ ] Erişim gözden geçirme: hosting, DB, ödeme, domain, kod deposu. Eski erişimleri kaldır.
-- [ ] Kritik anahtarların yenilenmesi (rotation), özellikle sızma şüphesi olanlar.
-- [ ] Majör sürüm güncellemeleri planla (framework, runtime, SDK).
-- [ ] `docs/legal/privacy-kvkk.md` ve yayındaki metinler güncel mi? Yeni veri/servis eklendi mi?
-- [ ] `docs/security/checklist.md` tam tur.
-- [ ] `docs/operations/accounts.md`: bitiş tarihleri, 2FA, artık kullanılmayan hesaplar.
-
-## Olay müdahale (site çöktü / veri sızdı / fatura patladı)
-
-1. **Durdur:** Zarar sürüyorsa önce durdur. Önceki sürüme dön (rollback), sızan anahtarı iptal et, servisi bakım moduna al.
-2. **Kaydet:** Ne zaman başladı, kimler etkilendi, ne gördün? Ekran görüntüsü ve log al. Şimdi değil sonra hatırlamazsın.
-3. **Düzelt:** Kök nedeni bul ve düzelt; regresyon testi ekle.
-4. **Bildir:** Kişisel veri ihlali varsa KVKK Kurulu'na **72 saat** içinde bildirim ve etkilenen kullanıcılara bilgilendirme (`docs/legal/privacy-kvkk.md`).
-5. **Öğren:** Aşağıdaki kayda yaz. Tekrarı engelleyen kontrolü ilgili listeye ekle.
+# Maintenance and Regular Checks
+
+> A live project decays on its own: dependencies age, certificates and cards expire,
+> bills swell, backups stop silently. This file catches those.
+> The commands `/maintain weekly` · `/maintain monthly` · `/maintain quarterly` run the matching list and add to the log.
+> Project-type-specific extra items: `docs/architecture/stack.md` → "Maintenance (extra)".
+
+## Weekly (~15 min)
+
+- [ ] Error tracking: any new or rising errors? If yes, add them to `docs/product/roadmap.md` as tasks.
+- [ ] Uptime: was there an outage?
+- [ ] Cost: is hosting, DB and AI API spend within the expected range? Did a spend alarm fire (`docs/operations/spend-alarms.md`)?
+- [ ] User feedback / support inbox scanned.
+- [ ] Were backups taken successfully in the last 7 days?
+
+## Monthly (~1 hour)
+
+- [ ] Dependency updates (patch and minor versions) + tests.
+- [ ] Dependency security scan (`npm audit` / `uv run --with pip-audit pip-audit`).
+- [ ] Performance measurement (project-type-specific targets, `docs/architecture/stack.md`).
+- [ ] Cost trend: why did it rise compared with last month?
+- [ ] Clean up unused services, environment variables, feature flags, dead code.
+- [ ] Are `docs/workflow/progress.md` and `docs/architecture/overview.md` current?
+- [ ] Analytics: status against the success criteria (`docs/product/prd.md` §4).
+- [ ] Duplicate code ratio (`npx jscpd --silent .`) and a monthly row in `docs/quality/metrics.md`.
+- [ ] Is `docs/product/unit-economics.md` current with the real invoices?
+- [ ] `docs/operations/feature-flags.md`: were the flags past their removal date cleaned up?
+- [ ] `docs/product/feedback.md`: was new feedback processed (`/user-feedback`)?
+
+## Quarterly (every 3 months, ~half a day)
+
+- [ ] **Full restore drill from backup** (into a separate environment).
+- [ ] Access review: hosting, DB, payment, domain, code repository. Remove old access.
+- [ ] Rotate critical keys, especially those suspected of a leak.
+- [ ] Plan major version updates (framework, runtime, SDK).
+- [ ] Are `docs/legal/privacy-kvkk.md` and the published texts current? Was new data/a new service added?
+- [ ] Full pass of `docs/security/checklist.md`.
+- [ ] `docs/operations/accounts.md`: expiry dates, 2FA, accounts no longer used.
+
+## Incident response (site down / data leaked / bill exploded)
+
+1. **Stop:** If damage continues, stop it first. Return to the previous version (rollback), revoke the leaked key, put the service in maintenance mode.
+2. **Record:** When did it start, who was affected, what did you see? Take screenshots and logs. You will not remember later.
+3. **Fix:** Find and fix the root cause; add a regression test.
+4. **Notify:** For a personal data breach, notify the KVKK Board within **72 hours** and inform the affected users (`docs/legal/privacy-kvkk.md`).
+5. **Learn:** Write it in the log below. Add the check that prevents a repeat to the matching list.
 
 ## Bakım kaydı
 
-| Tarih | Tür | Bulgular | Yapılan / açılan görev |
+| Date | Type | Findings | Done / task opened |
 |---|---|---|---|
-| | haftalık/aylık/çeyreklik/olay | | |
+| | weekly/monthly/quarterly/incident | | |