☕ Espressoir

Her fincanın bir hatırası var. Bir kahve tadım defteri ve arşivi: filtre, V60, kapsül, French press, Türk kahvesi… tüm demleme yöntemleri için. Önce kişisel bir arşiv; zamanla herkesin kendi tadımını girdiği bir topluluk ve bir mobil uygulama.

Kapsam ve yol haritası: PROJECT_BRIEF.md

Yığın

Next.js 16 (App Router, Cache Components) · TypeScript (strict) · Tailwind CSS 4 (tasarım token'larına bağlı) · Supabase (Postgres, Auth, RLS) · Zod · Vitest (+ gömülü Postgres: PGlite) · Playwright · pnpm + Turborepo · Vercel (Hobby, fra1)

Klasör yapısı

design/            Tasarım dili (DESIGN.md), token'lar (tokens.css), bileşen referansı, içerik metinleri
apps/web/          Next.js uygulaması (Vercel'in Root Directory'si); src/content/ atölye programları ve bilgi yazıları
packages/core/     siteConfig, Türkçe katlama/slug, puan kademeleri, istatistik, liste filtresi
packages/i18n/     Tüm arayüz metinleri (Türkçe sözlük)
packages/db/       Şemadan üretilen tipler, arşiv okuma modelleri, tadım formu doğrulaması
packages/config/   Ortak tsconfig ve ESLint ayarları
supabase/          config.toml, migrations/, rollbacks/
scripts/           DB push, tip üretimi, Notion import, hesap oluşturma, testler
docs/              Kurulum, yayın ve yedek rehberleri
data/              Notion export'un ve import raporu (git'e girmez)

Başlangıç

Gerekenler: Node 22 (.nvmrc) ve pnpm 10 (corepack enable yeterli). Docker gerekmez.

corepack enable yetki hatası verirse (Node sistem klasörüne kuruluysa olur), pnpm komutunu PATH'indeki kendi klasörlerinden birine koy: corepack enable pnpm --install-directory <klasör>.

pnpm install
pnpm dev:offline               # hesap/anahtar gerekmeden: http://localhost:3000

dev:offline, data/notion-export.csv dosyanı (yoksa örnek veriyi) bilgisayarında çalışan gömülü bir Postgres'e aktarır ve siteyi oradan gösterir. Sayfaları görmek ve tasarım üzerinde çalışmak için yeterli; giriş ve panel için gerçek bir Supabase projesi gerekir:

cp .env.example .env.local     # dev Supabase değerlerini gir (docs/setup-supabase.md)
pnpm db:push:dev               # migration'ları dev projesine uygula
pnpm admin:bootstrap           # hesabını oluştur
pnpm import:notion --dry-run   # Notion arşivini dene; sonra --dry-run olmadan yaz
pnpm dev                       # http://localhost:3000

Komutlar

Komut	Ne yapar
pnpm dev	Web uygulamasını dev Supabase'e karşı başlatır
pnpm dev:offline	Aynısı, veriyi yerel bir anlık görüntüden okuyarak (Supabase gerekmez)
pnpm build	Tüm paketleri derler (web: production build)
pnpm check	lint + typecheck + testler (RLS ve import testleri dahil, gömülü Postgres'te)
pnpm test:e2e:offline	Örnek veriyle derler ve Playwright testlerini çalıştırır
pnpm test:e2e	Playwright testleri, hazır bir derlemeye karşı (CI'da gerçek Supabase ile)
pnpm format	Prettier ile biçimlendirir
pnpm db:new <ad>	Yeni migration dosyası (geri alma dosyasını da yaz: supabase/rollbacks/)
pnpm db:push:dev / db:push:prod	Migration'ları dev/prod'a uygular (prod onay ister)
pnpm types:gen	packages/db tiplerini migration'lardan yeniden üretir
pnpm tokens:gen	design/tokens.css renklerini CSS okuyamayan yerler için TS'e yazar (paylaşım görseli vb.)
pnpm admin:bootstrap	Hesabını oluşturur ve admin yapar (--env prod ile canlıda)
pnpm user:invite <e-posta>	Kayıt kapalıyken davet gönderir (sitede: /osman → Moderasyon → Davetler)
pnpm import:notion	Notion CSV'sini içe aktarır (--offline, --dry-run, --env prod)
pnpm seed:dev	Dev'e örnek arşivi yükler (prod'u reddeder)
pnpm media:sweep	Hiçbir kaydın göstermediği fotoğraf dosyalarını listeler (--apply siler)
pnpm export:analytics	Herkese açık tadımları takma adla CSV'ye döker: data/analytics/ (yalnızca okur)
pnpm import:recommendations	Python'da kurduğun modelin önerilerini yükler (, , , )

Playwright tarayıcısı kurulu değilse: pnpm --filter @espressoir/web exec playwright install chromium, ya da kurulu Chrome'u göster: PLAYWRIGHT_CHROMIUM_EXECUTABLE="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome".

Sayfalar

Adres	İçerik
/	Önce kahve bilgisi: "Okumaya başla", demleme rehberleri, yazılar, sıradaki atölye, son tadım notları
/workshop, /workshop/[id]	Atölye (Kahve 101): tarih ("Takvime ekle", Google Takvim), konum, kontenjan, program, açılır kapanır sorular, başvuru formu; /atolye buraya gelir
/teyit/[anahtar]	Onaylı kişinin "geliyor musun?" sayfası: WhatsApp'tan gönderilen kişisel bağlantı, Geliyorum / Gelemiyorum
/bilgi, /bilgi/[yazi]	Demleme rehberleri (tarif, fincan sayısına göre ölçeklenen demleme asistanı ve zamanlayıcı, adımlar) ve kısa kahve yazıları; her biri bir Markdown dosyası
/ara	Sitede arama: yazılar, kahveler, markalar, kafeler, üyeler; yazdıkça sonuç, / ya da ⌘K ile her sayfadan açılır
/kahve-testi	Beş soruda sana uyan demleme yöntemi ve kavrum; sonuç bağlantıyla paylaşılır
/kahveler	Tüm kahveler; arama, filtre, sıralama, kart görünümü (durum URL'de)
/kahve/[marka]/[kahve]	Tadımlar, künye, benzer kahveler, paylaşım görseli, JSON-LD
/marka/[slug]	Markanın kahveleri ve ortalaması
/istatistik	Arşivin sayıları, en yüksek puanlılar, yöntemler; dağılım, marka/form/yöntem ortalamaları (n ile), saçılım
/hakkinda	Site ve puanlama hakkında
/akis	Son tadımlar: herkes ya da takip ettiklerin; son kafe ziyaretleri
/kafeler	Kafeler; şehre ve ada göre süzme (durum URL'de)
/kafe/[sehir]/[kafe]	Kafenin ziyaretleri, ortalaması, içecek türüne göre ortalama (n ile)
/tadim/[id]	Tek bir tadım: beğeni, yorumlar (tek seviye yanıt), şikâyet
/u/[kullanici]	Üyenin defteri: sayılar, grafikler, tadımlar, listeler, denenecekler; takip
/u/[kullanici]/liste/[liste]	Üyenin herkese açık bir listesi: sırasıyla kahveler ve notlar

Rehberler

• Supabase kurulumu, hesap oluşturma, Notion import
• Giriş kurulumu: e-posta kodu, Google, Turnstile, davet
• Ziyaret istatistikleri: Google Analytics ve /osman
• Vercel yayını ve espressoir.com DNS
• Yedek ve uyandırma iş akışları
• Mobil uygulama: iPhone'a kurmak

Durum

• Faz 0: Kurulum. Monorepo, tasarım temeli, Supabase altyapısı, CI.
• Faz 1: Arşiv + çok kullanıcılı altyapı. Şema, RLS, Notion import, tadım formu, public sayfalar, istatistik, SEO, yedek. Yayında: https://espressoir.com
• Faz 2: Topluluk. Dört adımda ilerliyor, önce davetli beta:
  • Hazırlık: dev projesi ve önizlemeler.
  • 2A Hesaplar: e-posta kodu ve Google ile giriş, davet, kullanıcı adı seçimi, profil sayfası, veri indirme, hesap silme, KVKK taslakları.
  • 2B Topluluk tadımları: kahve arama ve kopya uyarısı, hız sınırları, takip, akış, profil grafikleri.
  • 2C Etkileşim ve moderasyon: yorum, beğeni, şikâyet, yönetim paneli.
  • 2D Davet ekranı ve iki görünüm: yönetimden e-posta daveti; daha kolay okunan "Sade" görünüm (varsayılan) ve özgün "Tadım formu", sağ üstteki menüden anında değişir.
• Faz 3: Sosyal derinlik. Altı adımda:
  • 3A Tat: formda tat etiketleri, tadımda radar grafiği, kahve sayfasında topluluğun tat profili ve öne çıkan tatlar, profilde damak özeti.
  • 3B Listeler: herkese açık ya da gizli kahve listeleri (sıra ve not ile), kahve sayfasında "Listeye ekle" ve tek tıkla "Denemek istiyorum".
  • 3C Bildirimler: beğeni, yorum, yanıt ve yeni takipçi; başlıkta okunmamış sayısı.
  • 3D Fotoğraf: tadım başına bir fotoğraf ve profil resmi; telefonda küçültülür, konum bilgisi silinir; yönetimden silinebilir.
  • 3E Ana ekran ve hızlı form: telefonda ana ekrana eklenir, uygulama gibi açılır; son içtiğin kahveler tek dokunuşta, yöntem ve cihaz son tadımdan dolu gelir.
  • 3F Kafeler: her üye kafe ekleyip orada içtiğine puan verir (şehir, semt, isteğe bağlı harita bağlantısı); , kafe sayfası, profilde ve akışta kafe ziyaretleri; kopya uyarısı, yönetimden doğrulama ve birleştirme. Kahve ortalamalarına karışmaz.